@trentapps/manager-protocol 1.3.0

package/dist/analyzers/ArchitectureDetector.js

@@ -0,0 +1,218 @@
+/**
+ * Architecture Change Detector
+ *
+ * Detects when agent actions represent architectural changes that should
+ * be documented in the project's CLAUDE.md file.
+ */
+import path from 'path';
+export class ArchitectureDetector {
+    /**
+     * Detect if an action represents an architectural change
+     */
+    static detectChanges(action, _context) {
+        // Only process file-related actions
+        if (!this.isFileAction(action)) {
+            return null;
+        }
+        const filePath = this.extractFilePath(action);
+        if (!filePath) {
+            return null;
+        }
+        // Skip non-architectural files
+        if (this.shouldSkipFile(filePath)) {
+            return null;
+        }
+        // Detect the type of architectural change
+        const componentType = this.detectComponentType(filePath);
+        if (!componentType) {
+            return null;
+        }
+        // Generate documentation suggestion
+        return this.generateDocumentation(filePath, componentType, action);
+    }
+    /**
+     * Check if action is file-related
+     */
+    static isFileAction(action) {
+        const fileActions = [
+            'write_file',
+            'create_file',
+            'edit_file',
+            'modify_file',
+            'file_system'
+        ];
+        return (fileActions.some(a => action.name.toLowerCase().includes(a)) ||
+            action.category === 'file_system');
+    }
+    /**
+     * Extract file path from action parameters
+     */
+    static extractFilePath(action) {
+        const params = action.parameters || {};
+        // Try common parameter names
+        const pathKeys = ['filePath', 'file_path', 'path', 'file', 'target'];
+        for (const key of pathKeys) {
+            if (params[key] && typeof params[key] === 'string') {
+                return params[key];
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if file should be skipped (not architectural)
+     */
+    static shouldSkipFile(filePath) {
+        const skipPatterns = [
+            /\.test\.(ts|js|py)$/, // Test files
+            /\.spec\.(ts|js|py)$/, // Spec files
+            /\.md$/, // Documentation (except CLAUDE.md)
+            /node_modules\//, // Dependencies
+            /\.git\//, // Git files
+            /dist\//, // Build output
+            /build\//, // Build output
+            /\.env/, // Environment files
+            /package-lock\.json$/, // Lock files
+            /yarn\.lock$/, // Lock files
+            /\.gitignore$/, // Config files
+            /\.eslintrc/, // Config files
+            /tsconfig\.json$/, // Config files
+            /\.prettierrc/, // Config files
+            /README\.md$/, // READMEs
+            /LICENSE$/, // License files
+            /\.(png|jpg|jpeg|gif|svg|ico)$/ // Images
+        ];
+        return skipPatterns.some(pattern => pattern.test(filePath));
+    }
+    /**
+     * Detect the type of component being added/modified
+     */
+    static detectComponentType(filePath) {
+        const normalized = filePath.toLowerCase();
+        // Check directory structure
+        if (normalized.includes('/src/services/') || normalized.includes('/services/')) {
+            return 'service';
+        }
+        if (normalized.includes('/src/components/') || normalized.includes('/components/')) {
+            return 'component';
+        }
+        if (normalized.includes('/src/api/') || normalized.includes('/api/') ||
+            normalized.includes('/routes/') || normalized.includes('/blueprints/')) {
+            return 'api';
+        }
+        if (normalized.includes('/src/models/') || normalized.includes('/models/') ||
+            normalized.includes('/schemas/')) {
+            return 'model';
+        }
+        if (normalized.includes('/src/utils/') || normalized.includes('/utils/') ||
+            normalized.includes('/helpers/')) {
+            return 'utility';
+        }
+        if (normalized.includes('/src/middleware/') || normalized.includes('/middleware/')) {
+            return 'middleware';
+        }
+        if (normalized.includes('/src/config/') || normalized.includes('/config/')) {
+            return 'configuration';
+        }
+        if (normalized.includes('/src/integrations/') || normalized.includes('/integrations/')) {
+            return 'integration';
+        }
+        if (normalized.includes('/src/engine/') || normalized.includes('/engine/')) {
+            return 'engine';
+        }
+        if (normalized.includes('/src/analyzers/') || normalized.includes('/analyzers/')) {
+            return 'analyzer';
+        }
+        if (normalized.includes('/src/dashboard/') || normalized.includes('/dashboard/')) {
+            return 'dashboard';
+        }
+        // Check for package.json (dependency change)
+        if (normalized.endsWith('package.json')) {
+            return 'dependency';
+        }
+        // Check for specific file patterns
+        if (normalized.endsWith('server.ts') || normalized.endsWith('server.js') ||
+            normalized.endsWith('app.ts') || normalized.endsWith('app.js')) {
+            return 'main';
+        }
+        return null;
+    }
+    /**
+     * Generate documentation suggestion
+     */
+    static generateDocumentation(filePath, componentType, _action) {
+        const fileName = path.basename(filePath, path.extname(filePath));
+        const componentName = this.formatComponentName(fileName);
+        const templates = {
+            service: {
+                section: 'Services',
+                template: (name) => `### ${name}\n\nBrief description of what this service does.\n\n**Purpose**: Core functionality provided by this service\n\n**Key Features**:\n- Feature 1\n- Feature 2\n\n**Dependencies**: List any external services or APIs used`
+            },
+            component: {
+                section: 'Components',
+                template: (name) => `### ${name}\n\nDescription of this component's role.\n\n**Props/Interface**:\n- Prop 1: Description\n- Prop 2: Description\n\n**Usage Example**:\n\`\`\`typescript\n// Usage example here\n\`\`\``
+            },
+            api: {
+                section: 'API Endpoints',
+                template: (name) => `### ${name} Endpoints\n\n**Routes**:\n- \`GET /api/${name.toLowerCase()}\` - Description\n- \`POST /api/${name.toLowerCase()}\` - Description\n\n**Authentication**: Required/Optional\n\n**Request/Response Format**:\n\`\`\`json\n{\n  "example": "data"\n}\n\`\`\``
+            },
+            model: {
+                section: 'Data Models',
+                template: (name) => `### ${name}\n\n**Schema**:\n\`\`\`typescript\ninterface ${name} {\n  // Define schema here\n}\n\`\`\`\n\n**Relationships**: Related models or tables\n\n**Validation**: Key validation rules`
+            },
+            utility: {
+                section: 'Utilities',
+                template: (name) => `### ${name}\n\n**Purpose**: What this utility provides\n\n**Key Functions**:\n- \`function1()\` - Description\n- \`function2()\` - Description\n\n**Usage**: Common use cases`
+            },
+            middleware: {
+                section: 'Middleware',
+                template: (name) => `### ${name}\n\n**Purpose**: What this middleware does\n\n**Applied To**: Which routes/endpoints\n\n**Configuration**: Any configuration options`
+            },
+            integration: {
+                section: 'Integrations',
+                template: (name) => `### ${name}\n\n**External Service**: Name and purpose\n\n**API Version**: Version of external API\n\n**Configuration**:\n- API Key: How to configure\n- Endpoints: List of used endpoints\n\n**Error Handling**: How failures are handled`
+            },
+            engine: {
+                section: 'Core Engine',
+                template: (name) => `### ${name}\n\n**Purpose**: Core engine component responsibility\n\n**Key Methods**:\n- Method 1: Description\n- Method 2: Description\n\n**Integration**: How it integrates with other components`
+            },
+            analyzer: {
+                section: 'Analyzers',
+                template: (name) => `### ${name}\n\n**Analyzes**: What this analyzer evaluates\n\n**Returns**: Analysis result format\n\n**Usage**: When and how to use this analyzer`
+            },
+            dashboard: {
+                section: 'Dashboard',
+                template: (name) => `### ${name}\n\n**Feature**: Dashboard feature provided\n\n**API Endpoints**: Related endpoints\n\n**UI Components**: User interface elements`
+            },
+            dependency: {
+                section: 'Dependencies',
+                template: () => `### New Dependency Added\n\nA new dependency was added to package.json.\n\n**Review Required**: Check package.json for the new dependency and document its purpose here.`
+            },
+            main: {
+                section: 'Core Application',
+                template: (name) => `### ${name}\n\n**Purpose**: Main application entry point changes\n\n**Configuration**: New configuration options\n\n**Startup**: Changes to startup sequence`
+            }
+        };
+        const template = templates[componentType] || templates.utility;
+        const suggestedContent = template.template(componentName);
+        return {
+            needed: true,
+            reason: `New ${componentType} detected at ${filePath}`,
+            suggestedContent,
+            section: template.section
+        };
+    }
+    /**
+     * Format component name for documentation
+     */
+    static formatComponentName(fileName) {
+        // Convert PascalCase/camelCase to Title Case
+        return fileName
+            .replace(/([A-Z])/g, ' $1') // Add space before capitals
+            .replace(/[-_]/g, ' ') // Replace dashes and underscores with spaces
+            .trim() // Remove leading/trailing spaces
+            .split(' ') // Split into words
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ');
+    }
+}
+//# sourceMappingURL=ArchitectureDetector.js.map

package/dist/analyzers/ArchitectureDetector.js.map

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

package/dist/analyzers/CSSAnalyzer.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Enterprise Agent Supervisor - CSS Analyzer
+ *
+ * Analyzes CSS rules for optimization, deduplication, and best practices.
+ *
+ * Task #44: Extensible pattern catalog system
+ * Task #51: Optimized similarity calculation with hashing/indexing
+ * Task #52: Comprehensive logging and metrics tracking
+ */
+export interface CSSRule {
+    selector: string;
+    properties: Record<string, string>;
+    source: 'inline' | 'style_tag' | 'external' | 'unknown';
+    file?: string;
+    line?: number;
+    specificity?: number;
+}
+export interface CSSAnalysisContext {
+    newRule: CSSRule;
+    existingRules?: CSSRule[];
+    projectType?: 'spa' | 'mpa' | 'component_library' | 'website';
+    framework?: 'react' | 'vue' | 'angular' | 'svelte' | 'vanilla' | 'other';
+    hasStyleSystem?: boolean;
+    styleSystemName?: string;
+    globalStylesFile?: string;
+    componentName?: string;
+}
+export interface CSSSuggestion {
+    type: 'use_existing' | 'make_global' | 'externalize' | 'remove_unused' | 'consolidate' | 'use_variable' | 'use_utility' | 'specificity_warning' | 'naming_convention';
+    severity: 'error' | 'warning' | 'info' | 'suggestion';
+    message: string;
+    details?: string;
+    existingRule?: CSSRule;
+    suggestedAction?: string;
+    codeExample?: string;
+}
+export interface CSSAnalysisResult {
+    ruleId: string;
+    newRule: CSSRule;
+    shouldExternalize: boolean;
+    shouldMakeGlobal: boolean;
+    duplicates: CSSRule[];
+    suggestions: CSSSuggestion[];
+    removableCandidates: CSSRule[];
+    riskScore: number;
+    summary: string;
+    metrics?: CSSAnalysisMetrics;
+}
+export interface CSSAnalysisMetrics {
+    rulesAnalyzed: number;
+    duplicatesFound: number;
+    suggestionsMade: number;
+    suggestionsByType: Record<string, number>;
+    suggestionsBySeverity: Record<string, number>;
+    timingMs: {
+        total: number;
+        duplicateCheck: number;
+        externalizeCheck: number;
+        globalCheck: number;
+        variableCheck: number;
+        utilityCheck: number;
+        specificityCheck: number;
+        namingCheck: number;
+        removableCheck: number;
+    };
+    cacheHits: number;
+    cacheMisses: number;
+}
+export interface CSSAnalyzerLogger {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+}
+export declare const consoleLogger: CSSAnalyzerLogger;
+export interface CSSVariablePattern {
+    id: string;
+    pattern: RegExp;
+    type: 'color' | 'spacing' | 'font-size' | 'font-weight' | 'duration' | 'easing' | 'custom';
+    varPrefix: string;
+    minValue?: number;
+    maxValue?: number;
+    description?: string;
+    enabled: boolean;
+}
+export interface CSSGlobalPattern {
+    id: string;
+    properties: string[];
+    minMatches: number;
+    description?: string;
+    enabled: boolean;
+}
+export interface CSSReusablePattern {
+    id: string;
+    name: string;
+    requiredProperties: string[];
+    optionalProperties?: string[];
+    description?: string;
+    enabled: boolean;
+}
+export interface CSSUtilityMapping {
+    property: string;
+    valueMapper: (value: string) => string | null;
+    enabled: boolean;
+}
+export interface CSSPatternCatalog {
+    variablePatterns: CSSVariablePattern[];
+    globalPatterns: CSSGlobalPattern[];
+    reusablePatterns: CSSReusablePattern[];
+    utilityMappings: CSSUtilityMapping[];
+}
+export interface CSSAnalyzerOptions {
+    logger?: CSSAnalyzerLogger;
+    patternCatalog?: Partial<CSSPatternCatalog>;
+    enableMetrics?: boolean;
+    enableCaching?: boolean;
+    similarityThreshold?: number;
+}
+export declare class CSSAnalyzer {
+    private knownUtilityClasses;
+    private patternCatalog;
+    private _ruleIndex;
+    private _lastIndexedRules;
+    private similarityThreshold;
+    private enableCaching;
+    private logger;
+    private enableMetrics;
+    private cumulativeMetrics;
+    constructor(options?: CSSAnalyzerOptions);
+    /**
+     * Merge custom patterns with defaults
+     */
+    private mergePatternCatalog;
+    /**
+     * Add a custom variable pattern
+     */
+    addVariablePattern(pattern: CSSVariablePattern): void;
+    /**
+     * Add a custom global pattern
+     */
+    addGlobalPattern(pattern: CSSGlobalPattern): void;
+    /**
+     * Add a custom reusable pattern
+     */
+    addReusablePattern(pattern: CSSReusablePattern): void;
+    /**
+     * Add a custom utility mapping
+     */
+    addUtilityMapping(mapping: CSSUtilityMapping): void;
+    /**
+     * Enable or disable a pattern by ID
+     */
+    setPatternEnabled(patternId: string, enabled: boolean): boolean;
+    /**
+     * Get the current pattern catalog (for inspection/debugging)
+     */
+    getPatternCatalog(): CSSPatternCatalog;
+    /**
+     * Get cumulative metrics (Task #52)
+     */
+    getCumulativeMetrics(): {
+        totalAnalyses: number;
+        totalRulesAnalyzed: number;
+        totalDuplicatesFound: number;
+        totalSuggestionsMade: number;
+        totalCacheHits: number;
+        totalCacheMisses: number;
+        totalTimeMs: number;
+    };
+    /**
+     * Reset cumulative metrics (Task #52)
+     */
+    resetCumulativeMetrics(): void;
+    /**
+     * Main analysis entry point
+     */
+    analyze(context: CSSAnalysisContext): CSSAnalysisResult;
+    private countSuggestionsByType;
+    private countSuggestionsBySeverity;
+    /**
+     * Get or build index for existing rules (Task #51: caching for performance)
+     */
+    private getOrBuildIndex;
+    /**
+     * Compute a signature for CSS properties for fast comparison (Task #51)
+     */
+    private computePropertySignature;
+    /**
+     * Find duplicates with optimized O(1) hash lookup + O(k) similarity check (Task #51)
+     * where k is the number of rules with similar property counts/keys
+     */
+    private findDuplicatesOptimized;
+    /**
+     * Find removable candidates with optimized lookup (Task #51)
+     */
+    private findRemovableCandidatesOptimized;
+    /**
+     * Clear the rule index cache (call when rules change)
+     */
+    clearIndexCache(): void;
+    /**
+     * Find duplicate or similar CSS rules
+     * @deprecated Use findDuplicatesOptimized instead (Task #51)
+     * @internal Kept for backward compatibility - delegates to optimized version
+     */
+    findDuplicates(newRule: CSSRule, existingRules: CSSRule[]): {
+        duplicates: CSSRule[];
+        suggestions: CSSSuggestion[];
+    };
+    /**
+     * Check if CSS should be externalized
+     */
+    private checkExternalization;
+    /**
+     * Check if CSS should be made global (Task #44: uses pattern catalog)
+     */
+    private checkGlobalCandidate;
+    /**
+     * Check if a rule matches a reusable pattern from the catalog (Task #44)
+     */
+    private matchesReusablePattern;
+    /**
+     * Check for CSS variable candidates using design system tokens
+     */
+    private checkVariableCandidates;
+    /**
+     * Check for utility class opportunities (Task #44: uses pattern catalog)
+     */
+    private checkUtilityOpportunities;
+    /**
+     * Check CSS specificity issues
+     */
+    private checkSpecificity;
+    /**
+     * Check naming convention
+     */
+    private checkNamingConvention;
+    /**
+     * Find CSS rules that can be safely removed
+     * @deprecated Use findRemovableCandidatesOptimized instead (Task #51)
+     * @internal Kept for backward compatibility - delegates to optimized version
+     */
+    protected findRemovableCandidates(newRule: CSSRule, existingRules: CSSRule[]): CSSRule[];
+    /**
+     * Validate that a selector is well-formed and safe to process
+     */
+    private isValidSelector;
+    /**
+     * Normalize a selector for safe analysis by removing problematic content
+     */
+    private normalizeSelectorForAnalysis;
+    private generateRuleId;
+    private simpleHash;
+    private calculateSimilarity;
+    private calculateSpecificity;
+    /**
+     * Check if rule is a reusable pattern (Task #44: uses pattern catalog)
+     */
+    private isReusablePattern;
+    /**
+     * Check if rule is a typography rule (Task #44: uses pattern catalog)
+     * @internal Exposed for testing - now uses pattern catalog internally
+     */
+    protected isTypographyRule(rule: CSSRule): boolean;
+    /**
+     * Check if rule is a button pattern (Task #44: uses pattern catalog)
+     * @internal Exposed for testing - now uses pattern catalog internally
+     */
+    protected isButtonPattern(rule: CSSRule): boolean;
+    private generateExternalizeExample;
+    private getFontWeightName;
+    private suggestBEMName;
+    private completelyOverrides;
+    private isLikelyUnused;
+    private prioritizeSuggestions;
+    private generateSummary;
+    private initializeKnownPatterns;
+    /**
+     * Map pattern catalog variable types to design token categories
+     */
+    private mapTypeToTokenCategory;
+}
+export declare const cssAnalyzer: CSSAnalyzer;
+//# sourceMappingURL=CSSAnalyzer.d.ts.map

package/dist/analyzers/CSSAnalyzer.d.ts.map

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