El servidor de lenguaje
Estado del language server — un indicador en la barra de estado, a la izquierda, junto al indicador de la Release, que muestra running, starting o not running en rojo. Es la única superficie que está presente haga lo que haga el compilador, así que es donde descubres que no hay nada en ejecución en lugar de tener que deducirlo de superficies que se han quedado en silencio; y su información sobre herramientas indica cuál de los dos motivos se aplica: ninguna carpeta de aquí es una que Aggrega reconozca, o hay una y el servidor no está vinculado a ella. Al hacer clic en él se ofrece Start cuando no hay nada en ejecución y Restart cuando lo hay, y se ejecuta lo que elijas. Consulta Cuando el language server no se está ejecutando.
Cuando el servidor de lenguaje no se está ejecutando
Todos los comandos que aporta esta extensión existen desde el momento en que se inicia, haya o no un servidor de lenguaje en ejecución, y solo dos esperan a un servidor antes de que el índice de comandos los liste: el que se nombra más abajo, y Aggrega: Attach a Feature to the connection at the cursor, que solo se lista en un documento que el servidor de lenguaje identifica como un Aggregate o una Release. Un comando que solo existiera una vez conectado un servidor faltaría en el índice de comandos precisamente en la ventana que más lo necesita — aquella en la que no se está ejecutando nada y buscas la forma de iniciarlo.
El indicador de la izquierda en la barra de estado es donde averiguas qué está pasando. Muestra running, starting o not running en rojo, y su tooltip dice por qué: ninguna carpeta de esta ventana es una que Aggrega reconozca, o hay una y el servidor no está conectado a ella. Al hacer clic ofrece Start o Restart — lo que corresponda — y lo hace.

Ese indicador existe porque un comando que no puede ejecutarse no explica nada: el índice de comandos lo omite en lugar de decir por qué, y ninguna superficie del editor muestra un tooltip en un control deshabilitado. El indicador es donde se escribe el motivo, y también donde actúas en consecuencia.
Un inicio que falla dice qué está mal en la ruta del compilador. Cuando aggrega.server.binaryPath no apunta a nada, la notificación dice Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (No se pudo iniciar el servidor de lenguaje de Aggrega: no se encontró el compilador en ⟨path⟩.); cuando apunta a un archivo que no se puede ejecutar, dice … ⟨path⟩ is not an executable file. (… ⟨path⟩ no es un archivo ejecutable.) ⟨path⟩ es el archivo que la extensión intentó iniciar: una configuración que empieza por ~/ o ${userHome} se muestra resuelta a partir de tu carpeta personal, tal como se buscó. Ambas indican a continuación que establezcas aggrega.server.binaryPath en el binario aggrega, e incluyen Open binary path setting, que abre la pantalla de configuración en esa única opción, y Show output. Cuando la ruta no apunta a nada, la notificación incluye además Download the compiler y Choose another file antes de esos dos, porque entonces no hay ningún compilador que sustituir: el primero descarga uno como se describe en Obtener el compilador, y el segundo pide un archivo de compilador que tengas y apunta la configuración a él. Un archivo que está ahí y no se puede ejecutar es uno que pusiste tú, así que esa notificación no ofrece ninguna descarga. Cualquier otro fallo al iniciar da el motivo que se le dio, tras la misma apertura, y luego nombra el compilador que se ejecutó y la configuración que lo nombra. El canal de salida de Aggrega contiene el mismo informe.
Validate dice que el servidor no se está ejecutando y ofrece la forma de volver. Si se pulsa mientras no hay ningún servidor de lenguaje en ejecución, responde Aggrega: the language server is not running. (Aggrega: el servidor de lenguaje no se está ejecutando.) — seguido, cuando el último inicio falló, del motivo, en las palabras con que se informó de ese fallo — con Show output, Open binary path setting y el propio Start del indicador de la barra de estado.
Los paneles de lista dicen que el servidor no se está ejecutando en lugar de informar de un fallo. Sin ningún servidor de lenguaje en ejecución, los paneles Registries y Catalog muestran cada uno The Aggrega language server is not running. (El servidor de lenguaje de Aggrega no se está ejecutando.) en lugar de su lista, con el propio tooltip del indicador, y pulsar la fila inicia el servidor. La lista del panel Plugins procede de ejecutar el compilador como comando y no del servidor de lenguaje, así que cuando ese comando no pudo iniciarse su fila dice qué está mal en la ruta con las palabras de la notificación, y pulsarla abre la configuración.
Aggrega: Open status bar menu se omite del índice de comandos mientras ningún servidor de lenguaje responde: todo lo que ofrece es una acción sobre un servidor de lenguaje en ejecución, y tu editor no lista un comando que no puede ejecutarse allí. Vuelve en cuanto uno responde.
Un comando que funciona sin servidor permanece en el índice de comandos, aunque se refiera al servidor. Aggrega: Toggle the artifact-rendering stage while inspecting escribe una preferencia, y el servidor lee esa preferencia al iniciarse — así que un servidor detenido es el momento más útil para establecerla, no un motivo para ocultarla.
Ciclo de vida
La extensión gestiona todo el ciclo de vida del proceso del servidor de lenguaje. Cuando detiene el servidor de lenguaje — al cerrarse el editor, al pasar el servidor de lenguaje a otro espacio de trabajo de Aggrega, o al no quedar un único espacio de trabajo al que conectarlo — primero le pide al servidor de lenguaje que termine de forma cooperativa, lo que permite que el trabajo en curso finalice. Si el servidor de lenguaje sigue trabajando cuando se cierra ese periodo de gracia, se le pide una vez más — esta vez que abandone ese trabajo en lugar de terminarlo. Si aun así no ha terminado, la extensión recurre a la terminación a nivel del sistema operativo. Un reinicio — el comando de reinicio, un cambio de aggrega.server.binaryPath o un cambio de configuración que hizo la propia extensión — no pregunta: termina el proceso a nivel del sistema operativo e inicia uno nuevo. Cada uno de estos pasos se notifica en el canal de salida de Aggrega, de modo que un apagado lento muestra qué paso está tardando y si el servidor de lenguaje respondió siquiera. La semántica es idéntica en hosts POSIX y Windows.
Un servidor de lenguaje que se detiene sin que se le pida se vuelve a iniciar, un número limitado de veces. Cuando un servidor en ejecución termina, la extensión inicia uno nuevo; si ese también termina — al iniciarse, antes de haber respondido a la solicitud inicial de la extensión, o una vez en ejecución — se vuelve a iniciar a su vez, hasta aggrega.server.respawnAttempts reinicios en aggrega.server.respawnWindowSeconds segundos. El final posterior al último de ellos deja el servidor detenido y muestra Aggrega language server has stopped responding. (El servidor de lenguaje de Aggrega ha dejado de responder.), nombrando el comando que lo vuelve a iniciar, y a partir de ahí nada lo vuelve a iniciar por sí solo — así, un servidor que muere cada vez que se inicia se vuelve a iniciar ese número de veces y no más. El canal de salida de Aggrega describe cada paso con palabras: que el servidor se detuvo inesperadamente y cómo terminó, cada reinicio y cuántos permite el ajuste, un reinicio que no llegó a arrancar y por qué, y que no se vuelve a iniciar. Una detención o un reinicio que pediste — el comando de reinicio, un cambio de aggrega.server.binaryPath o un cambio de configuración que hizo la propia extensión — no se cuenta, y un reinicio pone el recuento a cero. El primer inicio, y un reinicio que pediste, no se repiten cuando fallan: cada uno termina en la notificación de que el servidor de lenguaje no pudo iniciarse, con el motivo.
Cada servidor de lenguaje empieza el panel Problems a partir de lo que informa él mismo. Cuando se inicia un servidor — el primero, un reinicio se haya pedido como se haya pedido, uno iniciado de nuevo después de que el último se detuviera inesperadamente, uno trasladado a otro espacio de trabajo de Aggrega y uno iniciado donde no se ejecutaba ninguno — el panel Problems se vacía de todo lo que informó el servidor anterior, y cada archivo YAML abierto se comprueba con el nuevo en cuanto responde. Un servidor no puede retirar lo que informó, y el que se inicia después no sabe qué era, así que un hallazgo que se mantuviera sería uno que ningún servidor en ejecución respalda — tras un traslado, uno sobre el espacio de trabajo que dejaste. Los hallazgos desaparecen y vuelven mientras se comprueban los archivos abiertos. Un hallazgo que solo calcula otra solicitud permanece ausente hasta que esa solicitud se vuelve a ejecutar: los hallazgos de la compilación vuelven cuando se dibuja el grafo o se ejecuta una compilación o una compilación de vista previa, el aviso de deriva de un lockfile cuando se dibuja el grafo — ambos a la vez donde hay un panel de grafo abierto en esa Release, ya que se vuelve a dibujar cuando el servidor regresa — y los hallazgos de las convenciones de publicación cuando ejecutas Lint. Un servidor que se detiene y no se sustituye — agotados sus reinicios, o sin ningún espacio de trabajo de Aggrega al que conectarse — deja el panel Problems como estaba.
El servidor de lenguaje lee su configuración al iniciarse y la conserva hasta que se detiene. La línea de comandos la vuelve a leer en cada ejecución, de modo que una edición de .aggrega-config.yaml o de ~/.config/aggrega/config.yaml cambia de inmediato lo que hace un terminal y no cambia nada en un servidor de lenguaje que ya está en ejecución. Por eso la extensión vigila los archivos de configuración que el servidor en ejecución informa que leyó — las rutas de archivo que Show config enumera entre los archivos que contribuyeron — y cuando uno de ellos cambia en disco, se elimina o vuelve a aparecer, y por tanto ya no coincide con lo que leyó el servidor, muestra un aviso que nombra el archivo y dice que el servidor de lenguaje lee su configuración al iniciarse, con un botón Restart server que ejecuta Aggrega: Start or restart the language server. Varias escrituras de un mismo guardado muestran un solo aviso. El aviso no se vuelve a mostrar para ese archivo mientras esté en pantalla, ni después de que lo descartes hasta que el archivo cambie de nuevo, y un reinicio vuelve a empezar la vigilancia a partir de lo que leyó el servidor reiniciado. Un archivo de configuración que no existía cuando se inició el servidor no se leyó, así que no se vigila y crearlo no muestra nada; el siguiente inicio lo lee. Qué archivos se vigilan se escribe en el canal de salida de Aggrega cada vez que se inicia un servidor.
Un cambio de configuración que hace la propia extensión se aplica reiniciando el servidor de lenguaje, sin preguntar. Añadir o quitar un registro, inicializar un registro desde la página de bienvenida, añadir o quitar un plugin, crear la configuración del espacio de trabajo desde la página de bienvenida y Aggrega: Set authoring_release in .aggrega-config.yaml… cuando tiene que crear el archivo van seguidos cada uno de un reinicio, que se muestra mientras se ejecuta como una notificación que nombra el archivo que el servidor está a punto de leer, y ninguno de ellos muestra el aviso: tú pediste ese cambio. Donde crear la configuración del espacio de trabajo inicia por sí mismo el servidor de lenguaje — no había ninguno en ejecución, o se ejecutaba para otra carpeta — ese inicio lee el nuevo archivo, y no sigue un segundo reinicio. Una vez que un servidor de lenguaje iniciado después del cambio lo ha leído, el propio final de la operación añade una frase que dice que el cambio está ya en vigor, en lugar de una segunda notificación; donde el reinicio falló, o no había ningún servidor de lenguaje en ejecución para leer el cambio, la frase se omite, porque el cambio está entonces en el archivo y aún no en vigor. Establecer authoring_release termina abriendo el archivo en lugar de con una frase, así que no añade nada.