webmcp-cli 1.0.0 → 1.2.1

package/dist/rules/security/SEC-001.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SEC-001: Destructive Actions Flagged
+ *
+ * CRITICAL security rule that checks if tools with critical
+ * destructive operations have either destructiveHint OR
+ * requiresConfirmation set.
+ *
+ * Critical operations include: delete, destroy, purchase, pay, transfer, etc.
+ */
+import type { Rule } from '../../core/types/rule.js';
+export declare const SEC_001: Rule;
+export default SEC_001;

package/dist/rules/security/SEC-001.js

@@ -0,0 +1,66 @@
+/**
+ * SEC-001: Destructive Actions Flagged
+ *
+ * CRITICAL security rule that checks if tools with critical
+ * destructive operations have either destructiveHint OR
+ * requiresConfirmation set.
+ *
+ * Critical operations include: delete, destroy, purchase, pay, transfer, etc.
+ */
+import { createRuleResult } from '../runner.js';
+import { CRITICAL_DESTRUCTIVE_KEYWORDS, hasKeyword, findMatchedKeywords, } from '../utils/keywords.js';
+export const SEC_001 = {
+    id: 'SEC-001',
+    category: 'security',
+    name: 'Destructive Actions Flagged',
+    description: 'Critical destructive operations must have destructiveHint or requiresConfirmation',
+    severity: 'critical',
+    maxScore: 15,
+    async check(context) {
+        const tools = context.tools;
+        if (tools.length === 0) {
+            return createRuleResult('SEC-001', 15, {
+                passed: true,
+                score: 15,
+                message: 'No tools detected (rule not applicable)',
+            });
+        }
+        const violations = [];
+        for (const tool of tools) {
+            const textToSearch = `${tool.name} ${tool.description}`;
+            if (hasKeyword(textToSearch, CRITICAL_DESTRUCTIVE_KEYWORDS)) {
+                // Check if either destructiveHint OR requiresConfirmation is set
+                const hasDestructiveHint = tool.annotations?.destructiveHint === true;
+                const hasRequiresConfirmation = tool.annotations?.requiresConfirmation === true;
+                if (!hasDestructiveHint && !hasRequiresConfirmation) {
+                    const matchedKeywords = findMatchedKeywords(textToSearch, CRITICAL_DESTRUCTIVE_KEYWORDS);
+                    violations.push({ name: tool.name, keywords: matchedKeywords });
+                }
+            }
+        }
+        if (violations.length === 0) {
+            return createRuleResult('SEC-001', 15, {
+                passed: true,
+                score: 15,
+                message: 'All critical destructive tools are properly flagged',
+            });
+        }
+        // Deduct 5 points per violation (critical security issue)
+        const penalty = violations.length * 5;
+        const score = Math.max(0, 15 - penalty);
+        return createRuleResult('SEC-001', 15, {
+            passed: false,
+            score,
+            message: `${violations.length} critical tool(s) missing security annotations`,
+            details: violations.map((v) => `CRITICAL: Tool "${v.name}" contains [${v.keywords.join(', ')}] but lacks destructiveHint or requiresConfirmation`),
+            suggestions: [
+                'Add destructiveHint: true OR requiresConfirmation: true for critical operations',
+                'These annotations help agents understand the impact of tool execution',
+                'Example: { annotations: { destructiveHint: true, requiresConfirmation: true } }',
+            ],
+            affectedTools: violations.map((v) => v.name),
+        });
+    },
+};
+export default SEC_001;
+//# sourceMappingURL=SEC-001.js.map

package/dist/rules/security/SEC-001.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SEC-001.js","sourceRoot":"","sources":["../../../src/rules/security/SEC-001.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,6BAA6B,EAC7B,UAAU,EACV,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,mFAAmF;IACrF,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,EAAE;IAEZ,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAA2C,EAAE,CAAC;QAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAExD,IAAI,UAAU,CAAC,YAAY,EAAE,6BAA6B,CAAC,EAAE,CAAC;gBAC5D,iEAAiE;gBACjE,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,KAAK,IAAI,CAAC;gBACtE,MAAM,uBAAuB,GAC3B,IAAI,CAAC,WAAW,EAAE,oBAAoB,KAAK,IAAI,CAAC;gBAElD,IAAI,CAAC,kBAAkB,IAAI,CAAC,uBAAuB,EAAE,CAAC;oBACpD,MAAM,eAAe,GAAG,mBAAmB,CACzC,YAAY,EACZ,6BAA6B,CAC9B,CAAC;oBACF,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;gBACrC,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,qDAAqD;aAC/D,CAAC,CAAC;QACL,CAAC;QAED,0DAA0D;QAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;QAExC,OAAO,gBAAgB,CAAC,SAAS,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,KAAK;YACL,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,gDAAgD;YAC7E,OAAO,EAAE,UAAU,CAAC,GAAG,CACrB,CAAC,CAAC,EAAE,EAAE,CACJ,mBAAmB,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,qDAAqD,CACrH;YACD,WAAW,EAAE;gBACX,iFAAiF;gBACjF,uEAAuE;gBACvE,iFAAiF;aAClF;YACD,aAAa,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/rules/utils/keywords.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Keyword utilities for rule analysis
+ *
+ * Shared keyword lists and matching utilities used by
+ * best-practices and security rules.
+ */
+/**
+ * Keywords that suggest destructive operations
+ * Used by BP-002 to check if destructiveHint should be set
+ */
+export declare const DESTRUCTIVE_KEYWORDS: string[];
+/**
+ * Critical destructive keywords that MUST have destructiveHint or requiresConfirmation
+ * Used by SEC-001 for security enforcement
+ */
+export declare const CRITICAL_DESTRUCTIVE_KEYWORDS: string[];
+/**
+ * Keywords that suggest read-only operations
+ * Used by BP-003 to check if readOnlyHint should be set
+ */
+export declare const READONLY_KEYWORDS: string[];
+/**
+ * Check if text contains any of the given keywords
+ * @param text - Text to search in (name or description)
+ * @param keywords - List of keywords to search for
+ * @returns true if any keyword is found
+ */
+export declare function hasKeyword(text: string, keywords: string[]): boolean;
+/**
+ * Find all matching keywords in the text
+ * @param text - Text to search in (name or description)
+ * @param keywords - List of keywords to search for
+ * @returns Array of matched keywords
+ */
+export declare function findMatchedKeywords(text: string, keywords: string[]): string[];

package/dist/rules/utils/keywords.js

@@ -0,0 +1,100 @@
+/**
+ * Keyword utilities for rule analysis
+ *
+ * Shared keyword lists and matching utilities used by
+ * best-practices and security rules.
+ */
+/**
+ * Keywords that suggest destructive operations
+ * Used by BP-002 to check if destructiveHint should be set
+ */
+export const DESTRUCTIVE_KEYWORDS = [
+    'delete',
+    'remove',
+    'destroy',
+    'drop',
+    'truncate',
+    'purchase',
+    'buy',
+    'order',
+    'checkout',
+    'pay',
+    'cancel',
+    'terminate',
+    'revoke',
+    'disable',
+    'wipe',
+    'clear',
+    'reset',
+    'unsubscribe',
+];
+/**
+ * Critical destructive keywords that MUST have destructiveHint or requiresConfirmation
+ * Used by SEC-001 for security enforcement
+ */
+export const CRITICAL_DESTRUCTIVE_KEYWORDS = [
+    'delete',
+    'remove',
+    'destroy',
+    'drop',
+    'wipe',
+    'purchase',
+    'buy',
+    'checkout',
+    'pay',
+    'transfer',
+    'cancel',
+    'terminate',
+    'revoke',
+    'ban',
+    'deactivate',
+];
+/**
+ * Keywords that suggest read-only operations
+ * Used by BP-003 to check if readOnlyHint should be set
+ */
+export const READONLY_KEYWORDS = [
+    'get',
+    'fetch',
+    'read',
+    'retrieve',
+    'load',
+    'search',
+    'find',
+    'lookup',
+    'query',
+    'browse',
+    'list',
+    'show',
+    'display',
+    'view',
+    'check',
+];
+/**
+ * Check if text contains any of the given keywords
+ * @param text - Text to search in (name or description)
+ * @param keywords - List of keywords to search for
+ * @returns true if any keyword is found
+ */
+export function hasKeyword(text, keywords) {
+    const lowerText = text.toLowerCase();
+    return keywords.some((keyword) => {
+        // Match as whole word or at word boundaries
+        const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+        return regex.test(lowerText);
+    });
+}
+/**
+ * Find all matching keywords in the text
+ * @param text - Text to search in (name or description)
+ * @param keywords - List of keywords to search for
+ * @returns Array of matched keywords
+ */
+export function findMatchedKeywords(text, keywords) {
+    const lowerText = text.toLowerCase();
+    return keywords.filter((keyword) => {
+        const regex = new RegExp(`\\b${keyword}\\b`, 'i');
+        return regex.test(lowerText);
+    });
+}
+//# sourceMappingURL=keywords.js.map

package/dist/rules/utils/keywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.js","sourceRoot":"","sources":["../../../src/rules/utils/keywords.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,UAAU;IACV,UAAU;IACV,KAAK;IACL,OAAO;IACP,UAAU;IACV,KAAK;IACL,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,aAAa;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,UAAU;IACV,KAAK;IACL,UAAU;IACV,KAAK;IACL,UAAU;IACV,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,KAAK;IACL,YAAY;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK;IACL,OAAO;IACP,MAAM;IACN,UAAU;IACV,MAAM;IACN,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;CACR,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAkB;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/B,4CAA4C;QAC5C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,QAAkB;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/scoring/calculator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Score Calculator
+ *
+ * Aggregates rule results into a final score and grade.
+ */
+import type { RuleResult, RuleCategory, Finding } from '../core/types/rule.js';
+import type { ScoreSummary, Grade, Recommendation } from '../core/types/audit.js';
+/**
+ * Calculate the overall score from rule results
+ */
+export declare function calculateScore(ruleResults: Map<string, RuleResult>, ruleCategories: Map<string, RuleCategory>): ScoreSummary;
+/**
+ * Calculate the letter grade from a numeric score
+ */
+export declare function calculateGrade(score: number): Grade;
+/**
+ * Extract findings (issues) from rule results
+ */
+export declare function extractFindings(ruleResults: Map<string, RuleResult>, ruleSeverities: Map<string, 'critical' | 'warning' | 'info'>): Finding[];
+/**
+ * Generate recommendations from findings
+ */
+export declare function generateRecommendations(findings: Finding[]): Recommendation[];
+/**
+ * Calculate score impact of fixing a specific rule
+ */
+export declare function estimateScoreImpact(currentScore: number, ruleResult: RuleResult, categoryWeight: number): number;

package/dist/scoring/calculator.js

@@ -0,0 +1,194 @@
+/**
+ * Score Calculator
+ *
+ * Aggregates rule results into a final score and grade.
+ */
+import { CATEGORY_WEIGHTS, CATEGORY_NAMES } from '../core/types/rule.js';
+import { GRADE_THRESHOLDS } from '../core/constants.js';
+/**
+ * Calculate the overall score from rule results
+ */
+export function calculateScore(ruleResults, ruleCategories) {
+    // Group results by category
+    const categoryResults = {
+        implementation: [],
+        description: [],
+        schema: [],
+        security: [],
+        'best-practices': [],
+        coverage: [],
+    };
+    for (const [ruleId, result] of ruleResults) {
+        const category = ruleCategories.get(ruleId);
+        if (category) {
+            categoryResults[category].push(result);
+        }
+    }
+    // Calculate scores per category
+    const categories = [];
+    let totalWeightedScore = 0;
+    let totalWeight = 0;
+    for (const [categoryId, results] of Object.entries(categoryResults)) {
+        if (results.length === 0)
+            continue;
+        const earnedScore = results.reduce((sum, r) => sum + r.score, 0);
+        const maxScore = results.reduce((sum, r) => sum + r.maxScore, 0);
+        const percentage = maxScore > 0 ? (earnedScore / maxScore) * 100 : 100;
+        categories.push({
+            name: CATEGORY_NAMES[categoryId],
+            id: categoryId,
+            score: earnedScore,
+            maxScore,
+            percentage: Math.round(percentage),
+        });
+        const weight = CATEGORY_WEIGHTS[categoryId];
+        totalWeightedScore += percentage * weight;
+        totalWeight += weight;
+    }
+    // Calculate final score (0-100)
+    const total = totalWeight > 0 ? Math.round(totalWeightedScore / totalWeight) : 0;
+    // Determine grade
+    const grade = calculateGrade(total);
+    // Count issues by severity
+    const issueCount = {
+        critical: 0,
+        warning: 0,
+        info: 0,
+    };
+    for (const result of ruleResults.values()) {
+        if (!result.passed) {
+            // Infer severity from score impact
+            if (result.maxScore - result.score >= 10) {
+                issueCount.critical++;
+            }
+            else if (result.maxScore - result.score >= 3) {
+                issueCount.warning++;
+            }
+            else {
+                issueCount.info++;
+            }
+        }
+    }
+    return {
+        total,
+        grade,
+        categories,
+        issueCount,
+    };
+}
+/**
+ * Calculate the letter grade from a numeric score
+ */
+export function calculateGrade(score) {
+    if (score >= GRADE_THRESHOLDS['A+'])
+        return 'A+';
+    if (score >= GRADE_THRESHOLDS['A'])
+        return 'A';
+    if (score >= GRADE_THRESHOLDS['B+'])
+        return 'B+';
+    if (score >= GRADE_THRESHOLDS['B'])
+        return 'B';
+    if (score >= GRADE_THRESHOLDS['C+'])
+        return 'C+';
+    if (score >= GRADE_THRESHOLDS['C'])
+        return 'C';
+    if (score >= GRADE_THRESHOLDS['D'])
+        return 'D';
+    return 'F';
+}
+/**
+ * Extract findings (issues) from rule results
+ */
+export function extractFindings(ruleResults, ruleSeverities) {
+    const findings = [];
+    for (const [ruleId, result] of ruleResults) {
+        if (result.passed)
+            continue;
+        const severity = ruleSeverities.get(ruleId) ?? 'warning';
+        const scoreImpact = result.maxScore - result.score;
+        // Create a finding for the main issue
+        findings.push({
+            ruleId,
+            severity,
+            message: result.message,
+            tool: result.affectedTools?.[0],
+            page: result.affectedPages?.[0],
+            fix: result.suggestions?.[0],
+            scoreImpact,
+        });
+        // Create additional findings for each affected tool
+        if (result.affectedTools && result.affectedTools.length > 1) {
+            for (const tool of result.affectedTools.slice(1)) {
+                findings.push({
+                    ruleId,
+                    severity,
+                    message: result.message,
+                    tool,
+                    fix: result.suggestions?.[0],
+                    scoreImpact: 0, // Only count once
+                });
+            }
+        }
+    }
+    // Sort by severity (critical first) and then by score impact
+    const severityOrder = { critical: 0, warning: 1, info: 2 };
+    findings.sort((a, b) => {
+        const severityDiff = severityOrder[a.severity] - severityOrder[b.severity];
+        if (severityDiff !== 0)
+            return severityDiff;
+        return b.scoreImpact - a.scoreImpact;
+    });
+    return findings;
+}
+/**
+ * Generate recommendations from findings
+ */
+export function generateRecommendations(findings) {
+    const recommendations = [];
+    const seenRules = new Set();
+    for (const finding of findings) {
+        if (seenRules.has(finding.ruleId))
+            continue;
+        seenRules.add(finding.ruleId);
+        if (!finding.fix)
+            continue;
+        // Estimate effort based on severity and type
+        let effort = 'medium';
+        if (finding.scoreImpact <= 3)
+            effort = 'low';
+        if (finding.scoreImpact >= 10)
+            effort = 'high';
+        if (finding.ruleId.startsWith('SEC-'))
+            effort = 'high';
+        if (finding.ruleId.startsWith('DESC-'))
+            effort = 'low';
+        // Collect affected tools
+        const affectedTools = findings
+            .filter((f) => f.ruleId === finding.ruleId && f.tool)
+            .map((f) => f.tool);
+        recommendations.push({
+            priority: recommendations.length + 1,
+            action: finding.fix,
+            scoreImpact: finding.scoreImpact,
+            effort,
+            ruleId: finding.ruleId,
+            affectedTools: affectedTools.length > 0 ? affectedTools : undefined,
+        });
+    }
+    // Sort by score impact (highest first)
+    recommendations.sort((a, b) => b.scoreImpact - a.scoreImpact);
+    // Reassign priorities after sorting
+    recommendations.forEach((rec, i) => {
+        rec.priority = i + 1;
+    });
+    return recommendations.slice(0, 10); // Return top 10
+}
+/**
+ * Calculate score impact of fixing a specific rule
+ */
+export function estimateScoreImpact(currentScore, ruleResult, categoryWeight) {
+    const improvement = ruleResult.maxScore - ruleResult.score;
+    const percentageImprovement = improvement; // Assuming max score per rule is normalized
+    return Math.round((percentageImprovement * categoryWeight) / 100);
+}
+//# sourceMappingURL=calculator.js.map

package/dist/scoring/calculator.js.map

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

package/dist/scoring/grades.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Grade Definitions and Display
+ */
+import type { Grade } from '../core/types/audit.js';
+/**
+ * Grade metadata
+ */
+export interface GradeInfo {
+    letter: Grade;
+    label: string;
+    description: string;
+    minScore: number;
+    color: string;
+}
+/**
+ * Grade definitions
+ */
+export declare const GRADES: Record<Grade, GradeInfo>;
+/**
+ * Get grade info for a score
+ */
+export declare function getGradeInfo(score: number): GradeInfo;
+/**
+ * Get the next grade up from the current score
+ */
+export declare function getNextGrade(score: number): GradeInfo | null;
+/**
+ * Calculate points needed to reach the next grade
+ */
+export declare function pointsToNextGrade(score: number): number;
+/**
+ * ASCII art for each grade letter
+ */
+export declare const GRADE_ASCII: Record<Grade, string>;

package/dist/scoring/grades.js

@@ -0,0 +1,167 @@
+/**
+ * Grade Definitions and Display
+ */
+/**
+ * Grade definitions
+ */
+export const GRADES = {
+    'A+': {
+        letter: 'A+',
+        label: 'Excellent',
+        description: 'Exceptional WebMCP implementation with best-in-class practices',
+        minScore: 95,
+        color: 'green',
+    },
+    'A': {
+        letter: 'A',
+        label: 'Great',
+        description: 'Strong WebMCP implementation with minor improvements possible',
+        minScore: 85,
+        color: 'green',
+    },
+    'B+': {
+        letter: 'B+',
+        label: 'Good',
+        description: 'Good implementation with some areas for improvement',
+        minScore: 80,
+        color: 'yellow',
+    },
+    'B': {
+        letter: 'B',
+        label: 'Above Average',
+        description: 'Functional implementation with notable gaps',
+        minScore: 70,
+        color: 'yellow',
+    },
+    'C+': {
+        letter: 'C+',
+        label: 'Average',
+        description: 'Basic implementation with significant room for improvement',
+        minScore: 65,
+        color: '#FF8C00',
+    },
+    'C': {
+        letter: 'C',
+        label: 'Below Average',
+        description: 'Minimal implementation with many issues',
+        minScore: 55,
+        color: '#FF8C00',
+    },
+    'D': {
+        letter: 'D',
+        label: 'Poor',
+        description: 'Inadequate implementation requiring significant work',
+        minScore: 40,
+        color: 'red',
+    },
+    'F': {
+        letter: 'F',
+        label: 'Failing',
+        description: 'Little to no WebMCP support detected',
+        minScore: 0,
+        color: 'red',
+    },
+};
+/**
+ * Get grade info for a score
+ */
+export function getGradeInfo(score) {
+    if (score >= 95)
+        return GRADES['A+'];
+    if (score >= 85)
+        return GRADES['A'];
+    if (score >= 80)
+        return GRADES['B+'];
+    if (score >= 70)
+        return GRADES['B'];
+    if (score >= 65)
+        return GRADES['C+'];
+    if (score >= 55)
+        return GRADES['C'];
+    if (score >= 40)
+        return GRADES['D'];
+    return GRADES['F'];
+}
+/**
+ * Get the next grade up from the current score
+ */
+export function getNextGrade(score) {
+    const grades = Object.values(GRADES).sort((a, b) => b.minScore - a.minScore);
+    for (const grade of grades) {
+        if (score < grade.minScore) {
+            return grade;
+        }
+    }
+    return null; // Already at A+
+}
+/**
+ * Calculate points needed to reach the next grade
+ */
+export function pointsToNextGrade(score) {
+    const next = getNextGrade(score);
+    if (!next)
+        return 0;
+    return next.minScore - score;
+}
+/**
+ * ASCII art for each grade letter
+ */
+export const GRADE_ASCII = {
+    'A+': `
+    █████╗    ╋
+   ██╔══██╗  ╋╋
+   ███████║   ╋
+   ██╔══██║
+   ██║  ██║  ╋
+   ╚═╝  ╚═╝     `,
+    'A': `
+    █████╗
+   ██╔══██╗
+   ███████║
+   ██╔══██║
+   ██║  ██║
+   ╚═╝  ╚═╝  `,
+    'B+': `
+   ██████╗   ╋
+   ██╔══██╗ ╋╋
+   ██████╔╝  ╋
+   ██╔══██╗
+   ██████╔╝ ╋
+   ╚═════╝      `,
+    'B': `
+   ██████╗
+   ██╔══██╗
+   ██████╔╝
+   ██╔══██╗
+   ██████╔╝
+   ╚═════╝   `,
+    'C+': `
+    ██████╗  ╋
+   ██╔════╝ ╋╋
+   ██║       ╋
+   ██║
+   ╚██████╗ ╋
+    ╚═════╝     `,
+    'C': `
+    ██████╗
+   ██╔════╝
+   ██║
+   ██║
+   ╚██████╗
+    ╚═════╝  `,
+    'D': `
+   ██████╗
+   ██╔══██╗
+   ██║  ██║
+   ██║  ██║
+   ██████╔╝
+   ╚═════╝  `,
+    'F': `
+   ███████╗
+   ██╔════╝
+   █████╗
+   ██╔══╝
+   ██║
+   ╚═╝     `,
+};
+//# sourceMappingURL=grades.js.map

package/dist/scoring/grades.js.map

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

package/dist/scoring/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Scoring Module
+ */
+export * from './calculator.js';
+export * from './grades.js';