@aquex/cmos-mcp 1.0.0

package/dist/quality/analyzers/completeness-analyzer.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * Completeness Dimension Analyzer
+ * Implements: Structural, Informational (Breadth & Density), and Semantic Coverage
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompletenessAnalyzer = void 0;
+const types_1 = require("../types");
+class CompletenessAnalyzer {
+    constructor(customWeights) {
+        // Required fields based on mission schema
+        this.REQUIRED_FIELDS = ['objective', 'context', 'successCriteria', 'deliverables'];
+        this.RECOMMENDED_FIELDS = ['missionId', 'domainFields'];
+        this.weights = { ...types_1.DEFAULT_COMPLETENESS_WEIGHTS, ...customWeights };
+    }
+    async analyze(mission) {
+        const metrics = {
+            structuralCompleteness: this.calculateStructuralCompleteness(mission),
+            informationBreadth: this.calculateInformationBreadth(mission),
+            informationDensity: this.calculateInformationDensity(mission),
+            semanticCoverage: await this.calculateSemanticCoverage(mission),
+        };
+        const metricResults = [
+            {
+                name: 'Structural Completeness',
+                rawValue: metrics.structuralCompleteness,
+                normalizedScore: metrics.structuralCompleteness,
+                weight: this.weights.structuralCompleteness,
+                details: this.getStructuralDetails(mission),
+            },
+            {
+                name: 'Information Breadth',
+                rawValue: metrics.informationBreadth,
+                normalizedScore: metrics.informationBreadth,
+                weight: this.weights.informationBreadth,
+                details: this.getBreadthDetails(mission),
+            },
+            {
+                name: 'Information Density',
+                rawValue: metrics.informationDensity,
+                normalizedScore: metrics.informationDensity,
+                weight: this.weights.informationDensity,
+                details: this.getDensityDetails(mission),
+            },
+            {
+                name: 'Semantic Coverage',
+                rawValue: metrics.semanticCoverage,
+                normalizedScore: metrics.semanticCoverage,
+                weight: this.weights.semanticCoverage,
+                details: { note: 'Simplified heuristic-based scoring' },
+            },
+        ];
+        const score = metricResults.reduce((sum, metric) => sum + metric.normalizedScore * metric.weight, 0);
+        return {
+            score,
+            weight: 0.35,
+            metrics: metricResults,
+        };
+    }
+    /**
+     * Calculate structural completeness (schema adherence)
+     * Percentage of required fields that are present and non-empty
+     */
+    calculateStructuralCompleteness(mission) {
+        let presentCount = 0;
+        const totalRequired = this.REQUIRED_FIELDS.length;
+        for (const field of this.REQUIRED_FIELDS) {
+            const value = mission[field];
+            if (value !== undefined && value !== null) {
+                // Check for non-empty content
+                if (typeof value === 'string' && value.trim().length > 0) {
+                    presentCount++;
+                }
+                else if (Array.isArray(value) && value.length > 0) {
+                    presentCount++;
+                }
+                else if (typeof value === 'object') {
+                    presentCount++;
+                }
+            }
+        }
+        return presentCount / totalRequired;
+    }
+    /**
+     * Calculate information breadth
+     * Checks for presence of diverse information types
+     */
+    calculateInformationBreadth(mission) {
+        const checks = [
+            // Core mission elements
+            { name: 'Has objective', test: () => this.hasNonEmpty(mission.objective) },
+            { name: 'Has context', test: () => this.hasNonEmpty(mission.context) },
+            { name: 'Has success criteria', test: () => this.hasArrayOrString(mission.successCriteria) },
+            { name: 'Has deliverables', test: () => this.hasArrayOrString(mission.deliverables) },
+            // Domain-specific elements
+            { name: 'Has domain type', test: () => mission.domainFields?.type !== undefined },
+            { name: 'Has mission ID', test: () => this.hasNonEmpty(mission.missionId) },
+            // Rich content indicators
+            {
+                name: 'Multiple success criteria',
+                test: () => this.getArrayLength(mission.successCriteria) >= 3,
+            },
+            { name: 'Multiple deliverables', test: () => this.getArrayLength(mission.deliverables) >= 2 },
+            // Domain-specific breadth (varies by type)
+            { name: 'Has domain fields', test: () => this.hasDomainFields(mission) },
+            { name: 'Has research content', test: () => this.hasResearchContent(mission) },
+        ];
+        const passedCount = checks.filter((check) => check.test()).length;
+        return passedCount / checks.length;
+    }
+    /**
+     * Calculate information density
+     * Ensures key fields contain sufficient detail
+     */
+    calculateInformationDensity(mission) {
+        const densityChecks = [
+            // Objective should be substantive (>10 words)
+            {
+                name: 'Objective density',
+                test: () => this.wordCount(mission.objective) >= 10,
+                weight: 0.3,
+            },
+            // Context should be detailed (>25 words)
+            {
+                name: 'Context density',
+                test: () => this.wordCount(mission.context) >= 25,
+                weight: 0.3,
+            },
+            // Success criteria should have multiple items with detail
+            {
+                name: 'Success criteria density',
+                test: () => {
+                    const count = this.getArrayLength(mission.successCriteria);
+                    const totalWords = this.wordCount(Array.isArray(mission.successCriteria)
+                        ? mission.successCriteria.join(' ')
+                        : mission.successCriteria);
+                    return count >= 3 && totalWords >= 30;
+                },
+                weight: 0.2,
+            },
+            // Deliverables should be specific
+            {
+                name: 'Deliverables density',
+                test: () => {
+                    const count = this.getArrayLength(mission.deliverables);
+                    return count >= 2;
+                },
+                weight: 0.2,
+            },
+        ];
+        let score = 0;
+        for (const check of densityChecks) {
+            if (check.test()) {
+                score += check.weight;
+            }
+        }
+        return score;
+    }
+    /**
+     * Calculate semantic coverage
+     * Simplified heuristic: checks for topic alignment with mission type
+     */
+    async calculateSemanticCoverage(mission) {
+        // In full implementation, this would use topic modeling or embeddings
+        // For now, using heuristic-based scoring
+        const missionTypeValue = mission.domainFields?.type;
+        const missionType = typeof missionTypeValue === 'string' ? missionTypeValue : '';
+        const fullText = this.extractFullText(mission);
+        const words = fullText.toLowerCase();
+        // Define expected topic keywords for different mission types
+        const topicKeywords = this.getExpectedTopics(missionType);
+        if (topicKeywords.length === 0) {
+            // Unknown type, give benefit of doubt
+            return 0.7;
+        }
+        // Check how many expected topics are covered
+        const coveredTopics = topicKeywords.filter((keyword) => words.includes(keyword.toLowerCase()));
+        const coverage = coveredTopics.length / topicKeywords.length;
+        // Also check for depth: are topics mentioned multiple times?
+        const depth = this.calculateTopicDepth(words, coveredTopics);
+        // Combine coverage and depth
+        return coverage * 0.7 + depth * 0.3;
+    }
+    // Helper methods
+    hasNonEmpty(value) {
+        if (value === undefined || value === null)
+            return false;
+        if (typeof value === 'string')
+            return value.trim().length > 0;
+        return true;
+    }
+    hasArrayOrString(value) {
+        if (Array.isArray(value))
+            return value.length > 0;
+        if (typeof value === 'string')
+            return value.trim().length > 0;
+        return false;
+    }
+    getArrayLength(value) {
+        if (Array.isArray(value))
+            return value.length;
+        if (typeof value === 'string' && value.trim().length > 0)
+            return 1;
+        return 0;
+    }
+    wordCount(value) {
+        if (!value)
+            return 0;
+        const text = typeof value === 'string' ? value : JSON.stringify(value);
+        return text.split(/\s+/).filter((w) => w.length > 0).length;
+    }
+    hasDomainFields(mission) {
+        return mission.domainFields !== undefined && Object.keys(mission.domainFields).length > 1; // More than just 'type'
+    }
+    hasResearchContent(mission) {
+        const df = mission.domainFields;
+        if (!df)
+            return false;
+        return !!(df.researchQuestions ||
+            df.keyFindings ||
+            df.evidenceCollection ||
+            df.buildImplications);
+    }
+    extractFullText(mission) {
+        const parts = [];
+        if (mission.objective)
+            parts.push(mission.objective);
+        if (mission.context)
+            parts.push(mission.context);
+        if (mission.successCriteria) {
+            parts.push(Array.isArray(mission.successCriteria)
+                ? mission.successCriteria.join(' ')
+                : mission.successCriteria);
+        }
+        if (mission.deliverables) {
+            parts.push(Array.isArray(mission.deliverables) ? mission.deliverables.join(' ') : mission.deliverables);
+        }
+        if (mission.domainFields) {
+            parts.push(JSON.stringify(mission.domainFields));
+        }
+        return parts.join(' ');
+    }
+    getExpectedTopics(missionType) {
+        const typeMap = {
+            'Build.TechnicalResearch.v1': [
+                'research',
+                'analysis',
+                'findings',
+                'evidence',
+                'standards',
+                'metrics',
+                'framework',
+                'methodology',
+                'evaluation',
+            ],
+            'Build.Implementation.v1': [
+                'implement',
+                'build',
+                'develop',
+                'code',
+                'test',
+                'integration',
+                'functionality',
+                'performance',
+                'deliverable',
+            ],
+            'Build.Documentation.v1': [
+                'document',
+                'specification',
+                'guide',
+                'instructions',
+                'overview',
+                'reference',
+                'examples',
+                'usage',
+            ],
+        };
+        return typeMap[missionType] || [];
+    }
+    calculateTopicDepth(text, topics) {
+        if (topics.length === 0)
+            return 0;
+        let totalMentions = 0;
+        for (const topic of topics) {
+            const regex = new RegExp(topic, 'gi');
+            const matches = text.match(regex);
+            totalMentions += matches ? matches.length : 0;
+        }
+        // Normalize: depth score based on average mentions per topic
+        const avgMentions = totalMentions / topics.length;
+        // Scale: 1 mention = 0.3, 2 = 0.6, 3+ = 1.0
+        if (avgMentions >= 3)
+            return 1.0;
+        if (avgMentions >= 2)
+            return 0.6;
+        if (avgMentions >= 1)
+            return 0.3;
+        return 0;
+    }
+    getStructuralDetails(mission) {
+        const missing = [];
+        const present = [];
+        for (const field of this.REQUIRED_FIELDS) {
+            if (!this.hasNonEmpty(mission[field])) {
+                missing.push(field);
+            }
+            else {
+                present.push(field);
+            }
+        }
+        return { present, missing, total: this.REQUIRED_FIELDS.length };
+    }
+    getBreadthDetails(mission) {
+        return {
+            hasSuccessCriteria: this.getArrayLength(mission.successCriteria),
+            hasDeliverables: this.getArrayLength(mission.deliverables),
+            hasDomainFields: this.hasDomainFields(mission),
+            hasResearchContent: this.hasResearchContent(mission),
+        };
+    }
+    getDensityDetails(mission) {
+        return {
+            objectiveWords: this.wordCount(mission.objective),
+            contextWords: this.wordCount(mission.context),
+            successCriteriaCount: this.getArrayLength(mission.successCriteria),
+            deliverablesCount: this.getArrayLength(mission.deliverables),
+        };
+    }
+}
+exports.CompletenessAnalyzer = CompletenessAnalyzer;
+//# sourceMappingURL=completeness-analyzer.js.map

package/dist/quality/analyzers/completeness-analyzer.js.map

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

package/dist/quality/improvement-engine.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Actionable Improvement Engine
+ * Maps metric scores to specific, context-aware recommendations
+ */
+import { ImprovementSuggestion, DimensionScore, MissionContent } from './types';
+interface FeedbackRule {
+    condition: (metricValue: number, details?: Record<string, unknown>) => boolean;
+    severity: 'critical' | 'important' | 'info';
+    category: string;
+    messageTemplate: (metricValue: number, details?: Record<string, unknown>, context?: MissionContent) => string;
+}
+export declare class ImprovementEngine {
+    private rules;
+    constructor();
+    /**
+     * Generate improvement suggestions based on dimensional scores
+     */
+    generateSuggestions(clarityScore: DimensionScore, completenessScore: DimensionScore, aiReadinessScore: DimensionScore, mission: MissionContent): ImprovementSuggestion[];
+    /**
+     * Evaluate a single metric against its rules
+     */
+    private evaluateMetric;
+    /**
+     * Initialize all feedback rules
+     */
+    private initializeRules;
+    /**
+     * Add a feedback rule for a specific metric
+     */
+    private addRule;
+    /**
+     * Get all rules for a metric (for testing/debugging)
+     */
+    getRulesForMetric(metricName: string): FeedbackRule[];
+}
+export {};
+//# sourceMappingURL=improvement-engine.d.ts.map

package/dist/quality/improvement-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvement-engine.d.ts","sourceRoot":"","sources":["../../src/quality/improvement-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAE9F,UAAU,YAAY;IACpB,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAC/E,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,cAAc,KACrB,MAAM,CAAC;CACb;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA8B;;IAO3C;;OAEG;IACH,mBAAmB,CACjB,YAAY,EAAE,cAAc,EAC5B,iBAAiB,EAAE,cAAc,EACjC,gBAAgB,EAAE,cAAc,EAChC,OAAO,EAAE,cAAc,GACtB,qBAAqB,EAAE;IAyB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4OvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;CAGtD"}

package/dist/quality/improvement-engine.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Actionable Improvement Engine
+ * Maps metric scores to specific, context-aware recommendations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImprovementEngine = void 0;
+class ImprovementEngine {
+    constructor() {
+        this.rules = new Map();
+        this.initializeRules();
+    }
+    /**
+     * Generate improvement suggestions based on dimensional scores
+     */
+    generateSuggestions(clarityScore, completenessScore, aiReadinessScore, mission) {
+        const suggestions = [];
+        // Process clarity metrics
+        for (const metric of clarityScore.metrics) {
+            suggestions.push(...this.evaluateMetric(metric.name, metric, mission));
+        }
+        // Process completeness metrics
+        for (const metric of completenessScore.metrics) {
+            suggestions.push(...this.evaluateMetric(metric.name, metric, mission));
+        }
+        // Process AI-readiness metrics
+        for (const metric of aiReadinessScore.metrics) {
+            suggestions.push(...this.evaluateMetric(metric.name, metric, mission));
+        }
+        // Sort by severity (critical first, then important, then info)
+        const severityOrder = { critical: 0, important: 1, info: 2 };
+        suggestions.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+        return suggestions;
+    }
+    /**
+     * Evaluate a single metric against its rules
+     */
+    evaluateMetric(metricName, metric, mission) {
+        const suggestions = [];
+        const rules = this.rules.get(metricName) || [];
+        for (const rule of rules) {
+            if (rule.condition(metric.rawValue, metric.details)) {
+                suggestions.push({
+                    severity: rule.severity,
+                    category: rule.category,
+                    message: rule.messageTemplate(metric.rawValue, metric.details, mission),
+                    metric: metricName,
+                    context: metric.details,
+                });
+            }
+        }
+        return suggestions;
+    }
+    /**
+     * Initialize all feedback rules
+     */
+    initializeRules() {
+        const getNumberDetail = (detail, key) => {
+            const value = detail?.[key];
+            return typeof value === 'number' ? value : undefined;
+        };
+        const getStringDetail = (detail, key) => {
+            const value = detail?.[key];
+            return typeof value === 'string' ? value : undefined;
+        };
+        const getBooleanDetail = (detail, key) => {
+            const value = detail?.[key];
+            return typeof value === 'boolean' ? value : undefined;
+        };
+        const getStringArrayDetail = (detail, key) => {
+            const value = detail?.[key];
+            if (!Array.isArray(value)) {
+                return [];
+            }
+            return value.filter((item) => typeof item === 'string');
+        };
+        // Syntactic Validity (Critical)
+        this.addRule('Syntactic Validity', {
+            condition: (value) => value === 0,
+            severity: 'critical',
+            category: 'Structure',
+            messageTemplate: () => 'The mission structure is invalid. Ensure all required fields are present and properly formatted.',
+        });
+        // Structural Completeness
+        this.addRule('Structural Completeness', {
+            condition: (value) => value < 1,
+            severity: 'critical',
+            category: 'Completeness',
+            messageTemplate: (value, details) => {
+                const missing = getStringArrayDetail(details, 'missing');
+                return `Mission is missing required fields: ${missing.join(', ')}. All required fields must be present.`;
+            },
+        });
+        // Mission Cyclomatic Complexity
+        this.addRule('Mission Cyclomatic Complexity', {
+            condition: (value) => value > 20,
+            severity: 'important',
+            category: 'Clarity',
+            messageTemplate: (value, details) => {
+                const riskLevel = getStringDetail(details, 'riskLevel') ?? 'unknown';
+                const decisionPoints = getNumberDetail(details, 'decisionPoints');
+                const decisionPointsText = decisionPoints !== undefined ? decisionPoints : 'unknown';
+                return (`This mission's logical complexity is very high (MCC: ${value}, Risk: ${riskLevel}). ` +
+                    `Consider refactoring into multiple, smaller missions to reduce the number of decision points (${decisionPointsText}).`);
+            },
+        });
+        this.addRule('Mission Cyclomatic Complexity', {
+            condition: (value) => value > 10 && value <= 20,
+            severity: 'info',
+            category: 'Clarity',
+            messageTemplate: (value, _details) => `Mission complexity is moderate (MCC: ${value}). Consider simplifying conditional logic if possible.`,
+        });
+        // Flesch-Kincaid Grade Level
+        this.addRule('Flesch-Kincaid Grade Level', {
+            condition: (value) => value > 15,
+            severity: 'info',
+            category: 'Clarity',
+            messageTemplate: (value, _details) => `Text readability is low (Grade Level: ${value.toFixed(1)}). Consider simplifying sentence structure and word choice.`,
+        });
+        this.addRule('Flesch-Kincaid Grade Level', {
+            condition: (value) => value < 10,
+            severity: 'info',
+            category: 'Clarity',
+            messageTemplate: (value) => `Text may be overly simplified for technical content (Grade Level: ${value.toFixed(1)}). Ensure sufficient technical detail.`,
+        });
+        // Lexical Density
+        this.addRule('Lexical Density', {
+            condition: (value) => value < 50,
+            severity: 'info',
+            category: 'Clarity',
+            messageTemplate: (value, details) => {
+                const percentage = getStringDetail(details, 'percentage') ?? 'N/A';
+                return `Information density is low (${percentage}). Consider reducing filler words and increasing content-bearing terms.`;
+            },
+        });
+        // Referential Ambiguity
+        this.addRule('Referential Ambiguity', {
+            condition: (value) => value < 0.8,
+            severity: 'important',
+            category: 'Clarity',
+            messageTemplate: (value) => `Mission contains pronouns with unclear antecedents (Score: ${(value * 100).toFixed(0)}%). ` +
+                `Replace ambiguous pronouns (it, they, this) with specific nouns for clarity.`,
+        });
+        // Lexical Ambiguity
+        this.addRule('Lexical Ambiguity', {
+            condition: (value, details) => (getNumberDetail(details, 'ambiguousWordCount') ?? 0) > 5,
+            severity: 'info',
+            category: 'Clarity',
+            messageTemplate: (value, details) => {
+                const ambiguousWordCount = getNumberDetail(details, 'ambiguousWordCount');
+                const countText = ambiguousWordCount !== undefined ? ambiguousWordCount : 'several';
+                return (`Mission contains ${countText} potentially ambiguous words. ` +
+                    `Review context-dependent terms for clarity.`);
+            },
+        });
+        // Information Density
+        this.addRule('Information Density', {
+            condition: (value) => value < 0.7,
+            severity: 'important',
+            category: 'Completeness',
+            messageTemplate: (value, details) => {
+                const issues = [];
+                const objectiveWords = getNumberDetail(details, 'objectiveWords');
+                const contextWords = getNumberDetail(details, 'contextWords');
+                const successCriteriaCount = getNumberDetail(details, 'successCriteriaCount');
+                if ((objectiveWords ?? 0) < 10)
+                    issues.push('objective is too brief');
+                if ((contextWords ?? 0) < 25)
+                    issues.push('context lacks detail');
+                if ((successCriteriaCount ?? 0) < 3)
+                    issues.push('insufficient success criteria');
+                return `Mission lacks sufficient detail: ${issues.join(', ')}. Add more specific information.`;
+            },
+        });
+        // Information Breadth
+        this.addRule('Information Breadth', {
+            condition: (value) => value < 0.6,
+            severity: 'important',
+            category: 'Completeness',
+            messageTemplate: (value, _details) => `Mission lacks diverse information types (Score: ${(value * 100).toFixed(0)}%). ` +
+                `Consider adding more context, examples, or domain-specific details.`,
+        });
+        // Semantic Coverage
+        this.addRule('Semantic Coverage', {
+            condition: (value) => value < 0.7,
+            severity: 'info',
+            category: 'Completeness',
+            messageTemplate: (value) => `Mission content may not fully align with its stated objective (Coverage: ${(value * 100).toFixed(0)}%). ` +
+                `Ensure all relevant topics are addressed.`,
+        });
+        // Instruction Specificity
+        this.addRule('Instruction Specificity', {
+            condition: (value, details) => !getBooleanDetail(details, 'hasExplicitGoal'),
+            severity: 'important',
+            category: 'AI-Readiness',
+            messageTemplate: () => `The objective should contain a clear, action-oriented goal starting with "To [verb]..." ` +
+                `and be at least 10 words.`,
+        });
+        this.addRule('Instruction Specificity', {
+            condition: (value, details) => !getBooleanDetail(details, 'hasFormatSpec'),
+            severity: 'info',
+            category: 'AI-Readiness',
+            messageTemplate: () => `Mission does not specify a desired output format. Consider adding phrases like ` +
+                `"Present output as JSON" or "Summarize in bullet points" for more predictable results.`,
+        });
+        this.addRule('Instruction Specificity', {
+            condition: (value, details) => !getBooleanDetail(details, 'hasConstraints'),
+            severity: 'info',
+            category: 'AI-Readiness',
+            messageTemplate: () => `Mission lacks explicit constraints. Consider adding "must/must not" statements ` +
+                `or defining what is out-of-scope.`,
+        });
+        this.addRule('Instruction Specificity', {
+            condition: (value, details) => !getBooleanDetail(details, 'hasSuccessCriteria'),
+            severity: 'important',
+            category: 'AI-Readiness',
+            messageTemplate: () => `Success criteria are not well-defined. Include at least 3 specific, measurable criteria ` +
+                `with at least 5 words each.`,
+        });
+        // Linting Score
+        this.addRule('Linting Score', {
+            condition: (value, details) => (getNumberDetail(details, 'vaguePhrasesCount') ?? 0) > 5,
+            severity: 'info',
+            category: 'AI-Readiness',
+            messageTemplate: (value, details) => {
+                const vagueCount = getNumberDetail(details, 'vaguePhrasesCount') ?? 0;
+                const phrases = getStringArrayDetail(details, 'vaguePhrasesFound');
+                const phrasesText = phrases.length > 0 ? phrases.join(', ') : 'n/a';
+                return (`Mission contains ${vagueCount} vague phrases ` +
+                    `(e.g., ${phrasesText}). Replace with specific, measurable terms.`);
+            },
+        });
+        this.addRule('Linting Score', {
+            condition: (value, details) => (getNumberDetail(details, 'emptyFieldsCount') ?? 0) > 0,
+            severity: 'info',
+            category: 'Structure',
+            messageTemplate: (value, details) => {
+                const emptyFieldsCount = getNumberDetail(details, 'emptyFieldsCount') ?? 0;
+                return `Mission has ${emptyFieldsCount} empty fields. Remove unused fields or populate with content.`;
+            },
+        });
+    }
+    /**
+     * Add a feedback rule for a specific metric
+     */
+    addRule(metricName, rule) {
+        if (!this.rules.has(metricName)) {
+            this.rules.set(metricName, []);
+        }
+        this.rules.get(metricName).push(rule);
+    }
+    /**
+     * Get all rules for a metric (for testing/debugging)
+     */
+    getRulesForMetric(metricName) {
+        return this.rules.get(metricName) || [];
+    }
+}
+exports.ImprovementEngine = ImprovementEngine;
+//# sourceMappingURL=improvement-engine.js.map