@brad-frost-web/eddie-brain 0.32.0

package/dist/knowledge-graph/token-taxonomy.js

@@ -0,0 +1,357 @@
+/**
+ * TokenTaxonomy — Organize and classify design tokens
+ *
+ * Parses token files and classifies tokens by tier (definition/usage/component),
+ * category (color/spacing/typography), and theme.
+ */
+import fg from 'fast-glob';
+const { globSync } = fg;
+import { readFileSync } from 'fs';
+import { join } from 'path';
+export class TokenTaxonomy {
+    tokens = new Map();
+    /**
+     * Build the token taxonomy by scanning token files.
+     *
+     * Two-pass build:
+     *  1. Walk the source JSON files in `tier-{1-definitions,2-usage,3-components}/`
+     *     directories to build an authoritative `tokenName → tier` map. The file
+     *     path is the source of truth for tier; relying on CSS-variable name
+     *     heuristics mis-classifies tier-2 blocks like `animation` and `viz`
+     *     because their first segment after `--ed-theme-` isn't a stock CSS
+     *     category name (#680).
+     *  2. Parse the compiled tokens.css per theme for the actual values,
+     *     looking up the tier in the map produced by pass 1.
+     *
+     * Tokens that exist in the compiled CSS but not in any source JSON
+     * (deprecated/leftover) fall through to the legacy name-heuristic
+     * classifier so we never emit an empty tier — but in practice every
+     * compiled token traces back to a JSON definition.
+     */
+    async build(rootDir) {
+        this.tokens.clear();
+        const tokenDir = join(rootDir, 'packages', 'eddie-design-tokens');
+        const tierMap = this.buildTierMap(tokenDir);
+        const cssFiles = globSync('*/build/css/tokens.css', {
+            cwd: tokenDir,
+        });
+        for (const file of cssFiles) {
+            const themeName = file.split('/')[0];
+            const filePath = join(tokenDir, file);
+            try {
+                await this.parseTokenFile(filePath, themeName, tierMap);
+            }
+            catch (err) {
+                // Silently skip unparseable files
+            }
+        }
+    }
+    /**
+     * Build the authoritative `tokenName → tier` map by walking source JSON.
+     *
+     * Looks under any theme directory (`bfw`, `bfw-dark`, `altitude`, etc.)
+     * for these conventional subdirectories:
+     *   - `tier-1-definitions/*.json` → tier "definition"
+     *   - `tier-2-usage/*.json`        → tier "usage"
+     *   - `tier-3-components/*.json`   → tier "component"
+     *
+     * Each leaf node (object with a non-object `value`) becomes a CSS variable
+     * name derived from the path: `--ed-<dot.path.dashed>` for tier 1, and
+     * `--ed-theme-<dot.path.dashed>` for tiers 2 and 3. The tier-1 vs theme
+     * prefix split mirrors how Style Dictionary emits the compiled CSS.
+     *
+     * Earliest tier wins on collision (in practice tokens don't appear in
+     * multiple tiers; this just keeps the result deterministic).
+     */
+    buildTierMap(tokenDir) {
+        const map = new Map();
+        const tiers = [
+            ['*/tier-1-definitions/*.json', 'definition'],
+            ['*/tier-2-usage/*.json', 'usage'],
+            ['*/tier-3-components/*.json', 'component'],
+        ];
+        for (const [pattern, tier] of tiers) {
+            const isTier1 = tier === 'definition';
+            const files = globSync(pattern, { cwd: tokenDir });
+            for (const relPath of files) {
+                try {
+                    const json = JSON.parse(readFileSync(join(tokenDir, relPath), 'utf-8'));
+                    for (const cssVarName of this.collectCssVarNames(json, isTier1)) {
+                        if (!map.has(cssVarName))
+                            map.set(cssVarName, tier);
+                    }
+                }
+                catch {
+                    // Skip unparseable JSON
+                }
+            }
+        }
+        return map;
+    }
+    /**
+     * Walk a Style-Dictionary-style JSON tree and yield the CSS variable name
+     * for each leaf (object with a non-object `value` property). Non-leaf
+     * objects recurse; primitive/array values are ignored.
+     */
+    collectCssVarNames(json, isTier1, path = []) {
+        if (typeof json !== 'object' || json === null)
+            return [];
+        const obj = json;
+        if ('value' in obj && (typeof obj.value !== 'object' || obj.value === null)) {
+            const segments = path.join('-').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
+            if (!segments)
+                return [];
+            const prefix = isTier1 ? '--ed-' : '--ed-theme-';
+            return [prefix + segments];
+        }
+        const out = [];
+        for (const [k, v] of Object.entries(obj)) {
+            out.push(...this.collectCssVarNames(v, isTier1, [...path, k]));
+        }
+        return out;
+    }
+    /**
+     * Parse a tokens.css file and extract all tokens
+     */
+    async parseTokenFile(filePath, themeName, tierMap) {
+        const content = readFileSync(filePath, 'utf-8');
+        // Match all CSS custom properties: --ed-*: value;
+        const tokenRegex = /(--ed[^:]+):\s*([^;]+);/g;
+        let match;
+        while ((match = tokenRegex.exec(content)) !== null) {
+            const name = match[1].trim();
+            const value = match[2].trim();
+            const tier = tierMap.get(name) ?? this.classifyTier(name);
+            const category = this.classifyCategory(name);
+            const intent = this.extractIntent(name);
+            const references = this.extractReferences(name, value);
+            const subcategory = this.deriveSubcategory(name, category);
+            const validProperties = this.deriveValidProperties(subcategory);
+            const key = `${name}:${themeName}`;
+            if (!this.tokens.has(key)) {
+                this.tokens.set(key, {
+                    name,
+                    tier,
+                    category,
+                    value,
+                    references,
+                    intent,
+                    usedBy: [],
+                    theme: themeName,
+                    deprecated: false,
+                    subcategory,
+                    validProperties,
+                });
+            }
+        }
+    }
+    /**
+     * Derive the color subcategory ("background" | "content" | "border") from
+     * a token name. The convention is that the segment immediately after
+     * `color-` in the name is the subcategory:
+     *   --ed-theme-color-background-default → "background"
+     *   --ed-theme-color-content-default    → "content"
+     *   --ed-theme-color-border-subtle      → "border"
+     * Returns undefined for non-color tokens, definition-tier color tokens
+     * (no subcategory in name), and any color-token shape we don't recognize.
+     */
+    deriveSubcategory(name, category) {
+        if (category !== 'color')
+            return undefined;
+        const m = name.match(/--ed-(?:theme-)?color-(background|content|border)-/);
+        if (!m)
+            return undefined;
+        return m[1];
+    }
+    /**
+     * Derive the CSS properties this token is valid to apply to.
+     * Only meaningful for color tokens with a known subcategory; other tokens
+     * return undefined (no `validProperties` field on output).
+     */
+    deriveValidProperties(subcategory) {
+        switch (subcategory) {
+            case 'background':
+                return ['background', 'background-color'];
+            case 'content':
+                return ['color', 'fill'];
+            case 'border':
+                return ['border-color'];
+            default:
+                return undefined;
+        }
+    }
+    /**
+     * Classify a token as tier 1 (definition), tier 2 (usage), or tier 3 (component)
+     *
+     * Tier 1: --ed-{category}-{name} (e.g., --ed-color-brand-blue)
+     * Tier 2: --ed-theme-{category}-{semantic} (e.g., --ed-theme-color-background-default)
+     * Tier 3: --ed-theme-{component}-{property} (e.g., --ed-theme-button-background)
+     */
+    classifyTier(name) {
+        if (name.includes('--ed-theme-')) {
+            // Tier 2 or 3
+            const parts = name.split('-');
+            // Check if it looks like a component token
+            // e.g., --ed-theme-button-background (has component-specific name)
+            const knownCategories = ['color', 'spacing', 'typography', 'border', 'shadow', 'motion', 'breakpoint', 'z-index', 'opacity'];
+            const hasKnownCategory = parts.some((p) => knownCategories.includes(p));
+            if (!hasKnownCategory && parts.length > 4) {
+                // Likely a component token
+                return 'component';
+            }
+            return 'usage';
+        }
+        return 'definition';
+    }
+    /**
+     * Classify a token by category
+     */
+    classifyCategory(name) {
+        const lowerName = name.toLowerCase();
+        if (lowerName.includes('color'))
+            return 'color';
+        if (lowerName.includes('space') || lowerName.includes('gap') || lowerName.includes('padding') || lowerName.includes('margin'))
+            return 'spacing';
+        if (lowerName.includes('font') ||
+            lowerName.includes('text') ||
+            lowerName.includes('letter') ||
+            lowerName.includes('line-height'))
+            return 'typography';
+        if (lowerName.includes('border'))
+            return 'border';
+        if (lowerName.includes('shadow'))
+            return 'shadow';
+        if (lowerName.includes('transition') || lowerName.includes('animation') || lowerName.includes('duration'))
+            return 'motion';
+        if (lowerName.includes('breakpoint') || lowerName.includes('viewport'))
+            return 'breakpoint';
+        if (lowerName.includes('z-index') || lowerName.includes('zindex'))
+            return 'z-index';
+        if (lowerName.includes('opacity'))
+            return 'opacity';
+        return 'color'; // Default to color
+    }
+    /**
+     * Extract intent from token name
+     */
+    extractIntent(name) {
+        // Remove prefixes and convert to readable form
+        const parts = name
+            .replace('--ed-', '')
+            .replace('--ed-theme-', '')
+            .split('-');
+        // Skip the first 1-2 parts (category names)
+        const intentParts = parts.slice(2);
+        if (intentParts.length === 0) {
+            return parts.join(' ');
+        }
+        return intentParts.join(' ');
+    }
+    /**
+     * Extract what token this one references (if any)
+     */
+    extractReferences(name, value) {
+        // If the value is itself a CSS variable, track it
+        const refMatch = value.match(/var\((--ed[^)]+)\)/);
+        if (refMatch) {
+            return refMatch[1];
+        }
+        return undefined;
+    }
+    /**
+     * Get a token by name
+     */
+    getToken(name) {
+        // Try exact match first
+        for (const [, entry] of this.tokens) {
+            if (entry.name === name) {
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all tokens
+     */
+    getAll() {
+        const seen = new Set();
+        const result = [];
+        for (const entry of this.tokens.values()) {
+            if (!seen.has(entry.name)) {
+                result.push(entry);
+                seen.add(entry.name);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get tokens by tier
+     */
+    getByTier(tier) {
+        const seen = new Set();
+        const result = [];
+        for (const entry of this.tokens.values()) {
+            if (entry.tier === tier && !seen.has(entry.name)) {
+                result.push(entry);
+                seen.add(entry.name);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get tokens by category
+     */
+    getByCategory(category) {
+        const seen = new Set();
+        const result = [];
+        for (const entry of this.tokens.values()) {
+            if (entry.category === category && !seen.has(entry.name)) {
+                result.push(entry);
+                seen.add(entry.name);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get tokens by theme
+     */
+    getByTheme(theme) {
+        return Array.from(this.tokens.values()).filter((entry) => entry.theme === theme);
+    }
+    /**
+     * Get available themes
+     */
+    getThemes() {
+        const themes = new Set();
+        for (const entry of this.tokens.values()) {
+            themes.add(entry.theme);
+        }
+        return Array.from(themes).sort();
+    }
+    /**
+     * Serialize to JSON
+     */
+    toJSON() {
+        const obj = {};
+        const seen = new Set();
+        for (const entry of this.tokens.values()) {
+            const key = `${entry.name}:${entry.theme}`;
+            if (!seen.has(key)) {
+                obj[key] = entry;
+                seen.add(key);
+            }
+        }
+        return obj;
+    }
+    /**
+     * Deserialize from JSON
+     */
+    static fromJSON(obj) {
+        const taxonomy = new TokenTaxonomy();
+        for (const [key, entry] of Object.entries(obj)) {
+            taxonomy.tokens.set(key, entry);
+        }
+        return taxonomy;
+    }
+}
+//# sourceMappingURL=token-taxonomy.js.map

package/dist/knowledge-graph/token-taxonomy.js.map

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

package/dist/loop/fix-agent.d.ts

@@ -0,0 +1,55 @@
+/**
+ * FixAgent — Lightweight single-call violation fixer.
+ *
+ * Makes one Anthropic API call with the file content, violation details,
+ * and available tokens. Validates the fix, retries once if needed.
+ * Much cheaper than the full 8-agent pipeline (~20K tokens vs ~160K).
+ */
+import type { KnowledgeGraph } from '../knowledge-graph/index.js';
+import type { ViolationIssue, FixAttempt } from './types.js';
+import type { Pacer } from './pacer.js';
+export declare class FixAgent {
+    private apiKey;
+    private model;
+    private rootDir;
+    private knowledgeGraph;
+    private pacer;
+    private client;
+    private tokenValidator;
+    private namingValidator;
+    private guidelinesCache;
+    constructor(apiKey: string, model: string, rootDir: string, knowledgeGraph: KnowledgeGraph, pacer: Pacer);
+    /**
+     * Attempt to fix a single violation issue.
+     */
+    fix(issue: ViolationIssue): Promise<FixAttempt>;
+    /**
+     * Build the system prompt for the fix-agent.
+     */
+    private buildSystemPrompt;
+    /**
+     * Build the user message with the file content and violation details.
+     */
+    private buildUserMessage;
+    /**
+     * Extract code from the API response.
+     */
+    private extractCode;
+    /**
+     * Validate content by writing to a temp file and running validators.
+     */
+    private validateContent;
+    /**
+     * Check that the fix is minimal — doesn't touch too many lines beyond the violation site.
+     */
+    private isMinimalChange;
+    /**
+     * Get relevant token names for the violations in this issue.
+     */
+    private getRelevantTokens;
+    /**
+     * Load and cache code guidelines.
+     */
+    private getGuidelines;
+}
+//# sourceMappingURL=fix-agent.d.ts.map

package/dist/loop/fix-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-agent.d.ts","sourceRoot":"","sources":["../../src/loop/fix-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKxC,qBAAa,QAAQ;IAOjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,KAAK;IAVf,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAuB;gBAGpC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,KAAK;IAOtB;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA+JrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;YACW,eAAe;IA4B7B;;OAEG;IACH,OAAO,CAAC,eAAe;IA8BvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,aAAa;CActB"}