@revealui/mcp 0.1.0 → 0.1.3

package/dist/scripts/lib/cache.js

@@ -1,390 +0,0 @@
-/**
- * Build caching utilities for improved performance.
- *
- * Provides file-based caching with:
- * - Content-based cache keys (hashing)
- * - TTL (time-to-live) support
- * - Cache statistics and metrics
- * - Automatic cleanup of stale entries
- *
- * @dependencies
- * - node:crypto - Hash generation for cache keys
- * - node:fs/promises - File system operations for cache storage
- * - node:path - Path manipulation utilities
- * - fast-glob - File pattern matching for cache key generation
- *
- * @example
- * ```typescript
- * import { BuildCache } from './cache.js'
- *
- * const cache = new BuildCache({ ttl: 3600000 }) // 1 hour
- *
- * const key = await cache.getCacheKey(['src/**\/*.ts'])
- * if (await cache.isCached(key)) {
- *   await cache.restore(key, 'dist/')
- * } else {
- *   // Build...
- *   await cache.save(key, 'dist/')
- * }
- *
- * const stats = cache.getStats()
- * console.log(`Cache hit rate: ${stats.hitRate}%`)
- * ```
- */
-import { createHash } from 'node:crypto';
-import { cp, mkdir, readdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
-import { join, relative } from 'node:path';
-import fg from 'fast-glob';
-import { ErrorCode, ScriptError } from './errors.js';
-import { createLogger } from './logger.js';
-import { getProjectRoot } from './paths.js';
-import { fileExists, formatBytes, formatDuration } from './utils.js';
-const logger = createLogger({ prefix: 'Cache' });
-/**
- * Build cache for improved performance.
- */
-export class BuildCache {
-    cacheDir;
-    ttl;
-    verbose;
-    maxSize;
-    stats;
-    projectRoot = null;
-    constructor(options = {}) {
-        this.cacheDir = options.cacheDir ?? '.cache/build';
-        this.ttl = options.ttl ?? 86_400_000; // 24 hours
-        this.verbose = options.verbose ?? false;
-        this.maxSize = options.maxSize ?? 1_073_741_824; // 1 GB
-        this.stats = { hits: 0, misses: 0 };
-    }
-    /**
-     * Get project root directory.
-     */
-    async getRoot() {
-        if (!this.projectRoot) {
-            this.projectRoot = await getProjectRoot(import.meta.url);
-        }
-        return this.projectRoot;
-    }
-    /**
-     * Get absolute cache directory path.
-     */
-    async getCacheDir() {
-        const root = await this.getRoot();
-        return join(root, this.cacheDir);
-    }
-    /**
-     * Generate cache key from file patterns.
-     *
-     * Creates a hash of file contents for content-based caching.
-     *
-     * @param patterns - Glob patterns to include
-     * @returns Cache key (SHA256 hash)
-     */
-    async getCacheKey(patterns) {
-        const root = await this.getRoot();
-        const hash = createHash('sha256');
-        // Resolve all patterns to file paths
-        const allFiles = await fg(patterns, {
-            cwd: root,
-            absolute: true,
-            onlyFiles: true,
-            ignore: ['**/node_modules/**', '**/.git/**', '**/dist/**', '**/.next/**'],
-        });
-        // Sort for consistent hashing
-        allFiles.sort();
-        if (this.verbose) {
-            logger.info(`Hashing ${allFiles.length} files for cache key`);
-        }
-        // Hash file contents
-        for (const file of allFiles) {
-            const content = await readFile(file);
-            const relativePath = relative(root, file);
-            hash.update(relativePath); // Include path in hash
-            hash.update(content);
-        }
-        const key = hash.digest('hex');
-        if (this.verbose) {
-            logger.info(`Generated cache key: ${key}`);
-        }
-        return key;
-    }
-    /**
-     * Check if cache entry exists and is valid.
-     *
-     * @param key - Cache key
-     * @returns True if cached and not expired
-     */
-    async isCached(key) {
-        const cacheDir = await this.getCacheDir();
-        const metadataPath = join(cacheDir, key, 'metadata.json');
-        if (!(await fileExists(metadataPath))) {
-            this.stats.misses++;
-            if (this.verbose) {
-                logger.info(`Cache miss: ${key}`);
-            }
-            return false;
-        }
-        try {
-            const content = await readFile(metadataPath, 'utf-8');
-            const entry = JSON.parse(content);
-            // Check TTL
-            const age = Date.now() - entry.timestamp;
-            if (age > this.ttl) {
-                if (this.verbose) {
-                    logger.info(`Cache expired: ${key} (age: ${formatDuration(age)})`);
-                }
-                // Clean up expired entry
-                await this.delete(key);
-                this.stats.misses++;
-                return false;
-            }
-            this.stats.hits++;
-            if (this.verbose) {
-                logger.success(`Cache hit: ${key} (age: ${formatDuration(age)})`);
-            }
-            return true;
-        }
-        catch (error) {
-            logger.warn(`Invalid cache metadata for ${key}: ${error}`);
-            this.stats.misses++;
-            return false;
-        }
-    }
-    /**
-     * Restore cached files to destination.
-     *
-     * @param key - Cache key
-     * @param dest - Destination directory
-     */
-    async restore(key, dest) {
-        const root = await this.getRoot();
-        const cacheDir = await this.getCacheDir();
-        const entryDir = join(cacheDir, key);
-        const metadataPath = join(entryDir, 'metadata.json');
-        if (!(await fileExists(metadataPath))) {
-            throw new ScriptError(`Cache entry not found: ${key}`, ErrorCode.NOT_FOUND);
-        }
-        const content = await readFile(metadataPath, 'utf-8');
-        const entry = JSON.parse(content);
-        const destPath = join(root, dest);
-        const cachedPath = join(entryDir, 'data');
-        if (this.verbose) {
-            logger.info(`Restoring cache ${key} to ${dest}`);
-        }
-        // Copy cached files to destination
-        await mkdir(destPath, { recursive: true });
-        await cp(cachedPath, destPath, { recursive: true });
-        if (this.verbose) {
-            logger.success(`Restored ${formatBytes(entry.size)} from cache`);
-        }
-    }
-    /**
-     * Save files to cache.
-     *
-     * @param key - Cache key
-     * @param source - Source directory to cache
-     * @param sourcePaths - Original source paths (for metadata)
-     */
-    async save(key, source, sourcePaths = []) {
-        const root = await this.getRoot();
-        const cacheDir = await this.getCacheDir();
-        const entryDir = join(cacheDir, key);
-        const metadataPath = join(entryDir, 'metadata.json');
-        const cachedPath = join(entryDir, 'data');
-        const sourcePath = join(root, source);
-        if (!(await fileExists(sourcePath))) {
-            throw new ScriptError(`Source directory not found: ${source}`, ErrorCode.NOT_FOUND);
-        }
-        if (this.verbose) {
-            logger.info(`Saving cache ${key} from ${source}`);
-        }
-        // Check cache size limit before saving
-        const currentSize = await this.getTotalSize();
-        const sourceSize = await this.getDirectorySize(sourcePath);
-        if (this.maxSize > 0 && currentSize + sourceSize > this.maxSize) {
-            logger.warn('Cache size limit reached, cleaning up oldest entries');
-            await this.cleanup({ maxSize: this.maxSize - sourceSize });
-        }
-        // Create cache entry directory
-        await mkdir(entryDir, { recursive: true });
-        // Copy files to cache
-        await cp(sourcePath, cachedPath, { recursive: true });
-        // Save metadata
-        const entry = {
-            key,
-            timestamp: Date.now(),
-            size: sourceSize,
-            sources: sourcePaths,
-            destination: source,
-        };
-        await writeFile(metadataPath, JSON.stringify(entry, null, 2));
-        if (this.verbose) {
-            logger.success(`Saved ${formatBytes(sourceSize)} to cache`);
-        }
-    }
-    /**
-     * Delete cache entry.
-     *
-     * @param key - Cache key
-     */
-    async delete(key) {
-        const cacheDir = await this.getCacheDir();
-        const entryDir = join(cacheDir, key);
-        if (await fileExists(entryDir)) {
-            await rm(entryDir, { recursive: true, force: true });
-            if (this.verbose) {
-                logger.info(`Deleted cache entry: ${key}`);
-            }
-        }
-    }
-    /**
-     * Clear all cache entries.
-     */
-    async clear() {
-        const cacheDir = await this.getCacheDir();
-        if (await fileExists(cacheDir)) {
-            await rm(cacheDir, { recursive: true, force: true });
-            logger.info('Cache cleared');
-        }
-        // Reset stats
-        this.stats.hits = 0;
-        this.stats.misses = 0;
-    }
-    /**
-     * Clean up cache entries based on criteria.
-     *
-     * @param options - Cleanup options
-     */
-    async cleanup(options = {}) {
-        const cacheDir = await this.getCacheDir();
-        if (!(await fileExists(cacheDir))) {
-            return;
-        }
-        const entries = await this.listEntries();
-        let deletedCount = 0;
-        let freedSize = 0;
-        // Sort by timestamp (oldest first)
-        entries.sort((a, b) => a.timestamp - b.timestamp);
-        // Delete by age
-        if (options.olderThan) {
-            const cutoff = Date.now() - options.olderThan;
-            for (const entry of entries) {
-                if (entry.timestamp < cutoff) {
-                    await this.delete(entry.key);
-                    deletedCount++;
-                    freedSize += entry.size;
-                }
-            }
-        }
-        // Delete by size limit
-        if (options.maxSize) {
-            let currentSize = await this.getTotalSize();
-            for (const entry of entries) {
-                if (currentSize <= options.maxSize) {
-                    break;
-                }
-                await this.delete(entry.key);
-                currentSize -= entry.size;
-                deletedCount++;
-                freedSize += entry.size;
-            }
-        }
-        if (deletedCount > 0) {
-            logger.info(`Cleaned up ${deletedCount} cache entries, freed ${formatBytes(freedSize)}`);
-        }
-    }
-    /**
-     * List all cache entries.
-     *
-     * @returns Array of cache entries
-     */
-    async listEntries() {
-        const cacheDir = await this.getCacheDir();
-        if (!(await fileExists(cacheDir))) {
-            return [];
-        }
-        const entries = [];
-        const dirs = await readdir(cacheDir);
-        for (const dir of dirs) {
-            const metadataPath = join(cacheDir, dir, 'metadata.json');
-            if (await fileExists(metadataPath)) {
-                try {
-                    const content = await readFile(metadataPath, 'utf-8');
-                    const entry = JSON.parse(content);
-                    entries.push(entry);
-                }
-                catch (error) {
-                    logger.warn(`Invalid metadata in ${dir}: ${error}`);
-                }
-            }
-        }
-        return entries;
-    }
-    /**
-     * Get cache statistics.
-     *
-     * @returns Cache stats
-     */
-    async getStats() {
-        const entries = await this.listEntries();
-        const totalSize = entries.reduce((sum, entry) => sum + entry.size, 0);
-        const total = this.stats.hits + this.stats.misses;
-        const hitRate = total > 0 ? (this.stats.hits / total) * 100 : 0;
-        return {
-            hits: this.stats.hits,
-            misses: this.stats.misses,
-            hitRate: Math.round(hitRate * 100) / 100,
-            entries: entries.length,
-            totalSize,
-            formattedSize: formatBytes(totalSize),
-        };
-    }
-    /**
-     * Get total cache size in bytes.
-     */
-    async getTotalSize() {
-        const entries = await this.listEntries();
-        return entries.reduce((sum, entry) => sum + entry.size, 0);
-    }
-    /**
-     * Get directory size in bytes.
-     */
-    async getDirectorySize(dir) {
-        let size = 0;
-        try {
-            const entries = await readdir(dir, { withFileTypes: true });
-            for (const entry of entries) {
-                const fullPath = join(dir, entry.name);
-                if (entry.isDirectory()) {
-                    size += await this.getDirectorySize(fullPath);
-                }
-                else if (entry.isFile()) {
-                    const stats = await stat(fullPath);
-                    size += stats.size;
-                }
-            }
-        }
-        catch (error) {
-            logger.warn(`Error calculating directory size for ${dir}: ${error}`);
-        }
-        return size;
-    }
-    /**
-     * Reset statistics.
-     */
-    resetStats() {
-        this.stats.hits = 0;
-        this.stats.misses = 0;
-    }
-}
-/**
- * Create a new build cache instance.
- *
- * @param options - Cache options
- * @returns BuildCache instance
- */
-export function createCache(options) {
-    return new BuildCache(options);
-}
-//# sourceMappingURL=cache.js.map

package/dist/scripts/lib/cache.js.map

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

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

@@ -1,116 +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 type { ParsedArgs } from '../args.js';
-/**
- * Dispatch mode
- * - 'import': Loads and executes script in same process (faster, shares context)
- * - 'subprocess': Spawns new process with pnpm tsx (isolated, better for long-running tasks)
- * - 'auto': Chooses best mode based on script characteristics (default)
- */
-export type DispatchMode = 'import' | 'subprocess' | 'auto';
-/**
- * Options for command dispatch
- */
-export interface DispatchOptions {
-    /** Dispatch mode (default: 'auto') */
-    mode?: DispatchMode;
-    /** Working directory for subprocess mode */
-    cwd?: string;
-    /** Additional arguments to pass to the script */
-    args?: ParsedArgs;
-    /** Environment variables for subprocess mode */
-    env?: Record<string, string>;
-    /** Timeout for subprocess in milliseconds */
-    timeout?: number;
-    /** Whether to capture output (subprocess mode only) */
-    captureOutput?: boolean;
-}
-/**
- * Result from dispatching a command
- */
-export interface DispatchResult {
-    /** Whether the command succeeded */
-    success: boolean;
-    /** Output from the command (if captureOutput was true) */
-    output?: string;
-    /** Error message if command failed */
-    error?: string;
-    /** Exit code (subprocess mode only) */
-    exitCode?: number;
-    /** Dispatch mode that was used */
-    mode: DispatchMode;
-    /** Script path that was executed */
-    scriptPath: string;
-}
-/**
- * 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 declare function dispatchCommand(scriptPath: string, options?: DispatchOptions): Promise<DispatchResult>;
-/**
- * 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 declare function dispatchOrThrow(scriptPath: string, options?: DispatchOptions): Promise<void>;
-//# sourceMappingURL=dispatch.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../../../scripts/lib/cli/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,IAAI,EAAE,YAAY,CAAA;IAClB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAA;CACnB;AA+GD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoBf"}