code-auditor-mcp 3.1.0 → 3.4.0

package/dist/styles/styleIndexer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Style indexer — Spec 10.
+ *
+ * Syncs style declarations, design tokens, and class usage to the SQLite
+ * style index. Uses content-hash-based change detection to avoid re-extracting
+ * unchanged files.
+ *
+ * Called from auditRunner.ts before the analyzer run, mirroring the function
+ * index sync pattern.
+ */
+import type Database from 'better-sqlite3';
+export interface StyleSyncResult {
+    /** Files whose declarations were added or updated. */
+    changed: number;
+    /** Files that were skipped (content hash unchanged). */
+    skipped: number;
+    /** Files whose declarations were removed (no longer on disk). */
+    removed: number;
+    /** Files that failed extraction. */
+    errors: number;
+}
+export interface StyleSyncOptions {
+    /** When true, only process the given files (scoped/diff audit). Default false. */
+    scoped?: boolean;
+}
+/**
+ * Sync the style index for the given files.
+ *
+ * - Extracts declarations, tokens, and class usage from each file.
+ * - Uses content hashes to skip unchanged files.
+ * - For scoped runs: deletes and re-inserts declarations for the given files.
+ * - For full runs: also removes stale entries for files no longer on disk.
+ */
+export declare function syncStyleIndex(rawDb: Database.Database, files: string[], projectRoot: string, options?: StyleSyncOptions): Promise<StyleSyncResult>;
+//# sourceMappingURL=styleIndexer.d.ts.map

package/dist/styles/styleIndexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleIndexer.d.ts","sourceRoot":"","sources":["../../src/styles/styleIndexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAe3C,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EACxB,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA2E1B"}

package/dist/styles/styleIndexer.js

@@ -0,0 +1,266 @@
+/**
+ * Style indexer — Spec 10.
+ *
+ * Syncs style declarations, design tokens, and class usage to the SQLite
+ * style index. Uses content-hash-based change detection to avoid re-extracting
+ * unchanged files.
+ *
+ * Called from auditRunner.ts before the analyzer run, mirroring the function
+ * index sync pattern.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { LanguageRegistry } from '../languages/LanguageRegistry.js';
+import { extractDeclarations, extractTokens } from './styleExtractor.js';
+import { loadTailwindConfig, tokensToStyleTokens } from './tailwindConfigLoader.js';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Sync the style index for the given files.
+ *
+ * - Extracts declarations, tokens, and class usage from each file.
+ * - Uses content hashes to skip unchanged files.
+ * - For scoped runs: deletes and re-inserts declarations for the given files.
+ * - For full runs: also removes stale entries for files no longer on disk.
+ */
+export async function syncStyleIndex(rawDb, files, projectRoot, options = {}) {
+    const result = { changed: 0, skipped: 0, removed: 0, errors: 0 };
+    const scoped = options.scoped ?? false;
+    // Load Tailwind config once for the project
+    const tailwindResult = loadTailwindConfig(projectRoot);
+    const tailwindTokens = tailwindResult.tokens;
+    // Get the language registry for adapters (needed by TS/JSX extraction)
+    let registry = null;
+    try {
+        registry = LanguageRegistry.getInstance();
+    }
+    catch {
+        // Registry not initialized — TS/JSX extraction will use source-only fallback
+    }
+    // Process each file
+    for (const filePath of files) {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const contentHash = computeFileHash(content);
+            // Check if file is already indexed and unchanged
+            if (!scoped) {
+                const existingHash = getStoredHash(rawDb, filePath);
+                if (existingHash === contentHash) {
+                    result.skipped++;
+                    continue;
+                }
+            }
+            // Delete old entries for this file (both scoped and full)
+            deleteFileEntries(rawDb, filePath);
+            // Extract declarations
+            const declarations = await extractForFile(filePath, content, registry, tailwindTokens);
+            // Insert declarations
+            if (declarations.length > 0) {
+                insertDeclarations(rawDb, filePath, declarations, contentHash);
+            }
+            // Extract and insert tokens (CSS custom properties)
+            const cssTokens = extractTokens(filePath, content);
+            if (cssTokens.length > 0) {
+                upsertTokens(rawDb, filePath, cssTokens);
+            }
+            // Extract and insert class usage
+            const classUsage = extractClassUsage(filePath, content);
+            if (classUsage.length > 0) {
+                upsertClassUsage(rawDb, filePath, classUsage);
+            }
+            result.changed++;
+        }
+        catch {
+            result.errors++;
+        }
+    }
+    // For full runs: remove stale entries for files not in the current set
+    if (!scoped) {
+        result.removed = removeStaleEntries(rawDb, files);
+    }
+    // Insert Tailwind theme tokens as style tokens
+    if (tailwindResult.source !== 'none' && result.changed > 0) {
+        const twTokens = tokensToStyleTokens(tailwindResult, projectRoot);
+        if (twTokens.length > 0) {
+            // Upsert each token individually (name is the unique key)
+            upsertTokens(rawDb, tailwindResult.configPath ?? 'tailwind-theme', twTokens);
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Extraction helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract declarations for a single file, dispatching to the appropriate
+ * extractor based on file extension.
+ */
+async function extractForFile(filePath, sourceCode, registry, tailwindTokens) {
+    const ext = filePath.includes('.') ? filePath.slice(filePath.lastIndexOf('.')) : '';
+    // CSS/SCSS can be extracted without an adapter
+    if (ext === '.css' || ext === '.scss') {
+        return extractDeclarations(filePath, null, sourceCode, undefined, tailwindTokens);
+    }
+    // TS/JS/TSX/JSX need a language adapter
+    if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
+        let adapter = null;
+        try {
+            if (registry) {
+                adapter = registry.getAdapterForFile(filePath);
+            }
+        }
+        catch {
+            // Adapter not available — skip extraction for this file
+        }
+        if (adapter) {
+            try {
+                const ast = await adapter.parse(filePath, sourceCode);
+                return extractDeclarations(filePath, adapter, sourceCode, ast, tailwindTokens);
+            }
+            catch {
+                // Parse error — skip
+            }
+        }
+        // Try extraction without AST (regex-only for class attributes)
+        return extractDeclarations(filePath, null, sourceCode, undefined, tailwindTokens);
+    }
+    // HTML/Vue/Svelte — extractor handles these with regex
+    if (['.html', '.vue', '.svelte'].includes(ext)) {
+        return extractDeclarations(filePath, null, sourceCode, undefined, tailwindTokens);
+    }
+    return [];
+}
+/**
+ * Extract class usage from a source file.
+ * Looks for className="..." attributes in JSX and class="..." in HTML.
+ */
+function extractClassUsage(filePath, sourceCode) {
+    const usage = [];
+    const ext = filePath.includes('.') ? filePath.slice(filePath.lastIndexOf('.')) : '';
+    // Determine mechanism by file type
+    let mechanism = 'class';
+    if (['.tsx', '.jsx', '.ts', '.js'].includes(ext)) {
+        mechanism = 'className';
+    }
+    // Match className="..." or class="..."
+    const attrRegex = /(?:className|class)\s*=\s*(?:"([^"]*)"|'([^']*)'|\{(["'`])((?:(?!\3).)*)\3\})/g;
+    let match;
+    while ((match = attrRegex.exec(sourceCode)) !== null) {
+        const value = match[1] ?? match[2] ?? match[4] ?? '';
+        const line = sourceCode.slice(0, match.index).split('\n').length;
+        const classes = value.split(/\s+/).filter(Boolean);
+        // Determine if unresolvable (dynamic expressions like clsx, template literals)
+        const isDynamic = !!(match[4] ?? match[3]);
+        const hasDynamicParts = isDynamic && /[\${}]/.test(value);
+        for (const className of classes) {
+            // Skip obvious static utility fragments from dynamic expressions
+            if (!className || className.length === 0)
+                continue;
+            usage.push({
+                className: className.trim(),
+                filePath,
+                line,
+                mechanism,
+                unresolvable: hasDynamicParts,
+            });
+        }
+    }
+    return usage;
+}
+// ---------------------------------------------------------------------------
+// Database helpers
+// ---------------------------------------------------------------------------
+function computeFileHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+function getStoredHash(rawDb, filePath) {
+    const row = rawDb.prepare('SELECT content_hash FROM style_declarations WHERE file_path = ? LIMIT 1').get(filePath);
+    return row?.content_hash ?? null;
+}
+function deleteFileEntries(rawDb, filePath) {
+    rawDb.prepare('DELETE FROM style_declarations WHERE file_path = ?').run(filePath);
+    rawDb.prepare('DELETE FROM style_class_usage WHERE file_path = ?').run(filePath);
+}
+function removeStaleEntries(rawDb, currentFiles) {
+    const filesSet = new Set(currentFiles);
+    const allIndexed = rawDb.prepare('SELECT DISTINCT file_path FROM style_declarations').all();
+    let removed = 0;
+    for (const { file_path } of allIndexed) {
+        if (!filesSet.has(file_path)) {
+            rawDb.prepare('DELETE FROM style_declarations WHERE file_path = ?').run(file_path);
+            rawDb.prepare('DELETE FROM style_class_usage WHERE file_path = ?').run(file_path);
+            removed++;
+        }
+    }
+    return removed;
+}
+function insertDeclarations(rawDb, filePath, declarations, contentHash) {
+    const insert = rawDb.prepare(`
+    INSERT INTO style_declarations
+      (property, raw_value, normalized_value, mechanism, file_path, line,
+       context, variant_context, token_ref, content_hash)
+    VALUES
+      (@property, @rawValue, @normalizedValue, @mechanism, @filePath, @line,
+       @context, @variantContext, @tokenRef, @contentHash)
+  `);
+    const txn = rawDb.transaction(() => {
+        for (const d of declarations) {
+            insert.run({
+                property: d.property,
+                rawValue: d.rawValue,
+                normalizedValue: d.normalizedValue ? JSON.stringify(d.normalizedValue) : null,
+                mechanism: d.mechanism,
+                filePath: d.filePath,
+                line: d.line,
+                context: d.context ?? null,
+                variantContext: d.variantContext ?? null,
+                tokenRef: d.tokenRef ?? null,
+                contentHash,
+            });
+        }
+    });
+    txn();
+}
+function upsertTokens(rawDb, filePath, tokens) {
+    // Delete existing tokens from this file first, then insert fresh
+    rawDb.prepare('DELETE FROM style_tokens WHERE file_path = ?').run(filePath);
+    const insert = rawDb.prepare(`
+    INSERT INTO style_tokens (name, value, file_path, mechanism)
+    VALUES (@name, @value, @filePath, @mechanism)
+  `);
+    const txn = rawDb.transaction(() => {
+        for (const token of tokens) {
+            insert.run({
+                name: token.name,
+                value: token.value,
+                filePath: token.filePath,
+                mechanism: token.mechanism,
+            });
+        }
+    });
+    txn();
+}
+function upsertClassUsage(rawDb, filePath, usage) {
+    // Delete existing class usage for this file first
+    rawDb.prepare('DELETE FROM style_class_usage WHERE file_path = ?').run(filePath);
+    const insert = rawDb.prepare(`
+    INSERT INTO style_class_usage
+      (class_name, file_path, line, mechanism, unresolvable)
+    VALUES
+      (@className, @filePath, @line, @mechanism, @unresolvable)
+  `);
+    const txn = rawDb.transaction(() => {
+        for (const u of usage) {
+            insert.run({
+                className: u.className,
+                filePath: u.filePath,
+                line: u.line,
+                mechanism: u.mechanism,
+                unresolvable: u.unresolvable ? 1 : 0,
+            });
+        }
+    });
+    txn();
+}
+//# sourceMappingURL=styleIndexer.js.map

package/dist/styles/styleIndexer.js.map

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

package/dist/styles/tailwindConfigLoader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tailwind config loader — Spec 10.
+ *
+ * Loads a project's Tailwind configuration to resolve design tokens
+ * (colors, spacing, font sizes, etc.) for utility expansion.
+ *
+ * Three-tier resolution:
+ *   1. Tailwind v3 JS config (tailwind.config.js / tailwind.config.ts)
+ *   2. Tailwind v4 CSS config (@theme blocks in CSS files)
+ *   3. Bundled default design tokens (Tailwind v4 defaults)
+ *
+ * Falls back gracefully — no config means we use defaults only.
+ */
+import type { StyleToken } from './types.js';
+/** Raw tailwind theme tokens extracted from config. */
+export interface TailwindThemeTokens {
+    colors: Record<string, string>;
+    spacing: Record<string, string>;
+    fontSize: Record<string, string>;
+    borderRadius: Record<string, string>;
+}
+/** Config file discovery result. */
+export interface TailwindConfigResult {
+    tokens: TailwindThemeTokens;
+    /** How the config was resolved. */
+    source: 'v3-js' | 'v4-css' | 'defaults' | 'none';
+    configPath: string | null;
+}
+/**
+ * Load Tailwind config tokens from a project root.
+ * Returns default tokens if no config is found — this is always graceful.
+ */
+export declare function loadTailwindConfig(projectRoot: string): TailwindConfigResult;
+/**
+ * Get the tokens as StyleToken[] for storage in the style index.
+ */
+export declare function tokensToStyleTokens(result: TailwindConfigResult, projectRoot: string): StyleToken[];
+//# sourceMappingURL=tailwindConfigLoader.d.ts.map

package/dist/styles/tailwindConfigLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwindConfigLoader.d.ts","sourceRoot":"","sources":["../../src/styles/tailwindConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mCAAmC;IACnC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAsBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAe5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,MAAM,GAClB,UAAU,EAAE,CAyCd"}