@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Clarity Dimension Analyzer
+ * Implements metrics: Flesch-Kincaid, Lexical Density, Ambiguity Detection, MCC
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClarityAnalyzer = void 0;
+const types_1 = require("../types");
+class ClarityAnalyzer {
+    constructor(customWeights) {
+        this.weights = { ...types_1.DEFAULT_CLARITY_WEIGHTS, ...customWeights };
+    }
+    async analyze(mission) {
+        const text = this.extractTextContent(mission);
+        // Calculate all clarity metrics
+        const metrics = {
+            fleschKincaidGradeLevel: this.calculateFleschKincaid(text),
+            lexicalDensity: this.calculateLexicalDensity(text),
+            lexicalAmbiguity: this.detectLexicalAmbiguity(text),
+            syntacticAmbiguity: this.detectSyntacticAmbiguity(text),
+            referentialAmbiguity: this.detectReferentialAmbiguity(text),
+            missionCyclomaticComplexity: this.calculateMCC(mission),
+        };
+        // Normalize and create metric results
+        const metricResults = [
+            {
+                name: 'Flesch-Kincaid Grade Level',
+                rawValue: metrics.fleschKincaidGradeLevel,
+                normalizedScore: this.normalizeFleschKincaid(metrics.fleschKincaidGradeLevel),
+                weight: this.weights.fleschKincaidGradeLevel,
+                details: {
+                    target: '10-12',
+                    interpretation: this.interpretFKGL(metrics.fleschKincaidGradeLevel),
+                },
+            },
+            {
+                name: 'Lexical Density',
+                rawValue: metrics.lexicalDensity,
+                normalizedScore: this.normalizeLexicalDensity(metrics.lexicalDensity),
+                weight: this.weights.lexicalDensity,
+                details: { target: '>50%', percentage: `${metrics.lexicalDensity.toFixed(1)}%` },
+            },
+            {
+                name: 'Lexical Ambiguity',
+                rawValue: metrics.lexicalAmbiguity,
+                normalizedScore: metrics.lexicalAmbiguity,
+                weight: this.weights.lexicalAmbiguity,
+                details: {
+                    ambiguousWordCount: Math.round((1 - metrics.lexicalAmbiguity) * text.split(/\s+/).length),
+                },
+            },
+            {
+                name: 'Syntactic Ambiguity',
+                rawValue: metrics.syntacticAmbiguity,
+                normalizedScore: metrics.syntacticAmbiguity,
+                weight: this.weights.syntacticAmbiguity,
+            },
+            {
+                name: 'Referential Ambiguity',
+                rawValue: metrics.referentialAmbiguity,
+                normalizedScore: metrics.referentialAmbiguity,
+                weight: this.weights.referentialAmbiguity,
+            },
+            {
+                name: 'Mission Cyclomatic Complexity',
+                rawValue: metrics.missionCyclomaticComplexity,
+                normalizedScore: this.normalizeMCC(metrics.missionCyclomaticComplexity),
+                weight: this.weights.missionCyclomaticComplexity,
+                details: {
+                    riskLevel: this.getMCCRiskLevel(metrics.missionCyclomaticComplexity),
+                    decisionPoints: metrics.missionCyclomaticComplexity - 1,
+                },
+            },
+        ];
+        // Calculate weighted dimension score
+        const score = metricResults.reduce((sum, metric) => sum + metric.normalizedScore * metric.weight, 0);
+        return {
+            score,
+            weight: 0.35, // Default clarity dimension weight
+            metrics: metricResults,
+        };
+    }
+    /**
+     * Calculate Flesch-Kincaid Grade Level
+     * FKGL = 0.39 * (total words / total sentences) + 11.8 * (total syllables / total words) - 15.59
+     */
+    calculateFleschKincaid(text) {
+        const sentences = this.countSentences(text);
+        const words = this.countWords(text);
+        const syllables = this.countSyllables(text);
+        if (words === 0 || sentences === 0)
+            return 0;
+        const avgWordsPerSentence = words / sentences;
+        const avgSyllablesPerWord = syllables / words;
+        return 0.39 * avgWordsPerSentence + 11.8 * avgSyllablesPerWord - 15.59;
+    }
+    /**
+     * Calculate Lexical Density
+     * LD = (Number of lexical items / Total words) * 100
+     */
+    calculateLexicalDensity(text) {
+        const words = text
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((w) => w.length > 0);
+        if (words.length === 0)
+            return 0;
+        // Function words (articles, prepositions, pronouns, conjunctions)
+        const functionWords = new Set([
+            'the',
+            'a',
+            'an',
+            'and',
+            'or',
+            'but',
+            'in',
+            'on',
+            'at',
+            'to',
+            'for',
+            'of',
+            'with',
+            'from',
+            'by',
+            'as',
+            'is',
+            'was',
+            'are',
+            'were',
+            'be',
+            'been',
+            'being',
+            'have',
+            'has',
+            'had',
+            'do',
+            'does',
+            'did',
+            'will',
+            'would',
+            'should',
+            'could',
+            'may',
+            'might',
+            'can',
+            'must',
+            'shall',
+            'this',
+            'that',
+            'these',
+            'those',
+            'i',
+            'you',
+            'he',
+            'she',
+            'it',
+            'we',
+            'they',
+            'them',
+            'their',
+            'my',
+            'your',
+            'his',
+            'her',
+            'its',
+            'our',
+            'who',
+            'what',
+            'where',
+            'when',
+            'why',
+            'how',
+            'if',
+            'than',
+        ]);
+        const lexicalItems = words.filter((word) => !functionWords.has(word.toLowerCase()));
+        return (lexicalItems.length / words.length) * 100;
+    }
+    /**
+     * Detect lexical ambiguity (words with multiple meanings)
+     * Simplified heuristic-based approach
+     */
+    detectLexicalAmbiguity(text) {
+        const words = text
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((w) => w.length > 0);
+        if (words.length === 0)
+            return 1;
+        // Common ambiguous words in technical contexts
+        const ambiguousWords = new Set([
+            'bank',
+            'record',
+            'table',
+            'field',
+            'file',
+            'run',
+            'execute',
+            'process',
+            'service',
+            'object',
+            'class',
+            'type',
+            'value',
+            'set',
+            'get',
+            'check',
+            'test',
+            'case',
+            'base',
+            'model',
+            'view',
+            'state',
+        ]);
+        const ambiguousCount = words.filter((w) => ambiguousWords.has(w)).length;
+        return 1 - ambiguousCount / words.length;
+    }
+    /**
+     * Detect syntactic ambiguity
+     * Simplified heuristic: Check for potentially ambiguous sentence structures
+     */
+    detectSyntacticAmbiguity(text) {
+        const sentences = this.getSentences(text);
+        if (sentences.length === 0)
+            return 1;
+        let ambiguousCount = 0;
+        for (const sentence of sentences) {
+            // Patterns that often lead to syntactic ambiguity
+            const patterns = [
+                /\b(saw|watched|heard)\s+\w+\s+(duck|bear|fish|fly)\b/i, // "saw her duck"
+                /\b\w+\s+and\s+\w+\s+(or|and)\s+\w+\b/, // Multiple conjunctions
+                /\b(more|less)\s+\w+\s+(than|or)\b/, // Comparative ambiguity
+                /\b(without|with)\s+\w+\s+(and|or)\b/, // Prepositional phrase attachment
+            ];
+            if (patterns.some((pattern) => pattern.test(sentence))) {
+                ambiguousCount++;
+            }
+        }
+        return 1 - ambiguousCount / sentences.length;
+    }
+    /**
+     * Detect referential ambiguity (unclear pronoun references)
+     */
+    detectReferentialAmbiguity(text) {
+        const pronouns = ['it', 'they', 'them', 'this', 'that', 'these', 'those', 'which'];
+        const sentences = this.getSentences(text);
+        let unresolvedCount = 0;
+        let totalPronouns = 0;
+        for (const sentence of sentences) {
+            const words = sentence.toLowerCase().split(/\s+/);
+            for (let i = 0; i < words.length; i++) {
+                if (pronouns.includes(words[i])) {
+                    totalPronouns++;
+                    // Simple heuristic: pronoun at sentence start is more likely unresolved
+                    if (i < 2) {
+                        unresolvedCount++;
+                    }
+                    // Pronoun without clear antecedent in previous words
+                    else if (i > 0 && this.hasNoNearbyNoun(words.slice(Math.max(0, i - 5), i))) {
+                        unresolvedCount++;
+                    }
+                }
+            }
+        }
+        if (totalPronouns === 0)
+            return 1;
+        return 1 - unresolvedCount / totalPronouns;
+    }
+    /**
+     * Calculate Mission Cyclomatic Complexity
+     * MCC = Number of Decision Points + 1
+     */
+    calculateMCC(mission) {
+        const text = JSON.stringify(mission, null, 2).toLowerCase();
+        let decisionPoints = 0;
+        // Conditional keywords
+        const conditionalKeywords = [
+            /\bif\b/g,
+            /\bwhen\b/g,
+            /\bunless\b/g,
+            /\botherwise\b/g,
+            /\balternatively\b/g,
+            /\bin case of\b/g,
+            /\bdepending on\b/g,
+            /\bshould\b/g,
+            /\bmay\b/g,
+            /\bcan\b/g,
+            /\bmight\b/g,
+        ];
+        // Logical operators
+        const logicalOperators = [/\band\b/g, /\bor\b/g];
+        // Implicit loops
+        const loopPatterns = [/\bfor each\b/g, /\brepeat for\b/g, /\ball\b/g];
+        // Count decision points
+        [...conditionalKeywords, ...logicalOperators, ...loopPatterns].forEach((pattern) => {
+            const matches = text.match(pattern);
+            if (matches)
+                decisionPoints += matches.length;
+        });
+        // Check for optional fields in structure
+        if (mission.domainFields) {
+            // Optional sections add complexity
+            const optionalSections = ['assumptions', 'blockers', 'nextMission'];
+            optionalSections.forEach((section) => {
+                if (section in mission.domainFields)
+                    decisionPoints++;
+            });
+        }
+        return decisionPoints + 1;
+    }
+    // Helper methods
+    extractTextContent(mission) {
+        const textParts = [];
+        if (mission.objective)
+            textParts.push(mission.objective);
+        if (mission.context)
+            textParts.push(mission.context);
+        if (mission.successCriteria) {
+            textParts.push(Array.isArray(mission.successCriteria)
+                ? mission.successCriteria.join(' ')
+                : mission.successCriteria);
+        }
+        if (mission.deliverables) {
+            textParts.push(Array.isArray(mission.deliverables) ? mission.deliverables.join(' ') : mission.deliverables);
+        }
+        return textParts.join(' ');
+    }
+    countSentences(text) {
+        return text.split(/[.!?]+/).filter((s) => s.trim().length > 0).length;
+    }
+    countWords(text) {
+        return text.split(/\s+/).filter((w) => w.length > 0).length;
+    }
+    countSyllables(text) {
+        const words = text.toLowerCase().split(/\s+/);
+        let syllables = 0;
+        for (const word of words) {
+            syllables += this.countWordSyllables(word);
+        }
+        return syllables;
+    }
+    countWordSyllables(word) {
+        word = word.replace(/[^a-z]/gi, '');
+        if (word.length <= 3)
+            return 1;
+        const vowels = word.match(/[aeiouy]+/gi);
+        let count = vowels ? vowels.length : 1;
+        // Adjust for silent e
+        if (word.endsWith('e'))
+            count--;
+        return Math.max(1, count);
+    }
+    getSentences(text) {
+        return text.split(/[.!?]+/).filter((s) => s.trim().length > 0);
+    }
+    hasNoNearbyNoun(words) {
+        const nounsIndicators = ['the', 'a', 'an', 'this', 'that'];
+        return !words.some((w) => nounsIndicators.includes(w.toLowerCase()));
+    }
+    // Normalization functions
+    normalizeFleschKincaid(fkgl) {
+        // Target: 10-12, penalize > 15
+        if (fkgl < 10)
+            return 0.8;
+        if (fkgl <= 12)
+            return 1.0;
+        if (fkgl <= 15)
+            return 0.7;
+        return Math.max(0, 1 - (fkgl - 15) * 0.1);
+    }
+    normalizeLexicalDensity(density) {
+        // Target: > 50%
+        if (density >= 50)
+            return 1.0;
+        return density / 50;
+    }
+    normalizeMCC(mcc) {
+        // MCC 1-10: 1.0-0.5, MCC > 20: 0.0
+        if (mcc <= 10)
+            return 1.0 - (mcc - 1) * 0.05;
+        if (mcc <= 20)
+            return 0.5 - (mcc - 10) * 0.05;
+        return 0;
+    }
+    interpretFKGL(fkgl) {
+        if (fkgl < 10)
+            return 'Too simple for technical content';
+        if (fkgl <= 12)
+            return 'Optimal for technical documentation';
+        if (fkgl <= 15)
+            return 'Acceptable complexity';
+        return 'Overly complex';
+    }
+    getMCCRiskLevel(mcc) {
+        if (mcc <= 10)
+            return 'Low';
+        if (mcc <= 20)
+            return 'Moderate';
+        if (mcc <= 50)
+            return 'High';
+        return 'Very High';
+    }
+}
+exports.ClarityAnalyzer = ClarityAnalyzer;
+//# sourceMappingURL=clarity-analyzer.js.map

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

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

package/dist/quality/analyzers/completeness-analyzer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Completeness Dimension Analyzer
+ * Implements: Structural, Informational (Breadth & Density), and Semantic Coverage
+ */
+import { DimensionScore, CompletenessMetrics, MissionContent } from '../types';
+export declare class CompletenessAnalyzer {
+    private weights;
+    private readonly REQUIRED_FIELDS;
+    private readonly RECOMMENDED_FIELDS;
+    constructor(customWeights?: Partial<Record<keyof CompletenessMetrics, number>>);
+    analyze(mission: MissionContent): Promise<DimensionScore>;
+    /**
+     * Calculate structural completeness (schema adherence)
+     * Percentage of required fields that are present and non-empty
+     */
+    private calculateStructuralCompleteness;
+    /**
+     * Calculate information breadth
+     * Checks for presence of diverse information types
+     */
+    private calculateInformationBreadth;
+    /**
+     * Calculate information density
+     * Ensures key fields contain sufficient detail
+     */
+    private calculateInformationDensity;
+    /**
+     * Calculate semantic coverage
+     * Simplified heuristic: checks for topic alignment with mission type
+     */
+    private calculateSemanticCoverage;
+    private hasNonEmpty;
+    private hasArrayOrString;
+    private getArrayLength;
+    private wordCount;
+    private hasDomainFields;
+    private hasResearchContent;
+    private extractFullText;
+    private getExpectedTopics;
+    private calculateTopicDepth;
+    private getStructuralDetails;
+    private getBreadthDetails;
+    private getDensityDetails;
+}
+//# sourceMappingURL=completeness-analyzer.d.ts.map

package/dist/quality/analyzers/completeness-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completeness-analyzer.d.ts","sourceRoot":"","sources":["../../../src/quality/analyzers/completeness-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EAEd,mBAAmB,EACnB,cAAc,EAEf,MAAM,UAAU,CAAC;AAElB,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAA4C;IAG3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+D;IAC/F,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiC;gBAExD,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAIxE,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAmD/D;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAqBvC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA4BnC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAoDnC;;;OAGG;YACW,yBAAyB;IA+BvC,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;CAQ1B"}