@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/limpieza/tipos.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Tipos compartidos de `ada-cli cleanse`.
+ *
+ * Los nombres de campo van en español ({@link Diagnostico}: ruta, linea,
+ * regla, mensaje) porque ese es el contrato que pide la tarea y el que
+ * respeta el resto del módulo.
+ */
+/** Un problema accionable que reportó un comprobador del proyecto. */
+export interface Diagnostico {
+    /** id del comprobador que lo generó — permite re-ejecutar solo ese tras un arreglo. */
+    comprobador: string;
+    /** undefined = diagnóstico de proyecto entero (p.ej. un test que falla), no de un fichero. */
+    ruta?: string;
+    linea?: number;
+    columna?: number;
+    regla?: string;
+    mensaje: string;
+    /** Severidad normalizada: error > warning > info. Para peso y ordenación. */
+    gravedad?: "error" | "warning" | "info";
+    /** Sugerencia de arreglo si el checker la proporciona (para peso). */
+    sugerencia?: string;
+}
+/** Un diagnóstico sin el campo `comprobador` — lo añade quien ejecuta, no quien parsea. */
+export type DiagnosticoParcial = Omit<Diagnostico, "comprobador">;
+/** Todos los diagnósticos de un fichero (o del proyecto entero si `ruta` es undefined). */
+export interface GrupoPorFichero {
+    ruta?: string;
+    diagnosticos: Diagnostico[];
+}
+/** Salida cruda de ejecutar un comprobador. */
+export interface SalidaComando {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+/** Un comprobador detectado y listo para ejecutar. */
+export interface Comprobador {
+    id: string;
+    etiqueta: string;
+    comando: string;
+    args: string[];
+    cwd: string;
+    parsear: (salida: SalidaComando, cwd: string) => DiagnosticoParcial[];
+    /**
+     * "fichero" = sus diagnósticos vienen con `ruta` (lint, typecheck…);
+     * "proyecto" = sin `ruta`, del proyecto entero (un test runner). Decide
+     * qué comprobadores se re-ejecutan al verificar el arreglo de UN fichero:
+     * hace falta correrlos TODOS los de "fichero", no solo el que originó el
+     * diagnóstico — si no, un arreglo de lint que rompe el typecheck del mismo
+     * fichero pasaría como limpio porque nunca se vuelve a correr tsc.
+     */
+    alcance: "fichero" | "proyecto";
+    /** Si true, el checker reescribe ficheros (clippy --fix, etc.). Solo activo con --fix. */
+    mutador?: boolean;
+}
+/** Resultado de mirar qué hay en el proyecto. */
+export interface Deteccion {
+    comprobadores: Comprobador[];
+    /** Cada sitio comprobado, se haya encontrado algo o no — para cuando no hay ninguno. */
+    mirado: string[];
+}
+/** Opciones de ejecución de cleanse que afectan a detección/ejecución. */
+export interface OpcionesCleanse {
+    fix?: boolean;
+}
+/** Mensaje de steering vía IRC para diagnósticos tardíos. */
+export interface SteeringMensaje {
+    tipo: "steering";
+    ruta: string;
+    diagnosticos: Diagnostico[];
+    origen: string;
+}
+/** Resultado de intentar entregar un steering. */
+export type SteeringResultado = {
+    entregado: true;
+    workerId: string;
+} | {
+    entregado: false;
+    motivo: string;
+};
+//# sourceMappingURL=tipos.d.ts.map

package/dist/core/limpieza/tipos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.d.ts","sourceRoot":"","sources":["../../../src/core/limpieza/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC3B,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAElE,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,KAAK,kBAAkB,EAAE,CAAC;IACtE;;;;;;;OAOG;IACH,OAAO,EAAE,SAAS,GAAG,UAAU,CAAC;IAChC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACzB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,wFAAwF;IACxF,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,MAAM,iBAAiB,GAAG;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/core/limpieza/tipos.js

@@ -0,0 +1,9 @@
+/**
+ * Tipos compartidos de `ada-cli cleanse`.
+ *
+ * Los nombres de campo van en español ({@link Diagnostico}: ruta, linea,
+ * regla, mensaje) porque ese es el contrato que pide la tarea y el que
+ * respeta el resto del módulo.
+ */
+export {};
+//# sourceMappingURL=tipos.js.map

package/dist/core/limpieza/tipos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../../src/core/limpieza/tipos.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/core/lsp/cliente.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Cliente JSON-RPC sobre stdio contra un servidor de lenguaje (LSP).
+ *
+ * Fichero nuestro (coste cero de fork): el LanguageService de TypeScript en
+ * `core/edicion/tipos.ts` cubre un único lenguaje sin salir de proceso; esto
+ * es lo que hace falta para los demás — hablar el protocolo LSP con un
+ * binario externo que arranca y para por comando.
+ *
+ * Decisión deliberada de diseño (ponytail): un servidor por LLAMADA, no un
+ * pool de servidores vivos entre llamadas. Arrancar `gopls`/`rust-analyzer`
+ * cuesta cientos de ms, pero un servidor que sobrevive a la llamada que lo
+ * arrancó es exactamente el "proceso huérfano" que la puerta de este hueco
+ * prohíbe, y mantener un pool con temporizador de inactividad es la mitad de
+ * `client.ts` del competidor (1601 líneas) para un problema que aquí no
+ * existe todavía. Subir a un pool es la mejora natural si el coste de
+ * relanzar por llamada llega a notarse.
+ */
+/** Lo que de verdad puede fallar al hablar con el servidor: nunca se colapsa en un único "error". */
+export declare class ErrorLsp extends Error {
+    readonly tipo: "proceso_murio" | "timeout" | "rpc" | "cierre";
+    constructor(message: string, tipo: "proceso_murio" | "timeout" | "rpc" | "cierre");
+}
+/** Conexión JSON-RPC ya inicializada (handshake `initialize`/`initialized` hecho) contra un servidor LSP. */
+export interface ClienteLsp {
+    /** Petición LSP que espera respuesta. Rechaza con `ErrorLsp` si el proceso muere o se agota el tiempo. */
+    enviar<T>(metodo: string, params: unknown, timeoutMs?: number): Promise<T>;
+    /** Notificación LSP sin respuesta (p. ej. `textDocument/didOpen`). */
+    notificar(metodo: string, params: unknown): void;
+    /**
+     * Cierre limpio: `shutdown` (petición) → `exit` (notificación) → espera a que
+     * el proceso termine solo → `SIGKILL` si no lo ha hecho a tiempo.
+     * Al resolver, el proceso YA NO existe — es la garantía que pide la puerta
+     * de "ningún servidor queda vivo al terminar".
+     */
+    cerrar(): Promise<void>;
+    /** PID del proceso del servidor. Solo para diagnóstico/pruebas: comprobar que no queda vivo tras `cerrar()`. */
+    readonly pid: number | undefined;
+    /**
+     * `capabilities` tal como el servidor los declaró en su respuesta
+     * `initialize`. Quien quiera saber si el servidor soporta una capacidad
+     * (p. ej. `textDocument.formatting` para format-on-write) la lee aquí en
+     * vez de disparar la petición a ciegas y distinguir "error" de "null".
+     */
+    readonly capacidades: Record<string, unknown> | undefined;
+}
+declare function uriDeRuta(ruta: string): string;
+/**
+ * Arranca `comando` como servidor LSP, hace el handshake `initialize` +
+ * `initialized` y devuelve un cliente listo para usar.
+ *
+ * Lanza `ErrorLsp` (nunca falla en silencio) si el binario no arranca o el
+ * `initialize` no responde a tiempo — quien llama distingue "no se pudo
+ * hablar con el servidor" de "el servidor contestó vacío".
+ */
+export declare function conectar(comando: string, args: string[], cwd: string, opciones?: {
+    timeoutInicializacionMs?: number;
+}): Promise<ClienteLsp>;
+export { uriDeRuta };
+//# sourceMappingURL=cliente.d.ts.map

package/dist/core/lsp/cliente.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliente.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/cliente.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,qGAAqG;AACrG,qBAAa,QAAS,SAAQ,KAAK;IAGlC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;gBAElD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ;CAKjF;AAED,6GAA6G;AAC7G,MAAM,WAAW,UAAU;IAC1B,0GAA0G;IAC1G,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,sEAAsE;IACtE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD;;;;;OAKG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,gHAAgH;IAChH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC1D;AAgFD,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvC;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE;IAAE,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,UAAU,CAAC,CAyHrB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/core/lsp/cliente.js

@@ -0,0 +1,234 @@
+/**
+ * Cliente JSON-RPC sobre stdio contra un servidor de lenguaje (LSP).
+ *
+ * Fichero nuestro (coste cero de fork): el LanguageService de TypeScript en
+ * `core/edicion/tipos.ts` cubre un único lenguaje sin salir de proceso; esto
+ * es lo que hace falta para los demás — hablar el protocolo LSP con un
+ * binario externo que arranca y para por comando.
+ *
+ * Decisión deliberada de diseño (ponytail): un servidor por LLAMADA, no un
+ * pool de servidores vivos entre llamadas. Arrancar `gopls`/`rust-analyzer`
+ * cuesta cientos de ms, pero un servidor que sobrevive a la llamada que lo
+ * arrancó es exactamente el "proceso huérfano" que la puerta de este hueco
+ * prohíbe, y mantener un pool con temporizador de inactividad es la mitad de
+ * `client.ts` del competidor (1601 líneas) para un problema que aquí no
+ * existe todavía. Subir a un pool es la mejora natural si el coste de
+ * relanzar por llamada llega a notarse.
+ */
+import { spawn } from "node:child_process";
+/** Cabecera LSP: los mensajes van precedidos de `Content-Length` en BYTES, no en caracteres. */
+const SEPARADOR = "\r\n\r\n";
+const PATRON_LONGITUD = /Content-Length:\s*(\d+)/i;
+/** Lo que de verdad puede fallar al hablar con el servidor: nunca se colapsa en un único "error". */
+export class ErrorLsp extends Error {
+    // Campo explícito, no propiedad de parámetro: el proyecto compila con
+    // `erasableSyntaxOnly`, que prohíbe la forma corta por no ser borrable.
+    tipo;
+    constructor(message, tipo) {
+        super(message);
+        this.name = "ErrorLsp";
+        this.tipo = tipo;
+    }
+}
+function escribirMensaje(proc, cuerpo) {
+    const json = JSON.stringify(cuerpo);
+    // Content-Length cuenta BYTES UTF-8, no unidades de código: un símbolo o
+    // comentario no-ASCII en el nombre nuevo de un rename lo desincroniza si se
+    // mide en caracteres.
+    const bytes = Buffer.byteLength(json, "utf-8");
+    proc.stdin.write(`Content-Length: ${bytes}${SEPARADOR}${json}`);
+}
+/** Trocea el flujo de stdout del servidor en mensajes JSON-RPC completos, cabecera incluida. */
+class Trocador {
+    buffer = Buffer.alloc(0);
+    agregar(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        const mensajes = [];
+        for (;;) {
+            const finCabecera = this.buffer.indexOf(SEPARADOR);
+            if (finCabecera === -1)
+                return mensajes;
+            const cabecera = this.buffer.subarray(0, finCabecera).toString("utf-8");
+            const coincidencia = cabecera.match(PATRON_LONGITUD);
+            if (!coincidencia) {
+                // Cabecera sin Content-Length: no hay forma fiable de saber dónde
+                // empieza el siguiente mensaje. Se descarta hasta el separador y se
+                // sigue — un servidor mal comportado no debe colgar el cliente.
+                this.buffer = this.buffer.subarray(finCabecera + SEPARADOR.length);
+                continue;
+            }
+            const longitud = Number(coincidencia[1]);
+            const inicioCuerpo = finCabecera + SEPARADOR.length;
+            if (this.buffer.length < inicioCuerpo + longitud)
+                return mensajes; // cuerpo incompleto, esperar más datos
+            const cuerpo = this.buffer.subarray(inicioCuerpo, inicioCuerpo + longitud).toString("utf-8");
+            this.buffer = this.buffer.subarray(inicioCuerpo + longitud);
+            try {
+                mensajes.push(JSON.parse(cuerpo));
+            }
+            catch {
+                // JSON roto de un servidor concreto no debe tirar abajo al cliente:
+                // se ignora ese mensaje y se sigue troceando el resto del flujo.
+            }
+        }
+    }
+}
+const ESPERA_SALIDA_MS = 2000;
+/** Espera a que el proceso emita `exit`, o hasta `timeoutMs`. `true` = salió solo. */
+function esperarSalida(proc, timeoutMs) {
+    if (proc.exitCode !== null || proc.signalCode !== null)
+        return Promise.resolve(true);
+    return new Promise((resolver) => {
+        const temporizador = setTimeout(() => {
+            proc.off("exit", alSalir);
+            resolver(false);
+        }, timeoutMs);
+        function alSalir() {
+            clearTimeout(temporizador);
+            resolver(true);
+        }
+        proc.once("exit", alSalir);
+    });
+}
+/** Capacidades mínimas que necesitan rename/symbols/definition/references. Ampliar aquí, no en cada tool. */
+const CAPACIDADES_CLIENTE = {
+    textDocument: {
+        synchronization: { didSave: true, dynamicRegistration: false },
+        definition: { dynamicRegistration: false, linkSupport: false },
+        references: { dynamicRegistration: false },
+        documentSymbol: { dynamicRegistration: false, hierarchicalDocumentSymbolSupport: true },
+        rename: { dynamicRegistration: false, prepareSupport: false },
+    },
+    workspace: {
+        applyEdit: false, // el cliente aplica el WorkspaceEdit él mismo (edits.ts); no delega en el servidor
+        workspaceEdit: { documentChanges: true, resourceOperations: [] },
+        workspaceFolders: true,
+        symbol: { dynamicRegistration: false },
+    },
+};
+function uriDeRuta(ruta) {
+    // file:// + porcentaje-escapado, igual que hace cualquier cliente LSP normal.
+    return `file://${encodeURI(ruta).replace(/#/g, "%23")}`;
+}
+/**
+ * Arranca `comando` como servidor LSP, hace el handshake `initialize` +
+ * `initialized` y devuelve un cliente listo para usar.
+ *
+ * Lanza `ErrorLsp` (nunca falla en silencio) si el binario no arranca o el
+ * `initialize` no responde a tiempo — quien llama distingue "no se pudo
+ * hablar con el servidor" de "el servidor contestó vacío".
+ */
+export async function conectar(comando, args, cwd, opciones) {
+    const proc = spawn(comando, args, { cwd, stdio: ["pipe", "pipe", "pipe"] });
+    const pendientes = new Map();
+    let siguienteId = 1;
+    let cerrado = false;
+    const trocador = new Trocador();
+    proc.stdout.on("data", (chunk) => {
+        for (const mensaje of trocador.agregar(chunk))
+            manejarMensaje(mensaje);
+    });
+    // stderr de un servidor LSP suele ser su log, no un fallo: se descarta salvo
+    // que el proceso muera, momento en el que sí importa para el mensaje de error.
+    let ultimoStderr = "";
+    proc.stderr.on("data", (chunk) => {
+        ultimoStderr = chunk.toString("utf-8").slice(-2000);
+    });
+    function manejarMensaje(mensaje) {
+        if (typeof mensaje.id !== "number")
+            return; // notificación del servidor (p. ej. publishDiagnostics): se ignora, no la necesitamos
+        const pendiente = pendientes.get(mensaje.id);
+        if (!pendiente)
+            return;
+        pendientes.delete(mensaje.id);
+        if (mensaje.error) {
+            const err = mensaje.error;
+            pendiente.rechazar(new ErrorLsp(`el servidor respondió un error: ${err.message ?? JSON.stringify(err)}`, "rpc"));
+        }
+        else {
+            pendiente.resolver(mensaje.result);
+        }
+    }
+    function rechazarTodoPendiente(error) {
+        for (const p of pendientes.values())
+            p.rechazar(error);
+        pendientes.clear();
+    }
+    let procesoMuerto = null;
+    proc.once("exit", (codigo, senal) => {
+        if (!cerrado) {
+            procesoMuerto = new ErrorLsp(`el servidor de lenguaje terminó solo (código ${codigo}, señal ${senal}): ${ultimoStderr || "sin salida en stderr"}`, "proceso_murio");
+            rechazarTodoPendiente(procesoMuerto);
+        }
+    });
+    proc.once("error", (error) => {
+        procesoMuerto = new ErrorLsp(`no se pudo arrancar «${comando}»: ${error.message}`, "proceso_murio");
+        rechazarTodoPendiente(procesoMuerto);
+    });
+    function enviar(metodo, params, timeoutMs = 30_000) {
+        if (procesoMuerto)
+            return Promise.reject(procesoMuerto);
+        const id = siguienteId++;
+        return new Promise((resolver, rechazar) => {
+            const temporizador = setTimeout(() => {
+                pendientes.delete(id);
+                rechazar(new ErrorLsp(`«${metodo}» no respondió en ${timeoutMs}ms`, "timeout"));
+            }, timeoutMs);
+            pendientes.set(id, {
+                resolver: (v) => {
+                    clearTimeout(temporizador);
+                    resolver(v);
+                },
+                rechazar: (e) => {
+                    clearTimeout(temporizador);
+                    rechazar(e);
+                },
+            });
+            escribirMensaje(proc, { jsonrpc: "2.0", id, method: metodo, params });
+        });
+    }
+    function notificar(metodo, params) {
+        if (procesoMuerto)
+            return;
+        escribirMensaje(proc, { jsonrpc: "2.0", method: metodo, params });
+    }
+    async function cerrar() {
+        if (cerrado)
+            return;
+        cerrado = true;
+        if (!procesoMuerto) {
+            // Handshake formal primero: le da al servidor la oportunidad de soltar
+            // ficheros de bloqueo, sockets, etc. antes del kill.
+            await enviar("shutdown", null, 3000).catch(() => { });
+            notificar("exit", undefined);
+        }
+        rechazarTodoPendiente(new ErrorLsp("cliente LSP cerrado", "cierre"));
+        if (await esperarSalida(proc, ESPERA_SALIDA_MS))
+            return;
+        proc.kill("SIGKILL");
+        await esperarSalida(proc, ESPERA_SALIDA_MS);
+        // Si tras SIGKILL sigue sin confirmar salida (proceso zombi, señal
+        // bloqueada) no hay nada más que este cliente pueda hacer: se ha hecho
+        // lo posible y se devuelve el control. Quien orquesta varios clientes
+        // puede comprobar el pid con `process.kill(-1, 0)` para decidir si avisa.
+    }
+    let capacidades;
+    try {
+        const timeoutInit = opciones?.timeoutInicializacionMs ?? 15_000;
+        const init = await enviar("initialize", {
+            processId: process.pid,
+            rootUri: uriDeRuta(cwd),
+            workspaceFolders: [{ uri: uriDeRuta(cwd), name: cwd }],
+            capabilities: CAPACIDADES_CLIENTE,
+        }, timeoutInit);
+        capacidades = typeof init === "object" && init !== null ? init : undefined;
+        notificar("initialized", {});
+    }
+    catch (error) {
+        await cerrar();
+        throw error;
+    }
+    return { enviar, notificar, cerrar, pid: proc.pid, capacidades };
+}
+export { uriDeRuta };
+//# sourceMappingURL=cliente.js.map

package/dist/core/lsp/cliente.js.map

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

package/dist/core/lsp/descubrimiento.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Qué servidor de lenguaje toca para un fichero, y si está instalado.
+ *
+ * TypeScript/JS quedan fuera a propósito: los cubre el LanguageService de
+ * `core/edicion/tipos.ts` (más rápido, ya pagado, sin salir de proceso). Este
+ * módulo es solo para los lenguajes donde no hay alternativa a hablar LSP con
+ * un binario externo.
+ *
+ * Regla 6 del hueco, aplicada aquí sin excepción: "no pude" (el binario no
+ * está instalado) y "no hay" (esta extensión no tiene servidor conocido) son
+ * dos resultados DISTINTOS. Ninguno de los dos es un error silencioso ni un
+ * "no hay símbolos" genérico — cada uno lleva lo que hace falta para actuar.
+ */
+/** Un servidor de lenguaje conocido: cómo arrancarlo, para qué ficheros sirve, y cómo instalarlo si falta. */
+export interface ServidorLsp {
+    nombre: string;
+    comando: string;
+    args: string[];
+    /** Extensiones con punto, en minúsculas: ".go", ".rs"... */
+    extensiones: string[];
+    /** Al menos uno de estos ficheros/directorios debe existir en algún ancestro del fichero para considerar el proyecto "de este lenguaje". */
+    marcadoresRaiz: string[];
+    /** Comando EXACTO para instalarlo. Se muestra tal cual al usuario: nada de "instala un LSP de Go". */
+    instalar: string;
+}
+/**
+ * Resultado de buscar servidor para un fichero. Tres formas, nunca
+ * colapsadas: hay servidor listo para usar; hay servidor conocido pero el
+ * binario no está instalado (con el comando exacto para arreglarlo); o esta
+ * extensión no tiene servidor conocido en absoluto (cobertura, no fallo).
+ */
+export type ResultadoDescubrimiento = {
+    estado: "disponible";
+    servidor: ServidorLsp;
+} | {
+    estado: "no_instalado";
+    servidor: ServidorLsp;
+} | {
+    estado: "sin_cobertura";
+    extension: string;
+};
+/**
+ * Busca el servidor LSP para `rutaFichero` dentro del proyecto `cwd`.
+ *
+ * No lanza nunca: toda situación (sin cobertura, servidor conocido pero no
+ * instalado, o servidor listo) es un valor de retorno distinguible, no una
+ * excepción que el llamador tenga que adivinar.
+ */
+export declare function descubrirParaFichero(rutaFichero: string, cwd: string): ResultadoDescubrimiento;
+/** Lista de servidores curados, para diagnóstico (`ada-cli` mostrando qué lenguajes cubre el cliente LSP). */
+export declare function servidoresConocidos(): readonly ServidorLsp[];
+/**
+ * ¿Hay algún lenguaje con servidor conocido en este proyecto? No mira si el
+ * binario está instalado — solo si el proyecto es "de ese lenguaje" (marcador
+ * de raíz específico presente). Es la comprobación que decide si vale la pena
+ * registrar los tools: si el proyecto no toca ningún lenguaje que cubrimos,
+ * no hay nada que ofrecer y las tools solo serían ruido en el contexto del
+ * modelo — un `.git` (casi cualquier proyecto lo tiene) no cuenta como señal
+ * de "este proyecto usa Bash" a estos efectos.
+ */
+export declare function hayLenguajeReconocidoEnProyecto(cwd: string): boolean;
+//# sourceMappingURL=descubrimiento.d.ts.map

package/dist/core/lsp/descubrimiento.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descubrimiento.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/descubrimiento.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,8GAA8G;AAC9G,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4IAA4I;IAC5I,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sGAAsG;IACtG,QAAQ,EAAE,MAAM,CAAC;CACjB;AAyFD;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAChC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAc9F;AAED,8GAA8G;AAC9G,wBAAgB,mBAAmB,IAAI,SAAS,WAAW,EAAE,CAE5D;AAaD;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKpE"}

package/dist/core/lsp/descubrimiento.js

@@ -0,0 +1,152 @@
+/**
+ * Qué servidor de lenguaje toca para un fichero, y si está instalado.
+ *
+ * TypeScript/JS quedan fuera a propósito: los cubre el LanguageService de
+ * `core/edicion/tipos.ts` (más rápido, ya pagado, sin salir de proceso). Este
+ * módulo es solo para los lenguajes donde no hay alternativa a hablar LSP con
+ * un binario externo.
+ *
+ * Regla 6 del hueco, aplicada aquí sin excepción: "no pude" (el binario no
+ * está instalado) y "no hay" (esta extensión no tiene servidor conocido) son
+ * dos resultados DISTINTOS. Ninguno de los dos es un error silencioso ni un
+ * "no hay símbolos" genérico — cada uno lleva lo que hace falta para actuar.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { dirname, join, delimiter as SEP_PATH, sep as SEP_RUTA } from "node:path";
+/**
+ * Lista curada, no exhaustiva (ponytail: los lenguajes más comunes, no los 50
+ * del competidor). Añadir uno nuevo es una entrada más aquí, nunca lógica
+ * nueva — si hace falta más cobertura, este es el único sitio que crece.
+ */
+const SERVIDORES = [
+    {
+        nombre: "gopls",
+        comando: "gopls",
+        args: ["serve"],
+        extensiones: [".go"],
+        marcadoresRaiz: ["go.mod", "go.work"],
+        instalar: "go install golang.org/x/tools/gopls@latest",
+    },
+    {
+        nombre: "rust-analyzer",
+        comando: "rust-analyzer",
+        args: [],
+        extensiones: [".rs"],
+        marcadoresRaiz: ["Cargo.toml"],
+        instalar: "rustup component add rust-analyzer",
+    },
+    {
+        nombre: "pyright",
+        comando: "pyright-langserver",
+        args: ["--stdio"],
+        extensiones: [".py", ".pyi"],
+        marcadoresRaiz: ["pyproject.toml", "setup.py", "requirements.txt"],
+        instalar: "npm install -g pyright",
+    },
+    {
+        nombre: "clangd",
+        comando: "clangd",
+        args: [],
+        extensiones: [".c", ".h", ".cpp", ".cc", ".hpp"],
+        marcadoresRaiz: ["compile_commands.json", "CMakeLists.txt"],
+        instalar: process.platform === "darwin" ? "brew install llvm" : "sudo apt install clangd",
+    },
+    {
+        nombre: "bash-language-server",
+        comando: "bash-language-server",
+        args: ["start"],
+        extensiones: [".sh", ".bash"],
+        marcadoresRaiz: [".git"],
+        instalar: "npm install -g bash-language-server",
+    },
+];
+/** Directorios y (en Windows) extensiones ejecutables candidatas para un `comando`. */
+function candidatosDeComando(comando) {
+    const directorios = (process.env.PATH ?? "").split(SEP_PATH).filter(Boolean);
+    const extensiones = process.platform === "win32" ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";") : [""];
+    const candidatos = [];
+    for (const dir of directorios) {
+        for (const ext of extensiones)
+            candidatos.push(join(dir, comando + ext));
+    }
+    return candidatos;
+}
+/** ¿Está `comando` en el PATH? No usa un `which` de shell: mismo resultado en macOS, Linux y Windows sin depender de que exista ese binario. */
+function estaInstalado(comando) {
+    return candidatosDeComando(comando).some((ruta) => existsSync(ruta));
+}
+/** ¿Hay algún marcador de `marcadores` en `dir` o en algún ancestro de `dir`? */
+function tieneMarcadorAncestro(dir, marcadores) {
+    let actual = dir;
+    for (;;) {
+        let entradas;
+        try {
+            entradas = readdirSync(actual);
+        }
+        catch {
+            entradas = [];
+        }
+        if (marcadores.some((m) => entradas.includes(m)))
+            return true;
+        const padre = dirname(actual);
+        if (padre === actual)
+            return false; // llegado a la raíz del sistema de ficheros
+        actual = padre;
+    }
+}
+function extensionDe(ruta) {
+    const base = ruta.slice(ruta.lastIndexOf(SEP_RUTA) + 1);
+    const punto = base.lastIndexOf(".");
+    return punto <= 0 ? "" : base.slice(punto).toLowerCase();
+}
+/**
+ * Busca el servidor LSP para `rutaFichero` dentro del proyecto `cwd`.
+ *
+ * No lanza nunca: toda situación (sin cobertura, servidor conocido pero no
+ * instalado, o servidor listo) es un valor de retorno distinguible, no una
+ * excepción que el llamador tenga que adivinar.
+ */
+export function descubrirParaFichero(rutaFichero, cwd) {
+    const extension = extensionDe(rutaFichero);
+    const candidato = SERVIDORES.find((s) => s.extensiones.includes(extension));
+    if (!candidato)
+        return { estado: "sin_cobertura", extension: extension || "(sin extensión)" };
+    const dirFichero = dirname(rutaFichero);
+    const raizDelLenguaje = tieneMarcadorAncestro(dirFichero, candidato.marcadoresRaiz) ||
+        tieneMarcadorAncestro(cwd, candidato.marcadoresRaiz);
+    if (!raizDelLenguaje)
+        return { estado: "sin_cobertura", extension };
+    return estaInstalado(candidato.comando)
+        ? { estado: "disponible", servidor: candidato }
+        : { estado: "no_instalado", servidor: candidato };
+}
+/** Lista de servidores curados, para diagnóstico (`ada-cli` mostrando qué lenguajes cubre el cliente LSP). */
+export function servidoresConocidos() {
+    return SERVIDORES;
+}
+/**
+ * Marcadores demasiado genéricos para decidir por sí solos "este proyecto es
+ * de este lenguaje": `.git` (el marcador de bash-language-server, elegido
+ * porque cualquier `.sh` en un repo git es un script legítimo) está presente
+ * en prácticamente TODO proyecto, sea cual sea su lenguaje. Sirve para
+ * `descubrirParaFichero` (ahí ya viene acotado por la extensión real del
+ * fichero), pero colaría a `hayLenguajeReconocidoEnProyecto` a devolver
+ * `true` siempre — el mismo marcador con dos papeles distintos.
+ */
+const MARCADORES_DEMASIADO_GENERICOS = new Set([".git"]);
+/**
+ * ¿Hay algún lenguaje con servidor conocido en este proyecto? No mira si el
+ * binario está instalado — solo si el proyecto es "de ese lenguaje" (marcador
+ * de raíz específico presente). Es la comprobación que decide si vale la pena
+ * registrar los tools: si el proyecto no toca ningún lenguaje que cubrimos,
+ * no hay nada que ofrecer y las tools solo serían ruido en el contexto del
+ * modelo — un `.git` (casi cualquier proyecto lo tiene) no cuenta como señal
+ * de "este proyecto usa Bash" a estos efectos.
+ */
+export function hayLenguajeReconocidoEnProyecto(cwd) {
+    return SERVIDORES.some((s) => {
+        const marcadoresFiables = s.marcadoresRaiz.filter((m) => !MARCADORES_DEMASIADO_GENERICOS.has(m));
+        return marcadoresFiables.length > 0 && tieneMarcadorAncestro(cwd, marcadoresFiables);
+    });
+}
+//# sourceMappingURL=descubrimiento.js.map

package/dist/core/lsp/descubrimiento.js.map

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