言語サーバー
言語サーバーの状態:状態バーの左側、Release インジケーターの横にあるインジケーターで、running、starting、または赤色の not running と表示されます。コンパイラが何をしていても常に存在する唯一の表示なので、静かになった表示から推測させられるのではなく、何も実行されていないことをここで知ることができます。ツールチップには 2 つの理由のどちらに当たるかが示されます。ここに Aggrega が認識するフォルダーがないか、フォルダーはあるもののサーバーがそれに接続されていないかです。クリックすると、何も実行されていないときは Start を、実行中のときは Restart を提示し、選んだ方を実行します。言語サーバーが実行されていないときを参照してください。
言語サーバーが実行されていない場合
この拡張機能が提供するすべてのコマンドは、言語サーバーが実行されているかどうかにかかわらず、拡張機能が起動した瞬間から存在します。そのうち、コマンドインデックスに表示される前にサーバーを待つのは 2 つだけです。後述するコマンドと、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 バイナリに設定するよう示し、その 1 つの設定で設定画面を開く Open binary path setting と、Show output を備えます。パスが何も指していない場合、通知にはその 2 つの前に 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 ワークスペースに移るとき、またはアタッチ先となる単一のワークスペースがなくなったとき)、まず言語サーバーに協調的に終了するよう求め、進行中の処理を完了させます。猶予期間が終わっても言語サーバーがまだ処理中であれば、もう一度だけ、今度は処理を完了させずに破棄するよう求めます。それでも終了しない場合、拡張機能は OS レベルの終了処理に切り替えます。再起動(再起動コマンド、aggrega.server.binaryPath の変更、または拡張機能自身が行った構成変更)では終了を求めず、オペレーティングシステムのレベルでプロセスを終了して新しいプロセスを起動します。これらの各ステップは Aggrega 出力チャネルに報告されるため、シャットダウンが遅い場合にどのステップに時間がかかっているか、また言語サーバーがそもそも応答したかがわかります。セマンティクスは POSIX と Windows のホストで同一です。
要求されずに停止した言語サーバーは、限られた回数だけ再起動されます。 実行中のサーバーが終了すると、拡張機能は新しいサーバーを起動します。そのサーバーも終了した場合(起動中、拡張機能の最初の要求に応答する前、または実行中のいずれでも)、順に再起動され、aggrega.server.respawnWindowSeconds 秒以内に最大 aggrega.server.respawnAttempts 回まで再起動されます。最後の再起動の後に終了すると、サーバーは停止したままになり、サーバーを再び起動するコマンドを示す Aggrega language server has stopped responding.(Aggrega 言語サーバーが応答しなくなりました。)が表示されます。それ以降、自動的に再起動されることはありません。そのため、起動するたびに異常終了するサーバーは、その回数だけ再起動され、それ以上は再起動されません。Aggrega 出力チャネルには、各ステップが言葉で記録されます。サーバーが予期せず停止したことと終了の仕方、各再起動と設定が許可する回数、起動しなかった再起動とその理由、そして再起動されないことです。ユーザーが要求した停止や再起動(再起動コマンド、aggrega.server.binaryPath の変更、または拡張機能自身が行った構成変更)は回数に数えられず、再起動するとカウントはゼロからやり直しになります。最初の起動と、ユーザーが要求した再起動は、失敗しても繰り返されません。いずれも、言語サーバーの起動に失敗したことを理由とともに伝える通知で終わります。
各言語サーバーは、自身が報告する内容から Problems パネルを開始します。 サーバーが起動するとき(最初のサーバー、どのように要求されたかにかかわらず再起動されたサーバー、前のサーバーが予期せず停止した後に再起動されたサーバー、別の Aggrega ワークスペースに移ったサーバー、そしてサーバーが実行されていなかったところで起動されたサーバー)、Problems パネルからは前のサーバーが報告した内容がすべて消去され、開いているすべての YAML ファイルが、新しいサーバーが応答するとすぐにそのサーバーに対してチェックされます。サーバーは報告した内容を取り消すことができず、その後に起動したサーバーはそれが何だったかを知らないため、残された検出結果は、実行中のどのサーバーも裏付けていないものになります。移動後であれば、離れたワークスペースに関するものです。開いているファイルのチェック中は、検出結果がいったん消えてから再び表示されます。別の要求でしか計算されない検出結果は、その要求が再び実行されるまで表示されません。ビルドの検出結果はグラフが描画されたときやビルドまたはプレビュービルドが実行されたときに、ロックファイルのドリフト警告はグラフが描画されたときに戻ります(その Release のグラフパネルが開いている場合は、サーバーが戻るとパネルが再描画されるため、両方が同時に戻ります)。公開の慣例に関する検出結果は Lint を実行したときに戻ります。停止して置き換えられないサーバー(再起動の回数を使い切った場合、またはアタッチ先の Aggrega ワークスペースがない場合)では、Problems パネルはそのままになります。
言語サーバーは起動時に構成を読み込み、停止するまでそれを保持します。 コマンドラインは実行のたびに構成を読み直すため、.aggrega-config.yaml や ~/.config/aggrega/config.yaml を編集するとターミナルの動作はすぐに変わりますが、すでに実行中の言語サーバーには何の変化もありません。そのため拡張機能は、実行中のサーバーが読み込んだと報告する構成ファイル(Show config が寄与したファイルとして一覧表示するファイルパス)を監視します。そのいずれかがディスク上で変更、削除、または復元され、サーバーが読み込んだ内容と一致しなくなると、ファイル名を示し、言語サーバーは起動時に構成を読み込むことを伝える警告を 1 つ表示します。この警告には、Aggrega: Start or restart the language server を実行する Restart server ボタンが付いています。1 回の保存による複数の書き込みでは警告は 1 つだけです。警告が画面に表示されている間はそのファイルについて再表示されず、閉じた後もファイルが再び変更されるまでは表示されません。再起動すると、再起動したサーバーが読み込んだ内容から監視がやり直されます。サーバーの起動時に存在しなかった構成ファイルは読み込まれていないため監視されず、作成しても何も表示されません。次回の起動時に読み込まれます。どのファイルが監視されているかは、サーバーが起動するたびに Aggrega 出力チャネルに書き込まれます。
拡張機能自身が行う構成変更は、確認なしに言語サーバーを再起動することで適用されます。 レジストリの追加または削除、ウェルカムページからのレジストリの初期設定、プラグインの追加または削除、ウェルカムページからのワークスペース構成の作成、そしてファイルを作成する必要がある場合の Aggrega: Set authoring_release in .aggrega-config.yaml… の後には、それぞれ再起動が行われます。再起動中は、サーバーがこれから読み込むファイルを示す通知が表示されます。これらはいずれも警告を表示しません。その変更はユーザー自身が求めたものだからです。ワークスペース構成の作成によって言語サーバー自体が起動する場合(サーバーが実行されていなかった場合、または別のフォルダーのために実行されていた場合)、その起動で新しいファイルが読み込まれ、2 回目の再起動は行われません。変更後に起動した言語サーバーがそれを読み込むと、操作自体の終了メッセージに、変更が有効になったことを伝える 1 文が追加されます。別の通知は表示されません。再起動に失敗した場合、または変更を読み込む言語サーバーが実行されていなかった場合、その 1 文は省かれます。その場合、変更はファイルにはあってもまだ有効になっていないためです。authoring_release の設定は 1 文ではなくファイルを開いて終わるため、何も追加しません。