@vinaes/succ 1.4.0 → 1.5.37

package/dist/lsp/client.js

@@ -0,0 +1,435 @@
+/**
+ * LSP Client — headless LSP connection over JSON-RPC stdio.
+ *
+ * Manages lifecycle: spawn → initialize → query → shutdown.
+ * Uses vscode-languageserver-protocol for typed LSP messages.
+ */
+import { spawn } from 'child_process';
+import { createProtocolConnection, StreamMessageReader, StreamMessageWriter, } from 'vscode-languageserver-protocol/node.js';
+import { InitializeRequest, ShutdownRequest, ExitNotification, DidOpenTextDocumentNotification, DidCloseTextDocumentNotification, DidChangeTextDocumentNotification, DefinitionRequest, ReferencesRequest, HoverRequest, } from 'vscode-languageserver-protocol';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logInfo, logWarn } from '../lib/fault-logger.js';
+import { pathToFileURL, fileURLToPath } from 'url';
+// ============================================================================
+// Client
+// ============================================================================
+export class LspClient {
+    process = null;
+    connection = null;
+    initialized = false;
+    /** Tracks open documents: URI → document version counter */
+    openDocuments = new Map();
+    /** File watchers for open documents to detect external edits */
+    fileWatchers = new Map();
+    /** Debounce timers for file change events (Windows fires duplicates) */
+    fileChangeTimers = new Map();
+    idleTimer = null;
+    /** Single-flight guard: if start() is in progress, concurrent callers share this promise */
+    startingPromise = null;
+    idleTimeoutMs;
+    options;
+    constructor(options) {
+        this.options = options;
+        this.idleTimeoutMs = options.idleTimeoutMs ?? 600000;
+    }
+    /**
+     * Start the LSP server process and initialize the connection.
+     * Cleans up spawned process and connection on any failure.
+     */
+    async start() {
+        if (this.initialized) {
+            throw new Error('LSP client already initialized');
+        }
+        // Single-flight: if a start() is already in progress, return its promise
+        if (this.startingPromise) {
+            return this.startingPromise;
+        }
+        this.startingPromise = this._doStart();
+        try {
+            return await this.startingPromise;
+        }
+        finally {
+            this.startingPromise = null;
+        }
+    }
+    async _doStart() {
+        // Spawn the server process
+        const child = spawn(this.options.command, this.options.args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            cwd: this.options.rootPath,
+        });
+        this.process = child;
+        // Handle spawn failures (e.g. command not found, ENOENT).
+        // Reject via spawnErrorPromise so start() doesn't hang on sendRequest.
+        // Bind to child so stale events from an old spawn don't tear down a newer process.
+        const spawnErrorPromise = new Promise((_, reject) => {
+            child.on('error', (err) => {
+                if (child !== this.process)
+                    return; // stale child — ignore
+                logWarn('lsp-client', `Failed to spawn ${this.options.command}: ${err.message}`);
+                this.cleanup();
+                reject(err);
+            });
+        });
+        if (!child.stdout || !child.stdin) {
+            // Spawned but streams unavailable — clean up immediately
+            this.cleanup();
+            throw new Error('Failed to get stdio streams from LSP server process');
+        }
+        // Capture stderr for diagnostics
+        child.stderr?.on('data', (data) => {
+            const msg = data.toString().trim();
+            if (msg) {
+                logWarn('lsp-client', `stderr from ${this.options.command}: ${msg.substring(0, 200)}`);
+            }
+        });
+        child.on('exit', (code) => {
+            if (child !== this.process)
+                return; // stale child — ignore
+            logInfo('lsp-client', `${this.options.command} exited with code ${code}`);
+            this.cleanup();
+        });
+        // Create JSON-RPC connection
+        this.connection = createProtocolConnection(new StreamMessageReader(child.stdout), new StreamMessageWriter(child.stdin));
+        this.connection.listen();
+        // Initialize — clean up resources on any failure
+        try {
+            const rootUri = pathToFileURL(this.options.rootPath).toString();
+            const initParams = {
+                processId: process.pid,
+                rootUri,
+                capabilities: {
+                    textDocument: {
+                        definition: { dynamicRegistration: false },
+                        references: { dynamicRegistration: false },
+                        hover: {
+                            dynamicRegistration: false,
+                            contentFormat: ['plaintext', 'markdown'],
+                        },
+                        callHierarchy: { dynamicRegistration: false },
+                    },
+                },
+                initializationOptions: this.options.initializationOptions,
+            };
+            // Race initialization against spawn error to avoid hanging on ENOENT
+            const result = await Promise.race([
+                this.connection.sendRequest(InitializeRequest.type, initParams),
+                spawnErrorPromise,
+            ]);
+            // Notify initialized
+            this.connection.sendNotification('initialized', {});
+            this.initialized = true;
+            this.resetIdleTimer();
+            logInfo('lsp-client', `${this.options.command} initialized for ${this.options.rootPath}`);
+            return result;
+        }
+        catch (error) {
+            // Clean up the spawned process and connection so nothing leaks
+            this.cleanup();
+            throw error;
+        }
+    }
+    /**
+     * Open a text document in the server (or re-sync it if disk content changed).
+     *
+     * If the document is already open and unchanged, this is a no-op.
+     * If the document was opened before but the file has since been modified
+     * on disk (detected via mtime tracking in the file watcher), the server
+     * receives a DidChange notification with the updated text.
+     */
+    async openDocument(filePath) {
+        if (!this.connection)
+            throw new Error('LSP client not started');
+        const uri = pathToFileURL(filePath).toString();
+        const existingVersion = this.openDocuments.get(uri);
+        if (existingVersion === undefined) {
+            // First open: read from disk and send DidOpen
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const languageId = this.detectLanguageId(filePath);
+            this.connection.sendNotification(DidOpenTextDocumentNotification.type, {
+                textDocument: {
+                    uri,
+                    languageId,
+                    version: 1,
+                    text: content,
+                },
+            });
+            this.openDocuments.set(uri, 1);
+            // Watch for external edits so we can push DidChange on next use
+            this.watchFile(filePath, uri);
+        }
+        // If already open the watcher keeps the version current; nothing to do here.
+        this.resetIdleTimer();
+    }
+    /**
+     * Close a text document and stop watching it for changes.
+     */
+    async closeDocument(filePath) {
+        if (!this.connection)
+            return;
+        const uri = pathToFileURL(filePath).toString();
+        if (!this.openDocuments.has(uri))
+            return;
+        this.connection.sendNotification(DidCloseTextDocumentNotification.type, {
+            textDocument: { uri },
+        });
+        this.openDocuments.delete(uri);
+        this.unwatchFile(uri);
+    }
+    // ============================================================================
+    // File watching — detect external edits while a document is open
+    // ============================================================================
+    watchFile(filePath, uri) {
+        try {
+            const watcher = fs.watch(filePath, { persistent: false }, (event) => {
+                if (event === 'change') {
+                    // Debounce: Windows (and sometimes macOS) fires duplicate 'change' events.
+                    // Coalesce within 100ms to avoid flooding the LSP server.
+                    const existing = this.fileChangeTimers.get(uri);
+                    if (existing)
+                        clearTimeout(existing);
+                    this.fileChangeTimers.set(uri, setTimeout(() => {
+                        this.fileChangeTimers.delete(uri);
+                        this.onFileChanged(filePath, uri);
+                    }, 100));
+                }
+            });
+            this.fileWatchers.set(uri, watcher);
+        }
+        catch (error) {
+            // Non-fatal: if we can't watch, the document just won't auto-refresh
+            logWarn('lsp-client', `Failed to watch file ${filePath}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    unwatchFile(uri) {
+        const timer = this.fileChangeTimers.get(uri);
+        if (timer) {
+            clearTimeout(timer);
+            this.fileChangeTimers.delete(uri);
+        }
+        const watcher = this.fileWatchers.get(uri);
+        if (watcher) {
+            watcher.close();
+            this.fileWatchers.delete(uri);
+        }
+    }
+    /**
+     * Called when a watched file changes on disk.
+     * Sends DidChange so the server sees the updated content.
+     */
+    onFileChanged(filePath, uri) {
+        if (!this.connection || !this.openDocuments.has(uri))
+            return;
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return; // File may have been deleted; don't crash
+        }
+        const nextVersion = (this.openDocuments.get(uri) ?? 1) + 1;
+        this.openDocuments.set(uri, nextVersion);
+        this.connection.sendNotification(DidChangeTextDocumentNotification.type, {
+            textDocument: { uri, version: nextVersion },
+            contentChanges: [{ text: content }],
+        });
+    }
+    /**
+     * Find the definition of a symbol at a position.
+     */
+    async definition(filePath, line, character) {
+        if (!this.connection)
+            throw new Error('LSP client not started');
+        this.resetIdleTimer();
+        await this.openDocument(filePath);
+        const uri = pathToFileURL(filePath).toString();
+        const result = await this.connection.sendRequest(DefinitionRequest.type, {
+            textDocument: { uri },
+            position: { line, character },
+        });
+        return this.normalizeLocations(result);
+    }
+    /**
+     * Find all references to a symbol at a position.
+     */
+    async references(filePath, line, character, includeDeclaration = true) {
+        if (!this.connection)
+            throw new Error('LSP client not started');
+        this.resetIdleTimer();
+        await this.openDocument(filePath);
+        const uri = pathToFileURL(filePath).toString();
+        const result = await this.connection.sendRequest(ReferencesRequest.type, {
+            textDocument: { uri },
+            position: { line, character },
+            context: { includeDeclaration },
+        });
+        return this.normalizeLocations(result);
+    }
+    /**
+     * Get hover information for a symbol at a position.
+     */
+    async hover(filePath, line, character) {
+        if (!this.connection)
+            throw new Error('LSP client not started');
+        this.resetIdleTimer();
+        await this.openDocument(filePath);
+        const uri = pathToFileURL(filePath).toString();
+        const result = await this.connection.sendRequest(HoverRequest.type, {
+            textDocument: { uri },
+            position: { line, character },
+        });
+        if (!result?.contents)
+            return null;
+        if (typeof result.contents === 'string')
+            return result.contents;
+        if ('value' in result.contents)
+            return result.contents.value;
+        if (Array.isArray(result.contents)) {
+            return result.contents.map((c) => (typeof c === 'string' ? c : c.value)).join('\n');
+        }
+        return null;
+    }
+    /**
+     * Gracefully shutdown the server.
+     */
+    async shutdown() {
+        if (!this.connection || !this.initialized)
+            return;
+        this.clearIdleTimer();
+        try {
+            // Close all open documents
+            for (const uri of this.openDocuments.keys()) {
+                this.connection.sendNotification(DidCloseTextDocumentNotification.type, {
+                    textDocument: { uri },
+                });
+            }
+            // Send shutdown request
+            await this.connection.sendRequest(ShutdownRequest.type);
+            // Send exit notification
+            this.connection.sendNotification(ExitNotification.type);
+        }
+        catch (error) {
+            logWarn('lsp-client', 'Error during shutdown', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        this.cleanup();
+    }
+    /**
+     * Check if the client is connected and initialized.
+     */
+    get isReady() {
+        return this.initialized && this.connection !== null;
+    }
+    // ============================================================================
+    // Internal
+    // ============================================================================
+    cleanup() {
+        this.clearIdleTimer();
+        this.initialized = false;
+        // Cancel pending file-change debounce timers
+        for (const timer of this.fileChangeTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.fileChangeTimers.clear();
+        // Stop all file watchers
+        for (const watcher of this.fileWatchers.values()) {
+            watcher.close();
+        }
+        this.fileWatchers.clear();
+        // Clear document tracking so stale state doesn't persist across restarts
+        this.openDocuments.clear();
+        if (this.connection) {
+            this.connection.dispose();
+            this.connection = null;
+        }
+        if (this.process) {
+            if (!this.process.killed) {
+                this.process.kill('SIGTERM');
+            }
+            this.process = null;
+        }
+    }
+    resetIdleTimer() {
+        this.clearIdleTimer();
+        this.idleTimer = setTimeout(() => {
+            logInfo('lsp-client', `Idle timeout reached, shutting down ${this.options.command}`);
+            this.shutdown().catch((err) => {
+                logWarn('lsp-client', 'Shutdown failed on idle timeout', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }, this.idleTimeoutMs);
+    }
+    clearIdleTimer() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+    normalizeLocations(result) {
+        if (!result)
+            return [];
+        const items = Array.isArray(result) ? result : [result];
+        // Convert LocationLink to Location format
+        const locations = items.map((item) => {
+            if ('targetUri' in item) {
+                // LocationLink
+                return { uri: item.targetUri, range: item.targetRange };
+            }
+            return item;
+        });
+        return locations.map((loc) => {
+            // Use fileURLToPath for correct percent-decoding and platform handling
+            let normalizedPath;
+            if (loc.uri.startsWith('file://')) {
+                normalizedPath = fileURLToPath(loc.uri);
+            }
+            else {
+                try {
+                    normalizedPath = new URL(loc.uri).pathname;
+                }
+                catch (err) {
+                    logWarn('lsp-client', `Malformed URI in location result: ${loc.uri}: ${err}`);
+                    normalizedPath = loc.uri;
+                }
+            }
+            return {
+                uri: loc.uri,
+                filePath: normalizedPath,
+                line: loc.range.start.line,
+                character: loc.range.start.character,
+                endLine: loc.range.end.line,
+                endCharacter: loc.range.end.character,
+            };
+        });
+    }
+    detectLanguageId(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        const map = {
+            '.ts': 'typescript',
+            '.tsx': 'typescriptreact',
+            '.js': 'javascript',
+            '.jsx': 'javascriptreact',
+            '.py': 'python',
+            '.go': 'go',
+            '.rs': 'rust',
+            '.cs': 'csharp',
+            '.c': 'c',
+            '.cpp': 'cpp',
+            '.h': 'c',
+            '.hpp': 'cpp',
+            '.rb': 'ruby',
+            '.java': 'java',
+            '.kt': 'kotlin',
+            '.vue': 'vue',
+            '.svelte': 'svelte',
+            '.swift': 'swift',
+        };
+        return map[ext] ?? 'plaintext';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/lsp/client.js.map

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

package/dist/lsp/installer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * LSP Auto-Installer — installs LSP servers on demand via npm or runtime tools.
+ *
+ * Install location: ~/.succ/lsp-servers/<name>/
+ * Strategies: npm (Tier 1), runtime (Tier 2). Binary download (Tier 3) is defined but not yet implemented.
+ * Security: npm --ignore-scripts, server name validation.
+ */
+import type { LspServerConfig } from './servers.js';
+/** Base directory for LSP server installations */
+export declare function getServersDir(): string;
+/**
+ * Validate a server name to prevent path traversal.
+ * Allows only alphanumeric characters, hyphens, underscores, and dots.
+ * Rejects absolute paths, path separators, and `..` components.
+ */
+export declare function validateServerName(serverName: string): void;
+/** Get install path for a specific server */
+export declare function getServerPath(serverName: string): string;
+/** Get the binary path for a server after installation */
+export declare function getServerBinaryPath(serverName: string, command: string): string;
+/**
+ * Check if a server is already installed.
+ */
+export declare function isServerInstalled(serverName: string, command: string): boolean;
+/**
+ * Install an LSP server.
+ *
+ * @returns true if installation succeeded
+ */
+export declare function installServer(serverName: string, config: LspServerConfig): Promise<boolean>;
+/**
+ * Uninstall a server.
+ */
+export declare function uninstallServer(serverName: string): boolean;
+/**
+ * List installed servers.
+ */
+export declare function listInstalledServers(): string[];
+//# sourceMappingURL=installer.d.ts.map

package/dist/lsp/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/lsp/installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,cAAc,CAAC;AAMrE,kDAAkD;AAClD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWxD;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB/E;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAsB9E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBjG;AAuID;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAc3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAgB/C"}