faf-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+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).
+
+## [1.0.0] - 2025-11-12
+
+### Added
+- **Universal MCP Package** - Platform-agnostic MCP server for all MCP-compatible platforms
+  - Works with Claude Desktop, Cursor, Windsurf, VS Code, and any MCP client
+  - 50 MCP tools for FAF context management
+  - Auto-installs faf-cli as dependency
+  - Orange smiley icon included in package
+- **Platform-Specific Documentation** - Setup guides for each major platform
+  - Claude Desktop config instructions
+  - Cursor IDE integration steps
+  - Windsurf Editor setup
+  - VS Code MCP extension guide
+
+### Technical
+- Based on claude-faf-mcp v3.3.0 codebase
+- 100% standalone operation (bundled FAF engine)
+- 16.2x faster than CLI versions
+- 19ms average execution time
+- Zero external dependencies
+
+### Ecosystem
+This is the universal package for FAF MCP integration. Platform-specific packages (cursor-faf-mcp, windsurf-faf-mcp, etc.) may follow based on demand.
+
+---
+
+*For claude-faf-mcp changelog history, see: https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/CHANGELOG.md*

package/CLAUDE.md

@@ -0,0 +1,73 @@
+# 🏎️ CLAUDE.md - faf-mcp Persistent Context
+
+## PROJECT STATE: ACTIVE 🚀
+**Current Position:** Universal MCP server for all platforms
+**Tyre Compound:** ULTRASOFT C5 (Maximum Performance)
+
+---
+
+## 🎨 CORE CONTEXT
+
+### Project Identity
+- **Name:** faf-mcp
+- **Stack:** Node.js/TypeScript
+- **Quality:** F1-INSPIRED (Championship Performance)
+
+### Our Mission - Universal MCP Integration
+
+**v1.0.0 Launch: PLATFORM-AGNOSTIC**
+
+```
+faf-mcp: UNIVERSAL MCP SERVER
+├── Claude Desktop support
+├── Cursor IDE support
+├── Windsurf Editor support
+├── VS Code support
+└── Any MCP-compatible platform
+```
+
+**CRITICAL: faf-mcp IS THE UNIVERSAL PACKAGE**
+- ✅ Works with ALL MCP platforms
+- ✅ 100% standalone (bundled FAF engine)
+- ✅ Based on proven claude-faf-mcp codebase
+- ✅ Championship-grade performance
+- ✅ Orange smiley icon everywhere
+
+**The .faf Position in MCP:**
+
+```
+Platform      Context          Protocol
+────────      ───────          ────────
+Claude    →   .faf        →    MCP
+Cursor    →   .faf        →    MCP
+Windsurf  →   .faf        →    MCP
+Any IDE   →   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 - AI Context Intelligence for All Platforms
+- **Main Language:** TypeScript
+
+### 📊 Context Quality Status
+- **Overall Assessment:** New (forked from claude-faf-mcp v3.3.0)
+- **Last Updated:** 2025-11-12
+
+---
+
+## 🎯 Strategic Position
+
+**Ecosystem Strategy:**
+- `faf-mcp` - Universal package (primary)
+- `claude-faf-mcp` - Maintained (established metrics)
+- Future: Platform-specific versions based on demand (cursor-faf-mcp, windsurf-faf-mcp, etc.)
+
+**Traffic Strategy:**
+- Capture searches across ALL MCP platforms
+- Keywords: mcp, cursor, windsurf, claude, gemini, vscode
+- Aggregate download metrics from universal package
+
+---
+
+**Built with F1-inspired engineering principles** 🏎️⚡

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 wolfejam (team@faf.one) 🏎️⚡ wolfejam.dev
+PODIUM EDITION 🍊
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,165 @@
+<div style="display: flex; align-items: center; gap: 12px;">
+  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40" />
+  <div>
+    <h1 style="margin: 0; color: #FF8C00;">faf-mcp</h1>
+    <p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
+  </div>
+</div>
+
+> Universal MCP server for .FAF (Foundational AI-context Format) with 50 tools - Works with Claude Desktop, Cursor, Windsurf, and all MCP-compatible platforms
+
+[![NPM Downloads](https://img.shields.io/npm/dt/faf-mcp?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-mcp)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3pjzpKsP)
+[![Chrome Web Store](https://img.shields.io/badge/Chrome-Extension-4285F4?logo=googlechrome&logoColor=white)](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)
+[![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🏁 AI-Readiness Scorecard
+
+**The closer you get to 100% the better AI can assist you.**
+
+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
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 CORE INTELLIGENCE                    🎯 CONTEXT DELIVERY
+├─ Project DNA            [██████] 100%  ├─ MCP Protocol      [██████] 100%
+├─ Architecture Map       [██████] 100%  ├─ 50 Native Tools   [██████] 100%
+├─ Domain Model          [██████] 100%  ├─ IANA Format       [██████] 100%
+└─ Version Tracking      [██████] 100%  └─ Universal Context [██████] 100%
+
+🚀 PERFORMANCE                          ⚡ STANDALONE OPERATION
+├─ 16.2x CLI Speedup     [██████] 100%  ├─ Zero Dependencies [██████] 100%
+├─ 19ms Avg Execution    [██████] 100%  ├─ Bundled Engine    [██████] 100%
+├─ 50/50 Tools Active    [██████] 100%  ├─ Direct Function   [██████] 100%
+└─ Zero Memory Leaks     [██████] 100%  └─ 14 Bundled Cmds   [██████] 100%
+
+🏆 project.faf score: podium
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## ⚡ Quick Start
+
+**Copy and paste this to Claude/your AI:**
+
+> Install the FAF MCP server: `npm install -g faf-mcp`, then add this to my MCP config: `{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}` and restart.
+
+### Platform-Specific Setup
+
+**Claude Desktop:** Add to `claude_desktop_config.json` ([location guide](https://wolfe-jam.github.io/claude-faf-mcp/))
+
+**Cursor IDE:** Add to `~/.cursor/mcp.json` ([setup guide](https://docs.cursor.com/context/model-context-protocol))
+
+**Windsurf Editor:** Add to `~/.codeium/windsurf/mcp_config.json` ([Cascade docs](https://docs.windsurf.com/windsurf/cascade/mcp))
+
+**VS Code:** Install MCP extension, then add server config
+
+---
+
+## 🎯 Want a Platform-Specific Package?
+
+We're launching `faf-mcp` as the universal package. If you'd prefer a dedicated package for your platform (like `cursor-faf-mcp` or `windsurf-faf-mcp` with tailored setup instructions), **[request it here](https://github.com/Wolfe-Jam/faf-mcp/issues)**.
+
+We'll publish platform-specific packages based on demand.
+
+---
+
+## 🎯 What is FAF?
+
+**The .FAF Position in the MCP Ecosystem:**
+
+```
+  Platform      Context          Protocol
+  ────────      ───────          ────────
+  Claude    →   .faf        →    MCP
+  Cursor    →   .faf        →    MCP
+  Windsurf  →   .faf        →    MCP
+  VS Code   →   .faf        →    MCP
+  Any IDE   →   IANA Format →    Open Protocol
+```
+
+**.FAF is the foundational, universal base layer** for any platform using the Model Context Protocol. It provides the standardized Context that makes MCP work for everyone.
+
+---
+
+## 🛠️ Core Features
+
+### 50 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
+- **faf_write** - Create/update FAF with validation
+- **faf_score** - AI-readiness scoring engine
+- **faf_compress** - Intelligent size optimization
+- **14 bundled commands** - Zero CLI dependencies, 16.2x faster
+
+### IANA-Registered Standard
+- Official MIME type: `application/vnd.faf+yaml`
+- W3C-compliant structured format
+- Universal AI context protocol
+- Cross-platform compatibility
+
+### Championship Performance
+- **16.2x faster** than CLI versions (direct function calls vs process spawning)
+- **19ms average** execution across all bundled commands
+- **Fastest: 1ms** (formats command)
+- **Zero memory leaks** with F1-grade engineering
+
+---
+
+## 📚 Documentation
+
+- **[Full Documentation](https://wolfe-jam.github.io/claude-faf-mcp/)** - Complete guide
+- **[Getting Started](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/getting-started.md)** - Installation & setup
+- **[MCP Tools Reference](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/mcp-tools.md)** - All 50 tools
+- **[FAQ](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/FAQ.md)** - Common questions
+- **[CHANGELOG](./CHANGELOG.md)** - Version history
+
+---
+
+## 🏆 Why FAF?
+
+> "README for the AI era" — Gemini CLI
+
+**Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
+
+**Universal Format** - IANA-registered standard works across Claude, Gemini, Cursor, Windsurf, any MCP platform
+
+**Zero Setup Tax** - One file (`project.faf`) eliminates AI context setup across your entire team
+
+**Championship Engineering** - F1-inspired performance with strict TypeScript, zero runtime errors
+
+---
+
+## 📦 Ecosystem
+
+- **[FAF Format Spec](https://github.com/Wolfe-Jam/faf)** - Official IANA specification
+- **[FAF CLI](https://github.com/Wolfe-Jam/faf-cli)** - Command-line tooling
+- **[claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp)** - Claude Desktop-specific package
+- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** - Browser integration
+- **[faf.one](https://faf.one)** - Official website and documentation
+- **[Discord Community](https://discord.com/invite/3pjzpKsP)** - Join the discussion
+
+---
+
+## 📄 License
+
+MIT License - Free and open source
+
+---
+
+**Built with F1-inspired engineering principles** 🏎️⚡
+
+*"It's so logical if it didn't exist, AI would have built it itself" — Claude*

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