@brad-frost-web/eddie-brain 0.32.0

package/dist/analyze/health-scorer.js

@@ -0,0 +1,420 @@
+/**
+ * Health Scorer
+ *
+ * Scores system health across 6 categories:
+ * - Tokens: proper usage of design tokens
+ * - Naming: BEM/BEMIT compliance
+ * - Coverage: completeness of component metadata
+ * - Documentation: presence and quality of documentation
+ * - Accessibility: ARIA and keyboard handling
+ * - Consistency: API and pattern consistency
+ */
+import { resolve } from 'path';
+import { TokenValidator } from './token-validator.js';
+import { NamingValidator } from './naming-validator.js';
+export class HealthScorer {
+    knowledgeGraph;
+    config;
+    tokenValidator;
+    namingValidator;
+    constructor(knowledgeGraph, config) {
+        this.knowledgeGraph = knowledgeGraph;
+        this.config = config;
+        this.tokenValidator = new TokenValidator();
+        this.namingValidator = new NamingValidator();
+    }
+    /**
+     * Score a single component across all health categories
+     */
+    async scoreComponent(tagName) {
+        const scores = [];
+        // Get component entry
+        const componentEntry = this.knowledgeGraph.getComponentEntries?.()?.find((c) => c.tagName === tagName);
+        if (!componentEntry) {
+            return [
+                {
+                    category: 'tokens',
+                    score: 0,
+                    issues: [
+                        {
+                            id: `health-component-not-found-${tagName}`,
+                            category: 'tokens',
+                            severity: 'error',
+                            message: `Component ${tagName} not found in knowledge graph`,
+                            file: 'unknown',
+                            autoFixable: false,
+                        },
+                    ],
+                },
+            ];
+        }
+        // Token health
+        scores.push(await this.scoreTokenHealth(componentEntry));
+        // Naming health
+        scores.push(await this.scoreNamingHealth(componentEntry));
+        // Documentation health
+        scores.push(this.scoreDocumentationHealth(componentEntry));
+        // Coverage health
+        scores.push(this.scoreCoverageHealth(componentEntry));
+        // Accessibility health
+        scores.push(this.scoreAccessibilityHealth(componentEntry));
+        // Consistency health
+        scores.push(await this.scoreConsistencyHealth(componentEntry));
+        return scores;
+    }
+    /**
+     * Generate full system health report
+     */
+    async scoreAll() {
+        const components = this.knowledgeGraph.getComponentEntries?.() || [];
+        const allScores = [];
+        const startTime = Date.now();
+        for (const component of components) {
+            const scores = await this.scoreComponent(component.tagName);
+            allScores.push(...scores);
+        }
+        // Aggregate scores by category
+        const categoryScores = this.aggregateScores(allScores);
+        // Calculate overall weighted score
+        const overall = this.calculateWeightedScore(categoryScores);
+        // Count issues by severity
+        const issueCounts = this.countIssuesBySeverity(allScores);
+        return {
+            timestamp: new Date().toISOString(),
+            overall,
+            categories: categoryScores,
+            totalIssues: allScores.reduce((sum, score) => sum + score.issues.length, 0),
+            issueCounts,
+        };
+    }
+    /**
+     * Score token usage health
+     */
+    async scoreTokenHealth(component) {
+        const issues = [];
+        // Validate component SCSS file if it exists
+        if (component.paths?.styles) {
+            const stylesPath = resolve(this.config.rootDir, component.paths.styles);
+            const taxonomy = this.knowledgeGraph.getTokenTaxonomy?.();
+            if (taxonomy) {
+                const styleIssues = await this.tokenValidator.validateFile(stylesPath, taxonomy);
+                issues.push(...styleIssues);
+            }
+        }
+        // Score: 100 - (violations / total_checks * 100)
+        // Assume ~10 token uses per component file
+        const estimatedTokenUses = 10;
+        const violationRate = issues.length / Math.max(estimatedTokenUses, 1);
+        const score = Math.max(0, Math.round(100 - violationRate * 100));
+        return {
+            category: 'tokens',
+            score,
+            issues,
+        };
+    }
+    /**
+     * Score naming convention compliance
+     */
+    async scoreNamingHealth(component) {
+        const issues = [];
+        // Validate component file
+        if (component.paths?.component) {
+            const componentPath = resolve(this.config.rootDir, component.paths.component);
+            const componentIssues = await this.namingValidator.validateFile(componentPath);
+            issues.push(...componentIssues);
+        }
+        // Validate SCSS file for class naming
+        if (component.paths?.styles) {
+            const stylesPath = resolve(this.config.rootDir, component.paths.styles);
+            const styleIssues = await this.namingValidator.validateFile(stylesPath);
+            issues.push(...styleIssues);
+        }
+        // Score based on issue count
+        // Assume ~5 class names per component
+        const estimatedClasses = 5;
+        const violationRate = issues.length / Math.max(estimatedClasses, 1);
+        const score = Math.max(0, Math.round(100 - violationRate * 100));
+        return {
+            category: 'naming',
+            score,
+            issues,
+        };
+    }
+    /**
+     * Score documentation completeness
+     */
+    scoreDocumentationHealth(component) {
+        const issues = [];
+        let docScore = 100;
+        // Check for intent
+        if (!component.intent || component.intent.length < 10) {
+            docScore -= 15;
+            issues.push({
+                id: `doc-missing-intent-${component.tagName}`,
+                category: 'documentation',
+                severity: 'warning',
+                message: `Component "${component.tagName}" missing or minimal intent description`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: true,
+                suggestion: 'Add a clear intent: "For [purpose], allowing users to [action]"',
+            });
+        }
+        // Check for slot descriptions
+        if (component.slots && component.slots.length > 0) {
+            const undocumentedSlots = component.slots.filter((slot) => !slot.description || slot.description.length < 5);
+            if (undocumentedSlots.length > 0) {
+                docScore -= undocumentedSlots.length * 5;
+                issues.push({
+                    id: `doc-undocumented-slots-${component.tagName}`,
+                    category: 'documentation',
+                    severity: 'info',
+                    message: `Component "${component.tagName}" has ${undocumentedSlots.length} undocumented slot(s)`,
+                    file: component.paths?.stories || 'unknown',
+                    autoFixable: true,
+                });
+            }
+        }
+        // Check for property descriptions
+        const undocumentedProps = component.properties?.filter((p) => !p.description || p.description.length < 5) || [];
+        if (undocumentedProps.length > 0) {
+            docScore -= Math.min(undocumentedProps.length * 3, 20);
+            issues.push({
+                id: `doc-undocumented-props-${component.tagName}`,
+                category: 'documentation',
+                severity: 'info',
+                message: `Component "${component.tagName}" has ${undocumentedProps.length} undocumented property(ies)`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: true,
+            });
+        }
+        // Check for guidelines
+        if (!component.guidelines || !component.guidelines.use || component.guidelines.use.length === 0) {
+            docScore -= 15;
+            issues.push({
+                id: `doc-missing-guidelines-${component.tagName}`,
+                category: 'documentation',
+                severity: 'warning',
+                message: `Component "${component.tagName}" missing usage guidelines`,
+                file: component.paths?.stories || 'unknown',
+                autoFixable: true,
+            });
+        }
+        return {
+            category: 'documentation',
+            score: Math.max(0, docScore),
+            issues,
+        };
+    }
+    /**
+     * Score metadata coverage
+     */
+    scoreCoverageHealth(component) {
+        const issues = [];
+        let coverageScore = 100;
+        // Check required metadata
+        const requiredFields = ['tagName', 'displayName', 'cssClassName', 'intent', 'baseClass'];
+        for (const field of requiredFields) {
+            if (!component[field]) {
+                coverageScore -= 10;
+                issues.push({
+                    id: `coverage-missing-${field}-${component.tagName}`,
+                    category: 'coverage',
+                    severity: 'error',
+                    message: `Component "${component.tagName}" missing required field: ${field}`,
+                    file: component.paths?.component || 'unknown',
+                    autoFixable: true,
+                });
+            }
+        }
+        // Check for test coverage
+        if (!component.paths?.test) {
+            coverageScore -= 15;
+            issues.push({
+                id: `coverage-no-test-${component.tagName}`,
+                category: 'coverage',
+                severity: 'warning',
+                message: `Component "${component.tagName}" has no test file`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: false,
+            });
+        }
+        // Check for story coverage
+        if (!component.paths?.stories) {
+            coverageScore -= 10;
+            issues.push({
+                id: `coverage-no-stories-${component.tagName}`,
+                category: 'coverage',
+                severity: 'warning',
+                message: `Component "${component.tagName}" has no Storybook stories`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: false,
+            });
+        }
+        return {
+            category: 'coverage',
+            score: Math.max(0, coverageScore),
+            issues,
+        };
+    }
+    /**
+     * Score accessibility features
+     */
+    scoreAccessibilityHealth(component) {
+        const issues = [];
+        let a11yScore = 100;
+        // Check for ARIA properties
+        const hasAriaProps = component.properties?.some((p) => p.name.toLowerCase().includes('aria') || p.name.toLowerCase().includes('role'));
+        if (!hasAriaProps && component.baseClass === 'EdFormElement') {
+            a11yScore -= 20;
+            issues.push({
+                id: `a11y-missing-aria-${component.tagName}`,
+                category: 'accessibility',
+                severity: 'warning',
+                message: `Form component "${component.tagName}" should have ARIA properties (aria-label, aria-describedby, etc.)`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: true,
+            });
+        }
+        // Check for accessibility guidelines
+        if (!component.guidelines?.accessibility || component.guidelines.accessibility.length === 0) {
+            a11yScore -= 15;
+            issues.push({
+                id: `a11y-missing-guidelines-${component.tagName}`,
+                category: 'accessibility',
+                severity: 'warning',
+                message: `Component "${component.tagName}" missing accessibility guidelines`,
+                file: component.paths?.stories || 'unknown',
+                autoFixable: true,
+            });
+        }
+        // Check for keyboard handling documentation
+        const hasKeyboardDocs = component.guidelines?.accessibility?.some((g) => g.toLowerCase().includes('keyboard') || g.toLowerCase().includes('focus'));
+        if (!hasKeyboardDocs && component.baseClass === 'EdFormElement') {
+            a11yScore -= 10;
+            issues.push({
+                id: `a11y-no-keyboard-docs-${component.tagName}`,
+                category: 'accessibility',
+                severity: 'info',
+                message: `Form component "${component.tagName}" should document keyboard interactions`,
+                file: component.paths?.stories || 'unknown',
+                autoFixable: true,
+            });
+        }
+        return {
+            category: 'accessibility',
+            score: Math.max(0, a11yScore),
+            issues,
+        };
+    }
+    /**
+     * Score API consistency with similar components
+     */
+    async scoreConsistencyHealth(component) {
+        const issues = [];
+        let consistencyScore = 100;
+        // Find similar components (same atomic level, same category)
+        const allComponents = this.knowledgeGraph.getComponentEntries?.() || [];
+        const similarComponents = allComponents.filter((c) => c.atomicLevel === component.atomicLevel &&
+            c.tagName !== component.tagName &&
+            c.package === component.package);
+        if (similarComponents.length === 0) {
+            // Not enough similar components to compare
+            return {
+                category: 'consistency',
+                score: consistencyScore,
+                issues,
+            };
+        }
+        // Check API consistency
+        const refComponent = similarComponents[0];
+        // Check property naming consistency
+        const hasVariantProp = component.properties?.some((p) => p.name === 'variant');
+        const refHasVariant = refComponent.properties?.some((p) => p.name === 'variant');
+        if (hasVariantProp !== refHasVariant && similarComponents.length > 2) {
+            consistencyScore -= 5;
+            issues.push({
+                id: `consistency-variant-naming-${component.tagName}`,
+                category: 'consistency',
+                severity: 'info',
+                message: `Component "${component.tagName}" naming differs from similar components regarding "variant" property`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: false,
+            });
+        }
+        // Check size property naming
+        const hasSizeProp = component.properties?.some((p) => p.name === 'size');
+        const refHasSize = refComponent.properties?.some((p) => p.name === 'size');
+        if (hasSizeProp !== refHasSize && similarComponents.length > 2) {
+            consistencyScore -= 5;
+            issues.push({
+                id: `consistency-size-naming-${component.tagName}`,
+                category: 'consistency',
+                severity: 'info',
+                message: `Component "${component.tagName}" naming differs from similar components regarding "size" property`,
+                file: component.paths?.component || 'unknown',
+                autoFixable: false,
+            });
+        }
+        return {
+            category: 'consistency',
+            score: Math.max(0, consistencyScore),
+            issues,
+        };
+    }
+    /**
+     * Aggregate scores by category
+     */
+    aggregateScores(allScores) {
+        const byCategory = new Map();
+        for (const score of allScores) {
+            if (!byCategory.has(score.category)) {
+                byCategory.set(score.category, []);
+            }
+            byCategory.get(score.category).push(score);
+        }
+        const aggregated = [];
+        for (const [category, scores] of byCategory.entries()) {
+            const avgScore = Math.round(scores.reduce((sum, s) => sum + s.score, 0) / scores.length);
+            const allIssues = scores.flatMap((s) => s.issues);
+            aggregated.push({
+                category,
+                score: avgScore,
+                issues: allIssues,
+            });
+        }
+        return aggregated;
+    }
+    /**
+     * Calculate weighted overall score
+     */
+    calculateWeightedScore(categoryScores) {
+        let weightedSum = 0;
+        let totalWeight = 0;
+        for (const category of Object.keys(this.config.healthWeights)) {
+            const weight = this.config.healthWeights[category];
+            const categoryScore = categoryScores.find((s) => s.category === category);
+            const score = categoryScore?.score || 0;
+            weightedSum += score * weight;
+            totalWeight += weight;
+        }
+        return Math.round(weightedSum / (totalWeight || 1));
+    }
+    /**
+     * Count issues by severity
+     */
+    countIssuesBySeverity(allScores) {
+        const counts = {
+            info: 0,
+            warning: 0,
+            error: 0,
+            critical: 0,
+        };
+        for (const score of allScores) {
+            for (const issue of score.issues) {
+                counts[issue.severity]++;
+            }
+        }
+        return counts;
+    }
+}
+//# sourceMappingURL=health-scorer.js.map

package/dist/analyze/health-scorer.js.map

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

package/dist/analyze/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Analysis Layer
+ *
+ * Exports all analyzer classes for detecting health issues and drift in the Eddie Design System.
+ */
+export { TokenValidator } from './token-validator.js';
+export { NamingValidator } from './naming-validator.js';
+export { SlotContractValidator } from './slot-contract-validator.js';
+export { HealthScorer } from './health-scorer.js';
+export { DriftDetector } from './drift-detector.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/analyze/index.js

@@ -0,0 +1,11 @@
+/**
+ * Analysis Layer
+ *
+ * Exports all analyzer classes for detecting health issues and drift in the Eddie Design System.
+ */
+export { TokenValidator } from './token-validator.js';
+export { NamingValidator } from './naming-validator.js';
+export { SlotContractValidator } from './slot-contract-validator.js';
+export { HealthScorer } from './health-scorer.js';
+export { DriftDetector } from './drift-detector.js';
+//# sourceMappingURL=index.js.map

package/dist/analyze/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/analyze/naming-validator.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Naming Validator
+ *
+ * Validates BEM/BEMIT naming conventions in Eddie components:
+ * - CSS class prefixes (ed-c-, ed-l-, ed-u-, ed-r-, ed-p-, etc.)
+ * - BEM structure (block__element--modifier)
+ * - Detects unclassed HTML elements in Lit component templates
+ *
+ * Understands Lit-specific patterns:
+ * - Only scans inside html`...` tagged template literals
+ * - Recognizes dynamic class bindings (class="${expr}")
+ * - Skips JSDoc/comment blocks
+ * - Skips .stories.ts files for unclassed element checks (slot content is fine)
+ */
+import { HealthIssue } from '../types.js';
+export declare class NamingValidator {
+    /**
+     * Class prefix patterns
+     */
+    private readonly validPrefixes;
+    /**
+     * HTML elements that can exist without a class
+     * - SVG internals, slots, templates, scripts, style tags
+     * - Custom elements (contain a hyphen) always skip
+     */
+    private readonly unclassedAllowed;
+    /**
+     * Validate a single component file
+     */
+    validateFile(filePath: string): Promise<HealthIssue[]>;
+    /**
+     * Validate all component files in a directory
+     */
+    validateDirectory(dirPath: string): Promise<HealthIssue[]>;
+    /**
+     * Validate a single CSS class name string
+     */
+    validateClassName(className: string): HealthIssue | null;
+    /**
+     * Validate HTML elements inside Lit templates.
+     *
+     * Key behaviors:
+     * - Extracts only the content inside html`...` tagged template literals
+     * - Strips JSDoc/block comments before scanning
+     * - Recognizes dynamic class bindings: class="${...}" counts as having a class
+     * - Skips unclassed-element checks in .stories.ts (slot content is fine)
+     * - Skips self-closing void elements and custom elements (contain hyphen)
+     */
+    private validateTemplate;
+    /**
+     * Strip block comments (/* ... * /) including JSDoc (/** ... * /)
+     * Preserves line count by replacing comment content with blank lines.
+     */
+    private stripBlockComments;
+    /**
+     * Extract content from html`...` tagged template literals.
+     * Returns regions with their content and the line offset where they start.
+     */
+    private extractLitTemplates;
+    /**
+     * Simplified check: does a template close on this line?
+     * Looks for a ` that's not preceded by ${ context.
+     */
+    private templateClosesOnLine;
+    /**
+     * Check for HTML elements without classes in template content.
+     *
+     * Understands:
+     * - class="${expr}" — dynamic class, counts as having a class
+     * - class="literal" — static class
+     * - styleModifier="..." — Eddie's pattern for passing classes to children
+     * - Tags with a hyphen are custom elements (always skip)
+     */
+    private checkUnclassedElements;
+    /**
+     * Check static class name values in templates for Eddie naming compliance.
+     * Only validates literal class strings, not dynamic ${} expressions.
+     */
+    private checkStaticClassNames;
+    /**
+     * Validate class names in SCSS file
+     */
+    private validateStyleFile;
+    /**
+     * Validate a single class name string against Eddie's BEM/BEMIT conventions
+     */
+    private classNameValidation;
+    /**
+     * Validate BEM structure (block__element--modifier)
+     * Allows: block, block__element, block--modifier, block__element--modifier
+     * Parts can contain hyphens (single) for multi-word names.
+     */
+    private validateBemStructure;
+    /**
+     * Suggest a corrected class name
+     */
+    private suggestClassName;
+}
+//# sourceMappingURL=naming-validator.d.ts.map

package/dist/analyze/naming-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-validator.d.ts","sourceRoot":"","sources":["../../src/analyze/naming-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1C,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAQ5B;IAEF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAQ9B;IAEH;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA8B5D;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmBhE;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAuBxD;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2D3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;;;OAQG;IACH,OAAO,CAAC,sBAAsB;IAyD9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgD7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAMzB"}