トポロジーグラフ
Topology graph — 選択した Release のコンパイル済み IR をインタラクティブなグラフとして描画します。境界とサブシステムのコンテナ(別の境界やサブシステムの中で宣言された境界やサブシステムはその内側に描画されます)、由来に応じたスタイルのエッジ、パンとズーム、ノードをクリックして選択し、ダブルクリックしてそのソースファイルを開く操作、そしてエッジをクリックしてそのエッジが描く接続を選択する操作を備えています。

各コンテナのタイトルはグループに加えてその種類も示すため、どちらも宣言していない(そうでなければ両方が同じ名前になる)ワークスペースでも、外側のボックスと内側のボックスを区別して読めます。誰も宣言していないグループ、つまり Release または Aggregate が最上位に列挙するコンポーネントのためにコンパイラが作成するグループには、何も宣言されていないことを示すタイトルが付き、そのボックスは宣言されたグループのものとは異なる描き方(点線の中立的な枠線)で描画されるため、その名前のグループとして読まれることはありません。自分で宣言したグループは、default を含め、どのような名前でもその名前を保持します。
各エッジは指し示す側の端に矢じりを持ちます。エッジは利用側のコンポーネントからそのターゲットへ向かい、矢じりはエッジ自身の色と破線パターンで描画されます。ノードのボックスは、描画するテキスト(ノード名とその下のコンポーネントの両方)を測定してサイズが決まるため、コンポーネント名がどれほど長くても、どちらも枠線からはみ出しません。
左下の凡例は、各グループをそれを宣言するドキュメントで示し(境界は Release、サブシステムは Aggregate)、描画にある場合は、どのグループにも属さないノードを収めるボックスとその内容を示します。また、エッジのどちらの端がターゲットかを示し、ノードの先頭側の縁に沿ったカラーバーと、描画がそれに与える各色を、その色が表す component.aggrega.ai/type の値(ラベルの記述どおり)と並べて示し、そのラベルを持たないノードがある場合はそれらのための行も示します。さらに、それらの色が何を意味しないかも示します。色はグラフを描画するたびに割り当てられるため、1 つのグラフ内ではノードを種類ごとにグループ化しますが、別のグラフで同じ色であっても同じ種類ではありません。描画に対して何を行っても凡例はその位置に留まるため、描画がパネルに合わせられるとき(最初の描画時と、グラフを要求するたび)は、凡例より上のパネル部分に合わせられます。つまり、パネルの全幅と凡例の上に残る高さの範囲内で、左右中央に配置されるため、凡例の行数がいくつであっても描画のどの部分も凡例に隠れません。凡例の上に余地がまったく残らないほど低いパネルでは、描画はパネル全体に合わせられます。
ノードを選択すると、そのノードにアタッチされているものを一覧表示するパネルが開きます。各アタッチメントについて、Feature とその解決済みバージョン、それが埋めるスロット(または宣言されたスロットを埋めないこと)、コンパイル済みグラフが名前を示している場合はそれを実現する FeatureRecipe の名前とバージョン、その由来、宣言しているラベル、作成者が記述した値が表示されます。コンポーネントの接続のいずれかに記述されたアタッチメント(Aggregate または Release 内の uses エントリーの features: の下に記述されたもの)はこの一覧には含まれません。コンパイル済みグラフが記録するとおり、それが属する接続上に描画され、ノードの接続にアタッチメントがある場合はノードのパネルにその旨が示されます。
エッジをクリックすると、そのエッジが描く接続が選択され、その接続のパネルが開きます。パネルのタイトルは利用側のコンポーネントとそのターゲットで、ソケットとエイリアスも示され、その接続のアタッチメントはノードの場合と同様に表示されます(各アタッチメントの Feature と解決済みバージョン、埋めるスロット、コンパイル済みグラフが名前を示している場合はそれを実現する FeatureRecipe、およびその値)。何もアタッチされていない場合はその旨を示す文が表示されます。ノードを選択すると選択中の接続は解除され、その逆も同様です。Escape またはパネルの閉じるボタンでどちらの選択も解除でき、再描画しても、再構築されたグラフがそのノード、または同じコンポーネントから同じソケットを通り同じエイリアスで出る接続をまだ描画している限り、選択は保持されます。
ノードのアタッチメントの下にある May attach に、パネルは、パネルが表示している Release のグラフ上でそのノードのラベルが宣言された適用範囲を満たす Features を一覧表示します。対象は、その Release が読み込むワークスペース内のドキュメントが宣言する Features(他の Releases だけが読み込むカタログディレクトリにあるものを除く)と、その Release がビルドの対象とするカタログディレクトリに含まれるものです。それぞれ、種類と、それを宣言するワークスペースファイルまたはそれの解決元である設定済みのカタログとともに示されます。この一覧は、それらの Features が適用対象として宣言しているものであり、どれかをアタッチすればビルドが成功するという判断ではありません。一覧が空の場合は、どの Feature の宣言された適用範囲もそれらのラベルに一致しないことを示し、これは何もアタッチできないという主張よりも狭い主張です。言語サーバーが応答できなかったリクエストは、一覧を空のままにせず、一覧の代わりにその旨を示します。ワークスペースの外へ通じるリンクの先で宣言された Feature(外部のディレクトリへのリンク、または YAML ファイルのような名前で外部のファイルへ通じるリンク)は、エディターのファイルツリーにはその Feature が表示されても、提示されません。言語サーバーはそのようなリンクを介してエンティティを読み込まないためです。ワークスペースにそのようなリンクがある場合は、一覧の下(または空の一覧の代わりの文の下)の行がその旨を示します。Features reached through this link are not offered, because it leads outside the Aggrega workspace:(このリンクを介して到達する Features は、Aggrega ワークスペースの外へ通じるため提示されません:)の後にワークスペースからの相対パスでリンクのパスが続きます。複数の場合は Features reached through these links are not offered, because each leads outside the Aggrega workspace:(これらのリンクを介して到達する Features は、それぞれ Aggrega ワークスペースの外へ通じるため提示されません:)となり、ディレクトリへのリンクが先に並びます。この行は、Catalog パネルが選択中の Release に基づいて示すのと同様に、言語サーバーが報告するリンクを、パネルが表示している Release に基づいて示します。その報告を読み取れない場合、一覧はその行なしで描画され、理由は Aggrega 出力チャネルに書き込まれます。生成できなかった一覧には行は付きません。

各行には、その行を確定する Attach コントロールがあります。選択したコンポーネントを宣言しているのはどのドキュメントか、そのドキュメント内のどこにそのようなアタッチメントが入るかをコンパイラに問い合わせ、エントリーはエディターを通じてその場所に書き込まれます。そのため、エントリーは元に戻す履歴に加わり、ディスクに最後に保存されたバージョンではなく表示中のバッファーに反映され、周囲のコメントや書式は記述したとおりに残ります。代わりに保存されるものは何もありません。この編集は他の変更と同じ変更であり、コンパイラは他の編集の後と同様にこれを再検証します。グラフは保存時に再描画されます。トポロジーはディスク上の現在のドキュメントからコンパイルされ、まだバッファー内にあるアタッチメントはそこに含まれていないためです。アタッチメントには Feature の名前が付けられ、その名前ですでにアタッチされている Feature をアタッチしようとすると、二重に書き込まれるのではなく拒否されます。サブシステム内で宣言されたコンポーネントも、最上位で宣言されたコンポーネントと同じ操作でアタッチでき、どちらも同じ理由で機能します。グラフはコンパイル済みトポロジー内の位置でコンポーネントを識別しますが、その位置からはコンポーネントの作成者がどのキーを記述したかはわからないため、拡張機能は再構築するのではなく問い合わせます。応答はドキュメントとその中のブロックへのパスを示し、どちらも受け取ったまま編集に引き継がれます。示すべきそのような場所がない場合(グラフが持たない ID、ドキュメントが記録されていないノード、または作成されたドキュメント内で自身のブロックを示せないコンポーネント)、パネルに表示されるのはこの拡張機能独自の文言ではなく、コンパイラが示した理由です。
選択した接続のパネルには、独自の May attach セクションがあります。その接続の socket が宣言するスロットが、コンポーネントが宣言した順に並び、それぞれについて必須かどうか、それを埋めるものが機密性の高い情報を扱うかどうか、許可される受け渡し方法、セレクター、説明が示されます。各スロットの下には、言語サーバーがその接続上でそのスロットを埋められると回答した Features、つまり宣言された適用条件を利用側コンポーネントのラベルが満たし、かつ自身のラベルがスロットのセレクターを満たすものが表示されます。埋められるスロットがない場合、パネルは言語サーバーの言葉でその理由(Feature がその接続を描いた、socket がコンポーネントの宣言していないものである、または socket がスロットを宣言していない)を示し、アタッチできるものは何も表示しません。スロットの下の Attach を押すと、その Feature がスロットの名前で、つまり type: でその Feature を指定する <slot>: エントリとして、その接続を描いたドキュメント内のその接続のエントリに書き込まれます。Release が描いた接続なら Release、それ以外なら Aggregate です。Aggrega: Attach a Feature to the connection at the cursor によってドキュメント内のエントリから選択した接続の場合は、代わりにそのドキュメントに書き込まれます(Aggregate が描いた接続に対する Release 自身のエントリなら Release)。その場合、May attach の下にあるパネルの行は、コマンドを実行したドキュメント内のその接続のエントリに Feature が書き込まれることを示します。そのエントリがそのドキュメントのどこに入るかはコンパイラに問い合わせられ、ドキュメントにまだないパスの部分も一緒に書き込まれ、編集はノードの場合と同じく未保存のままエディターに反映されます。グラフがその接続上ですでに埋められていると示しているスロットは、何かを問い合わせる前に拒否され、コンパイラからの拒否はコンパイラ自身の言葉で表示されます。
コンパイラが機密と報告した値は、言語サーバーが送信するグラフから除外され、グラフがビューに渡される前に拡張機能によっても再度除外されるため、ビューに表示される値として存在しません。パネルはそのフィールド名と除外の理由を示します。また、機密性のマーキングがパネルの認識できない形式になっているアタッチメントは、推測せずにすべての値を除外します。接続上に描かれたアタッチメントは、ノード上に描かれたものとまったく同じ規則、同じ設定のもとで除外されます。aggrega.graph.showSensitiveValues は、自分が書いた内容を読み返す必要がある作成者のために除外を無効にします。この設定がオンの間だけ、グラフのリクエストは言語サーバーにそれらの値を要求します。設定ページには、それによって何が表示されるかが記載されています。
ノードは Release のウェーブが起動される順に配置されるため、syncWave: を宣言する boundary は、それを待つ boundary よりも前に表示されます。ノードにカーソルを合わせると、そのコンポーネントと解決済みバージョン、ラベル、宣言されたウェーブ、そしてカタログエンティティ自身のメタデータ(ライセンス、リポジトリ、ホーム、キーワード、メンテナー)が表示されます。表示されるのは、エンティティが実際に宣言しているフィールドだけです。
開いているグラフは、ワークスペース内の作成されたドキュメントが保存されるたびに自動的に再描画されるため、開き直さなくても編集に追従します。トポロジーはディスク上の内容からコンパイルされるため、キー入力ごとではなく保存時に再描画されます。選択した Release のロックファイルが書き込まれたとき(Aggrega: Pull、Auto pull を有効にしたビルド、またはターミナルでの aggrega pull によって)にも再描画されます。グラフはそのロックファイルに固定されているためです。また、言語サーバーが再び応答できるようになったときにも再描画されるため、再起動をまたいで開いたままのグラフは自動的に回復します。
自分で要求していない再描画では、ビューは置いた位置のまま保たれます。再構築されたトポロジーが異なるかどうかにかかわらず、それまでのパンとズームは維持されるため、再構築されたレイアウトで元の位置に置かれたノードはパネルの同じ部分に留まり、別の場所に置かれたノード(追加されたコンポーネントによって周囲のコンポーネントがずれることがあります)は、ビューを引き連れて移動するのではなく、維持されたビューの中で移動します。グラフが別のタブの後ろにある間に再描画が行われた場合も同様で、戻ったときには離れたときのままです。
Aggrega: Show topology graph は描画をパネルに合わせ直します。一部を拡大した後に全体の形に戻るにはこれを使います。大きなトポロジーは切り取られずに全体がパネルに収められるため、大きなものは小さく表示されます。全体の構成を確認し、拡大して名前を読みます。1 つのボックスに含まれる 2 つ以上のグループが横幅より高さのほうが大きくなるように配置される場合、それらは 1 列に積み重ねられずに横に並べて描画されます。そのため、大きなトポロジーはパネルの幅を活用し、最初のフィットでは 1 列の場合よりも大きく描画されます。
コンパイラが拒否した再構築では、描画は空にならずにそのまま残ります。トポロジーは引き続き読む価値があり、作業していた場所でもあるからです。ただし描画は淡色表示になり、最新ではなくなった描画が最新のものと誤解されないようにします。その上の通知には、コンパイラ自身による理由が示されます。新しい描画が構築されると、描画はすぐに通常の表示に戻ります。レイアウトはビューで計算されます。コンパイラが提供するのはトポロジーであり、座標は提供しません。