vaspera 2.5.0

package/dist/util/paths.js

@@ -0,0 +1,128 @@
+/**
+ * Path Validation Utilities
+ *
+ * Security-focused path validation to prevent path traversal attacks
+ * and ensure paths are within allowed boundaries.
+ *
+ * @module util/paths
+ */
+import { stat, lstat, realpath } from "fs/promises";
+import path from "path";
+/**
+ * Error thrown when path validation fails
+ */
+export class PathValidationError extends Error {
+    path;
+    reason;
+    constructor(message, path, reason) {
+        super(message);
+        this.path = path;
+        this.reason = reason;
+        this.name = "PathValidationError";
+    }
+}
+/**
+ * Validate a project path for security
+ *
+ * Checks:
+ * 1. Path is absolute after resolution
+ * 2. Path exists on the filesystem
+ * 3. Path is a directory (optional)
+ * 4. Symlinks are resolved and checked (optional)
+ * 5. Path doesn't escape base directory (optional)
+ *
+ * @param projectPath - The path to validate
+ * @param options - Validation options
+ * @returns The validated, resolved absolute path
+ * @throws PathValidationError if validation fails
+ */
+export async function validateProjectPath(projectPath, options = {}) {
+    const { requireDirectory = true, allowSymlinks = false, basePath } = options;
+    // Resolve to absolute path
+    const resolvedPath = path.resolve(projectPath);
+    // Check for path traversal attempts
+    if (projectPath.includes("..") && !path.isAbsolute(projectPath)) {
+        // Verify the resolved path doesn't escape intended boundaries
+        const normalizedInput = path.normalize(projectPath);
+        if (normalizedInput.startsWith("..")) {
+            throw new PathValidationError(`Path traversal detected: ${projectPath}`, projectPath, "path_traversal");
+        }
+    }
+    try {
+        // Check if path exists (using lstat to detect symlinks)
+        const lstats = await lstat(resolvedPath);
+        // Handle symlinks
+        if (lstats.isSymbolicLink()) {
+            if (!allowSymlinks) {
+                // Resolve the symlink and verify it doesn't escape
+                const realPath = await realpath(resolvedPath);
+                // If basePath is specified, ensure symlink target is within it
+                if (basePath) {
+                    const resolvedBase = path.resolve(basePath);
+                    if (!realPath.startsWith(resolvedBase)) {
+                        throw new PathValidationError(`Symlink escapes base directory: ${projectPath} -> ${realPath}`, projectPath, "symlink_escape");
+                    }
+                }
+                // Use the real path
+                const realStats = await stat(realPath);
+                if (requireDirectory && !realStats.isDirectory()) {
+                    throw new PathValidationError(`Path is not a directory: ${projectPath}`, projectPath, "not_directory");
+                }
+                return realPath;
+            }
+        }
+        // Check if it's a directory (if required)
+        if (requireDirectory && !lstats.isDirectory()) {
+            throw new PathValidationError(`Path is not a directory: ${projectPath}`, projectPath, "not_directory");
+        }
+        // If basePath is specified, ensure the path is within it
+        if (basePath) {
+            const resolvedBase = path.resolve(basePath);
+            if (!resolvedPath.startsWith(resolvedBase)) {
+                throw new PathValidationError(`Path is outside base directory: ${projectPath}`, projectPath, "path_traversal");
+            }
+        }
+        return resolvedPath;
+    }
+    catch (error) {
+        if (error instanceof PathValidationError) {
+            throw error;
+        }
+        // Handle ENOENT (file not found)
+        if (error.code === "ENOENT") {
+            throw new PathValidationError(`Path does not exist: ${projectPath}`, projectPath, "not_found");
+        }
+        // Re-throw other errors
+        throw new PathValidationError(`Invalid path: ${projectPath} - ${error.message}`, projectPath, "invalid_path");
+    }
+}
+/**
+ * Validate a file path (not requiring directory)
+ */
+export async function validateFilePath(filePath, options = {}) {
+    return validateProjectPath(filePath, { ...options, requireDirectory: false });
+}
+/**
+ * Check if a path is safe (doesn't throw, returns boolean)
+ */
+export async function isPathSafe(projectPath, options = {}) {
+    try {
+        await validateProjectPath(projectPath, options);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sanitize a path for use in error messages (remove sensitive info)
+ */
+export function sanitizePathForLogging(inputPath) {
+    // Remove home directory prefix if present
+    const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+    if (homeDir && inputPath.startsWith(homeDir)) {
+        return "~" + inputPath.slice(homeDir.length);
+    }
+    return inputPath;
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

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

package/dist/util/retry.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Retry and Circuit Breaker Utilities
+ *
+ * Provides retry logic with exponential backoff and circuit breaker pattern
+ * for handling transient failures in scanner and LLM operations.
+ *
+ * @module util/retry
+ */
+/**
+ * Error classification for retry decisions
+ */
+export type ErrorType = "transient" | "permanent" | "unknown";
+/**
+ * Circuit breaker state
+ */
+export type CircuitState = "closed" | "open" | "half-open";
+/**
+ * Options for retry behavior
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts?: number;
+    /** Initial delay in ms before first retry (default: 1000) */
+    initialDelayMs?: number;
+    /** Maximum delay in ms between retries (default: 30000) */
+    maxDelayMs?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Add jitter to delays to prevent thundering herd (default: true) */
+    jitter?: boolean;
+    /** Timeout for each attempt in ms (optional) */
+    attemptTimeoutMs?: number;
+    /** Custom error classifier (default: classifyError) */
+    classifyError?: (error: Error) => ErrorType;
+    /** Callback for retry attempts */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit (default: 30000) */
+    resetTimeoutMs?: number;
+    /** Number of successes in half-open state to close circuit (default: 2) */
+    successThreshold?: number;
+    /** Callback when circuit state changes */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+/**
+ * Classify an error as transient or permanent
+ *
+ * Transient errors (should retry):
+ * - Timeout errors (ETIMEDOUT, ESOCKETTIMEDOUT)
+ * - Rate limiting (429)
+ * - Server errors (5xx)
+ * - Network errors (ECONNRESET, ECONNREFUSED, ENOTFOUND)
+ *
+ * Permanent errors (should not retry):
+ * - File not found (ENOENT)
+ * - Permission denied (EACCES, EPERM)
+ * - Invalid input (4xx except 429)
+ * - Authentication errors (401, 403)
+ */
+export declare function classifyError(error: Error): ErrorType;
+/**
+ * Retry error thrown when all attempts fail
+ */
+export declare class RetryError extends Error {
+    readonly attempts: number;
+    readonly lastError: Error;
+    readonly errors: Error[];
+    constructor(message: string, attempts: number, lastError: Error, errors: Error[]);
+}
+/**
+ * Circuit breaker error thrown when circuit is open
+ */
+export declare class CircuitOpenError extends Error {
+    readonly circuitName: string;
+    readonly openedAt: Date;
+    readonly resetAt: Date;
+    constructor(circuitName: string, openedAt: Date, resetAt: Date);
+}
+/**
+ * Execute a function with retry logic
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry options
+ * @returns The result of the function
+ * @throws RetryError if all attempts fail
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   { maxAttempts: 3, onRetry: (attempt, err) => console.log(`Retry ${attempt}: ${err.message}`) }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Circuit breaker implementation
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit tripped, requests fail fast
+ * - HALF-OPEN: Testing if service recovered
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime;
+    private readonly name;
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private readonly successThreshold;
+    private readonly onStateChange?;
+    constructor(name: string, options?: CircuitBreakerOptions);
+    /**
+     * Get the current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Check if the circuit allows requests
+     */
+    canExecute(): boolean;
+    /**
+     * Execute a function through the circuit breaker
+     *
+     * @param fn - The async function to execute
+     * @returns The result of the function
+     * @throws CircuitOpenError if circuit is open
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Record a successful execution
+     */
+    private onSuccess;
+    /**
+     * Record a failed execution
+     */
+    private onFailure;
+    /**
+     * Transition to a new state
+     */
+    private transition;
+    /**
+     * Reset the circuit breaker
+     */
+    private reset;
+    /**
+     * Force the circuit to a specific state (for testing)
+     */
+    forceState(state: CircuitState): void;
+    /**
+     * Get circuit breaker stats
+     */
+    getStats(): {
+        name: string;
+        state: CircuitState;
+        failures: number;
+        successes: number;
+        lastFailureTime: Date | null;
+    };
+}
+/**
+ * Execute a function with both retry and circuit breaker
+ *
+ * @param circuitBreaker - The circuit breaker instance
+ * @param fn - The async function to execute
+ * @param retryOptions - Retry options
+ * @returns The result of the function
+ */
+export declare function withRetryAndCircuitBreaker<T>(circuitBreaker: CircuitBreaker, fn: () => Promise<T>, retryOptions?: RetryOptions): Promise<T>;
+/**
+ * Create a retry wrapper for a function
+ *
+ * @param fn - The async function to wrap
+ * @param options - Retry options
+ * @returns A wrapped function that retries on failure
+ */
+export declare function createRetryWrapper<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, options?: RetryOptions): (...args: TArgs) => Promise<TResult>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/util/retry.d.ts.map

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

package/dist/util/retry.js

@@ -0,0 +1,338 @@
+/**
+ * Retry and Circuit Breaker Utilities
+ *
+ * Provides retry logic with exponential backoff and circuit breaker pattern
+ * for handling transient failures in scanner and LLM operations.
+ *
+ * @module util/retry
+ */
+/**
+ * Classify an error as transient or permanent
+ *
+ * Transient errors (should retry):
+ * - Timeout errors (ETIMEDOUT, ESOCKETTIMEDOUT)
+ * - Rate limiting (429)
+ * - Server errors (5xx)
+ * - Network errors (ECONNRESET, ECONNREFUSED, ENOTFOUND)
+ *
+ * Permanent errors (should not retry):
+ * - File not found (ENOENT)
+ * - Permission denied (EACCES, EPERM)
+ * - Invalid input (4xx except 429)
+ * - Authentication errors (401, 403)
+ */
+export function classifyError(error) {
+    const message = error.message.toLowerCase();
+    const code = error.code;
+    // Check for transient errors
+    if (code === "ETIMEDOUT" ||
+        code === "ESOCKETTIMEDOUT" ||
+        code === "ECONNRESET" ||
+        code === "ECONNREFUSED" ||
+        code === "ENOTFOUND" ||
+        code === "ENETUNREACH" ||
+        code === "EAI_AGAIN") {
+        return "transient";
+    }
+    // Check for permanent errors
+    if (code === "ENOENT" || code === "EACCES" || code === "EPERM" || code === "EEXIST") {
+        return "permanent";
+    }
+    // Check message for HTTP status codes
+    if (message.includes("429") || message.includes("rate limit")) {
+        return "transient";
+    }
+    if (message.includes("500") ||
+        message.includes("502") ||
+        message.includes("503") ||
+        message.includes("504") ||
+        message.includes("internal server error") ||
+        message.includes("bad gateway") ||
+        message.includes("service unavailable") ||
+        message.includes("gateway timeout")) {
+        return "transient";
+    }
+    if (message.includes("401") ||
+        message.includes("403") ||
+        message.includes("404") ||
+        message.includes("unauthorized") ||
+        message.includes("forbidden") ||
+        message.includes("not found")) {
+        return "permanent";
+    }
+    // Check for timeout in message
+    if (message.includes("timeout") || message.includes("timed out")) {
+        return "transient";
+    }
+    return "unknown";
+}
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ */
+function calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter) {
+    // Exponential backoff: initialDelay * multiplier^(attempt-1)
+    let delay = initialDelayMs * Math.pow(backoffMultiplier, attempt - 1);
+    // Cap at max delay
+    delay = Math.min(delay, maxDelayMs);
+    // Add jitter (±25%)
+    if (jitter) {
+        const jitterRange = delay * 0.25;
+        delay = delay + (Math.random() * 2 - 1) * jitterRange;
+    }
+    return Math.round(delay);
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Retry error thrown when all attempts fail
+ */
+export class RetryError extends Error {
+    attempts;
+    lastError;
+    errors;
+    constructor(message, attempts, lastError, errors) {
+        super(message);
+        this.attempts = attempts;
+        this.lastError = lastError;
+        this.errors = errors;
+        this.name = "RetryError";
+    }
+}
+/**
+ * Circuit breaker error thrown when circuit is open
+ */
+export class CircuitOpenError extends Error {
+    circuitName;
+    openedAt;
+    resetAt;
+    constructor(circuitName, openedAt, resetAt) {
+        super(`Circuit '${circuitName}' is open. Will reset at ${resetAt.toISOString()}`);
+        this.circuitName = circuitName;
+        this.openedAt = openedAt;
+        this.resetAt = resetAt;
+        this.name = "CircuitOpenError";
+    }
+}
+/**
+ * Execute a function with retry logic
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry options
+ * @returns The result of the function
+ * @throws RetryError if all attempts fail
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   { maxAttempts: 3, onRetry: (attempt, err) => console.log(`Retry ${attempt}: ${err.message}`) }
+ * );
+ * ```
+ */
+export async function withRetry(fn, options = {}) {
+    const { maxAttempts = 3, initialDelayMs = 1000, maxDelayMs = 30000, backoffMultiplier = 2, jitter = true, attemptTimeoutMs, classifyError: classifier = classifyError, onRetry, } = options;
+    const errors = [];
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            // Wrap with timeout if specified
+            if (attemptTimeoutMs) {
+                return await Promise.race([
+                    fn(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Attempt ${attempt} timed out after ${attemptTimeoutMs}ms`)), attemptTimeoutMs)),
+                ]);
+            }
+            return await fn();
+        }
+        catch (error) {
+            const err = error;
+            errors.push(err);
+            // Check if this is the last attempt
+            if (attempt >= maxAttempts) {
+                throw new RetryError(`All ${maxAttempts} attempts failed. Last error: ${err.message}`, attempt, err, errors);
+            }
+            // Classify the error
+            const errorType = classifier(err);
+            // Don't retry permanent errors
+            if (errorType === "permanent") {
+                throw new RetryError(`Permanent error after ${attempt} attempt(s): ${err.message}`, attempt, err, errors);
+            }
+            // Calculate delay for next attempt
+            const delayMs = calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter);
+            // Notify about retry
+            if (onRetry) {
+                onRetry(attempt, err, delayMs);
+            }
+            // Wait before retrying
+            await sleep(delayMs);
+        }
+    }
+    // This should never be reached, but TypeScript needs it
+    throw new Error("Unexpected retry loop exit");
+}
+/**
+ * Circuit breaker implementation
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit tripped, requests fail fast
+ * - HALF-OPEN: Testing if service recovered
+ */
+export class CircuitBreaker {
+    state = "closed";
+    failures = 0;
+    successes = 0;
+    lastFailureTime = null;
+    name;
+    failureThreshold;
+    resetTimeoutMs;
+    successThreshold;
+    onStateChange;
+    constructor(name, options = {}) {
+        this.name = name;
+        this.failureThreshold = options.failureThreshold ?? 5;
+        this.resetTimeoutMs = options.resetTimeoutMs ?? 30000;
+        this.successThreshold = options.successThreshold ?? 2;
+        this.onStateChange = options.onStateChange;
+    }
+    /**
+     * Get the current circuit state
+     */
+    getState() {
+        // Check if we should transition from open to half-open
+        if (this.state === "open" && this.lastFailureTime) {
+            const elapsed = Date.now() - this.lastFailureTime.getTime();
+            if (elapsed >= this.resetTimeoutMs) {
+                this.transition("half-open");
+            }
+        }
+        return this.state;
+    }
+    /**
+     * Check if the circuit allows requests
+     */
+    canExecute() {
+        const state = this.getState();
+        return state === "closed" || state === "half-open";
+    }
+    /**
+     * Execute a function through the circuit breaker
+     *
+     * @param fn - The async function to execute
+     * @returns The result of the function
+     * @throws CircuitOpenError if circuit is open
+     */
+    async execute(fn) {
+        const state = this.getState();
+        if (state === "open") {
+            const resetAt = new Date(this.lastFailureTime.getTime() + this.resetTimeoutMs);
+            throw new CircuitOpenError(this.name, this.lastFailureTime, resetAt);
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    /**
+     * Record a successful execution
+     */
+    onSuccess() {
+        if (this.state === "half-open") {
+            this.successes++;
+            if (this.successes >= this.successThreshold) {
+                this.transition("closed");
+                this.reset();
+            }
+        }
+        else {
+            // Reset failure count on success in closed state
+            this.failures = 0;
+        }
+    }
+    /**
+     * Record a failed execution
+     */
+    onFailure() {
+        this.failures++;
+        this.lastFailureTime = new Date();
+        if (this.state === "half-open") {
+            // Any failure in half-open goes back to open
+            this.transition("open");
+            this.successes = 0;
+        }
+        else if (this.state === "closed" && this.failures >= this.failureThreshold) {
+            this.transition("open");
+        }
+    }
+    /**
+     * Transition to a new state
+     */
+    transition(newState) {
+        if (this.state !== newState) {
+            const oldState = this.state;
+            this.state = newState;
+            if (this.onStateChange) {
+                this.onStateChange(oldState, newState);
+            }
+        }
+    }
+    /**
+     * Reset the circuit breaker
+     */
+    reset() {
+        this.failures = 0;
+        this.successes = 0;
+        this.lastFailureTime = null;
+    }
+    /**
+     * Force the circuit to a specific state (for testing)
+     */
+    forceState(state) {
+        this.transition(state);
+        if (state === "closed") {
+            this.reset();
+        }
+    }
+    /**
+     * Get circuit breaker stats
+     */
+    getStats() {
+        return {
+            name: this.name,
+            state: this.getState(),
+            failures: this.failures,
+            successes: this.successes,
+            lastFailureTime: this.lastFailureTime,
+        };
+    }
+}
+/**
+ * Execute a function with both retry and circuit breaker
+ *
+ * @param circuitBreaker - The circuit breaker instance
+ * @param fn - The async function to execute
+ * @param retryOptions - Retry options
+ * @returns The result of the function
+ */
+export async function withRetryAndCircuitBreaker(circuitBreaker, fn, retryOptions = {}) {
+    return circuitBreaker.execute(() => withRetry(fn, retryOptions));
+}
+/**
+ * Create a retry wrapper for a function
+ *
+ * @param fn - The async function to wrap
+ * @param options - Retry options
+ * @returns A wrapped function that retries on failure
+ */
+export function createRetryWrapper(fn, options = {}) {
+    return (...args) => withRetry(() => fn(...args), options);
+}
+//# sourceMappingURL=retry.js.map

package/dist/util/retry.js.map

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