@brad-frost-web/eddie-brain 0.32.0

package/README.md

@@ -0,0 +1,109 @@
+# Eddie Brain
+
+The agentic intelligence layer for the Eddie Design System. Exposes an MCP server so AI coding tools (Claude Code, Cursor, etc.) can query component metadata, validate token usage, check design system health, and compose canonical UI patterns.
+
+## What It Does
+
+- **`eddie_get_component`** — Full component docs: props, slots, events, guidelines
+- **`eddie_search`** — Search across components, tokens, and recipes
+- **`eddie_get_token`** — Token value, tier, intent, and which components use it
+- **`eddie_compose_recipe`** — Canonical composition patterns for a given UI intent (e.g. "login form", "destructive confirmation dialog")
+- **`eddie_check_health`** — Health scores across tokens, naming, docs, coverage, accessibility, and consistency
+- **`eddie_validate_file`** — Validate a file against Eddie conventions
+- **`eddie_suggest_fix`** — Suggest fixes for detected violations
+- **`eddie_get_relationships`** — Component composition relationships
+
+## Setup
+
+### Prerequisites
+
+- Node.js (same version as the monorepo)
+- The `eddie-design-system` repo cloned locally
+
+### 1. Install dependencies
+
+From the repo root:
+
+```bash
+npm install
+```
+
+### 2. Build the package
+
+```bash
+cd packages/eddie-brain
+npm run build
+```
+
+This runs `tsc` and copies the static knowledge base files (`components.json`, `tokens.json`, etc.) into `dist/`.
+
+Verify the output:
+
+```bash
+ls dist/mcp/server.js
+```
+
+### 3. MCP registration is automatic
+
+The repo's `.mcp.json` at the root handles registration for Claude Code:
+
+```json
+{
+  "mcpServers": {
+    "eddie-brain": {
+      "command": "node",
+      "args": ["packages/eddie-brain/dist/mcp/server.js"],
+      "env": {
+        "EDDIE_ROOT": "."
+      }
+    }
+  }
+}
+```
+
+Claude Code reads `.mcp.json` on startup when your working directory is inside `eddie-design-system`. The `EDDIE_ROOT: "."` env var tells the server where to find the design system files. No additional configuration needed.
+
+### Rebuilding After Changes
+
+Whenever `src/` or `data/` files change, rebuild and restart your editor session:
+
+```bash
+cd packages/eddie-brain
+npm run build
+```
+
+## CLI
+
+The package also ships a standalone CLI:
+
+```bash
+# Health report for the whole system
+node packages/eddie-brain/dist/cli/brain.js health
+
+# Full scan (monitor + analyze)
+node packages/eddie-brain/dist/cli/brain.js scan
+node packages/eddie-brain/dist/cli/brain.js scan --component ed-button
+
+# Validate tokens and naming in source files
+node packages/eddie-brain/dist/cli/brain.js validate src/
+node packages/eddie-brain/dist/cli/brain.js validate --fix
+
+# Compose a pattern from components
+node packages/eddie-brain/dist/cli/brain.js compose "destructive confirmation dialog"
+
+# View audit log
+node packages/eddie-brain/dist/cli/brain.js audit
+node packages/eddie-brain/dist/cli/brain.js audit --since 2026-03-01
+```
+
+## Development
+
+```bash
+npm run dev      # TypeScript watch mode
+npm test         # Run tests
+npm run health   # Quick health check
+```
+
+## Architecture
+
+See [SPEC.md](./SPEC.md) for the full technical specification, including the knowledge graph schema, trust level model, health scoring categories, and implementation phases.

package/dist/analyze/drift-detector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Drift Detector
+ *
+ * Detects deviations from the knowledge graph:
+ * - Token drift: new/changed/removed tokens
+ * - Recipe drift: composition recipe inconsistencies
+ * - Naming drift: naming convention violations
+ */
+import { Signal, CompositionRecipe } from '../types.js';
+import type { TokenTaxonomy } from '../knowledge-graph/token-taxonomy.js';
+import type { ComponentIndex } from '../knowledge-graph/component-index.js';
+export declare class DriftDetector {
+    /**
+     * Detect new, changed, or removed tokens in the codebase
+     */
+    detectTokenDrift(rootDir: string, taxonomy: TokenTaxonomy): Promise<Signal[]>;
+    /**
+     * Detect deviations from canonical composition recipes
+     */
+    detectRecipeDrift(rootDir: string, recipes: CompositionRecipe[]): Promise<Signal[]>;
+    /**
+     * Detect naming convention violations
+     */
+    detectNamingDrift(rootDir: string, componentIndex: ComponentIndex): Promise<Signal[]>;
+    /**
+     * Detect if a component deviates from an expected recipe
+     */
+    private detectRecipeInComponent;
+}
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/analyze/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../src/analyze/drift-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,MAAM,EAAgC,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAwC5E,qBAAa,aAAa;IACxB;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqHnF;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAAE,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BpB;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC;IAmIpB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAoDhC"}

package/dist/analyze/drift-detector.js

@@ -0,0 +1,310 @@
+/**
+ * Drift Detector
+ *
+ * Detects deviations from the knowledge graph:
+ * - Token drift: new/changed/removed tokens
+ * - Recipe drift: composition recipe inconsistencies
+ * - Naming drift: naming convention violations
+ */
+import { readFile } from 'fs/promises';
+import glob from 'fast-glob';
+export class DriftDetector {
+    /**
+     * Detect new, changed, or removed tokens in the codebase
+     */
+    async detectTokenDrift(rootDir, taxonomy) {
+        const signals = [];
+        // Find all SCSS files
+        const scssFiles = await glob('**/*.scss', {
+            cwd: rootDir,
+            absolute: true,
+            ignore: ['**/node_modules/**'],
+        });
+        const usedTokens = new Set();
+        const tokenUsageMap = new Map();
+        // Scan files for token usage
+        for (const file of scssFiles) {
+            try {
+                const content = await readFile(file, 'utf-8');
+                const tokenMatches = content.match(/var\((--ed-[^)]+)\)/g) || [];
+                for (const match of tokenMatches) {
+                    const tokenName = match.replace(/var\(|\)/g, '');
+                    usedTokens.add(tokenName);
+                    if (!tokenUsageMap.has(tokenName)) {
+                        tokenUsageMap.set(tokenName, []);
+                    }
+                    tokenUsageMap.get(tokenName).push(file);
+                }
+            }
+            catch (error) {
+                // Skip files that can't be read
+            }
+        }
+        // Get tokens from taxonomy
+        const allTokensArray = taxonomy.getAll?.() || [];
+        const knownTokens = new Set(allTokensArray.map((t) => t.name) || []);
+        // Detect orphaned tokens (used but not in taxonomy)
+        for (const token of usedTokens) {
+            if (!knownTokens.has(token)) {
+                signals.push({
+                    id: `drift-token-orphaned-${token}`,
+                    timestamp: new Date().toISOString(),
+                    source: 'usage',
+                    severity: 'warning',
+                    type: 'token-inconsistent',
+                    message: `Token "${token}" is used in code but not found in token taxonomy`,
+                    target: token,
+                    payload: {
+                        tokenName: token,
+                        missingThemes: taxonomy.getThemes?.() || [],
+                    },
+                });
+            }
+        }
+        // Detect unused tokens (in taxonomy but not used)
+        const allThemes = taxonomy.getThemes?.() || [];
+        for (const theme of allThemes) {
+            const themeTokens = taxonomy.getByTheme?.(theme) || [];
+            for (const token of themeTokens) {
+                // Skip internal/private tokens
+                if (!token.name || token.name.includes('private')) {
+                    continue;
+                }
+                if (!usedTokens.has(token.name)) {
+                    signals.push({
+                        id: `drift-token-unused-${token.name}-${theme}`,
+                        timestamp: new Date().toISOString(),
+                        source: 'usage',
+                        severity: 'info',
+                        type: 'token-removed',
+                        message: `Token "${token.name}" is defined in theme "${theme}" but not used anywhere`,
+                        target: token.name,
+                        payload: {
+                            tokenName: token.name,
+                            theme,
+                        },
+                    });
+                }
+            }
+        }
+        // Check for theme coverage gaps
+        for (const token of usedTokens) {
+            const missingThemes = [];
+            for (const theme of allThemes) {
+                const themeTokens = taxonomy.getByTheme?.(theme) || [];
+                const hasToken = themeTokens.some((t) => t.name === token);
+                if (!hasToken) {
+                    missingThemes.push(theme);
+                }
+            }
+            if (missingThemes.length > 0) {
+                signals.push({
+                    id: `drift-token-coverage-${token}`,
+                    timestamp: new Date().toISOString(),
+                    source: 'usage',
+                    severity: 'error',
+                    type: 'token-inconsistent',
+                    message: `Token "${token}" missing from themes: ${missingThemes.join(', ')}`,
+                    target: token,
+                    payload: {
+                        tokenName: token,
+                        missingThemes,
+                    },
+                });
+            }
+        }
+        return signals;
+    }
+    /**
+     * Detect deviations from canonical composition recipes
+     */
+    async detectRecipeDrift(rootDir, recipes) {
+        const signals = [];
+        // Find all component files that might use these recipes
+        const componentFiles = await glob('**/components/**/*.ts', {
+            cwd: rootDir,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/*.test.ts'],
+        });
+        for (const file of componentFiles) {
+            try {
+                const content = await readFile(file, 'utf-8');
+                for (const recipe of recipes) {
+                    // Check if this component file uses this recipe
+                    const recipeSignals = this.detectRecipeInComponent(file, content, recipe);
+                    signals.push(...recipeSignals);
+                }
+            }
+            catch (error) {
+                // Skip files that can't be read
+            }
+        }
+        return signals;
+    }
+    /**
+     * Detect naming convention violations
+     */
+    async detectNamingDrift(rootDir, componentIndex) {
+        const signals = [];
+        // Find all SCSS files with class definitions
+        const scssFiles = await glob('**/components/**/*.scss', {
+            cwd: rootDir,
+            absolute: true,
+            ignore: ['**/node_modules/**'],
+        });
+        const validPrefixes = [
+            /^ed-c-/, // Component
+            /^ed-l-/, // Layout
+            /^ed-u-/, // Utility
+            /^ed-r-/, // Recipe component
+            /^is-/, // State
+            /^has-/, // State
+        ];
+        for (const file of scssFiles) {
+            try {
+                const content = await readFile(file, 'utf-8');
+                const lines = content.split('\n');
+                lines.forEach((line, lineIndex) => {
+                    // Skip comments
+                    if (line.trim().startsWith('//'))
+                        return;
+                    // Find class definitions (.className {)
+                    const classMatches = line.matchAll(/\.([a-zA-Z0-9_-]+)\s*[{&]/g);
+                    for (const match of classMatches) {
+                        const className = match[1];
+                        // Check for valid prefix
+                        const hasValidPrefix = validPrefixes.some((p) => p.test(className));
+                        if (!hasValidPrefix && !className.startsWith('_') && className.length > 3) {
+                            signals.push({
+                                id: `drift-naming-prefix-${className}-${lineIndex}`,
+                                timestamp: new Date().toISOString(),
+                                source: 'git',
+                                severity: 'warning',
+                                type: 'prefix-mismatch',
+                                message: `Class ".${className}" in ${file} uses invalid prefix. Expected: ed-c-, ed-l-, ed-u-, ed-r-, is-, or has-`,
+                                target: className,
+                                payload: {
+                                    className,
+                                    expectedPrefix: 'ed-c- or ed-l- or ed-u- or ed-r- or is- or has-',
+                                    actualPrefix: className.match(/^[a-z]+-/)?.[0] || 'none',
+                                },
+                            });
+                        }
+                        // Check for uppercase in class names
+                        if (/[A-Z]/.test(className)) {
+                            signals.push({
+                                id: `drift-naming-case-${className}-${lineIndex}`,
+                                timestamp: new Date().toISOString(),
+                                source: 'git',
+                                severity: 'warning',
+                                type: 'naming-violation',
+                                message: `Class ".${className}" contains uppercase letters. BEM classes must be lowercase`,
+                                target: className,
+                                payload: {
+                                    className,
+                                    expectedPattern: className.toLowerCase(),
+                                },
+                            });
+                        }
+                    }
+                });
+            }
+            catch (error) {
+                // Skip files that can't be read
+            }
+        }
+        // Check for unclassed HTML elements in component templates
+        const componentFiles = await glob('**/components/**/*.ts', {
+            cwd: rootDir,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/*.test.ts'],
+        });
+        const allowedUnclassed = [
+            'svg', 'path', 'g', 'circle', 'rect', 'ellipse', 'line',
+            'style', 'script', 'template', 'slot', 'use', 'defs',
+        ];
+        for (const file of componentFiles) {
+            try {
+                const content = await readFile(file, 'utf-8');
+                // Skip TextPassage components
+                if (file.includes('TextPassage'))
+                    continue;
+                const lines = content.split('\n');
+                lines.forEach((line, lineIndex) => {
+                    // Look for HTML elements without class attributes
+                    const elementMatches = line.matchAll(/<([a-z][a-z0-9]*)\s+(?!.*class=)[^>]*>/gi);
+                    for (const match of elementMatches) {
+                        const tag = match[1].toLowerCase();
+                        if (!allowedUnclassed.includes(tag) && !tag.includes('-')) {
+                            signals.push({
+                                id: `drift-unclassed-element-${tag}-${lineIndex}`,
+                                timestamp: new Date().toISOString(),
+                                source: 'git',
+                                severity: 'warning',
+                                type: 'naming-violation',
+                                message: `Unclassed <${tag}> element found in ${file}. Every element should have a BEM class`,
+                                target: tag,
+                                payload: {
+                                    className: `<${tag}>`,
+                                    expectedPattern: `<${tag} class="ed-c-...">`,
+                                },
+                            });
+                        }
+                    }
+                });
+            }
+            catch (error) {
+                // Skip files that can't be read
+            }
+        }
+        return signals;
+    }
+    /**
+     * Detect if a component deviates from an expected recipe
+     */
+    detectRecipeInComponent(file, content, recipe) {
+        const signals = [];
+        // Check if component file mentions recipe components
+        for (const recipeComp of recipe.components) {
+            const isComponentMentioned = content.includes(recipeComp.tagName);
+            if (recipeComp.required && !isComponentMentioned) {
+                signals.push({
+                    id: `drift-recipe-missing-${recipe.name}-${recipeComp.tagName}`,
+                    timestamp: new Date().toISOString(),
+                    source: 'usage',
+                    severity: 'warning',
+                    type: 'recipe-incomplete',
+                    message: `Recipe "${recipe.name}" requires component "${recipeComp.tagName}", but it's not found in ${file}`,
+                    target: recipeComp.tagName,
+                    payload: {
+                        recipeName: recipe.name,
+                        missingComponent: recipeComp.tagName,
+                        expectedRole: recipeComp.role,
+                    },
+                });
+            }
+        }
+        // Check for required tokens in this component if it uses the recipe
+        if (recipe.components.some((c) => content.includes(c.tagName))) {
+            for (const [tokenKey, tokenValue] of Object.entries(recipe.tokens)) {
+                if (!content.includes(tokenValue)) {
+                    signals.push({
+                        id: `drift-recipe-missing-token-${recipe.name}-${tokenKey}`,
+                        timestamp: new Date().toISOString(),
+                        source: 'usage',
+                        severity: 'info',
+                        type: 'recipe-missing-token',
+                        message: `Recipe "${recipe.name}" expects token "${tokenValue}" to be used, but not found in ${file}`,
+                        target: tokenValue,
+                        payload: {
+                            recipeName: recipe.name,
+                            tokenName: tokenValue,
+                        },
+                    });
+                }
+            }
+        }
+        return signals;
+    }
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/analyze/drift-detector.js.map

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

package/dist/analyze/health-scorer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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 { HealthScore, HealthReport, BrainConfig } from '../types.js';
+interface KnowledgeGraph {
+    getComponentEntries?: () => any[];
+    getTokenTaxonomy?: () => any;
+    getTokens?: () => any[];
+    getAllThemes?: () => string[];
+}
+export declare class HealthScorer {
+    private knowledgeGraph;
+    private config;
+    private tokenValidator;
+    private namingValidator;
+    constructor(knowledgeGraph: KnowledgeGraph, config: BrainConfig);
+    /**
+     * Score a single component across all health categories
+     */
+    scoreComponent(tagName: string): Promise<HealthScore[]>;
+    /**
+     * Generate full system health report
+     */
+    scoreAll(): Promise<HealthReport>;
+    /**
+     * Score token usage health
+     */
+    private scoreTokenHealth;
+    /**
+     * Score naming convention compliance
+     */
+    private scoreNamingHealth;
+    /**
+     * Score documentation completeness
+     */
+    private scoreDocumentationHealth;
+    /**
+     * Score metadata coverage
+     */
+    private scoreCoverageHealth;
+    /**
+     * Score accessibility features
+     */
+    private scoreAccessibilityHealth;
+    /**
+     * Score API consistency with similar components
+     */
+    private scoreConsistencyHealth;
+    /**
+     * Aggregate scores by category
+     */
+    private aggregateScores;
+    /**
+     * Calculate weighted overall score
+     */
+    private calculateWeightedScore;
+    /**
+     * Count issues by severity
+     */
+    private countIssuesBySeverity;
+}
+export {};
+//# sourceMappingURL=health-scorer.d.ts.map

package/dist/analyze/health-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-scorer.d.ts","sourceRoot":"","sources":["../../src/analyze/health-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EAGZ,WAAW,EACZ,MAAM,aAAa,CAAC;AAIrB,UAAU,cAAc;IACtB,mBAAmB,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;CAC/B;AAOD,qBAAa,YAAY;IAKrB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;gBAG/B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,WAAW;IAM7B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgD7D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IA4BvC;;OAEG;YACW,gBAAgB;IA2B9B;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwEhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwDhC;;OAEG;YACW,sBAAsB;IA8DpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}