@nahisaho/musubix-core 1.0.0

package/dist/validators/ears-validator.d.ts

@@ -0,0 +1,182 @@
+/**
+ * EARS Validator
+ *
+ * Validates requirements against EARS (Easy Approach to Requirements Syntax) patterns
+ *
+ * @packageDocumentation
+ * @module validators/ears-validator
+ *
+ * @see REQ-RA-001 - EARS Pattern Recognition
+ * @see Article II - Requirements First
+ */
+/**
+ * Validation issue
+ */
+export interface ValidationIssue {
+    /** Issue code (same as ruleId) */
+    code?: string;
+    /** Rule ID */
+    ruleId?: string;
+    /** Issue message */
+    message: string;
+    /** Severity */
+    severity: 'error' | 'warning' | 'info';
+    /** Location if applicable */
+    location?: string;
+}
+/**
+ * EARS Pattern types
+ */
+export type EARSPatternType = 'ubiquitous' | 'event-driven' | 'state-driven' | 'unwanted' | 'optional' | 'complex';
+/**
+ * EARS Pattern match
+ */
+export interface EARSPatternMatch {
+    /** Pattern type */
+    type: EARSPatternType;
+    /** Match confidence (0-1) */
+    confidence: number;
+    /** Extracted components */
+    components: EARSComponents;
+    /** Original text */
+    original: string;
+    /** Suggested rewrite (if needed) */
+    suggestion?: string;
+}
+/**
+ * EARS Components extracted from requirement
+ */
+export interface EARSComponents {
+    /** System or actor */
+    system?: string;
+    /** Trigger condition (event-driven) */
+    trigger?: string;
+    /** State condition (state-driven) */
+    state?: string;
+    /** Precondition (unwanted behavior) */
+    condition?: string;
+    /** Feature flag (optional) */
+    feature?: string;
+    /** Action/behavior */
+    action?: string;
+    /** Response/result */
+    response?: string;
+}
+/**
+ * EARS validation options
+ */
+export interface EARSValidatorOptions {
+    /** Minimum confidence threshold */
+    confidenceThreshold: number;
+    /** Allow complex patterns */
+    allowComplex: boolean;
+    /** Strict mode (require exact pattern match) */
+    strictMode: boolean;
+    /** Suggest rewrites for non-conforming requirements */
+    suggestRewrites: boolean;
+}
+/**
+ * Default validation options
+ */
+export declare const DEFAULT_EARS_OPTIONS: EARSValidatorOptions;
+/**
+ * EARS Validator
+ *
+ * Validates and analyzes requirements using EARS patterns
+ */
+export declare class EARSValidator {
+    private options;
+    constructor(options?: Partial<EARSValidatorOptions>);
+    /**
+     * Validate a single requirement
+     */
+    validateRequirement(requirement: string): EARSValidationResult;
+    /**
+     * Validate multiple requirements
+     */
+    validateRequirements(requirements: string[]): EARSBatchValidationResult;
+    /**
+     * Match requirement against EARS patterns
+     */
+    private matchPattern;
+    /**
+     * Match complex (combined) patterns
+     */
+    private matchComplexPattern;
+    /**
+     * Calculate confidence score for pattern match
+     */
+    private calculateConfidence;
+    /**
+     * Check quality of matched requirement
+     */
+    private checkQuality;
+    /**
+     * Generate rewrite suggestions for non-conforming requirements
+     */
+    private generateRewrites;
+    /**
+     * Extract action from text
+     */
+    private extractAction;
+    /**
+     * Analyze pattern distribution
+     */
+    private analyzeDistribution;
+    /**
+     * Aggregate issues from all results
+     */
+    private aggregateIssues;
+    /**
+     * Get pattern description
+     */
+    static getPatternDescription(type: EARSPatternType): string;
+    /**
+     * Get all pattern descriptions
+     */
+    static getAllPatterns(): Array<{
+        type: EARSPatternType;
+        description: string;
+    }>;
+}
+/**
+ * EARS Validation Result
+ */
+export interface EARSValidationResult {
+    /** Is valid EARS format */
+    valid: boolean;
+    /** Pattern match details */
+    patternMatch: EARSPatternMatch | null;
+    /** Quality issues */
+    issues: ValidationIssue[];
+    /** Rewrite suggestions */
+    suggestions: string[];
+}
+/**
+ * EARS Batch Validation Result
+ */
+export interface EARSBatchValidationResult {
+    /** Total requirements */
+    total: number;
+    /** Valid requirements */
+    valid: number;
+    /** Invalid requirements */
+    invalid: number;
+    /** Coverage ratio */
+    coverage: number;
+    /** Individual results */
+    results: Array<{
+        index: number;
+        requirement: string;
+        result: EARSValidationResult;
+    }>;
+    /** Pattern distribution */
+    patternDistribution: Record<EARSPatternType, number>;
+    /** Aggregated issues */
+    overallIssues: Map<string, number>;
+}
+/**
+ * Create EARS validator instance
+ */
+export declare function createEARSValidator(options?: Partial<EARSValidatorOptions>): EARSValidator;
+//# sourceMappingURL=ears-validator.d.ts.map

package/dist/validators/ears-validator.d.ts.map

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

package/dist/validators/ears-validator.js

@@ -0,0 +1,357 @@
+/**
+ * EARS Validator
+ *
+ * Validates requirements against EARS (Easy Approach to Requirements Syntax) patterns
+ *
+ * @packageDocumentation
+ * @module validators/ears-validator
+ *
+ * @see REQ-RA-001 - EARS Pattern Recognition
+ * @see Article II - Requirements First
+ */
+/**
+ * Default validation options
+ */
+export const DEFAULT_EARS_OPTIONS = {
+    confidenceThreshold: 0.7,
+    allowComplex: true,
+    strictMode: false,
+    suggestRewrites: true,
+};
+/**
+ * Pattern definitions for EARS
+ */
+const EARS_PATTERNS = [
+    {
+        type: 'ubiquitous',
+        regex: /^(?:the\s+)?(.+?)\s+shall\s+(.+)$/i,
+        extract: (match) => ({
+            system: match[1]?.trim(),
+            action: match[2]?.trim(),
+        }),
+        description: 'The <system> shall <action>',
+    },
+    {
+        type: 'event-driven',
+        regex: /^when\s+(.+?),?\s+(?:the\s+)?(.+?)\s+shall\s+(.+)$/i,
+        extract: (match) => ({
+            trigger: match[1]?.trim(),
+            system: match[2]?.trim(),
+            action: match[3]?.trim(),
+        }),
+        description: 'When <trigger>, the <system> shall <action>',
+    },
+    {
+        type: 'state-driven',
+        regex: /^while\s+(.+?),?\s+(?:the\s+)?(.+?)\s+shall\s+(.+)$/i,
+        extract: (match) => ({
+            state: match[1]?.trim(),
+            system: match[2]?.trim(),
+            action: match[3]?.trim(),
+        }),
+        description: 'While <state>, the <system> shall <action>',
+    },
+    {
+        type: 'unwanted',
+        regex: /^if\s+(.+?),?\s+(?:then\s+)?(?:the\s+)?(.+?)\s+shall\s+(.+)$/i,
+        extract: (match) => ({
+            condition: match[1]?.trim(),
+            system: match[2]?.trim(),
+            action: match[3]?.trim(),
+        }),
+        description: 'If <condition>, then the <system> shall <action>',
+    },
+    {
+        type: 'optional',
+        regex: /^where\s+(.+?),?\s+(?:the\s+)?(.+?)\s+shall\s+(.+)$/i,
+        extract: (match) => ({
+            feature: match[1]?.trim(),
+            system: match[2]?.trim(),
+            action: match[3]?.trim(),
+        }),
+        description: 'Where <feature>, the <system> shall <action>',
+    },
+];
+/**
+ * EARS Validator
+ *
+ * Validates and analyzes requirements using EARS patterns
+ */
+export class EARSValidator {
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_EARS_OPTIONS, ...options };
+    }
+    /**
+     * Validate a single requirement
+     */
+    validateRequirement(requirement) {
+        const trimmed = requirement.trim();
+        if (!trimmed) {
+            return {
+                valid: false,
+                patternMatch: null,
+                issues: [{
+                        severity: 'error',
+                        message: 'Requirement text is empty',
+                        ruleId: 'ears-empty',
+                    }],
+                suggestions: ['Provide a non-empty requirement text'],
+            };
+        }
+        // Try to match EARS patterns
+        const match = this.matchPattern(trimmed);
+        if (match && match.confidence >= this.options.confidenceThreshold) {
+            return {
+                valid: true,
+                patternMatch: match,
+                issues: this.checkQuality(match),
+                suggestions: [],
+            };
+        }
+        // No pattern match - provide suggestions
+        const issues = [{
+                severity: this.options.strictMode ? 'error' : 'warning',
+                message: 'Requirement does not match any EARS pattern',
+                ruleId: 'ears-no-pattern',
+            }];
+        const suggestions = this.options.suggestRewrites
+            ? this.generateRewrites(trimmed)
+            : [];
+        return {
+            valid: !this.options.strictMode,
+            patternMatch: match,
+            issues,
+            suggestions,
+        };
+    }
+    /**
+     * Validate multiple requirements
+     */
+    validateRequirements(requirements) {
+        const results = requirements.map((req, index) => ({
+            index,
+            requirement: req,
+            result: this.validateRequirement(req),
+        }));
+        const valid = results.filter((r) => r.result.valid);
+        const invalid = results.filter((r) => !r.result.valid);
+        // Analyze pattern distribution
+        const patternDistribution = this.analyzeDistribution(results);
+        return {
+            total: requirements.length,
+            valid: valid.length,
+            invalid: invalid.length,
+            coverage: requirements.length > 0 ? valid.length / requirements.length : 0,
+            results,
+            patternDistribution,
+            overallIssues: this.aggregateIssues(results),
+        };
+    }
+    /**
+     * Match requirement against EARS patterns
+     */
+    matchPattern(text) {
+        let bestMatch = null;
+        let bestConfidence = 0;
+        for (const pattern of EARS_PATTERNS) {
+            const match = text.match(pattern.regex);
+            if (match) {
+                const components = pattern.extract(match);
+                const confidence = this.calculateConfidence(components, pattern.type);
+                if (confidence > bestConfidence) {
+                    bestConfidence = confidence;
+                    bestMatch = {
+                        type: pattern.type,
+                        confidence,
+                        components,
+                        original: text,
+                    };
+                }
+            }
+        }
+        // Check for complex patterns
+        if (!bestMatch && this.options.allowComplex) {
+            bestMatch = this.matchComplexPattern(text);
+        }
+        return bestMatch;
+    }
+    /**
+     * Match complex (combined) patterns
+     */
+    matchComplexPattern(text) {
+        // Complex: When + While combination
+        const complexRegex = /^when\s+(.+?)\s+(?:and\s+)?while\s+(.+?),?\s+(?:the\s+)?(.+?)\s+shall\s+(.+)$/i;
+        const match = text.match(complexRegex);
+        if (match) {
+            return {
+                type: 'complex',
+                confidence: 0.85,
+                components: {
+                    trigger: match[1]?.trim(),
+                    state: match[2]?.trim(),
+                    system: match[3]?.trim(),
+                    action: match[4]?.trim(),
+                },
+                original: text,
+            };
+        }
+        return null;
+    }
+    /**
+     * Calculate confidence score for pattern match
+     */
+    calculateConfidence(components, _type) {
+        let confidence = 0.5; // Base confidence for pattern match
+        // Check component quality
+        if (components.system && components.system.length > 2) {
+            confidence += 0.15;
+        }
+        if (components.action && components.action.length > 5) {
+            confidence += 0.2;
+        }
+        // Bonus for well-formed components
+        if (components.action?.includes(' ')) {
+            confidence += 0.1; // Action has multiple words
+        }
+        // Cap at 1.0
+        return Math.min(confidence, 1.0);
+    }
+    /**
+     * Check quality of matched requirement
+     */
+    checkQuality(match) {
+        const issues = [];
+        const { components } = match;
+        // Check for vague terms
+        const vagueTerms = ['appropriate', 'adequate', 'etc', 'and/or', 'as needed'];
+        const text = match.original.toLowerCase();
+        for (const term of vagueTerms) {
+            if (text.includes(term)) {
+                issues.push({
+                    severity: 'warning',
+                    message: `Requirement contains vague term: "${term}"`,
+                    ruleId: 'ears-vague-term',
+                });
+            }
+        }
+        // Check system name
+        if (components.system && components.system.length < 3) {
+            issues.push({
+                severity: 'warning',
+                message: 'System name is too short',
+                ruleId: 'ears-short-system',
+            });
+        }
+        // Check action specificity
+        if (components.action) {
+            const actionWords = components.action.split(/\s+/).length;
+            if (actionWords < 2) {
+                issues.push({
+                    severity: 'info',
+                    message: 'Action could be more specific',
+                    ruleId: 'ears-vague-action',
+                });
+            }
+        }
+        // Check for measurability
+        const hasMetric = /\d+|percent|seconds?|minutes?|hours?|ms|milliseconds?/i.test(text);
+        if (!hasMetric && match.type !== 'ubiquitous') {
+            issues.push({
+                severity: 'info',
+                message: 'Consider adding measurable criteria',
+                ruleId: 'ears-no-metric',
+            });
+        }
+        return issues;
+    }
+    /**
+     * Generate rewrite suggestions for non-conforming requirements
+     */
+    generateRewrites(text) {
+        const suggestions = [];
+        const lowerText = text.toLowerCase();
+        // Detect potential pattern and suggest
+        if (lowerText.includes('when') || lowerText.includes('upon')) {
+            suggestions.push(`Event-driven: "When <trigger>, the system shall ${this.extractAction(text)}"`);
+        }
+        if (lowerText.includes('while') || lowerText.includes('during')) {
+            suggestions.push(`State-driven: "While <state>, the system shall ${this.extractAction(text)}"`);
+        }
+        if (lowerText.includes('if') || lowerText.includes('in case')) {
+            suggestions.push(`Unwanted behavior: "If <condition>, then the system shall ${this.extractAction(text)}"`);
+        }
+        // Default ubiquitous suggestion
+        if (suggestions.length === 0) {
+            suggestions.push(`Ubiquitous: "The system shall ${this.extractAction(text)}"`);
+        }
+        return suggestions;
+    }
+    /**
+     * Extract action from text
+     */
+    extractAction(text) {
+        // Try to find verb phrase
+        const verbMatch = text.match(/(?:should|must|will|shall|can|may)\s+(.+?)(?:\.|$)/i);
+        if (verbMatch) {
+            return verbMatch[1].trim();
+        }
+        // Return cleaned text as action
+        return text.replace(/^(?:the\s+)?system\s+/i, '').trim() || '<action>';
+    }
+    /**
+     * Analyze pattern distribution
+     */
+    analyzeDistribution(results) {
+        const distribution = {
+            'ubiquitous': 0,
+            'event-driven': 0,
+            'state-driven': 0,
+            'unwanted': 0,
+            'optional': 0,
+            'complex': 0,
+        };
+        for (const { result } of results) {
+            if (result.patternMatch) {
+                distribution[result.patternMatch.type]++;
+            }
+        }
+        return distribution;
+    }
+    /**
+     * Aggregate issues from all results
+     */
+    aggregateIssues(results) {
+        const issueCount = new Map();
+        for (const { result } of results) {
+            for (const issue of result.issues) {
+                const key = issue.ruleId ?? issue.message;
+                issueCount.set(key, (issueCount.get(key) ?? 0) + 1);
+            }
+        }
+        return issueCount;
+    }
+    /**
+     * Get pattern description
+     */
+    static getPatternDescription(type) {
+        const pattern = EARS_PATTERNS.find((p) => p.type === type);
+        return pattern?.description ?? 'Unknown pattern';
+    }
+    /**
+     * Get all pattern descriptions
+     */
+    static getAllPatterns() {
+        return EARS_PATTERNS.map((p) => ({
+            type: p.type,
+            description: p.description,
+        }));
+    }
+}
+/**
+ * Create EARS validator instance
+ */
+export function createEARSValidator(options) {
+    return new EARSValidator(options);
+}
+//# sourceMappingURL=ears-validator.js.map

package/dist/validators/ears-validator.js.map

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

package/dist/validators/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Validators Module
+ *
+ * @packageDocumentation
+ * @module validators
+ */
+export { EARSValidator, createEARSValidator, type EARSPatternType, type EARSPatternMatch, type EARSValidatorOptions, type EARSBatchValidationResult, DEFAULT_EARS_OPTIONS, } from './ears-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/validators/index.js

@@ -0,0 +1,9 @@
+/**
+ * Validators Module
+ *
+ * @packageDocumentation
+ * @module validators
+ */
+export { EARSValidator, createEARSValidator, DEFAULT_EARS_OPTIONS, } from './ears-validator.js';
+// Note: EARSComponents and EARSValidationResult are exported from types module
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EAKnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,+EAA+E"}

package/dist/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MUSUBIX Version
+ *
+ * @packageDocumentation
+ * @module @musubix/core/version
+ */
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,8 @@
+/**
+ * MUSUBIX Version
+ *
+ * @packageDocumentation
+ * @module @musubix/core/version
+ */
+export const VERSION = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}