@defai.digital/ax-cli 4.4.7 → 4.4.11

package/dist/utils/path-validator.d.ts

@@ -1,66 +0,0 @@
-/**
- * Path validation utilities to prevent security issues
- * Protects against path traversal attacks and invalid file operations
- */
-import { z } from 'zod';
-/**
- * Path validation schema
- */
-export declare const PathSchema: z.ZodString;
-/**
- * Validate and resolve a file path safely
- * @throws Error if path is invalid or dangerous
- */
-export declare function validatePath(filePath: string): string;
-/**
- * Check if a path is within a specific directory
- */
-export declare function isPathWithin(filePath: string, baseDir: string): boolean;
-/**
- * Safely join paths with validation
- */
-export declare function safeJoin(...paths: string[]): string;
-/**
- * Check if path is safe for file operations
- */
-export declare function isPathSafe(filePath: string): boolean;
-/**
- * Get relative path safely
- */
-export declare function safeRelative(from: string, to: string): string;
-/**
- * Result type for path resolution with validation
- */
-export interface PathResolutionResult {
-    success: true;
-    path: string;
-}
-export interface PathResolutionError {
-    success: false;
-    error: string;
-}
-export type PathResolution = PathResolutionResult | PathResolutionError;
-/**
- * Resolve and validate a path with optional file existence checks
- *
- * @param filePath - The path to resolve
- * @param options - Optional validation requirements
- * @returns PathResolution with either the resolved path or an error
- *
- * @example
- * ```typescript
- * const result = await resolveAndValidatePath('/path/to/file', {
- *   mustExist: true,
- *   mustBeFile: true
- * });
- * if (!result.success) {
- *   return { success: false, error: result.error };
- * }
- * const resolvedPath = result.path;
- * ```
- */
-export declare function resolveAndValidatePath(filePath: string, options?: {
-    mustExist?: boolean;
-    mustBeFile?: boolean;
-    mustBeDirectory?: boolean;
-}): Promise<PathResolution>;

package/dist/utils/path-validator.js

@@ -1,141 +0,0 @@
-/**
- * Path validation utilities to prevent security issues
- * Protects against path traversal attacks and invalid file operations
- */
-import * as path from 'path';
-import { z } from 'zod';
-/**
- * Path validation schema
- */
-export const PathSchema = z.string().min(1).refine((filePath) => {
-    // Resolve to absolute path and check if it's within the current working directory
-    const resolved = path.resolve(filePath);
-    const cwd = process.cwd();
-    // Ensure path is within current working directory
-    const isWithinCwd = resolved === cwd || resolved.startsWith(cwd + path.sep);
-    if (!isWithinCwd) {
-        return false;
-    }
-    // Additional check: block access to sensitive system directories
-    // This is a defense-in-depth measure
-    const dangerousPaths = ['/etc', '/sys', '/proc', '/dev', '/root', '/boot'];
-    for (const dangerous of dangerousPaths) {
-        if (resolved.startsWith(dangerous + path.sep) || resolved === dangerous) {
-            return false;
-        }
-    }
-    return true;
-}, {
-    message: 'Invalid or potentially dangerous file path',
-});
-/**
- * Validate and resolve a file path safely
- * @throws Error if path is invalid or dangerous
- */
-export function validatePath(filePath) {
-    const result = PathSchema.safeParse(filePath);
-    if (!result.success) {
-        throw new Error(`Invalid path: ${result.error.message}`);
-    }
-    return path.resolve(filePath);
-}
-/**
- * Check if a path is within a specific directory
- */
-export function isPathWithin(filePath, baseDir) {
-    const resolvedPath = path.resolve(filePath);
-    const resolvedBase = path.resolve(baseDir);
-    // Exact match or starts with base + path separator
-    // This prevents false positives like /home/user/projects matching /home/user/project
-    return resolvedPath === resolvedBase ||
-        resolvedPath.startsWith(resolvedBase + path.sep);
-}
-/**
- * Safely join paths with validation
- */
-export function safeJoin(...paths) {
-    const joined = path.join(...paths);
-    return validatePath(joined);
-}
-/**
- * Check if path is safe for file operations
- */
-export function isPathSafe(filePath) {
-    try {
-        validatePath(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get relative path safely
- */
-export function safeRelative(from, to) {
-    const validFrom = validatePath(from);
-    const validTo = validatePath(to);
-    return path.relative(validFrom, validTo);
-}
-/**
- * Resolve and validate a path with optional file existence checks
- *
- * @param filePath - The path to resolve
- * @param options - Optional validation requirements
- * @returns PathResolution with either the resolved path or an error
- *
- * @example
- * ```typescript
- * const result = await resolveAndValidatePath('/path/to/file', {
- *   mustExist: true,
- *   mustBeFile: true
- * });
- * if (!result.success) {
- *   return { success: false, error: result.error };
- * }
- * const resolvedPath = result.path;
- * ```
- */
-export async function resolveAndValidatePath(filePath, options) {
-    try {
-        // Validate path safety first
-        const resolved = validatePath(filePath);
-        // If existence check requested, import fs-extra dynamically
-        if (options?.mustExist) {
-            const fs = await import('fs-extra');
-            if (!(await fs.pathExists(resolved))) {
-                return {
-                    success: false,
-                    error: `Path not found: ${filePath}`
-                };
-            }
-            // Perform stat call once if type checking is needed
-            if (options.mustBeFile || options.mustBeDirectory) {
-                const stats = await fs.stat(resolved);
-                if (options.mustBeFile && !stats.isFile()) {
-                    return {
-                        success: false,
-                        error: `Not a file: ${filePath}`
-                    };
-                }
-                if (options.mustBeDirectory && !stats.isDirectory()) {
-                    return {
-                        success: false,
-                        error: `Not a directory: ${filePath}`
-                    };
-                }
-            }
-        }
-        return {
-            success: true,
-            path: resolved
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: `Invalid path: ${error.message}`
-        };
-    }
-}
-//# sourceMappingURL=path-validator.js.map

package/dist/utils/path-validator.js.map

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

package/dist/utils/performance.d.ts

@@ -1,74 +0,0 @@
-/**
- * Performance monitoring utilities
- * Provides timing and performance metrics for operations
- */
-export interface PerformanceMetric {
-    name: string;
-    startTime: number;
-    endTime?: number;
-    duration?: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Simple performance timer for measuring operation duration
- *
- * @example
- * ```typescript
- * const timer = new PerformanceTimer('tokenCount');
- * // ... do work ...
- * const duration = timer.end();
- * console.log(`Operation took ${duration}ms`);
- * ```
- */
-export declare class PerformanceTimer {
-    private startTime;
-    private endTime?;
-    private name;
-    constructor(name: string);
-    /**
-     * End the timer and return duration in milliseconds
-     */
-    end(): number;
-    /**
-     * Get duration without ending timer
-     */
-    duration(): number;
-    /**
-     * Get metric object
-     */
-    getMetric(): PerformanceMetric;
-}
-/**
- * Measure the performance of an async function
- *
- * @example
- * ```typescript
- * const [result, duration] = await measureAsync(
- *   'apiCall',
- *   () => fetch('https://api.example.com')
- * );
- * console.log(`API call took ${duration}ms`);
- * ```
- */
-export declare function measureAsync<T>(name: string, fn: () => Promise<T>): Promise<[T, number]>;
-/**
- * Measure the performance of a sync function
- *
- * @example
- * ```typescript
- * const [result, duration] = measure('calculation', () => {
- *   return heavyComputation();
- * });
- * ```
- */
-export declare function measure<T>(name: string, fn: () => T): [T, number];
-/**
- * Debounce function to limit execution rate
- * Returns a tuple of [debounced function, cleanup function]
- */
-export declare function debounce<TArgs extends any[]>(fn: (...args: TArgs) => void, delay: number): [(...args: TArgs) => void, () => void];
-/**
- * Throttle function to limit execution frequency
- * Returns a tuple of [throttled function, cleanup function]
- */
-export declare function throttle<TArgs extends any[]>(fn: (...args: TArgs) => void, limit: number): [(...args: TArgs) => void, () => void];

package/dist/utils/performance.js

@@ -1,133 +0,0 @@
-/**
- * Performance monitoring utilities
- * Provides timing and performance metrics for operations
- */
-/**
- * Simple performance timer for measuring operation duration
- *
- * @example
- * ```typescript
- * const timer = new PerformanceTimer('tokenCount');
- * // ... do work ...
- * const duration = timer.end();
- * console.log(`Operation took ${duration}ms`);
- * ```
- */
-export class PerformanceTimer {
-    startTime;
-    endTime;
-    name;
-    constructor(name) {
-        this.name = name;
-        this.startTime = performance.now();
-    }
-    /**
-     * End the timer and return duration in milliseconds
-     */
-    end() {
-        this.endTime = performance.now();
-        return this.duration();
-    }
-    /**
-     * Get duration without ending timer
-     */
-    duration() {
-        const end = this.endTime || performance.now();
-        return end - this.startTime;
-    }
-    /**
-     * Get metric object
-     */
-    getMetric() {
-        return {
-            name: this.name,
-            startTime: this.startTime,
-            endTime: this.endTime,
-            duration: this.endTime ? this.duration() : undefined,
-        };
-    }
-}
-/**
- * Measure the performance of an async function
- *
- * @example
- * ```typescript
- * const [result, duration] = await measureAsync(
- *   'apiCall',
- *   () => fetch('https://api.example.com')
- * );
- * console.log(`API call took ${duration}ms`);
- * ```
- */
-export async function measureAsync(name, fn) {
-    const timer = new PerformanceTimer(name);
-    const result = await fn();
-    const duration = timer.end();
-    return [result, duration];
-}
-/**
- * Measure the performance of a sync function
- *
- * @example
- * ```typescript
- * const [result, duration] = measure('calculation', () => {
- *   return heavyComputation();
- * });
- * ```
- */
-export function measure(name, fn) {
-    const timer = new PerformanceTimer(name);
-    const result = fn();
-    const duration = timer.end();
-    return [result, duration];
-}
-/**
- * Debounce function to limit execution rate
- * Returns a tuple of [debounced function, cleanup function]
- */
-export function debounce(fn, delay) {
-    let timeoutId = null;
-    const debouncedFn = (...args) => {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-        }
-        timeoutId = setTimeout(() => {
-            fn(...args);
-            timeoutId = null;
-        }, delay);
-    };
-    const cleanup = () => {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-            timeoutId = null;
-        }
-    };
-    return [debouncedFn, cleanup];
-}
-/**
- * Throttle function to limit execution frequency
- * Returns a tuple of [throttled function, cleanup function]
- */
-export function throttle(fn, limit) {
-    let inThrottle = false;
-    let timeoutId = null;
-    const throttledFn = (...args) => {
-        if (!inThrottle) {
-            fn(...args);
-            inThrottle = true;
-            timeoutId = setTimeout(() => {
-                inThrottle = false;
-                timeoutId = null;
-            }, limit);
-        }
-    };
-    const cleanup = () => {
-        if (timeoutId) {
-            clearTimeout(timeoutId);
-            timeoutId = null;
-        }
-        inThrottle = false;
-    };
-    return [throttledFn, cleanup];
-}
-//# sourceMappingURL=performance.js.map

package/dist/utils/performance.js.map

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

package/dist/utils/process-pool.d.ts

@@ -1,109 +0,0 @@
-/**
- * Process Pool Manager
- *
- * Manages a pool of reusable child processes to prevent memory leaks
- * and resource exhaustion (REQ-ARCH-002).
- *
- * Key features:
- * - Limits concurrent processes to prevent resource exhaustion
- * - Queues requests when pool is full
- * - Automatic cleanup of idle processes
- * - Graceful shutdown with proper cleanup
- * - Memory leak prevention through proper event listener management
- *
- * @module process-pool
- */
-import { EventEmitter } from 'events';
-/**
- * Options for process execution
- */
-export interface ProcessExecutionOptions {
-    command: string;
-    args: string[];
-    timeout?: number;
-    cwd?: string;
-}
-/**
- * Result of process execution
- */
-export interface ProcessExecutionResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    signal: string | null;
-}
-/**
- * Process pool configuration
- */
-export interface ProcessPoolConfig {
-    maxProcesses?: number;
-    processTimeout?: number;
-    idleTimeout?: number;
-    maxQueueSize?: number;
-}
-/**
- * Process pool manager for efficient process reuse
- */
-export declare class ProcessPool extends EventEmitter {
-    private readonly maxProcesses;
-    private readonly processTimeout;
-    private readonly maxQueueSize;
-    private activeProcesses;
-    private taskQueue;
-    private shuttingDown;
-    private idleTimers;
-    constructor(config?: ProcessPoolConfig);
-    /**
-     * Execute a command using the process pool
-     */
-    execute(options: ProcessExecutionOptions): Promise<ProcessExecutionResult>;
-    /**
-     * Process the task queue
-     */
-    private processQueue;
-    /**
-     * Execute a single task
-     */
-    private executeTask;
-    /**
-     * Spawn a process and manage its lifecycle
-     */
-    private spawnProcess;
-    /**
-     * Cleanup process and associated resources
-     */
-    private cleanupProcess;
-    /**
-     * Get pool statistics
-     */
-    getStats(): {
-        activeProcesses: number;
-        queuedTasks: number;
-        maxProcesses: number;
-        maxQueueSize: number;
-    };
-    /**
-     * Shutdown the pool gracefully
-     */
-    shutdown(force?: boolean): Promise<void>;
-    /**
-     * Check if pool is idle (no active processes or queued tasks)
-     */
-    isIdle(): boolean;
-    /**
-     * Check if pool is at capacity
-     */
-    isAtCapacity(): boolean;
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy(): void;
-}
-/**
- * Get or create the ripgrep process pool
- */
-export declare function getRipgrepPool(): ProcessPool;
-/**
- * Shutdown the ripgrep pool (for testing)
- */
-export declare function shutdownRipgrepPool(): Promise<void>;