Мовний сервер
Стан мовного сервера — індикатор у лівій частині рядка стану, поруч з індикатором Release, що показує running, starting або червоне not running. Це єдиний елемент інтерфейсу, який присутній, хоч би що робив компілятор, тож саме тут ви дізнаєтеся, що нічого не запущено, а не здогадуєтеся про це із затихлих елементів, — а його підказка повідомляє, яка з двох причин має місце: жодна тека тут не розпізнається Aggrega, або така тека є, але сервер до неї не під’єднано. Клацання по ньому пропонує Start, коли нічого не запущено, і Restart, коли щось запущено, і виконує вибране. Див. Коли мовний сервер не запущено.
Коли мовний сервер не запущено
Кожна команда, яку додає це розширення, існує з моменту його запуску, незалежно від того, чи запущено мовний сервер, і лише дві з них чекають на сервер, перш ніж покажчик команд їх покаже: та, що названа нижче, і Aggrega: Attach a Feature to the connection at the cursor, яку показано лише в документі, що його мовний сервер визначає як Aggregate або Release. Команда, яка з’являлася б лише після підключення сервера, була б відсутня в покажчику команд саме тоді, коли вона найпотрібніша, — коли нічого не запущено й ви шукаєте спосіб це запустити.
Індикатор ліворуч у рядку стану — це місце, де ви дізнаєтеся, що відбувається. Він показує running, starting або червоним not running, а його підказка пояснює причину: жодна тека в цьому вікні не розпізнається Aggrega, або така тека є, але сервер до неї не підключено. Клацання по ньому пропонує Start або Restart — залежно від ситуації — і виконує це.

Цей індикатор існує тому, що команда, яку неможливо виконати, нічого не пояснює: покажчик команд пропускає її, не кажучи чому, і жодна поверхня редактора не показує підказки для вимкненого елемента керування. Індикатор — це місце, де записано причину, і водночас місце, де ви на неї реагуєте.
Невдалий запуск повідомляє, що не так зі шляхом до компілятора. Якщо aggrega.server.binaryPath ні на що не вказує, сповіщення має вигляд Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Не вдалося запустити мовний сервер Aggrega: компілятор за шляхом ⟨path⟩ не знайдено.); якщо він вказує на файл, який не можна запустити, — … ⟨path⟩ is not an executable file. (… ⟨path⟩ не є виконуваним файлом.). ⟨path⟩ — це файл, який розширення намагалося запустити: налаштування, що починається з ~/ або ${userHome}, показується розгорнутим відносно вашої домашньої папки, так, як його шукали. Обидва далі пропонують задати для aggrega.server.binaryPath двійковий файл aggrega і містять Open binary path setting, що відкриває екран налаштувань на цьому єдиному налаштуванні, та Show output. Якщо шлях ні на що не вказує, сповіщення також містить Download the compiler і Choose another file перед цими двома, бо тоді немає компілятора, який можна замінити: перша завантажує компілятор, як описано в розділі Отримання компілятора, а друга запитує наявний у вас файл компілятора й спрямовує на нього налаштування. Файл, який існує, але не може бути запущений, ви поклали туди самі, тож це сповіщення не пропонує завантаження. Будь-яка інша невдача запуску наводить отриману причину після того самого початку, а потім називає запущений компілятор і налаштування, яке його вказує. Канал виводу Aggrega містить той самий звіт.
Validate повідомляє, що сервер не запущено, і пропонує шлях назад. Якщо натиснути її, коли жоден мовний сервер не працює, вона відповідає Aggrega: the language server is not running. (Aggrega: мовний сервер не запущено.) — а якщо останній запуск не вдався, далі наводиться причина тими словами, якими було повідомлено про цю невдачу, — з Show output, Open binary path setting і власною кнопкою Start індикатора в рядку стану.
Панелі списків повідомляють, що сервер не запущено, а не про збій. Коли жоден мовний сервер не працює, панелі Registries і Catalog показують замість свого списку The Aggrega language server is not running. (Мовний сервер Aggrega не запущено.) із власною підказкою індикатора, а натискання цього рядка запускає сервер. Список панелі Plugins отримується запуском компілятора як команди, а не від мовного сервера, тож якщо цю команду не вдалося запустити, її рядок повідомляє словами сповіщення, що не так зі шляхом, а натискання на нього відкриває налаштування.
Aggrega: Open status bar menu не показується в покажчику команд, поки жоден мовний сервер не відповідає: усе, що вона пропонує, — це дії над працюючим мовним сервером, а ваш редактор не показує команди, яка не може там виконатися. Вона повертається тієї миті, коли сервер починає відповідати.
Команда, яка працює без сервера, залишається в покажчику команд, навіть якщо вона стосується сервера. Aggrega: Toggle the artifact-rendering stage while inspecting записує вподобання, а сервер читає це вподобання під час запуску, — тож зупинений сервер — найкорисніший момент, щоб його задати, а не причина його приховувати.
Життєвий цикл
Розширення керує повним життєвим циклом процесу мовного сервера. Коли воно зупиняє мовний сервер — під час закриття редактора, переходу мовного сервера до іншої робочої області Aggrega або коли не лишається єдиної робочої області, до якої він міг би під’єднатися, — воно спершу просить мовний сервер завершитися кооперативно, що дає змогу завершити поточну роботу. Якщо після закінчення цього пільгового періоду мовний сервер усе ще працює, його просять ще раз — цього разу покинути цю роботу, а не завершувати її. Якщо він досі не завершився, розширення вдається до завершення на рівні ОС. Перезапуск — команда перезапуску, зміна aggrega.server.binaryPath або зміна конфігурації, яку внесло саме розширення, — нічого не просить: він завершує процес на рівні операційної системи й запускає новий. Про кожен із цих кроків повідомляється в канал виводу Aggrega, тож за повільного завершення видно, який крок забирає час і чи відповів мовний сервер узагалі. Семантика однакова на хостах POSIX і Windows.
Мовний сервер, що зупиняється без запиту, запускається знову обмежену кількість разів. Коли запущений сервер завершується, розширення запускає новий; якщо й той завершується — під час запуску, до того як відповів на початковий запит розширення, або вже під час роботи, — його своєю чергою запускають знову, до aggrega.server.respawnAttempts перезапусків у межах aggrega.server.respawnWindowSeconds секунд. Завершення після останнього з них залишає сервер зупиненим і виводить Aggrega language server has stopped responding. (Мовний сервер Aggrega перестав відповідати.) із зазначенням команди, яка запускає його знову, і після цього ніщо не запускає його знову саме по собі — тож сервер, який падає під час кожного запуску, перезапускається саме стільки разів і не більше. Канал виводу Aggrega описує кожен крок словами: що сервер неочікувано зупинився і як він завершився, кожен перезапуск і скільки їх дозволяє налаштування, перезапуск, який не піднявся, і чому, а також що сервер більше не запускається. Зупинка чи перезапуск, які ви запросили, — команда перезапуску, зміна aggrega.server.binaryPath або зміна конфігурації, яку внесло саме розширення, — не враховуються, а перезапуск починає відлік заново з нуля. Перший запуск і запрошений вами перезапуск у разі невдачі не повторюються: кожен завершується сповіщенням про те, що мовний сервер не вдалося запустити, із зазначенням причини.
Кожен мовний сервер заповнює панель Problems з нуля тим, що повідомляє сам. Коли сервер запускається — перший, перезапущений незалежно від того, як було запрошено перезапуск, запущений знову після неочікуваної зупинки попереднього, перенесений до іншої робочої області Aggrega або запущений там, де жоден не працював, — панель Problems очищається від усього, що повідомив попередній сервер, і кожен відкритий файл YAML перевіряється новим сервером, щойно той відповість. Сервер не може відкликати те, що повідомив, а запущений після нього не знає, що це було, тож залишена знахідка була б такою, за якою не стоїть жоден запущений сервер, — після перенесення це знахідка про робочу область, яку ви покинули. Поки відкриті файли перевіряються, знахідки зникають і з’являються знову. Знахідка, яку обчислює лише інший запит, не з’являється, доки цей запит не виконається знову: знахідки збірки повертаються, коли малюється граф або виконується збірка чи попередня збірка, попередження про розбіжність lock-файлу — коли малюється граф (і те, й інше одночасно, якщо для цієї сутності Release відкрита панель графа, оскільки вона перемальовується, коли сервер повертається), а знахідки щодо домовленостей публікації — коли ви запускаєте Lint. Сервер, який зупиняється і не замінюється, — вичерпавши перезапуски або не маючи робочої області Aggrega для під’єднання, — залишає панель Problems як є.
Мовний сервер читає свою конфігурацію під час запуску і зберігає її до зупинки. Командний рядок читає її заново під час кожного запуску, тож редагування .aggrega-config.yaml або ~/.config/aggrega/config.yaml одразу змінює поведінку термінала і нічого не змінює в уже запущеному мовному сервері. Тому розширення стежить за файлами конфігурації, які, за повідомленням запущеного сервера, він прочитав, — шляхами до файлів, які Show config перелічує серед файлів, що зробили внесок, — і коли один із них змінюється на диску, видаляється або з’являється знову й через це більше не збігається з тим, що прочитав сервер, воно виводить одне попередження, що називає файл і пояснює, що мовний сервер читає свою конфігурацію під час запуску, з кнопкою Restart server, яка виконує Aggrega: Start or restart the language server. Кілька записів під час одного збереження викликають одне попередження. Попередження не виводиться знову для цього файлу, поки воно на екрані, ані після того, як ви його закриєте, доки файл не зміниться знову, а перезапуск починає стеження заново з того, що прочитав перезапущений сервер. Файл конфігурації, якого не було під час запуску сервера, не було прочитано, тож за ним не стежать і його створення нічого не викликає; його прочитає наступний запуск. Які файли відстежуються, записується в канал виводу Aggrega під час кожного запуску сервера.
Зміна конфігурації, яку вносить саме розширення, застосовується перезапуском мовного сервера без запиту. Після додавання чи видалення реєстру, початкового заповнення реєстру зі сторінки привітання, додавання чи видалення плагіна, створення конфігурації робочої області зі сторінки привітання та Aggrega: Set authoring_release in .aggrega-config.yaml… там, де їй доводиться створити файл, щоразу відбувається перезапуск, що під час виконання показується як сповіщення з назвою файлу, який сервер збирається прочитати, і жодна з цих дій не викликає попередження: цю зміну запросили ви. Там, де створення конфігурації робочої області саме запускає мовний сервер — жоден не працював або він працював для іншої папки, — цей запуск читає новий файл, і другого перезапуску не відбувається. Щойно мовний сервер, запущений після зміни, прочитав її, власне завершальне повідомлення операції доповнюється одним реченням про те, що зміна тепер діє, замість другого сповіщення; якщо перезапуск не вдався або не було запущеного мовного сервера, щоб прочитати зміну, речення пропускається, бо зміна тоді є у файлі, але ще не діє. Встановлення authoring_release завершується відкриттям файлу, а не реченням, тож нічого не додає.