@trentapps/manager-protocol 1.1.1

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,104 @@
+/**
+ * Enterprise Agent Supervisor - CSS Analyzer
+ *
+ * Analyzes CSS rules for optimization, deduplication, and best practices.
+ */
+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;
+}
+export declare class CSSAnalyzer {
+    private knownUtilityClasses;
+    constructor();
+    /**
+     * Main analysis entry point
+     */
+    analyze(context: CSSAnalysisContext): CSSAnalysisResult;
+    /**
+     * Find duplicate or similar CSS rules
+     */
+    private findDuplicates;
+    /**
+     * Check if CSS should be externalized
+     */
+    private checkExternalization;
+    /**
+     * Check if CSS should be made global
+     */
+    private checkGlobalCandidate;
+    /**
+     * Check for CSS variable candidates using design system tokens
+     */
+    private checkVariableCandidates;
+    /**
+     * Check for utility class opportunities
+     */
+    private checkUtilityOpportunities;
+    /**
+     * Check CSS specificity issues
+     */
+    private checkSpecificity;
+    /**
+     * Check naming convention
+     */
+    private checkNamingConvention;
+    /**
+     * Find CSS rules that can be safely removed
+     */
+    private findRemovableCandidates;
+    private generateRuleId;
+    private simpleHash;
+    private calculateSimilarity;
+    private calculateSpecificity;
+    private isReusablePattern;
+    private isTypographyRule;
+    private isButtonPattern;
+    private generateExternalizeExample;
+    private getFontWeightName;
+    private suggestBEMName;
+    private completelyOverrides;
+    private isLikelyUnused;
+    private prioritizeSuggestions;
+    private generateSummary;
+    private initializeKnownPatterns;
+    /**
+     * Map VARIABLE_CANDIDATES 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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"}