@revealui/mcp 0.1.0 → 0.1.3

package/dist/scripts/lib/cli/dispatch.js

@@ -1,206 +0,0 @@
-/**
- * Unified CLI Command Dispatcher
- *
- * Consolidates the two different dispatch patterns used across CLIs:
- * 1. Import pattern: import(scriptPath) - Used by setup.ts
- * 2. Subprocess pattern: execCommand('pnpm tsx', scriptPath) - Used by analyze.ts, maintain.ts
- *
- * Provides a single, consistent API for dispatching to script files.
- *
- * @dependencies
- * - scripts/lib/args.ts - ParsedArgs type definition
- * - scripts/lib/errors.ts - Error handling with ErrorCode
- * - scripts/lib/exec.ts - Command execution for subprocess mode
- */
-import { ErrorCode, notFound, ScriptError } from '../errors.js';
-import { execCommand } from '../exec.js';
-/**
- * Determine if a script should run in subprocess mode
- * Heuristics:
- * - Scripts in 'workflows/' should run in subprocess (long-running)
- * - Scripts with 'build' or 'deploy' in name should run in subprocess (resource-intensive)
- * - Everything else can use import mode (faster)
- */
-function shouldUseSubprocess(scriptPath) {
-    const path = scriptPath.toLowerCase();
-    // Long-running or resource-intensive tasks
-    if (path.includes('/workflows/'))
-        return true;
-    if (path.includes('build'))
-        return true;
-    if (path.includes('deploy'))
-        return true;
-    if (path.includes('release'))
-        return true;
-    // Short analysis/validation scripts can use import
-    return false;
-}
-/**
- * Dispatch a command using the import pattern
- * Loads and executes the script in the same process
- */
-async function dispatchImport(scriptPath, _options = {}) {
-    try {
-        // Import the script module
-        await import(scriptPath);
-        return {
-            success: true,
-            mode: 'import',
-            scriptPath,
-        };
-    }
-    catch (error) {
-        if (error.code === 'ERR_MODULE_NOT_FOUND') {
-            throw notFound('Script', scriptPath);
-        }
-        return {
-            success: false,
-            mode: 'import',
-            scriptPath,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-/**
- * Dispatch a command using the subprocess pattern
- * Spawns a new process with pnpm tsx
- */
-async function dispatchSubprocess(scriptPath, options = {}) {
-    const { cwd, args, env = {}, timeout, captureOutput = false } = options;
-    // Build command arguments
-    const cmdArgs = ['tsx', scriptPath];
-    // Add parsed arguments to command
-    if (args?.command)
-        cmdArgs.push(args.command);
-    // Add flags
-    if (args?.flags) {
-        Object.entries(args.flags).forEach(([key, value]) => {
-            if (typeof value === 'boolean' && value) {
-                cmdArgs.push(`--${key}`);
-            }
-            else if (value !== undefined && value !== false) {
-                cmdArgs.push(`--${key}`, String(value));
-            }
-        });
-    }
-    // Add positional arguments
-    if (args?.positional && args.positional.length > 0) {
-        cmdArgs.push(...args.positional.map(String));
-    }
-    try {
-        const result = await execCommand('pnpm', cmdArgs, {
-            cwd,
-            env,
-            timeout,
-        });
-        return {
-            success: result.success,
-            mode: 'subprocess',
-            scriptPath,
-            output: captureOutput ? result.stdout : undefined,
-            error: result.success ? undefined : result.stderr,
-            exitCode: result.exitCode,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            mode: 'subprocess',
-            scriptPath,
-            error: error instanceof Error ? error.message : String(error),
-            exitCode: ErrorCode.EXECUTION_ERROR,
-        };
-    }
-}
-/**
- * Dispatch a CLI command to its implementation script
- *
- * This is the main entry point for command dispatch. It automatically
- * chooses the best dispatch mode based on the script characteristics.
- *
- * @param scriptPath - Absolute or relative path to the script file
- * @param options - Dispatch options
- * @returns Result of the dispatch operation
- *
- * @example
- * ```typescript
- * // Auto mode (recommended)
- * const result = await dispatchCommand('scripts/analyze/console-usage.ts')
- *
- * // Force subprocess mode
- * const result = await dispatchCommand('scripts/build/production.ts', {
- *   mode: 'subprocess',
- *   args: { flags: { verbose: true } }
- * })
- *
- * // Force import mode (faster for quick scripts)
- * const result = await dispatchCommand('scripts/validate/types.ts', {
- *   mode: 'import'
- * })
- * ```
- */
-export async function dispatchCommand(scriptPath, options = {}) {
-    const { mode = 'auto' } = options;
-    // Determine dispatch mode
-    let actualMode;
-    if (mode === 'auto') {
-        actualMode = shouldUseSubprocess(scriptPath) ? 'subprocess' : 'import';
-    }
-    else {
-        actualMode = mode;
-    }
-    // Dispatch based on mode
-    if (actualMode === 'import') {
-        return dispatchImport(scriptPath, options);
-    }
-    else {
-        return dispatchSubprocess(scriptPath, options);
-    }
-}
-/**
- * Helper to dispatch and throw on failure.
- * Useful when you want to fail fast on command errors instead of checking results.
- *
- * @param scriptPath - Absolute or relative path to the script file
- * @param options - Dispatch options
- * @throws {ScriptError} If the command fails
- *
- * @example
- * ```typescript
- * import { ErrorCode } from '../errors.js'
- *
- * // Will throw if validation fails
- * await dispatchOrThrow('scripts/validate/typescript.ts')
- *
- * // Catch and handle errors
- * try {
- *   await dispatchOrThrow('scripts/build/production.ts', {
- *     mode: 'subprocess',
- *     timeout: 60000
- *   })
- *   console.log('Build succeeded!')
- * } catch (error) {
- *   console.error('Build failed:', error.message)
- *   process.exit(ErrorCode.EXECUTION_ERROR)
- * }
- * ```
- *
- * @see {@link dispatchCommand} for non-throwing version
- */
-export async function dispatchOrThrow(scriptPath, options = {}) {
-    const result = await dispatchCommand(scriptPath, options);
-    if (!result.success) {
-        throw new ScriptError(result.error || `Command failed: ${scriptPath}`, result.exitCode || ErrorCode.EXECUTION_ERROR, {
-            context: {
-                scriptPath: result.scriptPath,
-                mode: result.mode,
-            },
-            suggestions: [
-                'Check the script path is correct',
-                'Verify the script has no syntax errors',
-                'Review the error message above for details',
-            ],
-        });
-    }
-}
-//# sourceMappingURL=dispatch.js.map

package/dist/scripts/lib/cli/dispatch.js.map

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

package/dist/scripts/lib/cli/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * CLI Utilities Module
- *
- * Exports CLI-related utilities including unified command dispatcher.
- *
- * @dependencies
- * - scripts/lib/cli/dispatch.ts - Command dispatch implementation
- */
-export { type DispatchMode, type DispatchOptions, type DispatchResult, dispatchCommand, dispatchOrThrow, } from './dispatch.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/scripts/lib/cli/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../scripts/lib/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA"}

package/dist/scripts/lib/cli/index.js

@@ -1,10 +0,0 @@
-/**
- * CLI Utilities Module
- *
- * Exports CLI-related utilities including unified command dispatcher.
- *
- * @dependencies
- * - scripts/lib/cli/dispatch.ts - Command dispatch implementation
- */
-export { dispatchCommand, dispatchOrThrow, } from './dispatch.js';
-//# sourceMappingURL=index.js.map

package/dist/scripts/lib/cli/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../scripts/lib/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAA"}

package/dist/scripts/lib/database/ssl-config.d.ts

@@ -1,26 +0,0 @@
-/**
- * SSL Configuration Utility for Scripts
- *
- * Provides centralized SSL configuration for PostgreSQL connections based on
- * connection string sslmode parameter and environment variables.
- *
- * Note: This is a copy of the core SSL config utility for use in scripts.
- * Scripts cannot import from @revealui/core due to build dependencies.
- *
- * @module ssl-config
- */
-/**
- * PostgreSQL SSL configuration options
- */
-export interface SSLConfig {
-    rejectUnauthorized: boolean;
-}
-/**
- * Determines the appropriate SSL configuration for a PostgreSQL connection
- * based on the connection string's sslmode parameter.
- *
- * @param connectionString - PostgreSQL connection string (may include sslmode parameter)
- * @returns SSL configuration object or false to disable SSL, or undefined for default behavior
- */
-export declare function getSSLConfig(connectionString: string): SSLConfig | false | undefined;
-//# sourceMappingURL=ssl-config.d.ts.map

package/dist/scripts/lib/database/ssl-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ssl-config.d.ts","sourceRoot":"","sources":["../../../../../../scripts/lib/database/ssl-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CA8BpF"}

package/dist/scripts/lib/database/ssl-config.js

@@ -1,47 +0,0 @@
-/**
- * SSL Configuration Utility for Scripts
- *
- * Provides centralized SSL configuration for PostgreSQL connections based on
- * connection string sslmode parameter and environment variables.
- *
- * Note: This is a copy of the core SSL config utility for use in scripts.
- * Scripts cannot import from @revealui/core due to build dependencies.
- *
- * @module ssl-config
- */
-/**
- * Determines the appropriate SSL configuration for a PostgreSQL connection
- * based on the connection string's sslmode parameter.
- *
- * @param connectionString - PostgreSQL connection string (may include sslmode parameter)
- * @returns SSL configuration object or false to disable SSL, or undefined for default behavior
- */
-export function getSSLConfig(connectionString) {
-    try {
-        // Parse connection string
-        const url = new URL(connectionString);
-        const sslmode = url.searchParams.get('sslmode');
-        // No SSL if sslmode is explicitly disabled
-        if (sslmode === 'disable') {
-            return false;
-        }
-        // No sslmode specified - return undefined to use driver defaults
-        if (!sslmode) {
-            return undefined;
-        }
-        // Environment override for local development with self-signed certificates
-        // This should ONLY be used in development environments
-        if (process.env.DATABASE_SSL_REJECT_UNAUTHORIZED === 'false') {
-            return { rejectUnauthorized: false };
-        }
-        // Default: verify certificates (security best practice)
-        // Handles: require, verify-full, verify-ca, prefer
-        return { rejectUnauthorized: true };
-    }
-    catch (_error) {
-        // If URL parsing fails, assume local connection - return undefined for defaults
-        // Silently fallback to driver defaults for invalid connection strings
-        return undefined;
-    }
-}
-//# sourceMappingURL=ssl-config.js.map

package/dist/scripts/lib/database/ssl-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ssl-config.js","sourceRoot":"","sources":["../../../../../../scripts/lib/database/ssl-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,gBAAwB;IACnD,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAE/C,2CAA2C;QAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,iEAAiE;QACjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,2EAA2E;QAC3E,uDAAuD;QACvD,IAAI,OAAO,CAAC,GAAG,CAAC,gCAAgC,KAAK,OAAO,EAAE,CAAC;YAC7D,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAA;QACtC,CAAC;QAED,wDAAwD;QACxD,mDAAmD;QACnD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,gFAAgF;QAChF,sEAAsE;QACtE,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/scripts/lib/errors.d.ts

@@ -1,218 +0,0 @@
-/**
- * Unified Error System
- *
- * Consolidates error-handler.ts and errors.ts into a single comprehensive error system.
- * Provides standardized error codes, enhanced error messages, suggestions, and recovery options.
- *
- * Features:
- * - Typed error codes with exit code mapping
- * - Contextual error enhancement with suggestions
- * - Pattern-based suggestion generation
- * - Documentation link generation
- * - Error recovery helpers
- * - Retry logic with enhanced errors
- *
- * @example
- * ```typescript
- * import { ScriptError, ErrorCode } from './errors.js'
- *
- * // Throw typed errors with suggestions
- * throw new ScriptError('Database connection failed', ErrorCode.EXECUTION_ERROR, {
- *   suggestions: ['Check if database is running', 'Verify DATABASE_URL'],
- *   docsUrl: 'https://docs.revealui.dev/database',
- * })
- *
- * // Use factory functions with auto-suggestions
- * throw notFound('Workflow', id) // Auto-generates helpful suggestions
- *
- * // Handle errors with proper exit codes
- * try {
- *   await runCommand()
- * } catch (error) {
- *   if (error instanceof ScriptError) {
- *     console.error(error.format()) // Pretty formatted error
- *     process.exit(error.code)
- *   }
- *   process.exit(ErrorCode.GENERAL_ERROR)
- * }
- * ```
- *
- * @dependencies
- * - None (foundational module with no external dependencies)
- */
-/**
- * Standardized exit codes for CLI scripts.
- *
- * These follow Unix conventions where 0 = success, non-zero = failure,
- * with specific codes for different failure types.
- */
-export declare enum ErrorCode {
-    /** Operation completed successfully */
-    SUCCESS = 0,
-    /** General/unknown error */
-    GENERAL_ERROR = 1,
-    /** Configuration error (missing env var, bad config file) */
-    CONFIG_ERROR = 2,
-    /** Execution error (command failed, external service error) */
-    EXECUTION_ERROR = 3,
-    /** Validation error (bad input, invalid arguments) */
-    VALIDATION_ERROR = 4,
-    /** Timeout error (operation took too long) */
-    TIMEOUT_ERROR = 5,
-    /** Resource not found (workflow, file, etc.) */
-    NOT_FOUND = 6,
-    /** Permission denied (auth failed, insufficient permissions) */
-    PERMISSION_DENIED = 7,
-    /** Conflict error (resource already exists, concurrent modification) */
-    CONFLICT = 8,
-    /** Operation cancelled by user */
-    CANCELLED = 9,
-    /** Dependency error (missing tool, wrong version) */
-    DEPENDENCY_ERROR = 10,
-    /** Network error (connection failed, DNS resolution) */
-    NETWORK_ERROR = 11,
-    /** Rate limit exceeded */
-    RATE_LIMITED = 12,
-    /** Invalid state (operation not allowed in current state) */
-    INVALID_STATE = 13
-}
-/**
- * Human-readable descriptions for error codes
- */
-export declare const ErrorCodeDescriptions: Record<ErrorCode, string>;
-/**
- * Enhanced error options
- */
-export interface EnhancedErrorOptions {
-    /** Additional error details/context */
-    context?: Record<string, unknown>;
-    /** Suggested fixes for the error */
-    suggestions?: string[];
-    /** Documentation URL for more information */
-    docsUrl?: string;
-    /** Recovery steps that can be attempted */
-    recovery?: string[];
-    /** Whether this error is recoverable */
-    recoverable?: boolean;
-    /** What operation was being performed */
-    operation?: string;
-}
-/**
- * Unified error class for CLI scripts
- *
- * Includes error codes, contextual information, suggestions, and recovery options.
- * Merges functionality from both ScriptError and EnhancedError.
- */
-export declare class ScriptError extends Error {
-    /** Error code (maps to exit code) */
-    readonly code: ErrorCode;
-    /** Additional error details/context */
-    readonly context?: Record<string, unknown>;
-    /** Error code as string (for JSON output) */
-    readonly codeString: string;
-    /** Suggested fixes for this error */
-    readonly suggestions?: string[];
-    /** Documentation URL */
-    readonly docsUrl?: string;
-    /** Recovery steps */
-    readonly recovery?: string[];
-    /** Whether this error is recoverable */
-    readonly recoverable?: boolean;
-    /** Operation being performed when error occurred */
-    readonly operation?: string;
-    /** Timestamp when error was created */
-    readonly timestamp: number;
-    /** Original error if this wraps another error */
-    readonly originalError?: Error;
-    get details(): Record<string, unknown> | undefined;
-    constructor(message: string, code?: ErrorCode, options?: EnhancedErrorOptions | Record<string, unknown>);
-    /**
-     * Convert to JSON-serializable object
-     */
-    toJSON(): {
-        code: string;
-        exitCode: number;
-        message: string;
-        context?: Record<string, unknown>;
-        suggestions?: string[];
-        docsUrl?: string;
-        recovery?: string[];
-        timestamp: number;
-    };
-    /**
-     * Get the human-readable description for this error's code
-     */
-    getCodeDescription(): string;
-    /**
-     * Format error for display with colors and suggestions
-     */
-    format(verbose?: boolean): string;
-    /**
-     * Print error to console with formatting
-     */
-    print(verbose?: boolean): void;
-}
-/**
- * Create a not found error
- */
-export declare function notFound(resource: string, id?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create a validation error
- */
-export declare function validationError(message: string, field?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create a config error
- */
-export declare function configError(message: string, envVar?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create a timeout error
- */
-export declare function timeoutError(operation: string, timeoutMs: number, details?: Record<string, unknown>): ScriptError;
-/**
- * Create an execution error
- */
-export declare function executionError(command: string, exitCode?: number, stderr?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create a conflict error
- */
-export declare function conflictError(resource: string, reason?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create a permission denied error
- */
-export declare function permissionDenied(action: string, resource?: string, details?: Record<string, unknown>): ScriptError;
-/**
- * Create an invalid state error
- */
-export declare function invalidState(operation: string, currentState: string, expectedStates?: string[], details?: Record<string, unknown>): ScriptError;
-/**
- * Check if an error is a ScriptError
- */
-export declare function isScriptError(error: unknown): error is ScriptError;
-/**
- * Get the exit code for an error
- */
-export declare function getExitCode(error: unknown): number;
-/**
- * Wrap an unknown error as a ScriptError
- */
-export declare function wrapError(error: unknown, code?: ErrorCode): ScriptError;
-/**
- * Run a function and wrap any errors
- */
-export declare function withErrorHandling<T>(fn: () => Promise<T>, errorCode?: ErrorCode): Promise<T>;
-/**
- * Retry a function with enhanced error handling
- */
-export declare function retryWithEnhancedErrors<T>(fn: () => Promise<T>, options?: {
-    retries?: number;
-    delay?: number;
-    operation?: string;
-    context?: Record<string, unknown>;
-}): Promise<T>;
-/**
- * Wrap a function with enhanced error handling
- */
-export declare function withEnhancedErrors<T extends (...args: any[]) => any>(fn: T, options?: Omit<EnhancedErrorOptions, 'context'> & {
-    code?: ErrorCode;
-}): T;
-//# sourceMappingURL=errors.d.ts.map

package/dist/scripts/lib/errors.d.ts.map

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