cmp-standards 2.7.0 → 2.8.0

package/dist/patterns/registry.js

@@ -0,0 +1,442 @@
+/**
+ * @file Unified Pattern Registry
+ * @description Single source of truth for all pattern definitions
+ * @version 2.8.0
+ *
+ * Combines functionality from:
+ * - auto-improve/pattern-detector.ts
+ * - services/pattern-tracker.ts
+ */
+import { z } from 'zod';
+// =============================================================================
+// Schema
+// =============================================================================
+export const PatternSeveritySchema = z.enum(['critical', 'high', 'medium', 'low']);
+export const PatternStatusSchema = z.enum(['active', 'triggered', 'implemented', 'retired']);
+export const UnifiedPatternSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    severity: PatternSeveritySchema,
+    // Detection
+    regex: z.string().optional(),
+    filePatterns: z.array(z.string()).optional(),
+    excludePatterns: z.array(z.string()).optional(),
+    // ESLint integration
+    eslintRuleName: z.string().optional(),
+    astVisitorTemplate: z.string().optional(),
+    // Lifecycle
+    status: PatternStatusSchema.default('active'),
+    triggeredAt: z.string().optional(),
+    implementedAt: z.string().optional(),
+    retiredAt: z.string().optional(),
+    retiredReason: z.string().optional(),
+    // Learning feedback
+    threshold: z.number().default(3),
+    falsePositives: z.number().default(0),
+    confirmedViolations: z.number().default(0),
+    adjustedThreshold: z.number().optional(),
+    // Metadata
+    createdAt: z.string().optional(),
+    updatedAt: z.string().optional(),
+    createdBy: z.string().optional(),
+});
+// =============================================================================
+// Built-in Patterns
+// =============================================================================
+export const BUILTIN_PATTERNS = [
+    {
+        id: 'any-type',
+        name: 'Any Type Usage',
+        description: 'Using TypeScript any type instead of proper typing',
+        severity: 'high',
+        regex: ':\\s*any\\b|as\\s+any\\b',
+        filePatterns: ['*.ts', '*.tsx'],
+        excludePatterns: ['*.test.ts', '*.spec.ts'],
+        eslintRuleName: 'charter/no-any-type',
+        astVisitorTemplate: `return {
+      TSAnyKeyword(node) {
+        context.report({ node, messageId: 'violation' });
+      }
+    };`,
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'console-log',
+        name: 'Console Log in Production',
+        description: 'Console.log statements left in production code',
+        severity: 'medium',
+        regex: 'console\\.log\\(',
+        filePatterns: ['*.ts', '*.tsx', '*.js', '*.jsx'],
+        excludePatterns: ['*.test.ts', '*.spec.ts', '*.test.js'],
+        eslintRuleName: 'no-console',
+        astVisitorTemplate: `return {
+      CallExpression(node) {
+        if (node.callee.type === 'MemberExpression' &&
+            node.callee.object.name === 'console' &&
+            node.callee.property.name === 'log') {
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'eslint-disable',
+        name: 'ESLint Disable Comment',
+        description: 'ESLint disable comments hiding issues',
+        severity: 'high',
+        regex: 'eslint-disable',
+        filePatterns: ['*.ts', '*.tsx', '*.js', '*.jsx'],
+        eslintRuleName: 'charter/no-eslint-disable',
+        astVisitorTemplate: `const sourceCode = context.getSourceCode();
+    return {
+      Program() {
+        const comments = sourceCode.getAllComments();
+        for (const comment of comments) {
+          if (comment.value.includes('eslint-disable')) {
+            context.report({ loc: comment.loc, messageId: 'violation' });
+          }
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'raw-sql',
+        name: 'Raw SQL Query',
+        description: 'Raw SQL query instead of query builder',
+        severity: 'critical',
+        regex: 'db\\.execute\\([\'"`]|\\$\\{.*\\}.*SELECT|\\$\\{.*\\}.*INSERT',
+        filePatterns: ['*.ts'],
+        excludePatterns: ['**/migrations/**', '**/db/**'],
+        eslintRuleName: 'charter/no-raw-sql',
+        astVisitorTemplate: `return {
+      CallExpression(node) {
+        if (node.callee.type === 'MemberExpression' &&
+            node.callee.property.name === 'execute' &&
+            node.arguments[0]?.type === 'TemplateLiteral') {
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 2,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'missing-zod',
+        name: 'Missing Zod Validation',
+        description: 'TRPC endpoint without Zod input validation',
+        severity: 'high',
+        regex: 'publicProcedure\\.mutation\\(async\\s*\\(\\{\\s*input',
+        filePatterns: ['*.ts'],
+        excludePatterns: [],
+        eslintRuleName: 'charter/require-zod-validation',
+        astVisitorTemplate: `return {
+      CallExpression(node) {
+        // Check for publicProcedure.mutation without .input()
+        if (node.callee.type === 'MemberExpression' &&
+            node.callee.property.name === 'mutation') {
+          // Implementation details
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'async-useeffect',
+        name: 'Async UseEffect',
+        description: 'Async function directly in useEffect',
+        severity: 'medium',
+        regex: 'useEffect\\(async',
+        filePatterns: ['*.tsx', '*.jsx'],
+        eslintRuleName: 'charter/no-async-useeffect',
+        astVisitorTemplate: `return {
+      CallExpression(node) {
+        if (node.callee.type === 'Identifier' &&
+            node.callee.name === 'useEffect' &&
+            node.arguments[0]?.async) {
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'hardcoded-color',
+        name: 'Hardcoded Color',
+        description: 'Hardcoded color value instead of semantic token',
+        severity: 'low',
+        regex: '#[0-9a-fA-F]{3,8}',
+        filePatterns: ['*.tsx', '*.jsx', '*.css'],
+        excludePatterns: ['**/tailwind.config.*'],
+        eslintRuleName: 'charter/use-semantic-tokens',
+        astVisitorTemplate: `return {
+      Literal(node) {
+        if (typeof node.value === 'string' && /#[0-9a-fA-F]{3,8}/.test(node.value)) {
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 5,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'finance-no-ledger',
+        name: 'Finance Without Ledger',
+        description: 'Finance table insert without LedgerService.createEntry()',
+        severity: 'critical',
+        regex: 'insert\\(finance\\)(?!.*LedgerService)',
+        filePatterns: ['*.ts'],
+        eslintRuleName: 'charter/finance-ledger-sync',
+        astVisitorTemplate: `let hasFinanceInsert = false;
+    let hasLedgerCall = false;
+    return {
+      CallExpression(node) {
+        const callee = node.callee;
+        if (callee.property?.name === 'insert') hasFinanceInsert = true;
+        if (callee.object?.name === 'LedgerService') hasLedgerCall = true;
+      },
+      'Program:exit'(node) {
+        if (hasFinanceInsert && !hasLedgerCall) {
+          context.report({ node, messageId: 'violation' });
+        }
+      }
+    };`,
+        status: 'active',
+        threshold: 1,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+    {
+        id: 'sequential-api-calls',
+        name: 'Sequential API Calls',
+        description: 'Sequential API calls that could be parallelized',
+        severity: 'medium',
+        regex: 'await.*\\n\\s*await',
+        filePatterns: ['*.ts', '*.tsx'],
+        eslintRuleName: 'charter/no-sequential-api-calls',
+        status: 'active',
+        threshold: 3,
+        falsePositives: 0,
+        confirmedViolations: 0,
+    },
+];
+// =============================================================================
+// Registry Class
+// =============================================================================
+export class PatternRegistry {
+    patterns;
+    customPatterns = [];
+    constructor() {
+        this.patterns = new Map();
+        // Load builtin patterns
+        for (const pattern of BUILTIN_PATTERNS) {
+            this.patterns.set(pattern.id, { ...pattern });
+        }
+    }
+    /**
+     * Get pattern by ID
+     */
+    get(patternId) {
+        return this.patterns.get(patternId);
+    }
+    /**
+     * Get all patterns
+     */
+    getAll() {
+        return Array.from(this.patterns.values());
+    }
+    /**
+     * Get active patterns
+     */
+    getActive() {
+        return this.getAll().filter(p => p.status === 'active');
+    }
+    /**
+     * Get patterns by severity
+     */
+    getBySeverity(severity) {
+        return this.getAll().filter(p => p.severity === severity);
+    }
+    /**
+     * Register custom pattern
+     */
+    register(pattern) {
+        const validated = UnifiedPatternSchema.parse(pattern);
+        this.patterns.set(validated.id, validated);
+        this.customPatterns.push(validated);
+    }
+    /**
+     * Update pattern status
+     */
+    updateStatus(patternId, status, reason) {
+        const pattern = this.patterns.get(patternId);
+        if (!pattern)
+            return;
+        pattern.status = status;
+        pattern.updatedAt = new Date().toISOString();
+        if (status === 'triggered') {
+            pattern.triggeredAt = pattern.updatedAt;
+        }
+        else if (status === 'implemented') {
+            pattern.implementedAt = pattern.updatedAt;
+        }
+        else if (status === 'retired') {
+            pattern.retiredAt = pattern.updatedAt;
+            pattern.retiredReason = reason;
+        }
+    }
+    /**
+     * Record feedback (adjust learning)
+     */
+    recordFeedback(patternId, type) {
+        const pattern = this.patterns.get(patternId);
+        if (!pattern)
+            return;
+        if (type === 'confirmed') {
+            pattern.confirmedViolations++;
+        }
+        else {
+            pattern.falsePositives++;
+            // Adjust threshold if too many false positives
+            if (pattern.falsePositives >= 3 && !pattern.adjustedThreshold) {
+                pattern.adjustedThreshold = pattern.threshold + 2;
+                console.log(`[PatternRegistry] Adjusted threshold for ${patternId}: ${pattern.threshold} -> ${pattern.adjustedThreshold}`);
+            }
+        }
+        pattern.updatedAt = new Date().toISOString();
+    }
+    /**
+     * Get effective threshold for a pattern
+     */
+    getEffectiveThreshold(patternId) {
+        const pattern = this.patterns.get(patternId);
+        if (!pattern)
+            return 3;
+        return pattern.adjustedThreshold ?? pattern.threshold;
+    }
+    /**
+     * Detect pattern in content
+     */
+    detect(content, filePath) {
+        const results = [];
+        for (const pattern of this.getActive()) {
+            // Check file patterns
+            if (pattern.filePatterns) {
+                const matchesFile = pattern.filePatterns.some(fp => {
+                    const regex = new RegExp(fp.replace('*', '.*'));
+                    return regex.test(filePath);
+                });
+                if (!matchesFile)
+                    continue;
+            }
+            // Check exclude patterns
+            if (pattern.excludePatterns) {
+                const excluded = pattern.excludePatterns.some(ep => {
+                    const regex = new RegExp(ep.replace('*', '.*').replace('**/', '.*'));
+                    return regex.test(filePath);
+                });
+                if (excluded)
+                    continue;
+            }
+            // Detect with regex
+            if (pattern.regex) {
+                const regex = new RegExp(pattern.regex, 'gm');
+                const matches = [...content.matchAll(regex)];
+                if (matches.length > 0) {
+                    results.push({ pattern, matches });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Generate ESLint rule code for a pattern
+     */
+    generateEslintRule(patternId) {
+        const pattern = this.patterns.get(patternId);
+        if (!pattern || !pattern.eslintRuleName || !pattern.astVisitorTemplate) {
+            return null;
+        }
+        return `/**
+ * @file ${pattern.eslintRuleName}
+ * @description ${pattern.description}
+ * Auto-generated by cmp-standards pattern detection
+ * @version 1.0.0
+ */
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '${pattern.description}',
+      category: 'Best Practices',
+      recommended: true
+    },
+    schema: [],
+    messages: {
+      violation: '${pattern.description}'
+    }
+  },
+  create(context) {
+    ${pattern.astVisitorTemplate}
+  }
+}
+`;
+    }
+    /**
+     * Export all patterns for persistence
+     */
+    export() {
+        return this.getAll();
+    }
+    /**
+     * Import patterns from persistence
+     */
+    import(patterns) {
+        for (const pattern of patterns) {
+            try {
+                const validated = UnifiedPatternSchema.parse(pattern);
+                this.patterns.set(validated.id, validated);
+            }
+            catch (error) {
+                console.warn(`[PatternRegistry] Invalid pattern skipped: ${pattern.id}`, error);
+            }
+        }
+    }
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let registryInstance = null;
+export function getPatternRegistry() {
+    if (!registryInstance) {
+        registryInstance = new PatternRegistry();
+    }
+    return registryInstance;
+}
+export function resetPatternRegistry() {
+    registryInstance = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/patterns/registry.js.map

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

package/dist/performance/Debouncer.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @file Debouncer - Hook debouncing for performance optimization
+ * @description Prevents redundant operations by tracking recent calls
+ *
+ * Features:
+ * - Time-based debouncing (skip if same operation within window)
+ * - Hash-based key generation
+ * - Auto-cleanup of expired entries
+ * - Statistics tracking
+ */
+export interface DebouncerConfig {
+    /** Debounce window in milliseconds */
+    windowMs: number;
+    /** Max entries to track (memory limit) */
+    maxEntries: number;
+    /** Enable debug logging */
+    debug: boolean;
+}
+export interface DebouncerStats {
+    totalCalls: number;
+    skipped: number;
+    executed: number;
+    skipRate: number;
+    activeEntries: number;
+}
+export declare class Debouncer {
+    private config;
+    private entries;
+    private stats;
+    constructor(config?: Partial<DebouncerConfig>);
+    /**
+     * Check if operation should be skipped
+     * Returns true if same operation was called within debounce window
+     */
+    shouldSkip(key: string): boolean;
+    /**
+     * Generate hash key from tool name and params
+     */
+    createKey(toolName: string, params: Record<string, unknown>): string;
+    /**
+     * Check if tool call should skip embedding lookup
+     */
+    shouldSkipEmbedding(toolName: string, params: Record<string, unknown>): boolean;
+    /**
+     * Check if expert review should be skipped
+     */
+    shouldSkipReview(files: string[]): boolean;
+    /**
+     * Mark operation as complete (update timestamp)
+     */
+    markComplete(key: string): void;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get statistics
+     */
+    getStats(): DebouncerStats;
+    /**
+     * Reset all state
+     */
+    reset(): void;
+    /**
+     * Get config
+     */
+    getConfig(): DebouncerConfig;
+    /**
+     * Update config
+     */
+    setConfig(config: Partial<DebouncerConfig>): void;
+}
+/**
+ * Debouncer for embedding lookups
+ */
+export declare class EmbeddingDebouncer extends Debouncer {
+    constructor(config?: Partial<DebouncerConfig>);
+    shouldSkipLookup(text: string): boolean;
+}
+/**
+ * Debouncer for hook operations
+ */
+export declare class HookDebouncer extends Debouncer {
+    constructor(config?: Partial<DebouncerConfig>);
+    shouldSkipHook(hookName: string, context: Record<string, unknown>): boolean;
+}
+export declare function getDebouncer(config?: Partial<DebouncerConfig>): Debouncer;
+export declare function getEmbeddingDebouncer(config?: Partial<DebouncerConfig>): EmbeddingDebouncer;
+export declare function getHookDebouncer(config?: Partial<DebouncerConfig>): HookDebouncer;
+export declare function resetDebouncers(): void;
+//# sourceMappingURL=Debouncer.d.ts.map

package/dist/performance/Debouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Debouncer.d.ts","sourceRoot":"","sources":["../../src/performance/Debouncer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAiBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAGZ;gBAEW,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAIjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IA4BhC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAMpE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAK/E;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;IAM1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAY1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGlD;AAMD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIxC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAI5E;AAUD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAKzE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAK3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,aAAa,CAKjF;AAED,wBAAgB,eAAe,IAAI,IAAI,CAItC"}