byterover-cli 1.7.0 → 1.7.2

package/node_modules/@campfirein/brv-transport-client/dist/infra/client-factory.js

@@ -0,0 +1,451 @@
+import { ConnectionFailedError, InstanceCrashedError, NoInstanceRunningError, } from '../core/domain/errors/connection-error.js';
+import { NoOpClientLogger } from './no-op-client-logger.js';
+import { FileInstanceDiscovery } from './file-instance-discovery.js';
+import { TransportClient } from './socket-io-client.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_MAX_RETRIES = 8;
+const DEFAULT_RETRY_DELAY_MS = 150;
+const DEFAULT_WARMUP_TIMEOUT_MS = 1000;
+const DEFAULT_CONNECT_TIMEOUT_MS = 5000;
+const WARMUP_SETTLE_DELAY_MS = 100;
+const SANDBOX_ERROR_MULTIPLIER = 2;
+// ============================================================================
+// TransportClientFactory
+// ============================================================================
+/**
+ * Factory for creating connected Socket.IO clients.
+ * Follows Dependency Inversion Principle - depends on abstractions (IInstanceDiscovery, IClientLogger).
+ *
+ * Responsibilities:
+ * - Instance discovery (via injected IInstanceDiscovery)
+ * - Connection establishment with retry logic
+ * - HTTP warm-up for sandbox environments
+ * - Error translation to user-friendly messages
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const factory = new TransportClientFactory()
+ * const { client, projectRoot } = await factory.connect()
+ *
+ * // With custom dependencies (DIP)
+ * const factory = new TransportClientFactory({
+ *   discovery: new CustomDiscovery(),
+ *   logger: myLogger,
+ * })
+ * ```
+ */
+export class TransportClientFactory {
+    #discovery;
+    #logger;
+    #maxRetries;
+    #retryDelayMs;
+    #warmUpTimeoutMs;
+    #connectTimeoutMs;
+    #warmUpSettleDelayMs;
+    constructor(config) {
+        // Inject dependencies or use defaults (DIP)
+        this.#discovery = config?.discovery ?? new FileInstanceDiscovery();
+        this.#logger = config?.logger ?? new NoOpClientLogger();
+        // Configuration with defaults
+        this.#maxRetries = config?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.#retryDelayMs = config?.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+        this.#warmUpTimeoutMs = config?.warmUpTimeoutMs ?? DEFAULT_WARMUP_TIMEOUT_MS;
+        this.#connectTimeoutMs = config?.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+        this.#warmUpSettleDelayMs = config?.warmUpSettleDelayMs ?? WARMUP_SETTLE_DELAY_MS;
+    }
+    /**
+     * Discovers a running instance and connects to it.
+     *
+     * @param fromDir - Directory to start discovery from (default: cwd)
+     * @returns Connected client and project root
+     * @throws NoInstanceRunningError - No .brv directory found
+     * @throws InstanceCrashedError - Instance found but process dead
+     * @throws ConnectionFailedError - Instance found but connection failed
+     */
+    async connect(fromDir = process.cwd()) {
+        this.log(`Discovering instance from ${fromDir}`);
+        const result = await this.#discovery.discover(fromDir);
+        if (!result.found) {
+            throw result.reason === 'instance_crashed' ? new InstanceCrashedError() : new NoInstanceRunningError();
+        }
+        const { instance, projectRoot } = result;
+        const url = instance.getTransportUrl();
+        this.log(`Instance discovered: pid=${instance.pid}, port=${instance.port}, projectRoot=${projectRoot}`);
+        const client = await this.connectWithRetry(url, instance.port);
+        return Object.freeze({ client, projectRoot });
+    }
+    /**
+     * Connects to the instance with retry logic.
+     * Includes HTTP warm-up to trigger sandbox permission requests.
+     */
+    async connectWithRetry(url, port) {
+        let lastError;
+        // HTTP warm-up for sandbox environments
+        this.log(`Attempting HTTP warm-up to ${url}`);
+        await this.httpWarmUp(url);
+        await this.delay(this.#warmUpSettleDelayMs);
+        // Connection retry loop
+        for (let attempt = 1; attempt <= this.#maxRetries; attempt++) {
+            const client = new TransportClient({
+                logger: this.#logger,
+                connectTimeoutMs: this.#connectTimeoutMs,
+            });
+            try {
+                this.log(`Connection attempt ${attempt}/${this.#maxRetries} to ${url}`);
+                await client.connect(url);
+                this.log(`Connected to instance, clientId=${client.getClientId()}`);
+                return client;
+            }
+            catch (error) {
+                // Cleanup on failure
+                await this.safeDisconnect(client);
+                lastError = error instanceof Error ? error : new Error(String(error));
+                const isSandboxError = this.isSandboxError(lastError);
+                this.log(`Connection attempt ${attempt} failed: ${lastError.message}, isSandboxError=${isSandboxError}`);
+                // Wait before retry (except on last attempt)
+                if (attempt < this.#maxRetries) {
+                    const delayMs = this.calculateRetryDelay(attempt, isSandboxError);
+                    await this.delay(delayMs);
+                }
+            }
+        }
+        throw new ConnectionFailedError(port, lastError);
+    }
+    /**
+     * Attempts HTTP warm-up to trigger sandbox network permission.
+     * Returns true if warm-up succeeded (status 2xx), false otherwise.
+     */
+    async httpWarmUp(url) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.#warmUpTimeoutMs);
+            const response = await fetch(`${url}/socket.io/?EIO=4&transport=polling`, {
+                method: 'GET',
+                signal: controller.signal,
+            }).catch((error) => {
+                this.log(`HTTP warm-up fetch error: ${error.message}`);
+                return null;
+            });
+            clearTimeout(timeoutId);
+            if (response?.ok) {
+                this.log(`HTTP warm-up succeeded with status: ${response.status}`);
+                return true;
+            }
+            if (response) {
+                this.log(`HTTP warm-up completed with non-OK status: ${response.status}`);
+            }
+            return false;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log(`HTTP warm-up failed: ${errorMessage}`);
+            return false;
+        }
+    }
+    /**
+     * Safely disconnects a client, ignoring errors.
+     */
+    async safeDisconnect(client) {
+        try {
+            await client.disconnect();
+        }
+        catch {
+            // Ignore disconnect errors during cleanup
+        }
+    }
+    /**
+     * Checks if an error is likely a sandbox-related network error.
+     */
+    isSandboxError(error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('websocket error') ||
+            message.includes('network') ||
+            message.includes('connection failed') ||
+            message.includes('econnrefused'));
+    }
+    /**
+     * Calculates retry delay with exponential backoff for sandbox errors.
+     */
+    calculateRetryDelay(attempt, isSandboxError) {
+        const baseDelay = isSandboxError ? this.#retryDelayMs * SANDBOX_ERROR_MULTIPLIER : this.#retryDelayMs;
+        return baseDelay * attempt;
+    }
+    /**
+     * Promise-based delay.
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Logs a debug message.
+     */
+    log(message) {
+        this.#logger.debug(`[TransportClientFactory] ${message}`);
+    }
+}
+// ============================================================================
+// Singleton Client Manager (Encapsulated Global State)
+// ============================================================================
+/**
+ * Manages singleton instances for transport client.
+ * Encapsulates global state following OOP principles.
+ *
+ * @remarks
+ * This class provides explicit dependency management instead of hidden module-level state.
+ * - All state is encapsulated within the class instance
+ * - Supports multiple instances for testing scenarios
+ * - Thread-safe connection management via promise deduplication
+ *
+ * @example
+ * ```typescript
+ * // Default singleton usage
+ * const manager = SingletonClientManager.getInstance()
+ * const { client } = await manager.getConnectedClient()
+ *
+ * // Testing with isolated instance
+ * const testManager = new SingletonClientManager()
+ * testManager.reset()
+ * ```
+ */
+export class SingletonClientManager {
+    static #instance;
+    #factory;
+    #discovery;
+    #cachedConnection;
+    #connectingPromise;
+    #factoryConfig;
+    /**
+     * Creates a new singleton manager instance.
+     * @param factoryConfig - Optional configuration for the factory
+     */
+    constructor(factoryConfig) {
+        this.#factoryConfig = factoryConfig;
+    }
+    /**
+     * Gets the global singleton instance.
+     * Creates one if it doesn't exist.
+     */
+    static getInstance() {
+        if (!SingletonClientManager.#instance) {
+            SingletonClientManager.#instance = new SingletonClientManager();
+        }
+        return SingletonClientManager.#instance;
+    }
+    /**
+     * Resets the global singleton instance.
+     * Primarily for testing.
+     */
+    static resetInstance() {
+        SingletonClientManager.#instance = undefined;
+    }
+    /**
+     * Gets or creates the singleton factory.
+     * @param config - Configuration (only used on first call)
+     */
+    getFactory(config) {
+        if (!this.#factory) {
+            this.#factory = new TransportClientFactory(config ?? this.#factoryConfig);
+        }
+        return this.#factory;
+    }
+    /**
+     * Gets or creates the singleton discovery.
+     */
+    getDiscovery() {
+        if (!this.#discovery) {
+            this.#discovery = new FileInstanceDiscovery();
+        }
+        return this.#discovery;
+    }
+    /**
+     * Gets the singleton connected client, connecting if necessary.
+     * Thread-safe: concurrent calls share the same connection attempt.
+     *
+     * @param fromDir - Directory to start discovery from (default: cwd)
+     * @returns Connected client and project root
+     * @throws NoInstanceRunningError - No .brv directory found
+     * @throws InstanceCrashedError - Instance found but process dead
+     * @throws ConnectionFailedError - Instance found but connection failed
+     */
+    async getConnectedClient(fromDir = process.cwd()) {
+        // Return cached if connected
+        if (this.#cachedConnection?.client.getState() === 'connected') {
+            return this.#cachedConnection;
+        }
+        // Wait for in-progress connection (race condition prevention)
+        if (this.#connectingPromise) {
+            return this.#connectingPromise;
+        }
+        // Start new connection
+        this.#connectingPromise = (async () => {
+            try {
+                this.#cachedConnection = undefined;
+                const factory = this.getFactory();
+                this.#cachedConnection = await factory.connect(fromDir);
+                return this.#cachedConnection;
+            }
+            finally {
+                this.#connectingPromise = undefined;
+            }
+        })();
+        return this.#connectingPromise;
+    }
+    /**
+     * Disconnects and clears the singleton client.
+     */
+    async disconnectClient() {
+        if (this.#cachedConnection) {
+            await this.#cachedConnection.client.disconnect();
+            this.#cachedConnection = undefined;
+        }
+    }
+    /**
+     * Checks if the transport server is running without attempting to connect.
+     * Non-throwing alternative to connect().
+     *
+     * @param fromDir - Directory to start discovery from (default: cwd)
+     * @returns ServerStatus indicating whether server is running and why if not
+     */
+    async checkServerStatus(fromDir = process.cwd()) {
+        const discovery = this.getDiscovery();
+        const result = await discovery.discover(fromDir);
+        if (!result.found) {
+            return Object.freeze({
+                reason: result.reason === 'instance_crashed' ? 'instance_crashed' : 'no_instance',
+                running: false,
+            });
+        }
+        return Object.freeze({
+            instance: result.instance,
+            projectRoot: result.projectRoot,
+            running: true,
+        });
+    }
+    /**
+     * Resets all singleton state.
+     * Primarily for testing.
+     */
+    reset() {
+        this.#cachedConnection = undefined;
+        this.#connectingPromise = undefined;
+        this.#factory = undefined;
+        this.#discovery = undefined;
+    }
+    /**
+     * Gets the cached connection if available.
+     * Returns undefined if not connected.
+     */
+    get cachedConnection() {
+        return this.#cachedConnection;
+    }
+    /**
+     * Checks if a connection attempt is in progress.
+     */
+    get isConnecting() {
+        return this.#connectingPromise !== undefined;
+    }
+}
+// ============================================================================
+// Backward-Compatible Module Functions
+// ============================================================================
+/**
+ * Gets or creates the singleton factory.
+ * @param config - Configuration (only used on first call)
+ */
+export function getTransportClientFactory(config) {
+    return SingletonClientManager.getInstance().getFactory(config);
+}
+/**
+ * Creates a new factory instance (non-singleton).
+ * @deprecated Use connectToTransport() for simpler API
+ */
+export function createTransportClientFactory(config) {
+    return new TransportClientFactory(config);
+}
+/**
+ * Connects to ByteRover transport server (simplified API).
+ * Auto-discovers .brv directory by walking up from fromDir.
+ *
+ * @param fromDir - Directory to start discovery from (default: cwd)
+ * @param config - Optional factory configuration
+ * @returns Connected client and project root
+ * @throws NoInstanceRunningError - No .brv directory found
+ * @throws InstanceCrashedError - Instance found but process dead
+ * @throws ConnectionFailedError - Instance found but connection failed
+ *
+ * @example
+ * ```typescript
+ * // Simple connection
+ * const {client, projectRoot} = await connectToTransport()
+ *
+ * // With custom directory
+ * const {client} = await connectToTransport('/path/to/project')
+ *
+ * // With custom config
+ * const {client} = await connectToTransport(undefined, { logger: myLogger })
+ * ```
+ */
+export async function connectToTransport(fromDir, config) {
+    const factory = new TransportClientFactory(config);
+    return factory.connect(fromDir);
+}
+/**
+ * Checks if the transport server is running without attempting to connect.
+ * Non-throwing alternative to connectToTransport().
+ *
+ * @param fromDir - Directory to start discovery from (default: cwd)
+ * @returns ServerStatus indicating whether server is running and why if not
+ *
+ * @example
+ * ```typescript
+ * const status = await checkServerStatus()
+ * if (status.running) {
+ *   const { client } = await getConnectedClient()
+ * } else {
+ *   console.log(`Server not running: ${status.reason}`)
+ * }
+ * ```
+ */
+export async function checkServerStatus(fromDir = process.cwd()) {
+    return SingletonClientManager.getInstance().checkServerStatus(fromDir);
+}
+/**
+ * Gets the singleton connected client, connecting if necessary.
+ * Thread-safe: concurrent calls share the same connection attempt.
+ *
+ * @param fromDir - Directory to start discovery from (default: cwd)
+ * @returns Connected client and project root
+ * @throws NoInstanceRunningError - No .brv directory found
+ * @throws InstanceCrashedError - Instance found but process dead
+ * @throws ConnectionFailedError - Instance found but connection failed
+ *
+ * @example
+ * ```typescript
+ * // Concurrent calls share the same connection
+ * const [result1, result2] = await Promise.all([
+ *   getConnectedClient(),
+ *   getConnectedClient(),
+ * ])
+ * console.log(result1.client === result2.client) // true
+ * ```
+ */
+export async function getConnectedClient(fromDir = process.cwd()) {
+    return SingletonClientManager.getInstance().getConnectedClient(fromDir);
+}
+/**
+ * Disconnects and clears the singleton client.
+ */
+export async function disconnectClient() {
+    return SingletonClientManager.getInstance().disconnectClient();
+}
+/**
+ * Resets all singleton instances. Primarily for testing.
+ */
+export function resetSingletons() {
+    SingletonClientManager.getInstance().reset();
+    SingletonClientManager.resetInstance();
+}
+//# sourceMappingURL=client-factory.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/client-factory.js.map

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

package/node_modules/@campfirein/brv-transport-client/dist/infra/connection-state-manager.d.ts

@@ -0,0 +1,90 @@
+import type { ConnectionState, ConnectionStateHandler, IConnectionStateManager } from '../core/interfaces/i-connection-state.js';
+import type { IClientLogger } from '../core/interfaces/i-client-logger.js';
+/**
+ * Configuration for ConnectionStateManager.
+ */
+export type ConnectionStateManagerConfig = {
+    /** Initial connection state (default: 'disconnected') */
+    readonly initialState?: ConnectionState;
+    /** Logger for debugging (default: NoOpClientLogger) */
+    readonly logger?: IClientLogger;
+};
+/**
+ * Manages connection state and notifies subscribers of state changes.
+ * Implements Observer Pattern for state change notifications.
+ *
+ * @remarks
+ * - State handlers persist across state changes until explicitly unsubscribed
+ * - Each handler receives the new state when it changes
+ * - Handlers are called synchronously in registration order
+ *
+ * @example
+ * ```typescript
+ * const stateManager = new ConnectionStateManager()
+ *
+ * const unsubscribe = stateManager.onStateChange((state) => {
+ *   console.log('State changed to:', state)
+ * })
+ *
+ * stateManager.setState('connecting') // Logs: "State changed to: connecting"
+ * stateManager.setState('connected')   // Logs: "State changed to: connected"
+ *
+ * unsubscribe()
+ * stateManager.setState('disconnected') // No log (unsubscribed)
+ * ```
+ */
+export declare class ConnectionStateManager implements IConnectionStateManager {
+    #private;
+    constructor(config?: ConnectionStateManagerConfig);
+    /**
+     * Gets the current connection state.
+     * @returns Current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Updates the connection state and notifies handlers.
+     * Only notifies if the state actually changed.
+     * @throws {InvalidStateTransitionError} If the transition is not allowed
+     */
+    setState(newState: ConnectionState): void;
+    /**
+     * Registers a handler for connection state changes.
+     * @returns Unsubscribe function
+     */
+    onStateChange(handler: ConnectionStateHandler): () => void;
+    /**
+     * Clears all state handlers.
+     */
+    clearHandlers(): void;
+    /**
+     * Checks if transition to a new state is valid from current state.
+     * @param newState - The target state
+     * @returns True if transition is allowed
+     */
+    canTransitionTo(newState: ConnectionState): boolean;
+    /**
+     * Checks if currently connected.
+     * @returns True if state is 'connected'
+     */
+    isConnected(): boolean;
+    /**
+     * Checks if currently connecting.
+     * @returns True if state is 'connecting'
+     */
+    isConnecting(): boolean;
+    /**
+     * Checks if currently disconnected.
+     * @returns True if state is 'disconnected'
+     */
+    isDisconnected(): boolean;
+    /**
+     * Checks if currently reconnecting.
+     * @returns True if state is 'reconnecting'
+     */
+    isReconnecting(): boolean;
+    /**
+     * Notifies all handlers of the state change.
+     */
+    private notifyHandlers;
+}
+//# sourceMappingURL=connection-state-manager.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/connection-state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state-manager.d.ts","sourceRoot":"","sources":["../../infra/connection-state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uCAAuC,CAAA;AAexE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAA;IACvC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;;gBAKxD,MAAM,CAAC,EAAE,4BAA4B;IAKjD;;;OAGG;IACI,QAAQ,IAAI,eAAe;IAIlC;;;;OAIG;IACI,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAoBhD;;;OAGG;IACI,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAOjE;;OAEG;IACI,aAAa,IAAI,IAAI;IAI5B;;;;OAIG;IACI,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAK1D;;;OAGG;IACI,WAAW,IAAI,OAAO;IAI7B;;;OAGG;IACI,YAAY,IAAI,OAAO;IAI9B;;;OAGG;IACI,cAAc,IAAI,OAAO;IAIhC;;;OAGG;IACI,cAAc,IAAI,OAAO;IAIhC;;OAEG;IACH,OAAO,CAAC,cAAc;CAWvB"}