@buoy-design/cli 0.1.13 → 0.1.14

package/dist/services/context-generator.js

@@ -0,0 +1,252 @@
+/**
+ * Context Generator Service
+ *
+ * Generates design system context for CLAUDE.md files.
+ * Helps AI agents understand and follow design system rules.
+ */
+/**
+ * Generate design system context for CLAUDE.md
+ */
+export function generateContext(data, options = {}) {
+    const { detailLevel = 'standard', includeTokens = true, includeComponents = true, includeAntiPatterns = true, includeValidation = true, } = options;
+    const sections = [];
+    let antiPatternCount = 0;
+    // Header
+    sections.push(generateHeader(data.projectName));
+    // Component Usage
+    if (includeComponents && data.components.length > 0) {
+        sections.push(generateComponentSection(data.components, detailLevel));
+    }
+    // Token Requirements
+    if (includeTokens && data.tokens.length > 0) {
+        sections.push(generateTokenSection(data.tokens, detailLevel));
+    }
+    // Anti-Patterns
+    if (includeAntiPatterns) {
+        const antiPatterns = generateAntiPatternSection(data.drifts || [], detailLevel);
+        if (antiPatterns) {
+            sections.push(antiPatterns);
+            antiPatternCount = (data.drifts || []).length;
+        }
+    }
+    // Validation
+    if (includeValidation) {
+        sections.push(generateValidationSection());
+    }
+    return {
+        content: sections.join('\n\n'),
+        stats: {
+            tokenCount: data.tokens.length,
+            componentCount: data.components.length,
+            antiPatternCount,
+        },
+    };
+}
+/**
+ * Generate context header
+ */
+function generateHeader(projectName) {
+    return `## Design System Rules
+
+This project uses the ${projectName} Design System. Follow these rules when generating code:`;
+}
+/**
+ * Generate component usage section
+ */
+function generateComponentSection(components, detailLevel) {
+    const lines = ['### Component Usage'];
+    lines.push('');
+    // Group by framework
+    const byFramework = groupByFramework(components);
+    const frameworks = Object.keys(byFramework);
+    if (frameworks.length === 1) {
+        const framework = frameworks[0];
+        const comps = byFramework[framework];
+        lines.push(`Use components from your ${framework} component library. Check before creating new ones:`);
+        lines.push('');
+        lines.push(formatComponentList(comps, detailLevel));
+    }
+    else {
+        lines.push('Use existing components from your component libraries:');
+        lines.push('');
+        for (const framework of frameworks) {
+            const comps = byFramework[framework];
+            lines.push(`**${capitalize(framework)}:** ${formatComponentList(comps, detailLevel)}`);
+        }
+    }
+    if (detailLevel !== 'minimal') {
+        lines.push('');
+        lines.push('See full inventory: `buoy status --components`');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate token requirements section
+ */
+function generateTokenSection(tokens, detailLevel) {
+    const lines = ['### Token Requirements'];
+    lines.push('');
+    lines.push('**NEVER hardcode these values:**');
+    // Group tokens by category
+    const byCategory = groupByCategory(tokens);
+    if (byCategory.color && byCategory.color.length > 0) {
+        lines.push(`- Colors: Use design tokens or utility classes`);
+    }
+    if (byCategory.spacing && byCategory.spacing.length > 0) {
+        lines.push(`- Spacing: Use spacing scale tokens`);
+    }
+    if (byCategory.typography && byCategory.typography.length > 0) {
+        lines.push(`- Typography: Use font tokens`);
+    }
+    // Quick reference for standard/comprehensive
+    if (detailLevel !== 'minimal') {
+        lines.push('');
+        lines.push('**Quick Reference:**');
+        // Show sample tokens
+        if (byCategory.color) {
+            const samples = byCategory.color.slice(0, 3);
+            for (const token of samples) {
+                const value = formatTokenValue(token);
+                lines.push(`- ${token.name}: ${value}`);
+            }
+        }
+        if (byCategory.spacing) {
+            const spacingValues = byCategory.spacing
+                .map((t) => formatTokenValue(t))
+                .slice(0, 8)
+                .join(', ');
+            lines.push(`- Spacing scale: ${spacingValues}`);
+        }
+    }
+    // Comprehensive: show all tokens
+    if (detailLevel === 'comprehensive') {
+        lines.push('');
+        lines.push('**All Tokens:**');
+        lines.push('');
+        lines.push('| Token | Value | Category |');
+        lines.push('|-------|-------|----------|');
+        for (const token of tokens.slice(0, 50)) {
+            const value = formatTokenValue(token);
+            lines.push(`| \`${token.name}\` | ${value} | ${token.category} |`);
+        }
+        if (tokens.length > 50) {
+            lines.push(`| ... | ${tokens.length - 50} more tokens | ... |`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate anti-patterns section
+ */
+function generateAntiPatternSection(drifts, detailLevel) {
+    const lines = ['### Anti-Patterns'];
+    lines.push('');
+    lines.push('AVOID:');
+    // Common anti-patterns always included
+    const commonAntiPatterns = [
+        '- `<div onClick>` - Use `<Button>` or semantic elements',
+        '- Inline styles for colors/spacing - Use tokens or classes',
+        '- Creating component variants that already exist',
+        '- Arbitrary values (e.g., `p-[13px]`) - Use scale values',
+    ];
+    lines.push(...commonAntiPatterns);
+    // Add project-specific anti-patterns from drift signals
+    if (detailLevel !== 'minimal' && drifts.length > 0) {
+        const hardcodedTypes = new Set();
+        for (const drift of drifts) {
+            if (drift.type === 'hardcoded-value') {
+                // Extract the type of hardcoded value
+                const typeMatch = drift.message.match(/hardcoded (color|spacing|font|radius)/i);
+                if (typeMatch) {
+                    hardcodedTypes.add(typeMatch[1].toLowerCase());
+                }
+            }
+        }
+        if (hardcodedTypes.size > 0) {
+            lines.push('');
+            lines.push('**Detected issues in this codebase:**');
+            for (const type of hardcodedTypes) {
+                lines.push(`- Hardcoded ${type} values found - use tokens instead`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate validation section
+ */
+function generateValidationSection() {
+    return `### Validation
+
+Run before committing:
+\`\`\`bash
+buoy check          # Quick validation
+buoy drift check    # Detailed drift analysis
+buoy fix --dry-run  # See suggested fixes
+\`\`\``;
+}
+// Helper functions
+function groupByFramework(components) {
+    const groups = {};
+    for (const comp of components) {
+        const framework = comp.source.type;
+        if (!groups[framework]) {
+            groups[framework] = [];
+        }
+        groups[framework].push(comp);
+    }
+    return groups;
+}
+function groupByCategory(tokens) {
+    const groups = {};
+    for (const token of tokens) {
+        if (!groups[token.category]) {
+            groups[token.category] = [];
+        }
+        groups[token.category].push(token);
+    }
+    return groups;
+}
+function formatComponentList(components, detailLevel) {
+    const names = [...new Set(components.map((c) => c.name))].sort();
+    if (detailLevel === 'minimal') {
+        return names.slice(0, 10).join(', ') + (names.length > 10 ? '...' : '');
+    }
+    if (detailLevel === 'standard') {
+        return names.slice(0, 20).join(', ') + (names.length > 20 ? ` (+${names.length - 20} more)` : '');
+    }
+    // Comprehensive
+    return names.join(', ');
+}
+function formatTokenValue(token) {
+    const value = token.value;
+    if (value.type === 'color') {
+        return value.hex;
+    }
+    if (value.type === 'spacing') {
+        return `${value.value}${value.unit}`;
+    }
+    if (value.type === 'typography') {
+        return `${value.fontFamily} ${value.fontSize}`;
+    }
+    if (value.type === 'raw') {
+        return String(value.value);
+    }
+    return '(complex)';
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Generate minimal context (for quick reference)
+ */
+export function generateMinimalContext(data) {
+    return generateContext(data, { detailLevel: 'minimal' }).content;
+}
+/**
+ * Generate comprehensive context (for full documentation)
+ */
+export function generateComprehensiveContext(data) {
+    return generateContext(data, { detailLevel: 'comprehensive' }).content;
+}
+//# sourceMappingURL=context-generator.js.map

package/dist/services/context-generator.js.map

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

package/dist/services/skill-export.d.ts

@@ -0,0 +1,96 @@
+/**
+ * SkillExportService - Generate design system skills for AI agents
+ *
+ * Exports tokens, components, patterns, and anti-patterns as markdown files
+ * optimized for progressive disclosure in AI agent workflows.
+ */
+import type { Component, DesignToken, DriftSignal } from '@buoy-design/core';
+export interface SkillExportOptions {
+    /** Sections to include in export */
+    sections: string[];
+    /** Output directory path */
+    outputPath: string;
+}
+export interface ScanData {
+    tokens: DesignToken[];
+    components: Component[];
+    drifts: DriftSignal[];
+    projectName: string;
+}
+export interface SkillExportResult {
+    /** Files to write */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Statistics about exported content */
+    stats: {
+        tokens: {
+            colors: number;
+            spacing: number;
+            typography: number;
+            total: number;
+        };
+        components: number;
+        patterns: string[];
+    };
+}
+/**
+ * Service for exporting design system data as AI agent skills
+ */
+export declare class SkillExportService {
+    constructor(_projectName: string);
+    /**
+     * Export design system data as skill files
+     */
+    export(data: ScanData, options: SkillExportOptions): Promise<SkillExportResult>;
+    /**
+     * Generate the main SKILL.md entry point
+     */
+    generateSkillMd(data: ScanData): string;
+    /**
+     * Generate tokens index with category counts
+     */
+    generateTokensIndex(tokens: DesignToken[]): string;
+    /**
+     * Generate color tokens markdown
+     */
+    generateColorTokens(tokens: DesignToken[]): string;
+    /**
+     * Generate spacing tokens markdown
+     */
+    generateSpacingTokens(tokens: DesignToken[]): string;
+    /**
+     * Generate typography tokens markdown
+     */
+    generateTypographyTokens(tokens: DesignToken[]): string;
+    /**
+     * Generate component inventory markdown
+     */
+    generateComponentInventory(components: Component[]): string;
+    /**
+     * Generate patterns index based on component names
+     */
+    generatePatternsIndex(components: Component[]): string;
+    /**
+     * Generate anti-patterns from drift signals
+     */
+    generateAntiPatterns(drifts: DriftSignal[]): string;
+    /**
+     * Detect patterns from component names
+     */
+    private detectPatterns;
+    /**
+     * Get components that match a pattern
+     */
+    private getComponentsForPattern;
+    /**
+     * Capitalize pattern name for display
+     */
+    private capitalizePattern;
+    /**
+     * Format drift type for display
+     */
+    private formatDriftType;
+}
+//# sourceMappingURL=skill-export.d.ts.map

package/dist/services/skill-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-export.d.ts","sourceRoot":"","sources":["../../src/services/skill-export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG7E,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,wCAAwC;IACxC,KAAK,EAAE;QACL,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;QACF,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,kBAAkB;gBACjB,YAAY,EAAE,MAAM;IAKhC;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA8E7B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAkFvC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IA6DlD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IA+ClD;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAiDpD;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAgDvD;;OAEG;IACH,0BAA0B,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM;IAiD3D;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM;IA6CtD;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IA2DnD;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAMxB"}