@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * LSP Client — JSON-RPC client for LSP servers.
+ *
+ * Supports two modes:
+ * - **Direct**: spawns LSP server as child process (stdio)
+ * - **Socket**: connects to an LSP daemon via Unix domain socket
+ *
+ * Uses vscode-jsonrpc (bundled with vscode-languageserver-protocol) for
+ * JSON-RPC message framing and transport.
+ */
+import type { ServerCapabilities, Diagnostic } from "vscode-languageserver-protocol";
+export interface LspClientOptions {
+    /** Command to start the LSP server */
+    command: string;
+    /** Arguments for the command */
+    args: string[];
+    /** Root directory of the workspace */
+    rootDir: string;
+    /** Language ID this server handles */
+    languageId: string;
+    /** Extra environment variables */
+    env?: Record<string, string>;
+    /** Additional workspace folders (e.g. for multi-package workspaces) */
+    workspaceFolders?: {
+        uri: string;
+        name: string;
+    }[];
+    /** Connect to existing daemon socket instead of spawning a new process */
+    socketPath?: string;
+    /** LSP initializationOptions (e.g. jdtls settings for Lombok) */
+    initializationOptions?: Record<string, unknown>;
+    /** Settings returned by workspace/configuration handler (keyed by section, e.g. { intelephense: {...} }) */
+    settings?: Record<string, unknown>;
+    /** Called when the server exits unexpectedly (not from user-initiated shutdown) */
+    onUnexpectedExit?: (code: number | null) => void;
+}
+export declare class LspClient {
+    private options;
+    private process;
+    private socket;
+    private connection;
+    private _serverCapabilities;
+    private _diagnostics;
+    private _initialized;
+    private _disposed;
+    /** True if connected to a daemon socket (server init handled by daemon) */
+    private _isDaemonClient;
+    readonly languageId: string;
+    readonly command: string;
+    readonly rootDir: string;
+    constructor(options: LspClientOptions);
+    get initialized(): boolean;
+    get disposed(): boolean;
+    get serverCapabilities(): ServerCapabilities | null;
+    /** Get cached diagnostics for a URI */
+    getDiagnostics(uri: string): Diagnostic[];
+    /** Get all cached diagnostics */
+    getAllDiagnostics(): Map<string, Diagnostic[]>;
+    /** Start the LSP server and perform the initialize handshake */
+    start(): Promise<void>;
+    /** Register shared connection handlers (diagnostics, workspace/configuration, errors) */
+    private registerConnectionHandlers;
+    private connectToSocket;
+    private spawnDirect;
+    /** Safely dispose the connection without throwing */
+    private disposeConnection;
+    /** Send a request to the LSP server */
+    sendRequest<R>(method: string, params: unknown): Promise<R>;
+    /** Send a notification to the LSP server */
+    sendNotification(method: string, params: unknown): void;
+    /** Notify server of a newly opened document */
+    didOpen(uri: string, languageId: string, version: number, text: string): void;
+    /** Notify server of a document change (full content sync) */
+    didChange(uri: string, version: number, text: string): void;
+    /** Notify server of a closed document */
+    didClose(uri: string): void;
+    /** Gracefully shut down or disconnect from the server */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=lsp-client.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-client.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/lsp-client.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * LSP Client — JSON-RPC client for LSP servers.\n *\n * Supports two modes:\n * - **Direct**: spawns LSP server as child process (stdio)\n * - **Socket**: connects to an LSP daemon via Unix domain socket\n *\n * Uses vscode-jsonrpc (bundled with vscode-languageserver-protocol) for\n * JSON-RPC message framing and transport.\n */\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { connect as netConnect, type Socket } from \"node:net\";\nimport { pathToFileURL } from \"node:url\";\nimport {\n  createMessageConnection,\n  StreamMessageReader,\n  StreamMessageWriter,\n  SocketMessageReader,\n  SocketMessageWriter,\n  type MessageConnection,\n} from \"vscode-languageserver-protocol/node\";\nimport type {\n  InitializeParams,\n  InitializeResult,\n  ServerCapabilities,\n  Diagnostic,\n  PublishDiagnosticsParams,\n} from \"vscode-languageserver-protocol\";\n\nexport interface LspClientOptions {\n  /** Command to start the LSP server */\n  command: string;\n  /** Arguments for the command */\n  args: string[];\n  /** Root directory of the workspace */\n  rootDir: string;\n  /** Language ID this server handles */\n  languageId: string;\n  /** Extra environment variables */\n  env?: Record<string, string>;\n  /** Additional workspace folders (e.g. for multi-package workspaces) */\n  workspaceFolders?: { uri: string; name: string }[];\n  /** Connect to existing daemon socket instead of spawning a new process */\n  socketPath?: string;\n  /** LSP initializationOptions (e.g. jdtls settings for Lombok) */\n  initializationOptions?: Record<string, unknown>;\n  /** Settings returned by workspace/configuration handler (keyed by section, e.g. { intelephense: {...} }) */\n  settings?: Record<string, unknown>;\n  /** Called when the server exits unexpectedly (not from user-initiated shutdown) */\n  onUnexpectedExit?: (code: number | null) => void;\n}\n\nexport class LspClient {\n  private process: ChildProcess | null = null;\n  private socket: Socket | null = null;\n  private connection: MessageConnection | null = null;\n  private _serverCapabilities: ServerCapabilities | null = null;\n  private _diagnostics: Map<string, Diagnostic[]> = new Map();\n  private _initialized = false;\n  private _disposed = false;\n  /** True if connected to a daemon socket (server init handled by daemon) */\n  private _isDaemonClient = false;\n\n  readonly languageId: string;\n  readonly command: string;\n  readonly rootDir: string;\n\n  constructor(private options: LspClientOptions) {\n    this.languageId = options.languageId;\n    this.command = options.command;\n    this.rootDir = options.rootDir;\n  }\n\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  get serverCapabilities(): ServerCapabilities | null {\n    return this._serverCapabilities;\n  }\n\n  /** Get cached diagnostics for a URI */\n  getDiagnostics(uri: string): Diagnostic[] {\n    return this._diagnostics.get(uri) ?? [];\n  }\n\n  /** Get all cached diagnostics */\n  getAllDiagnostics(): Map<string, Diagnostic[]> {\n    return new Map(this._diagnostics);\n  }\n\n  /** Start the LSP server and perform the initialize handshake */\n  async start(): Promise<void> {\n    if (this._initialized || this._disposed) return;\n\n    if (this.options.socketPath) {\n      await this.connectToSocket(this.options.socketPath);\n    } else {\n      await this.spawnDirect();\n    }\n  }\n\n  /** Register shared connection handlers (diagnostics, workspace/configuration, errors) */\n  private registerConnectionHandlers(): void {\n    if (!this.connection) return;\n\n    // Listen for published diagnostics\n    this.connection.onNotification(\n      \"textDocument/publishDiagnostics\",\n      (params: PublishDiagnosticsParams) => {\n        this._diagnostics.set(params.uri, params.diagnostics);\n      }\n    );\n\n    // Handle workspace/configuration requests from the server.\n    // Servers like Intelephense request their settings via this method.\n    // Return settings from options if configured, otherwise empty defaults.\n    this.connection.onRequest(\n      \"workspace/configuration\",\n      (params: { items: { section?: string }[] }) => {\n        const settings = this.options.settings;\n        return params.items.map((item) => {\n          if (item.section && settings && item.section in settings) {\n            return settings[item.section];\n          }\n          return {};\n        });\n      }\n    );\n\n    // Handle connection-level errors to prevent unhandled exceptions\n    this.connection.onError(([err]) => {\n      console.error(`[LSP ${this.languageId}] Connection error: ${err.message}`);\n    });\n\n    this.connection.onClose(() => {\n      if (!this._disposed) {\n        this._initialized = false;\n      }\n    });\n  }\n\n  /** Connect to an existing LSP daemon via Unix socket (no init handshake needed) */\n  private async connectToSocket(socketPath: string): Promise<void> {\n    this._isDaemonClient = true;\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      const settle = (fn: () => void) => {\n        if (!settled) { settled = true; fn(); }\n      };\n\n      const socket = netConnect(socketPath, () => {\n        this.socket = socket;\n\n        const reader = new SocketMessageReader(socket);\n        const writer = new SocketMessageWriter(socket);\n        this.connection = createMessageConnection(reader, writer);\n\n        this.registerConnectionHandlers();\n\n        this.connection.listen();\n        this._initialized = true;\n        settle(() => resolve());\n      });\n\n      socket.on(\"error\", (err) => {\n        if (!this._initialized) {\n          settle(() => reject(new Error(`Failed to connect to LSP daemon: ${err.message}`)));\n        } else {\n          this._initialized = false;\n        }\n      });\n\n      socket.on(\"close\", () => {\n        if (!this._disposed) {\n          this._initialized = false;\n          this.options.onUnexpectedExit?.(null);\n        }\n      });\n\n      // Timeout\n      setTimeout(() => {\n        if (!settled) {\n          socket.destroy();\n          settle(() => reject(new Error(\"Timeout connecting to LSP daemon socket\")));\n        }\n      }, 10_000);\n    });\n  }\n\n  /** Spawn LSP server directly as child process with stdio */\n  private async spawnDirect(): Promise<void> {\n    const env = { ...process.env, ...this.options.env };\n\n    this.process = spawn(this.options.command, this.options.args, {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      env,\n      cwd: this.rootDir,\n    });\n\n    if (!this.process.stdout || !this.process.stdin) {\n      throw new Error(`Failed to spawn LSP server: ${this.options.command}`);\n    }\n\n    // Wait for the process to successfully spawn before setting up the connection.\n    // spawn() is async — ENOENT and other errors arrive on the 'error' event.\n    // If we don't wait, we'll try to write to a destroyed stdin and crash.\n    await new Promise<void>((resolve, reject) => {\n      const onSpawn = () => { cleanup(); resolve(); };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(new Error(`Failed to spawn LSP server \"${this.options.command}\": ${err.message}`));\n      };\n      const cleanup = () => {\n        this.process?.removeListener(\"spawn\", onSpawn);\n        this.process?.removeListener(\"error\", onError);\n      };\n      this.process!.on(\"spawn\", onSpawn);\n      this.process!.on(\"error\", onError);\n    });\n\n    // Discard stderr to prevent blocking\n    this.process.stderr?.resume();\n\n    // Patch stdin.write to silently drop writes when the stream is destroyed.\n    // StreamMessageWriter wraps stdin and calls write() which returns a Promise.\n    // If the stream is destroyed (process exited), write() throws ERR_STREAM_DESTROYED\n    // inside the Promise constructor, creating a rejection that propagates through\n    // the writer's semaphore and becomes unhandled (notifications are fire-and-forget).\n    // No amount of error handlers on the stream or connection can catch this.\n    const stdin = this.process.stdin!;\n    const originalWrite = stdin.write;\n    stdin.write = function (this: typeof stdin, ...args: any[]): boolean {\n      if (this.destroyed || this.writableEnded || this.writableFinished) {\n        // Call the callback (last arg) so the Promise resolves instead of rejecting\n        const cb = args[args.length - 1];\n        if (typeof cb === \"function\") process.nextTick(cb);\n        return false;\n      }\n      try {\n        return originalWrite.apply(this, args as any);\n      } catch (err: any) {\n        // Catch EPIPE synchronously — process exited between our check and the write\n        if (err?.code === \"EPIPE\" || err?.code === \"ERR_STREAM_DESTROYED\") {\n          const cb = args[args.length - 1];\n          if (typeof cb === \"function\") process.nextTick(cb);\n          return false;\n        }\n        throw err;\n      }\n    } as any;\n\n    // Catch EPIPE on the stdin stream itself to prevent unhandled error events\n    stdin.on(\"error\", (err: any) => {\n      if (err?.code === \"EPIPE\") return; // expected when server exits\n      console.error(`[LSP ${this.languageId}] stdin error: ${err.message}`);\n    });\n\n    this.process.on(\"error\", (err) => {\n      console.error(`[LSP ${this.languageId}] Process error: ${err.message}`);\n      this._initialized = false;\n      this.disposeConnection();\n    });\n\n    this.process.on(\"exit\", (code) => {\n      if (!this._disposed) {\n        console.error(`[LSP ${this.languageId}] Server exited with code ${code}`);\n        this._initialized = false;\n        this.disposeConnection();\n        this.options.onUnexpectedExit?.(code);\n      }\n    });\n\n    const reader = new StreamMessageReader(this.process.stdout);\n    const writer = new StreamMessageWriter(this.process.stdin);\n    this.connection = createMessageConnection(reader, writer);\n\n    this.registerConnectionHandlers();\n\n    this.connection.listen();\n\n    // Initialize handshake\n    const rootUri = pathToFileURL(this.rootDir).toString();\n    const defaultFolder = { uri: rootUri, name: this.rootDir.split(\"/\").pop() ?? \"workspace\" };\n\n    // Use provided workspace folders or fall back to single root\n    const workspaceFolders = this.options.workspaceFolders && this.options.workspaceFolders.length > 0\n      ? this.options.workspaceFolders\n      : [defaultFolder];\n\n    const initParams: InitializeParams = {\n      processId: process.pid,\n      capabilities: {\n        textDocument: {\n          synchronization: {\n            didSave: true,\n            dynamicRegistration: false,\n          },\n          hover: {\n            contentFormat: [\"plaintext\", \"markdown\"],\n          },\n          definition: {},\n          references: {},\n          documentSymbol: {\n            hierarchicalDocumentSymbolSupport: true,\n          },\n          rename: {\n            prepareSupport: false,\n          },\n          publishDiagnostics: {\n            relatedInformation: true,\n          },\n          completion: {\n            completionItem: {\n              snippetSupport: false,\n            },\n          },\n        },\n        workspace: {\n          workspaceFolders: true,\n          symbol: {},\n          configuration: true,\n        },\n      },\n      rootUri,\n      workspaceFolders,\n      ...(this.options.initializationOptions\n        ? { initializationOptions: this.options.initializationOptions }\n        : {}),\n    };\n\n    const result: InitializeResult = await this.connection.sendRequest(\n      \"initialize\",\n      initParams\n    );\n    this._serverCapabilities = result.capabilities;\n\n    // Send initialized notification\n    this.connection.sendNotification(\"initialized\", {});\n    this._initialized = true;\n  }\n\n  /** Safely dispose the connection without throwing */\n  private disposeConnection(): void {\n    try {\n      if (this.connection) {\n        this.connection.dispose();\n      }\n    } catch {\n      // Already disposed or stream destroyed — ignore\n    }\n    this.connection = null;\n  }\n\n  /** Send a request to the LSP server */\n  async sendRequest<R>(method: string, params: unknown): Promise<R> {\n    if (!this.connection || !this._initialized) {\n      throw new Error(`LSP ${this.languageId} not initialized`);\n    }\n    return this.connection.sendRequest(method, params) as Promise<R>;\n  }\n\n  /** Send a notification to the LSP server */\n  sendNotification(method: string, params: unknown): void {\n    if (!this.connection || !this._initialized) return;\n    this.connection.sendNotification(method, params);\n  }\n\n  /** Notify server of a newly opened document */\n  didOpen(uri: string, languageId: string, version: number, text: string): void {\n    this.sendNotification(\"textDocument/didOpen\", {\n      textDocument: { uri, languageId, version, text },\n    });\n  }\n\n  /** Notify server of a document change (full content sync) */\n  didChange(uri: string, version: number, text: string): void {\n    this.sendNotification(\"textDocument/didChange\", {\n      textDocument: { uri, version },\n      contentChanges: [{ text }],\n    });\n  }\n\n  /** Notify server of a closed document */\n  didClose(uri: string): void {\n    this.sendNotification(\"textDocument/didClose\", {\n      textDocument: { uri },\n    });\n  }\n\n  /** Gracefully shut down or disconnect from the server */\n  async shutdown(): Promise<void> {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._initialized = false;\n\n    if (this._isDaemonClient) {\n      // Socket client: just disconnect — daemon keeps the server alive\n      this.disposeConnection();\n      if (this.socket) {\n        this.socket.destroy();\n      }\n      this.socket = null;\n      return;\n    }\n\n    // Direct mode: shut down the server we own\n    try {\n      if (this.connection) {\n        // Race shutdown request against a timeout. Catch the request separately\n        // so if the timeout wins, the abandoned sendRequest rejection doesn't\n        // become an unhandled promise rejection.\n        const shutdownReq = this.connection.sendRequest(\"shutdown\").catch(() => {});\n        await Promise.race([\n          shutdownReq,\n          new Promise((resolve) => setTimeout(resolve, 3000)),\n        ]);\n        try { this.connection.sendNotification(\"exit\"); } catch {}\n      }\n    } catch {\n      // Server may already be dead\n    }\n    this.disposeConnection();\n\n    if (this.process) {\n      this.process.kill(\"SIGTERM\");\n      // Force kill after 2s\n      setTimeout(() => {\n        if (this.process && !this.process.killed) {\n          this.process.kill(\"SIGKILL\");\n        }\n      }, 2000);\n    }\n\n    this.process = null;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-client.js

@@ -0,0 +1,366 @@
+// @ts-nocheck
+/**
+ * LSP Client — JSON-RPC client for LSP servers.
+ *
+ * Supports two modes:
+ * - **Direct**: spawns LSP server as child process (stdio)
+ * - **Socket**: connects to an LSP daemon via Unix domain socket
+ *
+ * Uses vscode-jsonrpc (bundled with vscode-languageserver-protocol) for
+ * JSON-RPC message framing and transport.
+ */
+import { spawn } from "node:child_process";
+import { connect as netConnect } from "node:net";
+import { pathToFileURL } from "node:url";
+import { createMessageConnection, StreamMessageReader, StreamMessageWriter, SocketMessageReader, SocketMessageWriter, } from "vscode-languageserver-protocol/node";
+export class LspClient {
+    options;
+    process = null;
+    socket = null;
+    connection = null;
+    _serverCapabilities = null;
+    _diagnostics = new Map();
+    _initialized = false;
+    _disposed = false;
+    /** True if connected to a daemon socket (server init handled by daemon) */
+    _isDaemonClient = false;
+    languageId;
+    command;
+    rootDir;
+    constructor(options) {
+        this.options = options;
+        this.languageId = options.languageId;
+        this.command = options.command;
+        this.rootDir = options.rootDir;
+    }
+    get initialized() {
+        return this._initialized;
+    }
+    get disposed() {
+        return this._disposed;
+    }
+    get serverCapabilities() {
+        return this._serverCapabilities;
+    }
+    /** Get cached diagnostics for a URI */
+    getDiagnostics(uri) {
+        return this._diagnostics.get(uri) ?? [];
+    }
+    /** Get all cached diagnostics */
+    getAllDiagnostics() {
+        return new Map(this._diagnostics);
+    }
+    /** Start the LSP server and perform the initialize handshake */
+    async start() {
+        if (this._initialized || this._disposed)
+            return;
+        if (this.options.socketPath) {
+            await this.connectToSocket(this.options.socketPath);
+        }
+        else {
+            await this.spawnDirect();
+        }
+    }
+    /** Register shared connection handlers (diagnostics, workspace/configuration, errors) */
+    registerConnectionHandlers() {
+        if (!this.connection)
+            return;
+        // Listen for published diagnostics
+        this.connection.onNotification("textDocument/publishDiagnostics", (params) => {
+            this._diagnostics.set(params.uri, params.diagnostics);
+        });
+        // Handle workspace/configuration requests from the server.
+        // Servers like Intelephense request their settings via this method.
+        // Return settings from options if configured, otherwise empty defaults.
+        this.connection.onRequest("workspace/configuration", (params) => {
+            const settings = this.options.settings;
+            return params.items.map((item) => {
+                if (item.section && settings && item.section in settings) {
+                    return settings[item.section];
+                }
+                return {};
+            });
+        });
+        // Handle connection-level errors to prevent unhandled exceptions
+        this.connection.onError(([err]) => {
+            console.error(`[LSP ${this.languageId}] Connection error: ${err.message}`);
+        });
+        this.connection.onClose(() => {
+            if (!this._disposed) {
+                this._initialized = false;
+            }
+        });
+    }
+    /** Connect to an existing LSP daemon via Unix socket (no init handshake needed) */
+    async connectToSocket(socketPath) {
+        this._isDaemonClient = true;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const settle = (fn) => {
+                if (!settled) {
+                    settled = true;
+                    fn();
+                }
+            };
+            const socket = netConnect(socketPath, () => {
+                this.socket = socket;
+                const reader = new SocketMessageReader(socket);
+                const writer = new SocketMessageWriter(socket);
+                this.connection = createMessageConnection(reader, writer);
+                this.registerConnectionHandlers();
+                this.connection.listen();
+                this._initialized = true;
+                settle(() => resolve());
+            });
+            socket.on("error", (err) => {
+                if (!this._initialized) {
+                    settle(() => reject(new Error(`Failed to connect to LSP daemon: ${err.message}`)));
+                }
+                else {
+                    this._initialized = false;
+                }
+            });
+            socket.on("close", () => {
+                if (!this._disposed) {
+                    this._initialized = false;
+                    this.options.onUnexpectedExit?.(null);
+                }
+            });
+            // Timeout
+            setTimeout(() => {
+                if (!settled) {
+                    socket.destroy();
+                    settle(() => reject(new Error("Timeout connecting to LSP daemon socket")));
+                }
+            }, 10_000);
+        });
+    }
+    /** Spawn LSP server directly as child process with stdio */
+    async spawnDirect() {
+        const env = { ...process.env, ...this.options.env };
+        this.process = spawn(this.options.command, this.options.args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env,
+            cwd: this.rootDir,
+        });
+        if (!this.process.stdout || !this.process.stdin) {
+            throw new Error(`Failed to spawn LSP server: ${this.options.command}`);
+        }
+        // Wait for the process to successfully spawn before setting up the connection.
+        // spawn() is async — ENOENT and other errors arrive on the 'error' event.
+        // If we don't wait, we'll try to write to a destroyed stdin and crash.
+        await new Promise((resolve, reject) => {
+            const onSpawn = () => { cleanup(); resolve(); };
+            const onError = (err) => {
+                cleanup();
+                reject(new Error(`Failed to spawn LSP server "${this.options.command}": ${err.message}`));
+            };
+            const cleanup = () => {
+                this.process?.removeListener("spawn", onSpawn);
+                this.process?.removeListener("error", onError);
+            };
+            this.process.on("spawn", onSpawn);
+            this.process.on("error", onError);
+        });
+        // Discard stderr to prevent blocking
+        this.process.stderr?.resume();
+        // Patch stdin.write to silently drop writes when the stream is destroyed.
+        // StreamMessageWriter wraps stdin and calls write() which returns a Promise.
+        // If the stream is destroyed (process exited), write() throws ERR_STREAM_DESTROYED
+        // inside the Promise constructor, creating a rejection that propagates through
+        // the writer's semaphore and becomes unhandled (notifications are fire-and-forget).
+        // No amount of error handlers on the stream or connection can catch this.
+        const stdin = this.process.stdin;
+        const originalWrite = stdin.write;
+        stdin.write = function (...args) {
+            if (this.destroyed || this.writableEnded || this.writableFinished) {
+                // Call the callback (last arg) so the Promise resolves instead of rejecting
+                const cb = args[args.length - 1];
+                if (typeof cb === "function")
+                    process.nextTick(cb);
+                return false;
+            }
+            try {
+                return originalWrite.apply(this, args);
+            }
+            catch (err) {
+                // Catch EPIPE synchronously — process exited between our check and the write
+                if (err?.code === "EPIPE" || err?.code === "ERR_STREAM_DESTROYED") {
+                    const cb = args[args.length - 1];
+                    if (typeof cb === "function")
+                        process.nextTick(cb);
+                    return false;
+                }
+                throw err;
+            }
+        };
+        // Catch EPIPE on the stdin stream itself to prevent unhandled error events
+        stdin.on("error", (err) => {
+            if (err?.code === "EPIPE")
+                return; // expected when server exits
+            console.error(`[LSP ${this.languageId}] stdin error: ${err.message}`);
+        });
+        this.process.on("error", (err) => {
+            console.error(`[LSP ${this.languageId}] Process error: ${err.message}`);
+            this._initialized = false;
+            this.disposeConnection();
+        });
+        this.process.on("exit", (code) => {
+            if (!this._disposed) {
+                console.error(`[LSP ${this.languageId}] Server exited with code ${code}`);
+                this._initialized = false;
+                this.disposeConnection();
+                this.options.onUnexpectedExit?.(code);
+            }
+        });
+        const reader = new StreamMessageReader(this.process.stdout);
+        const writer = new StreamMessageWriter(this.process.stdin);
+        this.connection = createMessageConnection(reader, writer);
+        this.registerConnectionHandlers();
+        this.connection.listen();
+        // Initialize handshake
+        const rootUri = pathToFileURL(this.rootDir).toString();
+        const defaultFolder = { uri: rootUri, name: this.rootDir.split("/").pop() ?? "workspace" };
+        // Use provided workspace folders or fall back to single root
+        const workspaceFolders = this.options.workspaceFolders && this.options.workspaceFolders.length > 0
+            ? this.options.workspaceFolders
+            : [defaultFolder];
+        const initParams = {
+            processId: process.pid,
+            capabilities: {
+                textDocument: {
+                    synchronization: {
+                        didSave: true,
+                        dynamicRegistration: false,
+                    },
+                    hover: {
+                        contentFormat: ["plaintext", "markdown"],
+                    },
+                    definition: {},
+                    references: {},
+                    documentSymbol: {
+                        hierarchicalDocumentSymbolSupport: true,
+                    },
+                    rename: {
+                        prepareSupport: false,
+                    },
+                    publishDiagnostics: {
+                        relatedInformation: true,
+                    },
+                    completion: {
+                        completionItem: {
+                            snippetSupport: false,
+                        },
+                    },
+                },
+                workspace: {
+                    workspaceFolders: true,
+                    symbol: {},
+                    configuration: true,
+                },
+            },
+            rootUri,
+            workspaceFolders,
+            ...(this.options.initializationOptions
+                ? { initializationOptions: this.options.initializationOptions }
+                : {}),
+        };
+        const result = await this.connection.sendRequest("initialize", initParams);
+        this._serverCapabilities = result.capabilities;
+        // Send initialized notification
+        this.connection.sendNotification("initialized", {});
+        this._initialized = true;
+    }
+    /** Safely dispose the connection without throwing */
+    disposeConnection() {
+        try {
+            if (this.connection) {
+                this.connection.dispose();
+            }
+        }
+        catch {
+            // Already disposed or stream destroyed — ignore
+        }
+        this.connection = null;
+    }
+    /** Send a request to the LSP server */
+    async sendRequest(method, params) {
+        if (!this.connection || !this._initialized) {
+            throw new Error(`LSP ${this.languageId} not initialized`);
+        }
+        return this.connection.sendRequest(method, params);
+    }
+    /** Send a notification to the LSP server */
+    sendNotification(method, params) {
+        if (!this.connection || !this._initialized)
+            return;
+        this.connection.sendNotification(method, params);
+    }
+    /** Notify server of a newly opened document */
+    didOpen(uri, languageId, version, text) {
+        this.sendNotification("textDocument/didOpen", {
+            textDocument: { uri, languageId, version, text },
+        });
+    }
+    /** Notify server of a document change (full content sync) */
+    didChange(uri, version, text) {
+        this.sendNotification("textDocument/didChange", {
+            textDocument: { uri, version },
+            contentChanges: [{ text }],
+        });
+    }
+    /** Notify server of a closed document */
+    didClose(uri) {
+        this.sendNotification("textDocument/didClose", {
+            textDocument: { uri },
+        });
+    }
+    /** Gracefully shut down or disconnect from the server */
+    async shutdown() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this._initialized = false;
+        if (this._isDaemonClient) {
+            // Socket client: just disconnect — daemon keeps the server alive
+            this.disposeConnection();
+            if (this.socket) {
+                this.socket.destroy();
+            }
+            this.socket = null;
+            return;
+        }
+        // Direct mode: shut down the server we own
+        try {
+            if (this.connection) {
+                // Race shutdown request against a timeout. Catch the request separately
+                // so if the timeout wins, the abandoned sendRequest rejection doesn't
+                // become an unhandled promise rejection.
+                const shutdownReq = this.connection.sendRequest("shutdown").catch(() => { });
+                await Promise.race([
+                    shutdownReq,
+                    new Promise((resolve) => setTimeout(resolve, 3000)),
+                ]);
+                try {
+                    this.connection.sendNotification("exit");
+                }
+                catch { }
+            }
+        }
+        catch {
+            // Server may already be dead
+        }
+        this.disposeConnection();
+        if (this.process) {
+            this.process.kill("SIGTERM");
+            // Force kill after 2s
+            setTimeout(() => {
+                if (this.process && !this.process.killed) {
+                    this.process.kill("SIGKILL");
+                }
+            }, 2000);
+        }
+        this.process = null;
+    }
+}
+//# sourceMappingURL=lsp-client.js.map

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-client.js","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/lsp-client.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * LSP Client — JSON-RPC client for LSP servers.\n *\n * Supports two modes:\n * - **Direct**: spawns LSP server as child process (stdio)\n * - **Socket**: connects to an LSP daemon via Unix domain socket\n *\n * Uses vscode-jsonrpc (bundled with vscode-languageserver-protocol) for\n * JSON-RPC message framing and transport.\n */\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { connect as netConnect, type Socket } from \"node:net\";\nimport { pathToFileURL } from \"node:url\";\nimport {\n  createMessageConnection,\n  StreamMessageReader,\n  StreamMessageWriter,\n  SocketMessageReader,\n  SocketMessageWriter,\n  type MessageConnection,\n} from \"vscode-languageserver-protocol/node\";\nimport type {\n  InitializeParams,\n  InitializeResult,\n  ServerCapabilities,\n  Diagnostic,\n  PublishDiagnosticsParams,\n} from \"vscode-languageserver-protocol\";\n\nexport interface LspClientOptions {\n  /** Command to start the LSP server */\n  command: string;\n  /** Arguments for the command */\n  args: string[];\n  /** Root directory of the workspace */\n  rootDir: string;\n  /** Language ID this server handles */\n  languageId: string;\n  /** Extra environment variables */\n  env?: Record<string, string>;\n  /** Additional workspace folders (e.g. for multi-package workspaces) */\n  workspaceFolders?: { uri: string; name: string }[];\n  /** Connect to existing daemon socket instead of spawning a new process */\n  socketPath?: string;\n  /** LSP initializationOptions (e.g. jdtls settings for Lombok) */\n  initializationOptions?: Record<string, unknown>;\n  /** Settings returned by workspace/configuration handler (keyed by section, e.g. { intelephense: {...} }) */\n  settings?: Record<string, unknown>;\n  /** Called when the server exits unexpectedly (not from user-initiated shutdown) */\n  onUnexpectedExit?: (code: number | null) => void;\n}\n\nexport class LspClient {\n  private process: ChildProcess | null = null;\n  private socket: Socket | null = null;\n  private connection: MessageConnection | null = null;\n  private _serverCapabilities: ServerCapabilities | null = null;\n  private _diagnostics: Map<string, Diagnostic[]> = new Map();\n  private _initialized = false;\n  private _disposed = false;\n  /** True if connected to a daemon socket (server init handled by daemon) */\n  private _isDaemonClient = false;\n\n  readonly languageId: string;\n  readonly command: string;\n  readonly rootDir: string;\n\n  constructor(private options: LspClientOptions) {\n    this.languageId = options.languageId;\n    this.command = options.command;\n    this.rootDir = options.rootDir;\n  }\n\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  get serverCapabilities(): ServerCapabilities | null {\n    return this._serverCapabilities;\n  }\n\n  /** Get cached diagnostics for a URI */\n  getDiagnostics(uri: string): Diagnostic[] {\n    return this._diagnostics.get(uri) ?? [];\n  }\n\n  /** Get all cached diagnostics */\n  getAllDiagnostics(): Map<string, Diagnostic[]> {\n    return new Map(this._diagnostics);\n  }\n\n  /** Start the LSP server and perform the initialize handshake */\n  async start(): Promise<void> {\n    if (this._initialized || this._disposed) return;\n\n    if (this.options.socketPath) {\n      await this.connectToSocket(this.options.socketPath);\n    } else {\n      await this.spawnDirect();\n    }\n  }\n\n  /** Register shared connection handlers (diagnostics, workspace/configuration, errors) */\n  private registerConnectionHandlers(): void {\n    if (!this.connection) return;\n\n    // Listen for published diagnostics\n    this.connection.onNotification(\n      \"textDocument/publishDiagnostics\",\n      (params: PublishDiagnosticsParams) => {\n        this._diagnostics.set(params.uri, params.diagnostics);\n      }\n    );\n\n    // Handle workspace/configuration requests from the server.\n    // Servers like Intelephense request their settings via this method.\n    // Return settings from options if configured, otherwise empty defaults.\n    this.connection.onRequest(\n      \"workspace/configuration\",\n      (params: { items: { section?: string }[] }) => {\n        const settings = this.options.settings;\n        return params.items.map((item) => {\n          if (item.section && settings && item.section in settings) {\n            return settings[item.section];\n          }\n          return {};\n        });\n      }\n    );\n\n    // Handle connection-level errors to prevent unhandled exceptions\n    this.connection.onError(([err]) => {\n      console.error(`[LSP ${this.languageId}] Connection error: ${err.message}`);\n    });\n\n    this.connection.onClose(() => {\n      if (!this._disposed) {\n        this._initialized = false;\n      }\n    });\n  }\n\n  /** Connect to an existing LSP daemon via Unix socket (no init handshake needed) */\n  private async connectToSocket(socketPath: string): Promise<void> {\n    this._isDaemonClient = true;\n\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      const settle = (fn: () => void) => {\n        if (!settled) { settled = true; fn(); }\n      };\n\n      const socket = netConnect(socketPath, () => {\n        this.socket = socket;\n\n        const reader = new SocketMessageReader(socket);\n        const writer = new SocketMessageWriter(socket);\n        this.connection = createMessageConnection(reader, writer);\n\n        this.registerConnectionHandlers();\n\n        this.connection.listen();\n        this._initialized = true;\n        settle(() => resolve());\n      });\n\n      socket.on(\"error\", (err) => {\n        if (!this._initialized) {\n          settle(() => reject(new Error(`Failed to connect to LSP daemon: ${err.message}`)));\n        } else {\n          this._initialized = false;\n        }\n      });\n\n      socket.on(\"close\", () => {\n        if (!this._disposed) {\n          this._initialized = false;\n          this.options.onUnexpectedExit?.(null);\n        }\n      });\n\n      // Timeout\n      setTimeout(() => {\n        if (!settled) {\n          socket.destroy();\n          settle(() => reject(new Error(\"Timeout connecting to LSP daemon socket\")));\n        }\n      }, 10_000);\n    });\n  }\n\n  /** Spawn LSP server directly as child process with stdio */\n  private async spawnDirect(): Promise<void> {\n    const env = { ...process.env, ...this.options.env };\n\n    this.process = spawn(this.options.command, this.options.args, {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      env,\n      cwd: this.rootDir,\n    });\n\n    if (!this.process.stdout || !this.process.stdin) {\n      throw new Error(`Failed to spawn LSP server: ${this.options.command}`);\n    }\n\n    // Wait for the process to successfully spawn before setting up the connection.\n    // spawn() is async — ENOENT and other errors arrive on the 'error' event.\n    // If we don't wait, we'll try to write to a destroyed stdin and crash.\n    await new Promise<void>((resolve, reject) => {\n      const onSpawn = () => { cleanup(); resolve(); };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(new Error(`Failed to spawn LSP server \"${this.options.command}\": ${err.message}`));\n      };\n      const cleanup = () => {\n        this.process?.removeListener(\"spawn\", onSpawn);\n        this.process?.removeListener(\"error\", onError);\n      };\n      this.process!.on(\"spawn\", onSpawn);\n      this.process!.on(\"error\", onError);\n    });\n\n    // Discard stderr to prevent blocking\n    this.process.stderr?.resume();\n\n    // Patch stdin.write to silently drop writes when the stream is destroyed.\n    // StreamMessageWriter wraps stdin and calls write() which returns a Promise.\n    // If the stream is destroyed (process exited), write() throws ERR_STREAM_DESTROYED\n    // inside the Promise constructor, creating a rejection that propagates through\n    // the writer's semaphore and becomes unhandled (notifications are fire-and-forget).\n    // No amount of error handlers on the stream or connection can catch this.\n    const stdin = this.process.stdin!;\n    const originalWrite = stdin.write;\n    stdin.write = function (this: typeof stdin, ...args: any[]): boolean {\n      if (this.destroyed || this.writableEnded || this.writableFinished) {\n        // Call the callback (last arg) so the Promise resolves instead of rejecting\n        const cb = args[args.length - 1];\n        if (typeof cb === \"function\") process.nextTick(cb);\n        return false;\n      }\n      try {\n        return originalWrite.apply(this, args as any);\n      } catch (err: any) {\n        // Catch EPIPE synchronously — process exited between our check and the write\n        if (err?.code === \"EPIPE\" || err?.code === \"ERR_STREAM_DESTROYED\") {\n          const cb = args[args.length - 1];\n          if (typeof cb === \"function\") process.nextTick(cb);\n          return false;\n        }\n        throw err;\n      }\n    } as any;\n\n    // Catch EPIPE on the stdin stream itself to prevent unhandled error events\n    stdin.on(\"error\", (err: any) => {\n      if (err?.code === \"EPIPE\") return; // expected when server exits\n      console.error(`[LSP ${this.languageId}] stdin error: ${err.message}`);\n    });\n\n    this.process.on(\"error\", (err) => {\n      console.error(`[LSP ${this.languageId}] Process error: ${err.message}`);\n      this._initialized = false;\n      this.disposeConnection();\n    });\n\n    this.process.on(\"exit\", (code) => {\n      if (!this._disposed) {\n        console.error(`[LSP ${this.languageId}] Server exited with code ${code}`);\n        this._initialized = false;\n        this.disposeConnection();\n        this.options.onUnexpectedExit?.(code);\n      }\n    });\n\n    const reader = new StreamMessageReader(this.process.stdout);\n    const writer = new StreamMessageWriter(this.process.stdin);\n    this.connection = createMessageConnection(reader, writer);\n\n    this.registerConnectionHandlers();\n\n    this.connection.listen();\n\n    // Initialize handshake\n    const rootUri = pathToFileURL(this.rootDir).toString();\n    const defaultFolder = { uri: rootUri, name: this.rootDir.split(\"/\").pop() ?? \"workspace\" };\n\n    // Use provided workspace folders or fall back to single root\n    const workspaceFolders = this.options.workspaceFolders && this.options.workspaceFolders.length > 0\n      ? this.options.workspaceFolders\n      : [defaultFolder];\n\n    const initParams: InitializeParams = {\n      processId: process.pid,\n      capabilities: {\n        textDocument: {\n          synchronization: {\n            didSave: true,\n            dynamicRegistration: false,\n          },\n          hover: {\n            contentFormat: [\"plaintext\", \"markdown\"],\n          },\n          definition: {},\n          references: {},\n          documentSymbol: {\n            hierarchicalDocumentSymbolSupport: true,\n          },\n          rename: {\n            prepareSupport: false,\n          },\n          publishDiagnostics: {\n            relatedInformation: true,\n          },\n          completion: {\n            completionItem: {\n              snippetSupport: false,\n            },\n          },\n        },\n        workspace: {\n          workspaceFolders: true,\n          symbol: {},\n          configuration: true,\n        },\n      },\n      rootUri,\n      workspaceFolders,\n      ...(this.options.initializationOptions\n        ? { initializationOptions: this.options.initializationOptions }\n        : {}),\n    };\n\n    const result: InitializeResult = await this.connection.sendRequest(\n      \"initialize\",\n      initParams\n    );\n    this._serverCapabilities = result.capabilities;\n\n    // Send initialized notification\n    this.connection.sendNotification(\"initialized\", {});\n    this._initialized = true;\n  }\n\n  /** Safely dispose the connection without throwing */\n  private disposeConnection(): void {\n    try {\n      if (this.connection) {\n        this.connection.dispose();\n      }\n    } catch {\n      // Already disposed or stream destroyed — ignore\n    }\n    this.connection = null;\n  }\n\n  /** Send a request to the LSP server */\n  async sendRequest<R>(method: string, params: unknown): Promise<R> {\n    if (!this.connection || !this._initialized) {\n      throw new Error(`LSP ${this.languageId} not initialized`);\n    }\n    return this.connection.sendRequest(method, params) as Promise<R>;\n  }\n\n  /** Send a notification to the LSP server */\n  sendNotification(method: string, params: unknown): void {\n    if (!this.connection || !this._initialized) return;\n    this.connection.sendNotification(method, params);\n  }\n\n  /** Notify server of a newly opened document */\n  didOpen(uri: string, languageId: string, version: number, text: string): void {\n    this.sendNotification(\"textDocument/didOpen\", {\n      textDocument: { uri, languageId, version, text },\n    });\n  }\n\n  /** Notify server of a document change (full content sync) */\n  didChange(uri: string, version: number, text: string): void {\n    this.sendNotification(\"textDocument/didChange\", {\n      textDocument: { uri, version },\n      contentChanges: [{ text }],\n    });\n  }\n\n  /** Notify server of a closed document */\n  didClose(uri: string): void {\n    this.sendNotification(\"textDocument/didClose\", {\n      textDocument: { uri },\n    });\n  }\n\n  /** Gracefully shut down or disconnect from the server */\n  async shutdown(): Promise<void> {\n    if (this._disposed) return;\n    this._disposed = true;\n    this._initialized = false;\n\n    if (this._isDaemonClient) {\n      // Socket client: just disconnect — daemon keeps the server alive\n      this.disposeConnection();\n      if (this.socket) {\n        this.socket.destroy();\n      }\n      this.socket = null;\n      return;\n    }\n\n    // Direct mode: shut down the server we own\n    try {\n      if (this.connection) {\n        // Race shutdown request against a timeout. Catch the request separately\n        // so if the timeout wins, the abandoned sendRequest rejection doesn't\n        // become an unhandled promise rejection.\n        const shutdownReq = this.connection.sendRequest(\"shutdown\").catch(() => {});\n        await Promise.race([\n          shutdownReq,\n          new Promise((resolve) => setTimeout(resolve, 3000)),\n        ]);\n        try { this.connection.sendNotification(\"exit\"); } catch {}\n      }\n    } catch {\n      // Server may already be dead\n    }\n    this.disposeConnection();\n\n    if (this.process) {\n      this.process.kill(\"SIGTERM\");\n      // Force kill after 2s\n      setTimeout(() => {\n        if (this.process && !this.process.killed) {\n          this.process.kill(\"SIGKILL\");\n        }\n      }, 2000);\n    }\n\n    this.process = null;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-daemon.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * LSP Daemon — persistent LSP server proxy over Unix domain socket.
+ *
+ * Spawns an LSP server (stdio) and multiplexes connections from multiple
+ * pi sessions via a Unix socket. This avoids running duplicate heavy
+ * LSP servers (jdtls, pyright, etc.) across sessions in the same workspace.
+ *
+ * Protocol: clients connect to the socket and speak JSON-RPC using
+ * LSP Content-Length framing — same as talking to an LSP server directly.
+ *
+ * Lifecycle:
+ *   - First session spawns daemon (detached)
+ *   - Daemon spawns LSP server, listens on socket
+ *   - Sessions connect/disconnect freely
+ *   - After last client disconnects, daemon waits 5 min then exits
+ *
+ * Usage: node lsp-daemon.js <socketPath> <command> [args...]
+ *   Env: LSP_ROOT_DIR, LSP_LANGUAGE_ID, LSP_WORKSPACE_FOLDERS (JSON)
+ */
+export {};
+//# sourceMappingURL=lsp-daemon.d.ts.map

package/dist/builtin-extensions/pi-lsp-extension/src/lsp-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-daemon.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-lsp-extension/src/lsp-daemon.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG","sourcesContent":["#!/usr/bin/env node\n// @ts-nocheck\n/**\n * LSP Daemon — persistent LSP server proxy over Unix domain socket.\n *\n * Spawns an LSP server (stdio) and multiplexes connections from multiple\n * pi sessions via a Unix socket. This avoids running duplicate heavy\n * LSP servers (jdtls, pyright, etc.) across sessions in the same workspace.\n *\n * Protocol: clients connect to the socket and speak JSON-RPC using\n * LSP Content-Length framing — same as talking to an LSP server directly.\n *\n * Lifecycle:\n *   - First session spawns daemon (detached)\n *   - Daemon spawns LSP server, listens on socket\n *   - Sessions connect/disconnect freely\n *   - After last client disconnects, daemon waits 5 min then exits\n *\n * Usage: node lsp-daemon.js <socketPath> <command> [args...]\n *   Env: LSP_ROOT_DIR, LSP_LANGUAGE_ID, LSP_WORKSPACE_FOLDERS (JSON)\n */\n\nimport { createServer, type Server, type Socket } from \"node:net\";\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { unlinkSync, existsSync, writeFileSync, mkdirSync, appendFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\n// ── LSP Message Framing ────────────────────────────────────────────────────\n\ninterface JsonRpcMessage {\n  jsonrpc: \"2.0\";\n  id?: number | string;\n  method?: string;\n  params?: unknown;\n  result?: unknown;\n  error?: unknown;\n}\n\n/**\n * Incremental parser for LSP Content-Length framed messages.\n * Accumulates data and emits complete JSON-RPC messages.\n */\nclass MessageParser {\n  private buffer = Buffer.alloc(0);\n  private contentLength = -1;\n  private headerComplete = false;\n  private onMessage: (msg: JsonRpcMessage) => void;\n\n  constructor(onMessage: (msg: JsonRpcMessage) => void) {\n    this.onMessage = onMessage;\n  }\n\n  feed(data: Buffer): void {\n    this.buffer = Buffer.concat([this.buffer, data]);\n    this.parse();\n  }\n\n  private parse(): void {\n    while (true) {\n      if (!this.headerComplete) {\n        const headerEnd = this.buffer.indexOf(\"\\r\\n\\r\\n\");\n        if (headerEnd === -1) return; // incomplete header\n\n        const header = this.buffer.subarray(0, headerEnd).toString(\"ascii\");\n        const match = header.match(/Content-Length:\\s*(\\d+)/i);\n        if (!match) {\n          // Skip malformed header — advance past it\n          this.buffer = this.buffer.subarray(headerEnd + 4);\n          continue;\n        }\n\n        this.contentLength = parseInt(match[1], 10);\n        this.headerComplete = true;\n        this.buffer = this.buffer.subarray(headerEnd + 4);\n      }\n\n      if (this.buffer.length < this.contentLength) return; // incomplete body\n\n      const body = this.buffer.subarray(0, this.contentLength).toString(\"utf-8\");\n      this.buffer = this.buffer.subarray(this.contentLength);\n      this.contentLength = -1;\n      this.headerComplete = false;\n\n      try {\n        const msg = JSON.parse(body) as JsonRpcMessage;\n        this.onMessage(msg);\n      } catch {\n        // Skip malformed JSON\n      }\n    }\n  }\n}\n\n/** Encode a JSON-RPC message with Content-Length header */\nfunction encodeMessage(msg: JsonRpcMessage): Buffer {\n  const body = JSON.stringify(msg);\n  const bodyBytes = Buffer.byteLength(body, \"utf-8\");\n  const header = `Content-Length: ${bodyBytes}\\r\\n\\r\\n`;\n  return Buffer.concat([Buffer.from(header, \"ascii\"), Buffer.from(body, \"utf-8\")]);\n}\n\n// ── Client Tracking ────────────────────────────────────────────────────────\n\ninterface ClientConnection {\n  id: number;\n  socket: Socket;\n  parser: MessageParser;\n}\n\n// ── Main Daemon ────────────────────────────────────────────────────────────\n\nconst args = process.argv.slice(2);\nconst socketPath = args[0];\nconst lspCommand = args[1];\nconst lspArgs = args.slice(2);\nconst rootDir = process.env.LSP_ROOT_DIR || process.cwd();\nconst languageId = process.env.LSP_LANGUAGE_ID || \"unknown\";\nconst workspaceFoldersJson = process.env.LSP_WORKSPACE_FOLDERS;\nconst initializationOptionsJson = process.env.LSP_INITIALIZATION_OPTIONS;\nconst settingsJson = process.env.LSP_SETTINGS;\n\nif (!socketPath || !lspCommand) {\n  console.error(\"Usage: lsp-daemon.js <socketPath> <command> [args...]\");\n  process.exit(1);\n}\n\nlet nextClientId = 1;\nlet nextDaemonRequestId = 1;\nconst clients = new Map<number, ClientConnection>();\n/** Map daemon request ID → { clientId, originalId } for client-initiated requests */\nconst pendingRequests = new Map<number | string, { clientId: number; originalId: number | string }>();\n/** Map server request ID → clientId for server-initiated requests forwarded to a client */\nconst pendingServerRequests = new Map<number | string, number>();\n/** Parsed settings for workspace/configuration responses */\nlet settings: Record<string, unknown> | undefined;\nlet shutdownTimer: ReturnType<typeof setTimeout> | null = null;\nlet server: Server;\nlet lspProcess: ChildProcess;\nlet lspParser: MessageParser;\nlet lspInitialized = false;\n/** The request ID used for the initialize handshake (set by initializeLsp) */\nlet initRequestId: number | null = null;\n/** Resolve/reject callbacks for the initialize promise */\nlet initResolve: (() => void) | null = null;\nlet initReject: ((err: Error) => void) | null = null;\n\n// ── Spawn LSP Server ───────────────────────────────────────────────────────\n\nfunction spawnLspServer(): ChildProcess {\n  const child = spawn(lspCommand, lspArgs, {\n    stdio: [\"pipe\", \"pipe\", \"pipe\"],\n    cwd: rootDir,\n    env: process.env,\n  });\n\n  child.stderr?.resume(); // prevent blocking\n\n  child.on(\"error\", (err) => {\n    log(`LSP server error: ${err.message}`);\n    shutdown(1);\n  });\n\n  child.on(\"exit\", (code) => {\n    log(`LSP server exited with code ${code}`);\n    shutdown(0);\n  });\n\n  return child;\n}\n\n// ── Message Routing ────────────────────────────────────────────────────────\n\n/** Forward a message from a client to the LSP server, rewriting request IDs */\nfunction clientToServer(clientId: number, msg: JsonRpcMessage): void {\n  if (!lspProcess.stdin?.writable) return;\n\n  if (msg.id !== undefined && msg.method) {\n    // Request from client — rewrite ID to track routing\n    const daemonId = nextDaemonRequestId++;\n    pendingRequests.set(daemonId, { clientId, originalId: msg.id });\n    const rewritten = { ...msg, id: daemonId };\n    lspProcess.stdin.write(encodeMessage(rewritten));\n  } else if (msg.id !== undefined && !msg.method) {\n    // Response from client to a server-initiated request — relay back to LSP server\n    if (pendingServerRequests.has(msg.id)) {\n      pendingServerRequests.delete(msg.id);\n      lspProcess.stdin.write(encodeMessage(msg));\n    }\n  } else {\n    // Notification from client — forward as-is\n    lspProcess.stdin.write(encodeMessage(msg));\n  }\n}\n\n/**\n * Route a message from the LSP server.\n * Before initialization: looks for the init response. All other messages are dropped\n * (no clients can be connected before init completes anyway).\n * After initialization: routes to connected clients.\n */\nfunction handleServerMessage(msg: JsonRpcMessage): void {\n  if (!lspInitialized) {\n    // During init, only the initialize response matters\n    if (initRequestId !== null && msg.id === initRequestId && !msg.method) {\n      lspInitialized = true;\n      initRequestId = null;\n\n      // Send initialized notification\n      lspProcess.stdin!.write(encodeMessage({\n        jsonrpc: \"2.0\",\n        method: \"initialized\",\n        params: {},\n      }));\n\n      log(`LSP server initialized (${languageId})`);\n      initResolve?.();\n      initResolve = null;\n      initReject = null;\n    }\n    // Other pre-init messages (e.g. window/logMessage) are ignored —\n    // no clients are connected yet anyway\n    return;\n  }\n\n  serverToClients(msg);\n}\n\n/** Route a message from the LSP server to the appropriate client(s) */\nfunction serverToClients(msg: JsonRpcMessage): void {\n  if (msg.id !== undefined && !msg.method) {\n    // Response — route to the client that sent the request\n    const pending = pendingRequests.get(msg.id);\n    if (pending) {\n      pendingRequests.delete(msg.id);\n      const client = clients.get(pending.clientId);\n      if (client && !client.socket.destroyed) {\n        const rewritten = { ...msg, id: pending.originalId };\n        client.socket.write(encodeMessage(rewritten));\n      }\n    }\n  } else if (msg.id !== undefined && msg.method) {\n    // Server-initiated request (e.g. workspace/configuration) — handle locally or forward to a client\n    handleServerRequest(msg);\n  } else if (msg.method && msg.id === undefined) {\n    // Notification from server — broadcast to ALL clients\n    const encoded = encodeMessage(msg);\n    for (const client of clients.values()) {\n      if (!client.socket.destroyed) {\n        client.socket.write(encoded);\n      }\n    }\n  }\n}\n\n/**\n * Handle a server-initiated request.\n * Some requests (workspace/configuration) can be answered locally by the daemon.\n * Others are forwarded to the first connected client and the response is relayed back.\n */\nfunction handleServerRequest(msg: JsonRpcMessage): void {\n  if (msg.method === \"workspace/configuration\") {\n    // Answer locally — daemon has the settings from LSP_SETTINGS env\n    const params = msg.params as { items: { section?: string }[] } | undefined;\n    const items = params?.items ?? [];\n    const result = items.map((item) => {\n      if (item.section && settings && item.section in settings) {\n        return settings[item.section];\n      }\n      return {};\n    });\n    const response: JsonRpcMessage = { jsonrpc: \"2.0\", id: msg.id!, result };\n    lspProcess.stdin!.write(encodeMessage(response));\n    return;\n  }\n\n  // For other server-initiated requests, forward to first connected client\n  // and relay the response back to the server\n  const firstClient = getFirstConnectedClient();\n  if (firstClient) {\n    pendingServerRequests.set(msg.id!, firstClient.id);\n    firstClient.socket.write(encodeMessage(msg));\n  } else {\n    // No clients connected — respond with error\n    const errorResponse: JsonRpcMessage = {\n      jsonrpc: \"2.0\",\n      id: msg.id!,\n      error: { code: -32001, message: \"No clients connected to handle request\" },\n    };\n    lspProcess.stdin!.write(encodeMessage(errorResponse));\n  }\n}\n\n/** Get first non-destroyed connected client */\nfunction getFirstConnectedClient(): ClientConnection | undefined {\n  for (const client of clients.values()) {\n    if (!client.socket.destroyed) return client;\n  }\n  return undefined;\n}\n\n// ── Initialize LSP Server ──────────────────────────────────────────────────\n\nasync function initializeLsp(): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const rootUri = pathToFileURL(rootDir).toString();\n\n    let workspaceFolders = [{ uri: rootUri, name: rootDir.split(\"/\").pop() ?? \"workspace\" }];\n    if (workspaceFoldersJson) {\n      try {\n        const parsed = JSON.parse(workspaceFoldersJson);\n        if (Array.isArray(parsed) && parsed.length > 0) {\n          workspaceFolders = parsed;\n        }\n      } catch { /* use default */ }\n    }\n\n    let initializationOptions: Record<string, unknown> | undefined;\n    if (initializationOptionsJson) {\n      try {\n        initializationOptions = JSON.parse(initializationOptionsJson);\n      } catch { /* ignore */ }\n    }\n\n    const initParams = {\n      processId: process.pid,\n      capabilities: {\n        textDocument: {\n          synchronization: { didSave: true, dynamicRegistration: false },\n          hover: { contentFormat: [\"plaintext\", \"markdown\"] },\n          definition: {},\n          references: {},\n          documentSymbol: { hierarchicalDocumentSymbolSupport: true },\n          rename: { prepareSupport: false },\n          publishDiagnostics: { relatedInformation: true },\n          completion: { completionItem: { snippetSupport: false } },\n        },\n        workspace: { workspaceFolders: true, symbol: {}, configuration: true },\n      },\n      rootUri,\n      workspaceFolders,\n      ...(initializationOptions ? { initializationOptions } : {}),\n    };\n\n    // Store resolve/reject so handleServerMessage can settle the promise\n    initResolve = resolve;\n    initReject = reject;\n\n    // Set the init request ID so handleServerMessage knows which response to watch for\n    initRequestId = nextDaemonRequestId++;\n    const initRequest: JsonRpcMessage = {\n      jsonrpc: \"2.0\",\n      id: initRequestId,\n      method: \"initialize\",\n      params: initParams,\n    };\n\n    lspProcess.stdin!.write(encodeMessage(initRequest));\n\n    // Timeout\n    setTimeout(() => {\n      if (!lspInitialized) {\n        initResolve = null;\n        initReject = null;\n        reject(new Error(\"LSP initialize timed out after 5 minutes\"));\n      }\n    }, 5 * 60_000);\n  });\n}\n\n// ── Socket Server ──────────────────────────────────────────────────────────\n\nfunction startSocketServer(): Server {\n  // Ensure socket directory exists\n  mkdirSync(dirname(socketPath), { recursive: true });\n\n  // Clean up stale socket\n  if (existsSync(socketPath)) {\n    try { unlinkSync(socketPath); } catch { /* ignore */ }\n  }\n\n  const srv = createServer((socket) => {\n    const clientId = nextClientId++;\n    log(`Client ${clientId} connected`);\n\n    // Cancel shutdown timer\n    if (shutdownTimer) {\n      clearTimeout(shutdownTimer);\n      shutdownTimer = null;\n    }\n\n    const parser = new MessageParser((msg) => {\n      clientToServer(clientId, msg);\n    });\n\n    const conn: ClientConnection = { id: clientId, socket, parser };\n    clients.set(clientId, conn);\n\n    socket.on(\"data\", (data) => parser.feed(Buffer.from(data)));\n\n    socket.on(\"close\", () => {\n      log(`Client ${clientId} disconnected`);\n      clients.delete(clientId);\n\n      // Clean up pending requests for this client\n      for (const [reqId, pending] of pendingRequests) {\n        if (pending.clientId === clientId) {\n          pendingRequests.delete(reqId);\n        }\n      }\n\n      // Start shutdown timer if no clients remain\n      if (clients.size === 0) {\n        log(\"No clients remaining, will shut down in 5 minutes\");\n        shutdownTimer = setTimeout(() => shutdown(0), 5 * 60 * 1000);\n      }\n    });\n\n    socket.on(\"error\", (err) => {\n      log(`Client ${clientId} error: ${err.message}`);\n      clients.delete(clientId);\n    });\n  });\n\n  srv.listen(socketPath, () => {\n    log(`Listening on ${socketPath}`);\n    // Write PID file\n    const pidPath = socketPath.replace(/\\.sock$/, \".pid\");\n    writeFileSync(pidPath, String(process.pid));\n  });\n\n  srv.on(\"error\", (err) => {\n    log(`Socket server error: ${err.message}`);\n    shutdown(1);\n  });\n\n  return srv;\n}\n\n// ── Lifecycle ──────────────────────────────────────────────────────────────\n\nfunction log(msg: string): void {\n  const ts = new Date().toISOString();\n  const logPath = socketPath.replace(/\\.sock$/, \".log\");\n  try {\n    appendFileSync(logPath, `[${ts}] ${msg}\\n`);\n  } catch { /* ignore */ }\n}\n\nfunction shutdown(code: number): void {\n  log(\"Shutting down daemon\");\n\n  if (shutdownTimer) clearTimeout(shutdownTimer);\n\n  // Close all client connections\n  for (const client of clients.values()) {\n    client.socket.destroy();\n  }\n  clients.clear();\n\n  // Shut down LSP server\n  if (lspProcess && !lspProcess.killed) {\n    try {\n      lspProcess.stdin?.write(encodeMessage({\n        jsonrpc: \"2.0\",\n        id: nextDaemonRequestId++,\n        method: \"shutdown\",\n        params: null,\n      }));\n      setTimeout(() => {\n        lspProcess.stdin?.write(encodeMessage({\n          jsonrpc: \"2.0\",\n          method: \"exit\",\n          params: null,\n        }));\n        setTimeout(() => {\n          if (!lspProcess.killed) lspProcess.kill(\"SIGTERM\");\n        }, 1000);\n      }, 2000);\n    } catch {\n      lspProcess.kill(\"SIGTERM\");\n    }\n  }\n\n  // Clean up socket and PID files\n  try { unlinkSync(socketPath); } catch { /* ignore */ }\n  try { unlinkSync(socketPath.replace(/\\.sock$/, \".pid\")); } catch { /* ignore */ }\n\n  if (server) server.close();\n\n  setTimeout(() => process.exit(code), 3000);\n}\n\nprocess.on(\"SIGTERM\", () => shutdown(0));\nprocess.on(\"SIGINT\", () => shutdown(0));\nprocess.on(\"uncaughtException\", (err) => {\n  log(`Uncaught exception: ${err.message}\\n${err.stack ?? \"\"}`);\n  shutdown(1);\n});\nprocess.on(\"unhandledRejection\", (reason) => {\n  log(`Unhandled rejection: ${reason}`);\n  shutdown(1);\n});\n\n// ── Start ──────────────────────────────────────────────────────────────────\n\nasync function main() {\n  log(`Starting daemon: ${lspCommand} ${lspArgs.join(\" \")} (${languageId})`);\n\n  // Parse settings for workspace/configuration responses\n  if (settingsJson) {\n    try {\n      settings = JSON.parse(settingsJson);\n    } catch (e) { log(`Warning: failed to parse LSP_SETTINGS: ${e}`); }\n  }\n\n  lspProcess = spawnLspServer();\n\n  // Single parser for all server messages — routes via handleServerMessage\n  // which checks lspInitialized to decide whether to look for init response\n  // or forward to clients. No parser swapping needed.\n  lspParser = new MessageParser(handleServerMessage);\n  lspProcess.stdout!.on(\"data\", (data) => lspParser.feed(data));\n\n  server = startSocketServer();\n\n  try {\n    await initializeLsp();\n  } catch (err: any) {\n    log(`Failed to initialize LSP server: ${err.message}`);\n    shutdown(1);\n  }\n}\n\nmain().catch((err) => {\n  log(`Daemon fatal error: ${err.message}`);\n  process.exit(1);\n});\n"]}