faf-mcp 1.2.2 → 1.2.3

package/README.md

@@ -1,247 +1,189 @@
 <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 | use>faf</h1>
+    <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 17 native tools + CLI fallback - Persistent project context for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms (including [Claude Desktop](https://github.com/Wolfe-Jam/claude-faf-mcp))
+> **.FAF optimizes AI for your codebase.** At 100% (Gold Code), AI stops guessing and starts knowing. Universal MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms.
 
-**Universal version of [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp)** — Anthropic-approved MCP server, now compatible with all platforms. Built on the IANA-registered .FAF format (`application/vnd.faf+yaml`).
+**Universal version of [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp)** — Anthropic-approved MCP server, now compatible with all 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/56fPBUJKfk)
-[![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)
 
 ---
 
-## ⚡ Quick Start
-
-**1. Install:**
-
-```bash
-npm install -g faf-mcp
-```
-
-**2. Copy and paste this to 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
+## The Problem: Context-Drift
 
-**Cursor IDE:** Add to `~/.cursor/mcp.json` ([setup guide](https://docs.cursor.com/context/model-context-protocol))
+AI assistants forget. They misunderstand. They drift.
 
-**Windsurf Editor:** Add to `~/.codeium/windsurf/mcp_config.json` ([Cascade docs](https://docs.windsurf.com/windsurf/cascade/mcp))
+Every new session, every new file, every new developer — AI starts guessing again. Your codebase context leaks away. Yesterday's perfect assistant becomes today's confused intern.
 
-**Cline:** Add to Cline's MCP settings
-
-**VS Code:** Install MCP extension, then add server config
-
-**Claude Desktop:** Use the [dedicated claude-faf-mcp package](https://github.com/Wolfe-Jam/claude-faf-mcp) for optimized Claude integration
+**.FAF fixes this permanently.**
 
 ---
 
-## 🏁 AI-Readiness Scorecard
-
-> **"README for the AI era"** — Google Gemini
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf-mcp/main/assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
-  <p><em><strong>project.faf is to AI context what package.json is to dependencies</strong></em></p>
-  <p><em>Lives at the project root, between package.json and README.md</em></p>
-</div>
-
-**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.
+## The Solution: Gold Code
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏎️  FAF AI-READINESS SCORE: 100/100 — PODIUM EDITION
+🏆  FAF AI-READINESS SCORE: 100/100 — GOLD CODE
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-📊 CORE INTELLIGENCE                    🎯 CONTEXT DELIVERY
-├─ Project DNA            [██████] 100%  ├─ MCP Protocol      [██████] 100%
-├─ Architecture Map       [██████] 100%  ├─ 17 Native Tools   [██████] 100%
-├─ Domain Model          [██████] 100%  ├─ IANA Format       [██████] 100%
-└─ Version Tracking      [██████] 100%  └─ Universal Context [██████] 100%
+At 100%, AI is optimized. No more guessing.
+Peak AI performance activated.
 
-🚀 PERFORMANCE                          ⚡ STANDALONE OPERATION
-├─ 16.2x CLI Speedup     [██████] 100%  ├─ Zero Dependencies [██████] 100%
-├─ 19ms Avg Execution    [██████] 100%  ├─ Bundled Engine    [██████] 100%
-├─ 17/17 Tools Active    [██████] 100%  ├─ Direct Function   [██████] 100%
-└─ Zero Memory Leaks     [██████] 100%  └─ 14 Bundled Cmds   [██████] 100%
+├─ Project DNA locked in        ├─ Zero context-drift
+├─ Architecture understood      ├─ Eternal bi-sync active
+├─ Domain model captured        ├─ Team alignment permanent
+└─ Every session starts smart   └─ AI works WITH you, not around you
 
-🏆 project.faf score: podium
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
 ---
 
-## 🎯 Want a Platform-Specific Package?
+## 💎 Lifecycle Value
+
+Setup savings get you started. Lifecycle optimization keeps you ahead.
 
-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)**.
+| When | Without FAF | With FAF |
+|------|-------------|----------|
+| **Day 1** | 20 min setup per dev | 0 min — instant context |
+| **Month 1** | AI forgets between sessions | AI remembers everything |
+| **Year 1** | New devs re-explain everything | New devs inherit full context |
+| **Year 3+** | Institutional knowledge lost | Project DNA preserved forever |
 
-We'll publish platform-specific packages based on demand.
+**Setup savings: 20 minutes. Lifecycle savings: Infinite.**
 
 ---
 
-## 💬 use>faf | Prompt Pattern
+## ⚡ Quick Start
 
-**Start every prompt with "Use FAF"** to invoke MCP tools directly:
+**1. Install:**
 
-### All Platforms
-```
-Use FAF to initialize my project
-Use FAF to sync my project.faf to all platforms
-Use FAF to score my AI-readiness
-Use FAF to enhance my project context
-Use FAF to create platform sync files
+```bash
+npm install -g faf-mcp
 ```
 
-### Why "Use FAF" Works Everywhere
-
-**Claude Desktop:**
-- ✅ Calls MCP tool instead of searching web
-- ✅ No void container issues
-- ✅ Direct tool invocation
-
-**Claude.ai (Web):**
-- ✅ Stops web search addiction immediately
-- ✅ Forces MCP tool usage
-- ✅ No more guessing
-
-**Cursor / Windsurf / Cline:**
-- ✅ MCP standard compliance
-- ✅ Tool invocation (not manual file creation)
-- ✅ Consistent behavior
+**2. Add to your MCP config:**
 
-### The Pattern
+```json
+{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}
+```
 
-**Without "Use FAF":**
-- ❌ AI searches the web
-- ❌ AI creates files manually
-- ❌ Void containers
-- ❌ Inconsistent results
+### Platform-Specific Setup
 
-**With "Use FAF":**
-- ✅ MCP tool called correctly
-- ✅ Championship output
-- ✅ Every time
+| Platform | Config File |
+|----------|-------------|
+| **Cursor** | `~/.cursor/mcp.json` |
+| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
+| **Cline** | Cline MCP settings |
+| **VS Code** | MCP extension config |
+| **Claude Desktop** | Use [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp) |
 
 ---
 
-## 🎯 What is FAF?
+## 🔄 Eternal Bi-Sync
 
-**The .FAF Position in the MCP Ecosystem:**
+The magic: `.faf` ↔ `CLAUDE.md` stay synchronized in milliseconds.
 
 ```
-  Platform      Context          Protocol
-  ────────      ───────          ────────
-  Any IDE   →   IANA Format →    Open Protocol
-  Cursor    →   .faf        →    MCP
-  Windsurf  →   .faf        →    MCP
-  Cline     →   .faf        →    MCP
-  VS Code   →   .faf        →    MCP
-  Claude    →   .faf        →    MCP
-  Gemini    →   .faf        →    MCP
+project.faf  ←──── 8ms ────→  CLAUDE.md
+     │                            │
+     └── Single source of truth ──┘
 ```
 
-**.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.
+- Update either file → both stay aligned
+- Zero manual maintenance
+- Works across teams, branches, sessions
+- **Context never goes stale**
 
 ---
 
-## 🛠️ Core Features
-
-### 17 Native MCP Tools
-- **faf_init** - Initialize project.faf with auto-detection
-- **faf_score** - AI-readiness scoring engine
-- **faf_enhance** - Intelligent enhancement with auto-detection
-- **faf_read** - Parse and validate FAF files
-- **faf_write** - Create/update FAF with validation
-- **faf_sync** - Synchronize context across platforms
-- **faf_bi_sync** - Bi-directional CLAUDE.md sync
-
-### CLI Fallback (40+ commands)
-- **faf readme** - Smart 6 Ws extraction from README.md
-- **faf human-add** - Non-interactive human context entry
-- **faf git** - GitHub repo extraction (Git CLI, no rate limits)
-- Plus all other faf-cli commands
-
-### 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
-
----
+## Tier System: From Blind to Optimized
 
-## 📚 Documentation
+| Tier | Score | Status |
+|------|-------|--------|
+| 🏆 **Trophy** | 100% | **AI Optimized** — Gold Code |
+| 🥇 **Gold** | 99%+ | Near-perfect context |
+| 🥈 **Silver** | 95%+ | Excellent |
+| 🥉 **Bronze** | 85%+ | Production ready |
+| 🟢 **Green** | 70%+ | Solid foundation |
+| 🟡 **Yellow** | 55%+ | AI flipping coins |
+| 🔴 **Red** | <55% | AI working blind |
+| 🤍 **White** | 0% | No context at all |
 
-- **[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 17 native tools
-- **[FAQ](https://github.com/Wolfe-Jam/claude-faf-mcp/blob/main/docs/FAQ.md)** - Common questions
-- **[CHANGELOG](./CHANGELOG.md)** - Version history
+**At 55%, AI is guessing half the time.** At 100%, AI is optimized.
 
 ---
 
-## 🏆 Why FAF?
+## 💬 use>faf | Prompt Pattern
+
+**Start every prompt with "Use FAF"** to invoke MCP tools:
 
-### Championship Credentials
+```
+Use FAF to initialize my project
+Use FAF to score my AI-readiness
+Use FAF to sync my context
+Use FAF to enhance my project
+```
 
-**🏅 Creators of the Format** - We designed .FAF (IANA-registered `application/vnd.faf+yaml`)
-**🏅 First & Only** - Persistent Project Context MCP Server approved by Anthropic
-**🏅 Creators of Context-Mirroring** - faf_bi_sync creates native files for all platforms
-**🏅 Google Chrome-Approved** - Published Chrome Extension
-**🏅 15K+ npm Downloads** - Proven adoption across the FAF ecosystem
+Works on all platforms — stops web search, forces tool usage.
 
-> "README for the AI era" — Google Gemini
+---
 
-### The FAF Advantage
+## 🛠️ 17 Native MCP Tools
 
-**Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
+| Tool | Purpose |
+|------|---------|
+| `faf_init` | Initialize project.faf |
+| `faf_score` | Check AI-readiness (0-100%) |
+| `faf_sync` | Sync context across platforms |
+| `faf_bi_sync` | Bi-directional .faf ↔ CLAUDE.md |
+| `faf_enhance` | Intelligent enhancement |
+| `faf_read` | Parse and validate FAF files |
+| `faf_write` | Create/update FAF with validation |
 
-**Universal Format** - IANA-registered standard works across Claude, Gemini, Cursor, Windsurf, any MCP platform
+Plus CLI fallback with 40+ commands.
 
-**Zero Setup Tax** - One file (`project.faf`) eliminates AI context setup across your entire team
+---
 
-**FREE FOREVER** - MIT License, open source, no subscription
+## 🎯 The .FAF Position
 
-**All Boats Rise Together** - Improving projects, AI performance, code quality, speed to market for everyone
+```
+  Platform      Context          Protocol
+  ────────      ───────          ────────
+  Cursor     →   .faf        →    MCP
+  Windsurf   →   .faf        →    MCP
+  Cline      →   .faf        →    MCP
+  VS Code    →   .faf        →    MCP
+  Claude     →   .faf        →    MCP
+  Any IDE    →   .faf        →    MCP
+```
 
-**Championship Engineering** - F1-inspired performance with strict TypeScript, zero runtime errors
+**.FAF is the foundational layer.** Universal context format. IANA-registered. Works everywhere.
 
 ---
 
 ## 📦 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/56fPBUJKfk)** - Join the discussion
+- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (52 tools)
+- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI (18k+ downloads)
+- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)
+- **[faf.one](https://faf.one)** — Official website
 
 ---
 
 ## 📄 License
 
-MIT License - Free and open source
+MIT License — Free and open source
 
 ---
 
-**Built with F1-inspired engineering principles** 🏎️⚡
+**Zero drift. Eternal sync. AI optimized.** 🏆
 
 *"It's so logical if it didn't exist, AI would have built it itself" — Claude*

package/dist/index.json

@@ -0,0 +1 @@
+{"note":"Placeholder for Vercel build"}

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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"}