@aquex/cmos-mcp 1.0.0

package/dist/quality/analyzers/ai-readiness-analyzer.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * AI-Readiness Dimension Analyzer
+ * Implements: Syntactic Validity, Instruction Specificity, Structural Consistency
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIReadinessAnalyzer = void 0;
+const types_1 = require("../types");
+class AIReadinessAnalyzer {
+    constructor(customWeights) {
+        // Weak phrases that indicate vagueness (from NASA requirements quality model)
+        this.WEAK_PHRASES = [
+            'adequate',
+            'as appropriate',
+            'timely',
+            'significant',
+            'possibly',
+            'etc',
+            'appropriate',
+            'reasonable',
+            'normal',
+            'typical',
+            'various',
+            'suitable',
+            'proper',
+            'effective',
+            'efficient',
+            'robust',
+            'good',
+            'bad',
+            'better',
+            'worse',
+            'fast',
+            'slow',
+            'easy',
+            'hard',
+            'simple',
+            'complex',
+            'flexible',
+            'user-friendly',
+            'as needed',
+            'if necessary',
+        ];
+        this.weights = { ...types_1.DEFAULT_AI_READINESS_WEIGHTS, ...customWeights };
+    }
+    async analyze(mission) {
+        const metrics = {
+            syntacticValidity: this.checkSyntacticValidity(mission),
+            instructionSpecificity: this.calculateInstructionSpecificity(mission),
+            lintingScore: this.calculateLintingScore(mission),
+        };
+        const metricResults = [
+            {
+                name: 'Syntactic Validity',
+                rawValue: metrics.syntacticValidity ? 1 : 0,
+                normalizedScore: metrics.syntacticValidity ? 1 : 0,
+                weight: this.weights.syntacticValidity,
+                details: {
+                    isValid: metrics.syntacticValidity,
+                    note: metrics.syntacticValidity ? 'Valid structure' : 'Invalid structure detected',
+                },
+            },
+            {
+                name: 'Instruction Specificity',
+                rawValue: metrics.instructionSpecificity,
+                normalizedScore: metrics.instructionSpecificity,
+                weight: this.weights.instructionSpecificity,
+                details: this.getSpecificityDetails(mission),
+            },
+            {
+                name: 'Linting Score',
+                rawValue: metrics.lintingScore,
+                normalizedScore: metrics.lintingScore,
+                weight: this.weights.lintingScore,
+                details: this.getLintingDetails(mission),
+            },
+        ];
+        // If syntactic validity fails, entire dimension scores 0
+        if (!metrics.syntacticValidity) {
+            return {
+                score: 0,
+                weight: 0.2,
+                metrics: metricResults,
+            };
+        }
+        const score = metricResults.reduce((sum, metric) => sum + metric.normalizedScore * metric.weight, 0);
+        return {
+            score,
+            weight: 0.2,
+            metrics: metricResults,
+        };
+    }
+    /**
+     * Check syntactic validity
+     * Hard gate: mission must be valid structure
+     */
+    checkSyntacticValidity(mission) {
+        try {
+            // Mission is already parsed, but check for basic structure
+            if (typeof mission !== 'object' || mission === null) {
+                return false;
+            }
+            // Check for basic required structure
+            const hasBasicStructure = mission.objective !== undefined ||
+                mission.context !== undefined ||
+                mission.successCriteria !== undefined;
+            return hasBasicStructure;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * Calculate instruction specificity
+     * Based on prompt engineering best practices checklist
+     */
+    calculateInstructionSpecificity(mission) {
+        const checks = [
+            // 1. Explicit Goal
+            {
+                name: 'Explicit goal',
+                test: () => this.hasExplicitGoal(mission.objective),
+                weight: 0.25,
+            },
+            // 2. Defined Scope
+            {
+                name: 'Defined scope',
+                test: () => this.hasDefinedScope(mission.context),
+                weight: 0.2,
+            },
+            // 3. Format Specification
+            {
+                name: 'Format specification',
+                test: () => this.hasFormatSpecification(mission),
+                weight: 0.2,
+            },
+            // 4. Constraint Declaration
+            {
+                name: 'Constraint declaration',
+                test: () => this.hasConstraints(mission),
+                weight: 0.15,
+            },
+            // 5. Success Criteria Definition
+            {
+                name: 'Success criteria',
+                test: () => this.hasWellDefinedSuccessCriteria(mission.successCriteria),
+                weight: 0.2,
+            },
+        ];
+        let score = 0;
+        for (const check of checks) {
+            if (check.test()) {
+                score += check.weight;
+            }
+        }
+        return score;
+    }
+    /**
+     * Calculate linting score
+     * Checks for structural consistency and best practices
+     */
+    calculateLintingScore(mission) {
+        const violations = [];
+        // Check for consistent data types
+        if (mission.successCriteria && typeof mission.successCriteria === 'string') {
+            // Prefer array over multi-line string
+            if (mission.successCriteria.includes('\n')) {
+                violations.push('successCriteria should be array, not multi-line string');
+            }
+        }
+        if (mission.deliverables && typeof mission.deliverables === 'string') {
+            if (mission.deliverables.includes('\n')) {
+                violations.push('deliverables should be array, not multi-line string');
+            }
+        }
+        // Check for vague language
+        const fullText = JSON.stringify(mission).toLowerCase();
+        const vaguePhrasesFound = [];
+        for (const phrase of this.WEAK_PHRASES) {
+            if (fullText.includes(phrase.toLowerCase())) {
+                vaguePhrasesFound.push(phrase);
+            }
+        }
+        if (vaguePhrasesFound.length > 0) {
+            violations.push(`Contains ${vaguePhrasesFound.length} vague phrases`);
+        }
+        // Check for proper field naming
+        if (mission.domainFields) {
+            const fields = Object.keys(mission.domainFields);
+            for (const field of fields) {
+                // Check for camelCase convention
+                if (!/^[a-z][a-zA-Z0-9]*$/.test(field) && field !== 'type') {
+                    violations.push(`Field '${field}' doesn't follow camelCase convention`);
+                }
+            }
+        }
+        // Check for empty fields
+        const emptyFields = this.findEmptyFields(mission);
+        if (emptyFields.length > 0) {
+            violations.push(`${emptyFields.length} empty fields found`);
+        }
+        // Calculate score: 1 - (violations / total possible lines)
+        const totalLines = JSON.stringify(mission, null, 2).split('\n').length;
+        const score = Math.max(0, 1 - violations.length / totalLines);
+        return score;
+    }
+    // Helper methods for instruction specificity
+    hasExplicitGoal(objective) {
+        if (!objective || typeof objective !== 'string')
+            return false;
+        const text = objective.toLowerCase();
+        // Should contain action verbs
+        const actionVerbs = [
+            'implement',
+            'create',
+            'build',
+            'develop',
+            'research',
+            'define',
+            'analyze',
+            'design',
+            'test',
+            'document',
+        ];
+        const hasActionVerb = actionVerbs.some((verb) => text.includes(verb));
+        // Should be substantive (>10 words)
+        const wordCount = objective.split(/\s+/).length;
+        // Should start with "To" or contain action verb
+        const isWellFormed = text.startsWith('to ') || hasActionVerb;
+        return isWellFormed && wordCount >= 10;
+    }
+    hasDefinedScope(context) {
+        if (!context || typeof context !== 'string')
+            return false;
+        const text = context.toLowerCase();
+        // Look for scope indicators
+        const scopeIndicators = [
+            'in-scope',
+            'out-of-scope',
+            'scope',
+            'boundary',
+            'boundaries',
+            'includes',
+            'excludes',
+            'focuses on',
+            'limited to',
+            'specifically',
+        ];
+        const hasScopeIndicator = scopeIndicators.some((indicator) => text.includes(indicator));
+        // Context should be detailed (>25 words)
+        const wordCount = context.split(/\s+/).length;
+        return hasScopeIndicator || wordCount >= 25;
+    }
+    hasFormatSpecification(mission) {
+        const fullText = JSON.stringify(mission).toLowerCase();
+        // Look for format specifications
+        const formatIndicators = [
+            'format',
+            'json',
+            'yaml',
+            'table',
+            'list',
+            'bullet',
+            'markdown',
+            'structured',
+            'template',
+            'schema',
+        ];
+        return formatIndicators.some((indicator) => fullText.includes(indicator));
+    }
+    hasConstraints(mission) {
+        const fullText = JSON.stringify(mission).toLowerCase();
+        // Look for negative constraints
+        const constraintIndicators = [
+            'do not',
+            "don't",
+            'avoid',
+            'exclude',
+            'without',
+            'must not',
+            'should not',
+            'cannot',
+            'never',
+        ];
+        const hasNegativeConstraints = constraintIndicators.some((indicator) => fullText.includes(indicator));
+        // Or positive constraints
+        const positiveConstraints = [
+            'must',
+            'required',
+            'shall',
+            'only',
+            'specifically',
+            'constraint',
+            'limitation',
+            'restriction',
+        ];
+        const hasPositiveConstraints = positiveConstraints.some((indicator) => fullText.includes(indicator));
+        // Check domainFields for constraints
+        const hasConstraintsField = mission.domainFields?.constraintToRespect !== undefined;
+        return hasNegativeConstraints || hasPositiveConstraints || hasConstraintsField;
+    }
+    hasWellDefinedSuccessCriteria(successCriteria) {
+        if (!successCriteria)
+            return false;
+        if (Array.isArray(successCriteria)) {
+            // Should have at least 3 criteria
+            if (successCriteria.length < 3)
+                return false;
+            // Each criterion should be specific (>5 words)
+            const allSpecific = successCriteria.every((criterion) => typeof criterion === 'string' && criterion.split(/\s+/).length >= 5);
+            return allSpecific;
+        }
+        if (typeof successCriteria === 'string') {
+            // If string, should be detailed
+            return successCriteria.split(/\s+/).length >= 30;
+        }
+        return false;
+    }
+    // Helper methods for linting
+    findEmptyFields(obj, path = '') {
+        const empty = [];
+        for (const key in obj) {
+            const value = obj[key];
+            const currentPath = path ? `${path}.${key}` : key;
+            if (value === null || value === undefined || value === '') {
+                empty.push(currentPath);
+            }
+            else if (Array.isArray(value) && value.length === 0) {
+                empty.push(currentPath);
+            }
+            else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                empty.push(...this.findEmptyFields(value, currentPath));
+            }
+        }
+        return empty;
+    }
+    getSpecificityDetails(mission) {
+        return {
+            hasExplicitGoal: this.hasExplicitGoal(mission.objective),
+            hasDefinedScope: this.hasDefinedScope(mission.context),
+            hasFormatSpec: this.hasFormatSpecification(mission),
+            hasConstraints: this.hasConstraints(mission),
+            hasSuccessCriteria: this.hasWellDefinedSuccessCriteria(mission.successCriteria),
+        };
+    }
+    getLintingDetails(mission) {
+        const fullText = JSON.stringify(mission).toLowerCase();
+        const vaguePhrasesFound = this.WEAK_PHRASES.filter((phrase) => fullText.includes(phrase.toLowerCase()));
+        return {
+            vaguePhrasesCount: vaguePhrasesFound.length,
+            vaguePhrasesFound: vaguePhrasesFound.slice(0, 5), // First 5
+            emptyFieldsCount: this.findEmptyFields(mission).length,
+        };
+    }
+}
+exports.AIReadinessAnalyzer = AIReadinessAnalyzer;
+//# sourceMappingURL=ai-readiness-analyzer.js.map

package/dist/quality/analyzers/ai-readiness-analyzer.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * Clarity Dimension Analyzer
+ * Implements metrics: Flesch-Kincaid, Lexical Density, Ambiguity Detection, MCC
+ */
+import { DimensionScore, ClarityMetrics, MissionContent } from '../types';
+export declare class ClarityAnalyzer {
+    private weights;
+    constructor(customWeights?: Partial<Record<keyof ClarityMetrics, number>>);
+    analyze(mission: MissionContent): Promise<DimensionScore>;
+    /**
+     * Calculate Flesch-Kincaid Grade Level
+     * FKGL = 0.39 * (total words / total sentences) + 11.8 * (total syllables / total words) - 15.59
+     */
+    private calculateFleschKincaid;
+    /**
+     * Calculate Lexical Density
+     * LD = (Number of lexical items / Total words) * 100
+     */
+    private calculateLexicalDensity;
+    /**
+     * Detect lexical ambiguity (words with multiple meanings)
+     * Simplified heuristic-based approach
+     */
+    private detectLexicalAmbiguity;
+    /**
+     * Detect syntactic ambiguity
+     * Simplified heuristic: Check for potentially ambiguous sentence structures
+     */
+    private detectSyntacticAmbiguity;
+    /**
+     * Detect referential ambiguity (unclear pronoun references)
+     */
+    private detectReferentialAmbiguity;
+    /**
+     * Calculate Mission Cyclomatic Complexity
+     * MCC = Number of Decision Points + 1
+     */
+    private calculateMCC;
+    private extractTextContent;
+    private countSentences;
+    private countWords;
+    private countSyllables;
+    private countWordSyllables;
+    private getSentences;
+    private hasNoNearbyNoun;
+    private normalizeFleschKincaid;
+    private normalizeLexicalDensity;
+    private normalizeMCC;
+    private interpretFKGL;
+    private getMCCRiskLevel;
+}
+//# sourceMappingURL=clarity-analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clarity-analyzer.d.ts","sourceRoot":"","sources":["../../../src/quality/analyzers/clarity-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EAEd,cAAc,EACd,cAAc,EAEf,MAAM,UAAU,CAAC;AAElB,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAuC;gBAE1C,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC;IAInE,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA8E/D;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAgF/B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAqC9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4BlC;;;OAGG;IACH,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;CAMxB"}