@vinaes/succ 1.4.0 → 1.5.37

package/dist/lsp/installer.js

@@ -0,0 +1,275 @@
+/**
+ * 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 { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { logInfo, logWarn } from '../lib/fault-logger.js';
+// ============================================================================
+// Paths
+// ============================================================================
+/** Base directory for LSP server installations */
+export function getServersDir() {
+    return path.join(os.homedir(), '.succ', 'lsp-servers');
+}
+/**
+ * Validate a server name to prevent path traversal.
+ * Allows only alphanumeric characters, hyphens, underscores, and dots.
+ * Rejects absolute paths, path separators, and `..` components.
+ */
+export function validateServerName(serverName) {
+    if (!serverName || serverName.length === 0) {
+        throw new Error('Server name must not be empty');
+    }
+    if (!/^[a-zA-Z0-9._-]+$/.test(serverName)) {
+        throw new Error(`Invalid server name "${serverName}": only alphanumeric characters, hyphens, underscores, and dots are allowed`);
+    }
+    // Reject dot-only names and names containing '..' components
+    if (serverName === '.' || serverName === '..' || serverName.includes('..')) {
+        throw new Error(`Invalid server name "${serverName}": path traversal not allowed`);
+    }
+}
+/** Get install path for a specific server */
+export function getServerPath(serverName) {
+    validateServerName(serverName);
+    const resolved = path.resolve(getServersDir(), serverName);
+    // Guard: ensure the resolved path stays inside the managed directory
+    if (!resolved.startsWith(path.resolve(getServersDir()) + path.sep) &&
+        resolved !== path.resolve(getServersDir())) {
+        throw new Error(`Server path "${resolved}" escapes the managed directory`);
+    }
+    return resolved;
+}
+/** Get the binary path for a server after installation */
+export function getServerBinaryPath(serverName, command) {
+    if (!command) {
+        throw new Error('LSP command must not be empty');
+    }
+    // Validate command to prevent path traversal
+    const basename = path.basename(command);
+    if (basename !== command || command.includes('..')) {
+        throw new Error(`Invalid LSP command "${command}": path traversal not allowed`);
+    }
+    const serverDir = getServerPath(serverName);
+    const npmBin = path.join(serverDir, 'node_modules', '.bin', command);
+    if (fs.existsSync(npmBin))
+        return npmBin;
+    if (fs.existsSync(npmBin + '.cmd'))
+        return npmBin + '.cmd';
+    // Try direct path (for binary downloads or runtime installs)
+    const direct = path.join(serverDir, command);
+    if (fs.existsSync(direct))
+        return direct;
+    // Fall back to global command
+    return command;
+}
+// ============================================================================
+// Installation
+// ============================================================================
+/**
+ * Check if a server is already installed.
+ */
+export function isServerInstalled(serverName, command) {
+    const binaryPath = getServerBinaryPath(serverName, command);
+    // Check if it's in our managed directory (append sep to avoid matching siblings)
+    const serversDir = getServersDir() + path.sep;
+    if (binaryPath.startsWith(serversDir)) {
+        return fs.existsSync(binaryPath);
+    }
+    // Check if it's available globally
+    try {
+        execFileSync(command, ['--version'], {
+            stdio: 'pipe',
+            timeout: 5000,
+        });
+        return true;
+    }
+    catch (error) {
+        logWarn('lsp-installer', `Server ${command} not found globally`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+}
+/**
+ * Install an LSP server.
+ *
+ * @returns true if installation succeeded
+ */
+export async function installServer(serverName, config) {
+    const serverDir = getServerPath(serverName);
+    try {
+        switch (config.install.type) {
+            case 'npm':
+                return installViaNpm(serverName, serverDir, config.install);
+            case 'runtime':
+                return installViaRuntime(serverName, config.install);
+            case 'binary':
+                logWarn('lsp-installer', `Binary download not yet implemented for ${serverName}`);
+                return false;
+            default:
+                return false;
+        }
+    }
+    catch (error) {
+        logWarn('lsp-installer', `Failed to install ${serverName}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+}
+/**
+ * Install via npm (Tier 1 strategy).
+ */
+function installViaNpm(serverName, serverDir, strategy) {
+    // Install into a temp directory first so a failed install cannot delete a
+    // previously working version of the server.
+    const tmpDir = `${serverDir}.tmp`;
+    // Clean up any leftover temp dir from a previous failed attempt
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch (cleanupErr) {
+        logWarn('lsp-installer', `Failed to remove stale temp dir for ${serverName}`, {
+            error: cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr),
+        });
+    }
+    fs.mkdirSync(tmpDir, { recursive: true });
+    // Initialize package.json
+    const pkgJson = path.join(tmpDir, 'package.json');
+    fs.writeFileSync(pkgJson, JSON.stringify({ name: `succ-lsp-${serverName}`, private: true }));
+    // Install packages with --ignore-scripts for security
+    logInfo('lsp-installer', `Installing ${serverName} via npm: ${strategy.packages.join(', ')}`);
+    try {
+        execFileSync('npm', ['install', '--ignore-scripts', ...strategy.packages], {
+            cwd: tmpDir,
+            stdio: 'pipe',
+            timeout: 120000,
+        });
+    }
+    catch (error) {
+        // Clean up temp dir only — never touch serverDir so an existing working
+        // install is preserved.
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch (cleanupErr) {
+            logWarn('lsp-installer', `Failed to clean up temp install dir for ${serverName}`, {
+                error: cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr),
+            });
+        }
+        throw error;
+    }
+    // Atomically replace the existing install (if any) with the new one.
+    // Must remove serverDir first — fs.renameSync fails on Windows if the
+    // destination exists. If removal fails, clean up tmpDir and rethrow so
+    // the caller sees a clean failure rather than a stranded temp directory.
+    if (fs.existsSync(serverDir)) {
+        try {
+            fs.rmSync(serverDir, { recursive: true, force: true });
+        }
+        catch (cleanupErr) {
+            const msg = cleanupErr instanceof Error ? cleanupErr.message : String(cleanupErr);
+            logWarn('lsp-installer', `Failed to remove old install dir for ${serverName}`, {
+                error: msg,
+            });
+            // Clean up temp dir so it doesn't accumulate on repeated failures
+            try {
+                fs.rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch (tmpCleanupErr) {
+                logWarn('lsp-installer', `Failed to clean up temp dir for ${serverName} after removal failure`, { error: tmpCleanupErr instanceof Error ? tmpCleanupErr.message : String(tmpCleanupErr) });
+            }
+            throw new Error(`Cannot replace existing install for ${serverName}: ${msg}`, {
+                cause: cleanupErr,
+            });
+        }
+    }
+    fs.renameSync(tmpDir, serverDir);
+    logInfo('lsp-installer', `Successfully installed ${serverName}`);
+    return true;
+}
+/**
+ * Install via runtime (Tier 2 strategy).
+ */
+function installViaRuntime(serverName, strategy) {
+    // Check if runtime is available
+    const checkParts = strategy.check.split(/\s+/);
+    try {
+        execFileSync(checkParts[0], checkParts.slice(1), { stdio: 'pipe', timeout: 5000 });
+    }
+    catch (error) {
+        logWarn('lsp-installer', `Cannot install ${serverName}: ${strategy.hint}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+    logInfo('lsp-installer', `Installing ${serverName}: ${strategy.installCmd.join(' ')}`);
+    execFileSync(strategy.installCmd[0], strategy.installCmd.slice(1), {
+        stdio: 'pipe',
+        timeout: 300000,
+    });
+    // Record runtime install in manifest so listInstalledServers() can find it
+    recordRuntimeInstall(serverName, strategy);
+    logInfo('lsp-installer', `Successfully installed ${serverName}`);
+    return true;
+}
+/**
+ * Record a runtime install in a manifest file under the server directory.
+ * This makes runtime installs visible to listInstalledServers() and
+ * allows uninstallServer() to know the install type.
+ */
+function recordRuntimeInstall(serverName, strategy) {
+    const serverDir = getServerPath(serverName);
+    fs.mkdirSync(serverDir, { recursive: true });
+    const manifest = {
+        type: 'runtime',
+        installedAt: new Date().toISOString(),
+        check: strategy.check,
+        installCmd: strategy.installCmd,
+    };
+    fs.writeFileSync(path.join(serverDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+}
+/**
+ * Uninstall a server.
+ */
+export function uninstallServer(serverName) {
+    const serverDir = getServerPath(serverName);
+    if (!fs.existsSync(serverDir))
+        return true;
+    try {
+        fs.rmSync(serverDir, { recursive: true, force: true });
+        logInfo('lsp-installer', `Uninstalled ${serverName}`);
+        return true;
+    }
+    catch (error) {
+        logWarn('lsp-installer', `Failed to uninstall ${serverName}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+}
+/**
+ * List installed servers.
+ */
+export function listInstalledServers() {
+    const dir = getServersDir();
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir).filter((entry) => {
+        const full = path.join(dir, entry);
+        try {
+            return fs.statSync(full).isDirectory();
+        }
+        catch (e) {
+            logWarn('lsp-installer', `Skipping vanished entry ${entry}: ${e instanceof Error ? e.message : String(e)}`);
+            return false;
+        }
+    });
+}
+//# sourceMappingURL=installer.js.map

package/dist/lsp/installer.js.map

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

package/dist/lsp/manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * LSP Manager — manages LSP server instances per language:root.
+ *
+ * Lifecycle:
+ * 1. Detect project language from marker files
+ * 2. Auto-install LSP server if missing (configurable)
+ * 3. Spawn server on first query (lazy)
+ * 4. Keep server alive across queries (singleton per language:root)
+ * 5. Idle timeout: kill after 10 min of inactivity
+ * 6. Graceful degradation: LSP unavailable → return null
+ */
+import { LspClient, type LspLocation } from './client.js';
+export interface LspQueryResult {
+    locations: LspLocation[];
+    /** Whether the result came from LSP (true) or null/empty (false = fallback needed) */
+    fromLsp: boolean;
+    /** Server name that handled the query */
+    server?: string;
+}
+/**
+ * Get or create an LSP client for a given language and project root.
+ *
+ * @param language - Language key (e.g. 'typescript', 'python')
+ * @param rootPath - Project root directory
+ * @param autoInstall - Whether to auto-install if server is missing (default: true)
+ */
+export declare function getClient(language: string, rootPath: string, autoInstall?: boolean): Promise<LspClient | null>;
+/**
+ * Find definition of a symbol.
+ *
+ * @param filePath - File containing the symbol
+ * @param line - 0-based line number
+ * @param character - 0-based character offset
+ * @param rootPath - Project root
+ */
+export declare function findDefinition(filePath: string, line: number, character: number, rootPath: string): Promise<LspQueryResult>;
+/**
+ * Find all references to a symbol.
+ */
+export declare function findReferences(filePath: string, line: number, character: number, rootPath: string, includeDeclaration?: boolean): Promise<LspQueryResult>;
+/**
+ * Get hover information.
+ */
+export declare function getHover(filePath: string, line: number, character: number, rootPath: string): Promise<{
+    content: string | null;
+    fromLsp: boolean;
+}>;
+/**
+ * Shutdown all active LSP clients, including any still initializing.
+ *
+ * Clients whose `start()` is in-flight (present in `initializing`) are awaited
+ * first so that their process is never left running after this function returns.
+ */
+export declare function shutdownAll(): Promise<void>;
+/**
+ * Get status of all active LSP clients.
+ */
+export declare function getStatus(): Array<{
+    key: string;
+    ready: boolean;
+}>;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/lsp/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,OAAc,GAC1B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAuB3B;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,OAAc,GACjC,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBvD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqCjD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAKlE"}

package/dist/lsp/manager.js

@@ -0,0 +1,234 @@
+/**
+ * LSP Manager — manages LSP server instances per language:root.
+ *
+ * Lifecycle:
+ * 1. Detect project language from marker files
+ * 2. Auto-install LSP server if missing (configurable)
+ * 3. Spawn server on first query (lazy)
+ * 4. Keep server alive across queries (singleton per language:root)
+ * 5. Idle timeout: kill after 10 min of inactivity
+ * 6. Graceful degradation: LSP unavailable → return null
+ */
+import * as path from 'path';
+import { LspClient } from './client.js';
+import { LSP_SERVERS } from './servers.js';
+import { installServer, isServerInstalled, getServerBinaryPath } from './installer.js';
+import { logInfo, logWarn } from '../lib/fault-logger.js';
+const clients = new Map();
+const initializing = new Map();
+/**
+ * Get or create an LSP client for a given language and project root.
+ *
+ * @param language - Language key (e.g. 'typescript', 'python')
+ * @param rootPath - Project root directory
+ * @param autoInstall - Whether to auto-install if server is missing (default: true)
+ */
+export async function getClient(language, rootPath, autoInstall = true) {
+    const key = `${language}:${rootPath}`;
+    // Return existing client if ready
+    const existing = clients.get(key);
+    if (existing?.isReady)
+        return existing;
+    // Prevent duplicate initialization
+    const pending = initializing.get(key);
+    if (pending)
+        return pending;
+    const promise = initializeClient(language, rootPath, autoInstall);
+    initializing.set(key, promise);
+    try {
+        const client = await promise;
+        if (client) {
+            clients.set(key, client);
+        }
+        return client;
+    }
+    finally {
+        initializing.delete(key);
+    }
+}
+/**
+ * Find definition of a symbol.
+ *
+ * @param filePath - File containing the symbol
+ * @param line - 0-based line number
+ * @param character - 0-based character offset
+ * @param rootPath - Project root
+ */
+export async function findDefinition(filePath, line, character, rootPath) {
+    const language = detectLanguageFromFile(filePath);
+    if (!language)
+        return { locations: [], fromLsp: false };
+    const client = await getClient(language, rootPath);
+    if (!client)
+        return { locations: [], fromLsp: false };
+    try {
+        const locations = await client.definition(filePath, line, character);
+        return { locations, fromLsp: true, server: language };
+    }
+    catch (error) {
+        logWarn('lsp-manager', `Definition query failed for ${filePath}:${line}:${character}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return { locations: [], fromLsp: false };
+    }
+}
+/**
+ * Find all references to a symbol.
+ */
+export async function findReferences(filePath, line, character, rootPath, includeDeclaration = true) {
+    const language = detectLanguageFromFile(filePath);
+    if (!language)
+        return { locations: [], fromLsp: false };
+    const client = await getClient(language, rootPath);
+    if (!client)
+        return { locations: [], fromLsp: false };
+    try {
+        const locations = await client.references(filePath, line, character, includeDeclaration);
+        return { locations, fromLsp: true, server: language };
+    }
+    catch (error) {
+        logWarn('lsp-manager', `References query failed for ${filePath}:${line}:${character}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return { locations: [], fromLsp: false };
+    }
+}
+/**
+ * Get hover information.
+ */
+export async function getHover(filePath, line, character, rootPath) {
+    const language = detectLanguageFromFile(filePath);
+    if (!language)
+        return { content: null, fromLsp: false };
+    const client = await getClient(language, rootPath);
+    if (!client)
+        return { content: null, fromLsp: false };
+    try {
+        const content = await client.hover(filePath, line, character);
+        return { content, fromLsp: true };
+    }
+    catch (error) {
+        logWarn('lsp-manager', `Hover query failed for ${filePath}:${line}:${character}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return { content: null, fromLsp: false };
+    }
+}
+/**
+ * Shutdown all active LSP clients, including any still initializing.
+ *
+ * Clients whose `start()` is in-flight (present in `initializing`) are awaited
+ * first so that their process is never left running after this function returns.
+ */
+export async function shutdownAll() {
+    // Collect already-resolved clients
+    const clientShutdowns = Array.from(clients.entries()).map(async ([key, client]) => {
+        try {
+            await client.shutdown();
+        }
+        catch (error) {
+            logWarn('lsp-manager', `Failed to shutdown ${key}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    // Also await any in-flight initializations and shut down the resulting clients
+    const initializingShutdowns = Array.from(initializing.entries()).map(async ([key, promise]) => {
+        let initClient;
+        try {
+            initClient = await promise;
+        }
+        catch {
+            // Initialization failed — no client to shut down
+            return;
+        }
+        if (!initClient)
+            return;
+        try {
+            await initClient.shutdown();
+        }
+        catch (error) {
+            logWarn('lsp-manager', `Failed to shutdown in-flight client ${key}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    await Promise.all([...clientShutdowns, ...initializingShutdowns]);
+    clients.clear();
+    // initializing entries remove themselves in getClient's finally block;
+    // clearing here ensures no stale entries remain even if called out of order.
+    initializing.clear();
+    logInfo('lsp-manager', 'All LSP clients shut down');
+}
+/**
+ * Get status of all active LSP clients.
+ */
+export function getStatus() {
+    return Array.from(clients.entries()).map(([key, client]) => ({
+        key,
+        ready: client.isReady,
+    }));
+}
+// ============================================================================
+// Internal
+// ============================================================================
+async function initializeClient(language, rootPath, autoInstall) {
+    const config = LSP_SERVERS[language];
+    if (!config) {
+        logWarn('lsp-manager', `No LSP server config for language: ${language}`);
+        return null;
+    }
+    // Check if installed
+    if (!isServerInstalled(language, config.command)) {
+        if (!autoInstall) {
+            logInfo('lsp-manager', `${config.name} not installed and auto-install disabled`);
+            return null;
+        }
+        logInfo('lsp-manager', `Auto-installing ${config.name}...`);
+        const installed = await installServer(language, config);
+        if (!installed) {
+            logWarn('lsp-manager', `Failed to auto-install ${config.name}`);
+            return null;
+        }
+    }
+    // Get the actual command path
+    const command = getServerBinaryPath(language, config.command);
+    try {
+        const client = new LspClient({
+            command,
+            args: config.args,
+            rootPath,
+            initializationOptions: config.initializationOptions,
+            idleTimeoutMs: config.idleTimeoutMs,
+        });
+        await client.start();
+        logInfo('lsp-manager', `${config.name} started for ${rootPath}`);
+        return client;
+    }
+    catch (error) {
+        logWarn('lsp-manager', `Failed to start ${config.name}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return null;
+    }
+}
+function detectLanguageFromFile(filePath) {
+    const ext = path.extname(filePath).slice(1).toLowerCase();
+    if (!ext)
+        return null;
+    const extMap = {
+        ts: 'typescript',
+        tsx: 'typescript',
+        js: 'typescript',
+        jsx: 'typescript',
+        py: 'python',
+        go: 'go',
+        rs: 'rust',
+        cs: 'csharp',
+        kt: 'kotlin',
+        kts: 'kotlin',
+        swift: 'swift',
+    };
+    return extMap[ext] ?? null;
+}
+//# sourceMappingURL=manager.js.map

package/dist/lsp/manager.js.map

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

package/dist/lsp/servers.d.ts

@@ -0,0 +1,52 @@
+/**
+ * LSP Server Definitions — per-language server configuration.
+ *
+ * Defines how to detect, install, and start LSP servers for each language.
+ * Three install strategies: npm, binary download, or runtime check.
+ */
+export type InstallStrategy = {
+    type: 'npm';
+    packages: string[];
+} | {
+    type: 'binary';
+    repo: string;
+    asset: string;
+} | {
+    type: 'runtime';
+    check: string;
+    installCmd: string[];
+    hint: string;
+};
+export interface LspServerConfig {
+    /** Human-readable name */
+    name: string;
+    /** Language IDs this server handles */
+    languages: string[];
+    /** How to detect if project uses this language */
+    rootMarkers: string[];
+    /** How to install the server */
+    install: InstallStrategy;
+    /** Command to start the server */
+    command: string;
+    /** Arguments for the server command */
+    args: string[];
+    /** Additional initialization options for the LSP server */
+    initializationOptions?: Record<string, unknown>;
+    /** Server capabilities to request */
+    capabilities?: Record<string, unknown>;
+    /** Idle timeout before killing (default: 600000ms = 10min) */
+    idleTimeoutMs?: number;
+    /** Support tier: 1=auto-install, 2=needs runtime, 3=community */
+    tier: 1 | 2 | 3;
+}
+export declare const LSP_SERVERS: Record<string, LspServerConfig>;
+/**
+ * Detect which LSP servers should be used for a project.
+ * Checks for root marker files (exact names) and glob-style markers (e.g. "*.csproj").
+ *
+ * @param rootPath - Absolute path to the project root directory
+ * @param existsSync - Predicate to test whether a path exists (injectable for tests)
+ * @param readdirSync - Read a directory and return its entry names (injectable for tests)
+ */
+export declare function detectProjectLanguages(rootPath: string, existsSync: (path: string) => boolean, readdirSync?: (path: string) => string[]): string[];
+//# sourceMappingURL=servers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../src/lsp/servers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gCAAgC;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACjB;AAMD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA+GvD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACrC,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAuB,GAC3D,MAAM,EAAE,CA2BV"}