@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/mcp/src/servers/stripe.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env tsx
+/**
+ * Stripe MCP Server Launcher
+ *
+ * Starts the Stripe MCP server for AI-powered payment management.
+ *
+ * Usage:
+ *   pnpm mcp:stripe
+ */
+import { spawn } from 'node:child_process';
+import { createLogger, getProjectRoot } from '@revealui/scripts';
+import { ErrorCode } from '@revealui/scripts/errors';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+const logger = createLogger();
+// Load environment variables
+config();
+const MAX_RESTARTS = 3;
+const RESTART_DELAYS_MS = [2000, 4000, 8000];
+async function spawnStripe(stripeSecretKey) {
+    return new Promise((resolve) => {
+        const child = spawn('pnpm', ['dlx', '@stripe/mcp', '--tools=all'], {
+            stdio: 'inherit',
+            env: { ...process.env, STRIPE_SECRET_KEY: stripeSecretKey },
+        });
+        child.on('error', (error) => {
+            logger.error(`Failed to start Stripe MCP server: ${error.message}`);
+            resolve(ErrorCode.CONFIG_ERROR);
+        });
+        child.on('exit', (code) => resolve(code ?? 0));
+        process.on('SIGINT', () => {
+            child.kill('SIGINT');
+        });
+        process.on('SIGTERM', () => {
+            child.kill('SIGTERM');
+        });
+    });
+}
+async function startStripeMCP() {
+    try {
+        await getProjectRoot(import.meta.url);
+        const stripeSecretKey = process.env.STRIPE_SECRET_KEY;
+        if (!stripeSecretKey) {
+            logger.error('STRIPE_SECRET_KEY environment variable is required');
+            logger.info('   Get your key from: https://dashboard.stripe.com/apikeys');
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        const withRestart = process.argv.includes('--restart');
+        logger.header('Starting Stripe MCP Server');
+        logger.info(`   Secret Key: ${stripeSecretKey.substring(0, 12)}...`);
+        if (withRestart)
+            logger.info('   Restart mode: enabled (up to 3 attempts)');
+        let attempt = 0;
+        while (true) {
+            const code = await spawnStripe(stripeSecretKey);
+            if (!withRestart || attempt >= MAX_RESTARTS) {
+                process.exit(code ?? 0);
+            }
+            const delay = RESTART_DELAYS_MS[attempt] ?? 8000;
+            attempt++;
+            logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+/**
+ * Main function
+ */
+async function main() {
+    try {
+        if (!(await checkMcpLicense())) {
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        await startStripeMCP();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=stripe.js.map

package/dist/packages/mcp/src/servers/stripe.js.map

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

package/dist/packages/mcp/src/servers/supabase.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env tsx
+/**
+ * Supabase MCP Server Launcher
+ *
+ * Starts the Supabase MCP server for AI-powered database management.
+ *
+ * Usage:
+ *   pnpm mcp:supabase
+ */
+export {};
+//# sourceMappingURL=supabase.d.ts.map

package/dist/packages/mcp/src/servers/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../../../../src/servers/supabase.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/packages/mcp/src/servers/supabase.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env tsx
+/**
+ * Supabase MCP Server Launcher
+ *
+ * Starts the Supabase MCP server for AI-powered database management.
+ *
+ * Usage:
+ *   pnpm mcp:supabase
+ */
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { createLogger, getProjectRoot } from '@revealui/scripts';
+import { ErrorCode } from '@revealui/scripts/errors';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+const logger = createLogger();
+// Load environment variables
+config();
+async function startSupabaseMCP() {
+    try {
+        await getProjectRoot(import.meta.url);
+        // Supabase MCP uses local package supabase-mcp
+        // Verified: Package expects SUPABASE_URL, SUPABASE_ANON_KEY, and SUPABASE_SERVICE_ROLE_KEY
+        // Source: node_modules/supabase-mcp/dist/esm/config.js and services/supabase.js
+        //
+        // NEW API KEY SUPPORT (2025):
+        // Supabase introduced new API keys: sb_publishable_... (replaces anon) and sb_secret_... (replaces service_role)
+        // Legacy keys (anon/service_role JWT) still work but will be deprecated in Nov 2025
+        // The @supabase/supabase-js client accepts any key format, so we support both
+        // Reference: https://github.com/orgs/supabase/discussions/29260
+        const supabaseUrl = process.env.SUPABASE_URL;
+        // Support both legacy and new API key formats
+        // New format: SUPABASE_PUBLISHABLE_KEY (sb_publishable_...) or SUPABASE_ANON_KEY (legacy)
+        // New format: SUPABASE_SECRET_KEY (sb_secret_...) or SUPABASE_SERVICE_ROLE_KEY (legacy)
+        const supabaseAnonKey = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_ANON_KEY;
+        const supabaseServiceRoleKey = process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY;
+        if (!supabaseUrl) {
+            logger.error('SUPABASE_URL is required');
+            logger.info('   Get your credentials from: https://supabase.com/dashboard → Settings → API');
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        if (!supabaseAnonKey) {
+            logger.error('SUPABASE_ANON_KEY or SUPABASE_PUBLISHABLE_KEY is required');
+            logger.info('   Legacy: SUPABASE_ANON_KEY (anon JWT key)');
+            logger.info('   New: SUPABASE_PUBLISHABLE_KEY (sb_publishable_... key)');
+            logger.info('   Get from: https://supabase.com/dashboard → Settings → API');
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        if (!supabaseServiceRoleKey) {
+            logger.error('SUPABASE_SERVICE_ROLE_KEY or SUPABASE_SECRET_KEY is required');
+            logger.info('   Legacy: SUPABASE_SERVICE_ROLE_KEY (service_role JWT key)');
+            logger.info('   New: SUPABASE_SECRET_KEY (sb_secret_... key)');
+            logger.info('   Note: Required for MCP server operations (full database access)');
+            logger.info('   Get from: https://supabase.com/dashboard → Settings → API');
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        // MCP_API_KEY is required by supabase-mcp package for server authentication
+        // This is NOT a Supabase key - it's a key you generate yourself to secure the MCP server
+        let mcpApiKey = process.env.MCP_API_KEY;
+        if (!mcpApiKey) {
+            // Auto-generate a secure random key if not provided
+            mcpApiKey = randomBytes(32).toString('hex');
+            logger.warning('⚠️  MCP_API_KEY not set - auto-generated a secure key');
+            logger.warning('   Add this to your .env file to persist it:');
+            logger.warning(`   MCP_API_KEY=${mcpApiKey}`);
+            logger.warning('   (This key secures your MCP server endpoint)');
+        }
+        const withRestart = process.argv.includes('--restart');
+        logger.header('Starting Supabase MCP Server (Local)');
+        logger.info(`   Supabase URL: ${supabaseUrl}`);
+        if (withRestart)
+            logger.info('   Restart mode: enabled (up to 3 attempts)');
+        // Detect key format for logging
+        const usingNewKeys = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_SECRET_KEY;
+        if (usingNewKeys) {
+            logger.info('   Using new API key format (sb_publishable_/sb_secret_)');
+        }
+        else {
+            logger.info('   Using legacy API key format (anon/service_role JWT)');
+            logger.warning('   ⚠️  Consider migrating to new keys before Nov 2025');
+            logger.info('   See: https://github.com/orgs/supabase/discussions/29260');
+        }
+        // Build env once — used for all spawn attempts
+        // Package validates: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, MCP_API_KEY
+        // We map new keys to legacy variable names for package compatibility
+        const spawnEnv = {
+            ...process.env,
+            SUPABASE_URL: supabaseUrl,
+            SUPABASE_ANON_KEY: supabaseAnonKey,
+            SUPABASE_SERVICE_ROLE_KEY: supabaseServiceRoleKey,
+            MCP_API_KEY: mcpApiKey,
+            SUPABASE_PUBLISHABLE_KEY: process.env.SUPABASE_PUBLISHABLE_KEY,
+            SUPABASE_SECRET_KEY: process.env.SUPABASE_SECRET_KEY,
+        };
+        const MaxRestarts = 3;
+        const RestartDelaysMs = [2000, 4000, 8000];
+        const spawnSupabase = () => new Promise((resolve) => {
+            const child = spawn('pnpm', ['dlx', 'supabase-mcp'], { stdio: 'inherit', env: spawnEnv });
+            child.on('error', (error) => {
+                logger.error(`Failed to start Supabase MCP server: ${error.message}`);
+                resolve(ErrorCode.CONFIG_ERROR);
+            });
+            child.on('exit', (code) => resolve(code ?? 0));
+            process.on('SIGINT', () => {
+                child.kill('SIGINT');
+            });
+            process.on('SIGTERM', () => {
+                child.kill('SIGTERM');
+            });
+        });
+        let attempt = 0;
+        while (true) {
+            const code = await spawnSupabase();
+            if (!withRestart || attempt >= MaxRestarts) {
+                process.exit(code ?? 0);
+            }
+            const delay = RestartDelaysMs[attempt] ?? 8000;
+            attempt++;
+            logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MaxRestarts})...`);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+/**
+ * Main function
+ */
+async function main() {
+    try {
+        if (!(await checkMcpLicense())) {
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        await startSupabaseMCP();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=supabase.js.map

package/dist/packages/mcp/src/servers/supabase.js.map

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

package/dist/packages/mcp/src/servers/vercel.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env tsx
+/**
+ * Vercel MCP Server Launcher
+ *
+ * Starts the Vercel MCP server for AI-powered Vercel management.
+ *
+ * Usage:
+ *   pnpm mcp:vercel
+ */
+export {};
+//# sourceMappingURL=vercel.d.ts.map

package/dist/packages/mcp/src/servers/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../../../src/servers/vercel.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/packages/mcp/src/servers/vercel.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env tsx
+/**
+ * Vercel MCP Server Launcher
+ *
+ * Starts the Vercel MCP server for AI-powered Vercel management.
+ *
+ * Usage:
+ *   pnpm mcp:vercel
+ */
+import { spawn } from 'node:child_process';
+import { createLogger, getProjectRoot } from '@revealui/scripts';
+import { ErrorCode } from '@revealui/scripts/errors';
+import { config } from 'dotenv';
+import { checkMcpLicense } from '../index.js';
+const logger = createLogger();
+// Load environment variables
+config();
+const MAX_RESTARTS = 3;
+const RESTART_DELAYS_MS = [2000, 4000, 8000];
+async function spawnVercel(vercelApiKey) {
+    return new Promise((resolve) => {
+        // Pass credentials via environment only — never as CLI arguments (visible in ps aux).
+        const child = spawn('pnpm', ['exec', 'vercel-mcp'], {
+            stdio: 'inherit',
+            env: { ...process.env, VERCEL_API_KEY: vercelApiKey },
+        });
+        child.on('error', (error) => {
+            logger.error(`Failed to start Vercel MCP server: ${error.message}`);
+            resolve(ErrorCode.CONFIG_ERROR);
+        });
+        child.on('exit', (code) => resolve(code ?? 0));
+        process.on('SIGINT', () => {
+            child.kill('SIGINT');
+        });
+        process.on('SIGTERM', () => {
+            child.kill('SIGTERM');
+        });
+    });
+}
+async function startVercelMCP() {
+    try {
+        await getProjectRoot(import.meta.url);
+        const vercelApiKey = process.env.VERCEL_API_KEY ?? process.env.VERCEL_TOKEN;
+        if (!vercelApiKey) {
+            logger.error('VERCEL_API_KEY environment variable is required');
+            logger.info('   Get your token from: https://vercel.com/account/tokens');
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        const withRestart = process.argv.includes('--restart');
+        logger.header('Starting Vercel MCP Server');
+        logger.info(`   API Key: ${vercelApiKey.substring(0, 8)}...`);
+        if (withRestart)
+            logger.info('   Restart mode: enabled (up to 3 attempts)');
+        let attempt = 0;
+        while (true) {
+            const code = await spawnVercel(vercelApiKey);
+            if (!withRestart || attempt >= MAX_RESTARTS) {
+                process.exit(code ?? 0);
+            }
+            const delay = RESTART_DELAYS_MS[attempt] ?? 8000;
+            attempt++;
+            logger.warning(`   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+/**
+ * Main function
+ */
+async function main() {
+    try {
+        if (!(await checkMcpLicense())) {
+            process.exit(ErrorCode.CONFIG_ERROR);
+        }
+        await startVercelMCP();
+    }
+    catch (error) {
+        logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(ErrorCode.EXECUTION_ERROR);
+    }
+}
+main();
+//# sourceMappingURL=vercel.js.map

package/dist/packages/mcp/src/servers/vercel.js.map

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

package/dist/packages/mcp/src/servers/vultr-test.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=vultr-test.d.ts.map

package/dist/packages/mcp/src/servers/vultr-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vultr-test.d.ts","sourceRoot":"","sources":["../../../../../src/servers/vultr-test.ts"],"names":[],"mappings":""}

package/dist/packages/mcp/src/servers/vultr-test.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// Demo script to exercise Vultr Inference (chat + embeddings)
+// Usage:
+// Use ts-node or compile to JS. Example with ts-node:
+// VULTR_API_KEY=your_key VULTR_MODEL=your-model-id ts-node packages/ai/scripts/test-vultr.ts
+import { logger } from '@revealui/core/observability/logger';
+import { checkMcpLicense } from '../index.js';
+const KEY = process.env.VULTR_API_KEY;
+const MODEL = process.env.VULTR_MODEL;
+const BASE = process.env.VULTR_BASE_URL || 'https://api.vultrinference.com/v1';
+if (!(KEY && MODEL)) {
+    logger.error('Missing VULTR_API_KEY or VULTR_MODEL environment variables', new Error('Missing required environment variables'));
+    process.exit(1);
+}
+const headers = {
+    'Content-Type': 'application/json',
+    // biome-ignore lint/style/useNamingConvention: API field name
+    Authorization: `Bearer ${KEY}`,
+};
+async function chat(prompt) {
+    const body = {
+        model: MODEL,
+        messages: [{ role: 'user', content: prompt }],
+        max_tokens: 256,
+    };
+    const res = await fetch(`${BASE}/chat/completions`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const err = await res.text().catch(() => res.statusText);
+        throw new Error(`Chat request failed: ${res.status} ${err}`);
+    }
+    const data = (await res.json());
+    logger.info('Chat response', { data });
+    const choice = Array.isArray(data.choices)
+        ? data.choices[0]
+        : undefined;
+    const message = choice?.message
+        ? choice.message
+        : choice?.text
+            ? { content: choice.text }
+            : undefined;
+    if (message) {
+        logger.info('Assistant output', {
+            content: typeof message.content === 'string' ? message.content : JSON.stringify(message),
+        });
+    }
+}
+async function embed(inputs) {
+    const body = {
+        model: MODEL,
+        input: Array.isArray(inputs) ? inputs : [inputs],
+    };
+    const res = await fetch(`${BASE}/embeddings`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const err = await res.text().catch(() => res.statusText);
+        throw new Error(`Embeddings request failed: ${res.status} ${err}`);
+    }
+    const data = await res.json();
+    logger.info('Embeddings response', { data });
+}
+async function main() {
+    if (!(await checkMcpLicense())) {
+        process.exit(2);
+    }
+    try {
+        await chat('What is the capital of France?');
+        await embed('This is a test embedding.');
+    }
+    catch (err) {
+        logger.error('Error during demo', err instanceof Error ? err : new Error(String(err)));
+        process.exitCode = 2;
+    }
+}
+await main();
+//# sourceMappingURL=vultr-test.js.map

package/dist/packages/mcp/src/servers/vultr-test.js.map

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

package/dist/scripts/lib/analyzers/console-analyzer.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Unified Console Analyzer
+ *
+ * Provides both AST-based and regex-based console statement detection.
+ * Consolidates logic from analyze/console-usage.ts and validate/console-statements.ts
+ *
+ * Features:
+ * - AST mode: TypeScript AST parsing for accurate detection with production guard awareness
+ * - Regex mode: Fast pattern matching for simple validation
+ * - Auto mode: Intelligently picks best approach based on file type
+ * - File categorization: production, test, script, unknown
+ * - Production guard detection: Recognizes if (process.env.NODE_ENV !== 'production')
+ *
+ * @dependencies
+ * - node:fs - File system operations for reading files
+ * - node:path - Path manipulation utilities
+ * - typescript - TypeScript compiler API for AST parsing
+ */
+export interface ConsoleUsage {
+    file: string;
+    line: number;
+    column: number;
+    method: 'log' | 'error' | 'warn' | 'debug' | 'info' | 'trace';
+    code: string;
+    category: 'production' | 'test' | 'script' | 'unknown';
+}
+export interface ConsoleAnalysisResult {
+    usages: ConsoleUsage[];
+    summary: {
+        total: number;
+        production: number;
+        test: number;
+        script: number;
+        unknown: number;
+    };
+}
+export type AnalysisMode = 'ast' | 'regex' | 'auto';
+/**
+ * Categorize a file based on its path to determine the appropriate context
+ * for console statement analysis.
+ *
+ * @param filePath - Absolute path to the file to categorize
+ * @param workspaceRoot - Root directory of the workspace/project
+ * @returns File category: 'production', 'test', 'script', or 'unknown'
+ *
+ * @example
+ * ```typescript
+ * const category = categorizeFile('/app/src/components/Button.tsx', '/app')
+ * console.log(category) // 'production'
+ *
+ * const testCategory = categorizeFile('/app/src/__tests__/Button.test.tsx', '/app')
+ * console.log(testCategory) // 'test'
+ * ```
+ */
+export declare function categorizeFile(filePath: string, workspaceRoot: string): 'production' | 'test' | 'script' | 'unknown';
+/**
+ * Analyze file using TypeScript AST parsing for accurate console statement detection.
+ * More accurate but slower than regex. Detects production guards and appropriate
+ * console methods (e.g., console.error is acceptable in production).
+ *
+ * @param filePath - Absolute path to the file to analyze
+ * @param workspaceRoot - Root directory of the workspace/project
+ * @returns Array of console usages found in the file
+ *
+ * @example
+ * ```typescript
+ * const usages = analyzeFileAST('/app/src/utils/logger.ts', '/app')
+ * console.log(`Found ${usages.length} console statements`)
+ * usages.forEach(u => console.log(`${u.file}:${u.line} - ${u.method}`))
+ * ```
+ *
+ * @see {@link analyzeFileRegex} for faster regex-based analysis
+ * @see {@link analyzeFile} for automatic mode selection
+ */
+export declare function analyzeFileAST(filePath: string, workspaceRoot: string): ConsoleUsage[];
+/**
+ * Analyze file using regex pattern matching for fast console statement detection.
+ * Faster but less accurate than AST - cannot detect production guards or
+ * complex conditional logic.
+ *
+ * @param filePath - Absolute path to the file to analyze
+ * @param workspaceRoot - Root directory of the workspace/project
+ * @returns Promise resolving to array of console usages found
+ *
+ * @example
+ * ```typescript
+ * const usages = await analyzeFileRegex('/app/src/index.js', '/app')
+ * console.log(`Found ${usages.length} console statements (regex mode)`)
+ * ```
+ *
+ * @see {@link analyzeFileAST} for more accurate AST-based analysis
+ * @see {@link analyzeFile} for automatic mode selection
+ */
+export declare function analyzeFileRegex(filePath: string, workspaceRoot: string): Promise<ConsoleUsage[]>;
+/**
+ * Analyze file with automatic or explicit mode selection.
+ * Auto mode intelligently selects AST for TypeScript files and regex for JavaScript.
+ *
+ * @param filePath - Absolute path to the file to analyze
+ * @param workspaceRoot - Root directory of the workspace/project
+ * @param mode - Analysis mode: 'auto' (default), 'ast', or 'regex'
+ * @returns Promise resolving to array of console usages found
+ *
+ * @example
+ * ```typescript
+ * // Auto mode - picks best approach
+ * const usages = await analyzeFile('/app/src/components/Button.tsx', '/app')
+ *
+ * // Force AST mode
+ * const astUsages = await analyzeFile('/app/src/index.js', '/app', 'ast')
+ *
+ * // Force regex mode for speed
+ * const regexUsages = await analyzeFile('/app/src/utils.ts', '/app', 'regex')
+ * ```
+ *
+ * @see {@link analyzeFiles} to analyze multiple files at once
+ */
+export declare function analyzeFile(filePath: string, workspaceRoot: string, mode?: AnalysisMode): Promise<ConsoleUsage[]>;
+/**
+ * Analyze multiple files and aggregate results with categorized summary.
+ * Provides comprehensive analysis across many files with performance optimization.
+ *
+ * @param filePaths - Array of absolute file paths to analyze
+ * @param workspaceRoot - Root directory of the workspace/project
+ * @param mode - Analysis mode: 'auto' (default), 'ast', or 'regex'
+ * @returns Promise resolving to analysis result with usages and summary statistics
+ *
+ * @example
+ * ```typescript
+ * const files = await scanDirectoryAll('./src', { extensions: ['.ts', '.tsx'] })
+ * const result = await analyzeFiles(files, process.cwd())
+ *
+ * console.log(`Total console statements: ${result.summary.total}`)
+ * console.log(`Production issues: ${result.summary.production}`)
+ * console.log(`Test files: ${result.summary.test}`)
+ *
+ * result.usages.forEach(usage => {
+ *   console.log(`${usage.file}:${usage.line} - ${usage.method} (${usage.category})`)
+ * })
+ * ```
+ */
+export declare function analyzeFiles(filePaths: string[], workspaceRoot: string, mode?: AnalysisMode): Promise<ConsoleAnalysisResult>;
+/**
+ * Console Analyzer class for object-oriented usage.
+ * Provides a convenient API for analyzing console statements across a project.
+ *
+ * @example
+ * ```typescript
+ * const analyzer = new ConsoleAnalyzer('/path/to/project')
+ *
+ * // Analyze single file
+ * const usages = await analyzer.analyze('src/app.ts')
+ *
+ * // Analyze multiple files with summary
+ * const files = await scanDirectoryAll('./src', { extensions: ['.ts'] })
+ * const result = await analyzer.analyzeMultiple(files, 'auto')
+ * console.log(`Found ${result.summary.total} console statements`)
+ * ```
+ */
+export declare class ConsoleAnalyzer {
+    private workspaceRoot;
+    /**
+     * Create a new ConsoleAnalyzer instance.
+     *
+     * @param workspaceRoot - Root directory of the workspace/project
+     */
+    constructor(workspaceRoot: string);
+    /**
+     * Analyze file using TypeScript AST parsing.
+     *
+     * @param filePath - Absolute path to file to analyze
+     * @returns Array of console usages found
+     */
+    analyzeAST(filePath: string): ConsoleUsage[];
+    /**
+     * Analyze using regex pattern matching
+     */
+    analyzeRegex(filePath: string): Promise<ConsoleUsage[]>;
+    /**
+     * Smart analysis with automatic mode selection
+     */
+    analyze(filePath: string, mode?: AnalysisMode): Promise<ConsoleUsage[]>;
+    /**
+     * Analyze multiple files
+     */
+    analyzeMultiple(filePaths: string[], mode?: AnalysisMode): Promise<ConsoleAnalysisResult>;
+}
+//# sourceMappingURL=console-analyzer.d.ts.map