O grafo de topologia
Topology graph — apresenta a IR compilada da Release selecionada como um grafo interativo: contentores de limite e de subsistema, com cada limite ou subsistema declarado dentro de outro desenhado dentro dele, arestas estilizadas consoante a proveniência, deslocamento e zoom, clique num nó para o selecionar e duplo clique para abrir o seu ficheiro de origem, e clique numa aresta para selecionar a ligação que esta desenha.

O título de cada contentor indica o seu tipo, além do seu agrupamento, de modo que a caixa exterior e a interior se distinguem mesmo num workspace que não declara nenhuma delas — onde, de outra forma, ambas teriam o mesmo nome. Um agrupamento que ninguém declarou, que o compilador cria para os componentes que uma Release ou um Aggregate lista no nível superior, recebe um título que indica que nenhum foi declarado, e a sua caixa é desenhada de forma distinta da de um agrupamento declarado — um contorno pontilhado e neutro — para que não seja lido como um agrupamento com esse nome; um agrupamento declarado pelo utilizador mantém o seu nome, seja ele qual for, incluindo default.
Cada aresta tem uma ponta de seta na extremidade para a qual aponta: uma aresta vai do componente consumidor até ao seu destino, e a ponta de seta é desenhada com a cor e o tracejado da própria aresta. A caixa de um nó é dimensionada medindo o texto que apresenta, tanto o nome do nó como o componente por baixo dele, de modo que nenhum dos dois ultrapassa o contorno, por mais longo que seja o nome do componente.
Uma legenda no canto inferior esquerdo identifica cada agrupamento pelo documento que o declara — um limite pela Release, um subsistema pelo Aggregate — e, quando o desenho tem uma, a caixa que contém os nós que não pertencem a nenhum, com o que contém; indica qual extremidade de uma aresta é o seu destino; e identifica a barra de cor ao longo da margem inicial de um nó e cada cor que o desenho lhe atribui, ao lado do valor de component.aggrega.ai/type que essa cor representa, exatamente como a etiqueta está escrita, com uma linha para os nós sem essa etiqueta, quando existem. Indica também o que essas cores não significam: são atribuídas sempre que um grafo é desenhado, pelo que agrupam os nós por tipo dentro de um grafo, e a mesma cor noutro grafo não corresponde ao mesmo tipo. A legenda permanece onde está, independentemente do que se faça ao desenho, pelo que, sempre que o desenho é ajustado ao painel — no primeiro desenho e sempre que o grafo é pedido — é ajustado à parte do painel acima da legenda: dentro de toda a largura do painel e da altura que resta acima da legenda, centrado horizontalmente, de modo que a legenda não cobre nenhuma parte do desenho, por muitas linhas que tenha. Num painel demasiado baixo para deixar espaço acima da legenda, o desenho é ajustado ao painel inteiro.
Selecionar um nó abre um painel que lista o que lhe está anexado: para cada anexo, a Feature e a respetiva versão resolvida, o slot que preenche ou o facto de não preencher nenhum slot declarado, a FeatureRecipe que o realiza, por nome e versão, quando o grafo compilado indica uma, a sua proveniência, as etiquetas que declara e os valores que o seu autor escreveu. Um anexo escrito numa das ligações do componente — em features: numa entrada uses, no Aggregate ou na Release — não está nessa lista: é desenhado na ligação a que pertence, tal como o grafo compilado o regista, e o painel do nó indica quando as suas ligações têm algum.
Clicar numa aresta seleciona a ligação que esta desenha e abre o painel sobre ela, intitulado com o componente consumidor e o seu destino e com a indicação do socket e do alias, com os anexos dessa ligação apresentados como os de um nó — para cada um, a Feature e a respetiva versão resolvida, o slot que preenche, a FeatureRecipe que o realiza quando o grafo compilado indica uma, e os seus valores — ou uma frase a indicar que nada lhe está anexado. Selecionar um nó anula a seleção de uma ligação e vice-versa; Escape ou o botão de fechar do painel anula qualquer uma delas, e um novo desenho mantém a seleção enquanto o grafo reconstruído continuar a desenhar o nó, ou a ligação a partir do mesmo componente através do mesmo socket com o mesmo alias.
Abaixo dos anexos de um nó, em May attach, o painel lista as Features cuja aplicabilidade declarada é satisfeita pelas etiquetas desse nó no grafo da Release que o painel mostra — as Features declaradas pelos documentos do workspace que essa Release lê, todas exceto as de um diretório de catálogo que apenas outras Releases leem, e as contidas nos diretórios de catálogo com base nos quais essa Release é compilada — cada uma identificada com o seu tipo e com o ficheiro do workspace que a declara ou com o catálogo configurado a partir do qual foi resolvida. Essa lista é aquilo a que essas Features declaram aplicar-se, não uma decisão de que anexar uma resultará num build bem-sucedido — e, quando está vazia, indica que a aplicabilidade declarada de nenhuma Feature corresponde a essas etiquetas, o que é uma afirmação mais restrita do que a de que nada pode ser anexado. Um pedido a que o servidor de linguagem não conseguiu responder indica-o no lugar da lista, em vez de a deixar em branco. Uma Feature declarada por trás de um link que conduz para fora do workspace — um link para um diretório exterior, ou um link com nome de ficheiro YAML que conduz a um ficheiro exterior — não é oferecida, porque o servidor de linguagem não lê nenhuma entidade através de um link desses, embora a árvore de ficheiros do editor mostre a Feature. Quando o workspace contém um link desses, uma linha abaixo da lista, ou abaixo da frase que substitui uma lista vazia, indica-o: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (As Features alcançadas através deste link não são oferecidas, porque este conduz para fora do workspace do Aggrega:) seguido do caminho do link relativo ao workspace — ou Features reached through these links are not offered, because each leads outside the Aggrega workspace: (As Features alcançadas através destes links não são oferecidas, porque cada um conduz para fora do workspace do Aggrega:) quando são vários, primeiro os links para diretórios. Identifica os links que o servidor de linguagem reporta nos termos da Release que o painel mostra, tal como o painel Catalog faz nos da Release selecionada. Quando esse relatório não pode ser lido, a lista é desenhada sem a linha e o motivo é escrito no canal de saída do Aggrega; uma lista que não pôde ser produzida não tem nenhuma linha.

Cada linha tem um controlo Attach que a confirma: o compilador é consultado sobre qual o documento que declara o componente selecionado e em que ponto desse documento deve ficar um anexo desse tipo, e a entrada é escrita aí através do editor — assim entra no histórico de anulação, fica no buffer que está a ser visto, e não na última versão guardada em disco, e mantém os comentários e a formatação à sua volta tal como foram escritos. Nada é guardado em nome do utilizador; a edição é uma alteração como qualquer outra, e o compilador volta a validá-la como faria após qualquer edição. O grafo é redesenhado ao guardar, porque a topologia é compilada a partir dos documentos tal como estão em disco, e um anexo que ainda está no buffer ainda não faz parte deles. O anexo recebe o nome da Feature, e anexar uma Feature já anexada com esse nome é recusado em vez de ser escrito duas vezes. Um componente declarado dentro de um subsistema é anexado com o mesmo clique que um declarado no nível superior, e ambos funcionam pelo mesmo motivo: o grafo identifica um componente pela sua posição na topologia compilada, essa posição não diz quais as chaves que o autor do componente escreveu, e por isso a extensão pergunta em vez de reconstruir — a resposta indica o documento e o caminho até ao bloco dentro dele, e ambos são levados para a edição tal como chegaram. Quando não existe um local desses para indicar — um id que o grafo não tem, um nó para o qual não regista nenhum documento, ou um componente cujo próprio bloco não pode ser indicado no documento em que foi escrito — o que o painel mostra é o motivo dado pelo compilador, e não uma formulação própria desta extensão.
O painel de uma ligação selecionada tem uma secção May attach própria: os slots que o socket dessa ligação declara, pela ordem em que o componente os declara, cada um com a indicação de se é obrigatório, se aquilo que o preenche trata material sensível, a entrega que permite, o seu seletor e a sua descrição, e sob cada slot as Features que o language server responde poderem preenchê-lo nessa ligação — aquelas cuja aplicabilidade declarada é satisfeita pelas etiquetas do componente consumidor e cujas próprias etiquetas satisfazem o seletor do slot. Onde nenhum slot pode ser preenchido, o painel indica porquê nos termos do language server — uma Feature traçou a ligação, o socket não é um dos que o componente declara, ou o socket não declara slots — e não oferece nada para anexar. Premir Attach sob um slot escreve a Feature com o nome do slot, uma entrada <slot>: cujo type: nomeia a Feature, na entrada dessa ligação no documento que traçou a ligação: a Release, para uma ligação que a Release traçou, e o Aggregate nos restantes casos. Uma ligação selecionada a partir da sua entrada num documento, através de Aggrega: Attach a Feature to the connection at the cursor, é antes escrita nesse documento — a Release, para a entrada própria da Release relativa a uma ligação que o Aggregate traçou — e a linha do painel sob May attach indica então que a Feature é escrita na entrada dessa ligação no documento em que o comando foi executado. O compilador é consultado sobre onde essa entrada fica nesse documento, qualquer parte do caminho que o documento ainda não contenha é escrita juntamente com ela, e a edição chega ao editor tal como a de um nó, por guardar. Um slot que o grafo já mostra preenchido nessa ligação é recusado antes de qualquer pergunta, e uma recusa do compilador é apresentada nas suas próprias palavras.
Um valor que o compilador reporta como sensível é retido pelo language server no grafo que envia, e retido novamente pela extensão antes de o grafo chegar sequer à vista, pelo que não está na vista para ser apresentado — o painel nomeia o campo e indica porque é retido, e um anexo cuja marcação de sensibilidade tem uma forma que o painel não reconhece retém todos os valores em vez de tentar adivinhar. Um anexo desenhado numa ligação é retido exatamente pela mesma regra que um desenhado num nó, sob a mesma definição. aggrega.graph.showSensitiveValues desativa a retenção para um autor que precise de reler o que escreveu: só enquanto está ativa é que o pedido do grafo solicita esses valores ao language server, e a página de definições indica o que isso apresenta.
Os nós são dispostos pela ordem em que as vagas da Release são iniciadas, pelo que um boundary que declara um syncWave: aparece antes dos boundaries que aguardam por ele. Passar o ponteiro sobre um nó mostra o seu componente e a versão resolvida, as suas etiquetas, a vaga declarada e os metadados próprios da entidade do catálogo — licença, repositório, página inicial, palavras-chave e responsáveis pela manutenção —, apresentando apenas os campos que a entidade efetivamente declara.
Um grafo aberto volta a ser renderizado sempre que um documento redigido no workspace é guardado, pelo que acompanha as edições sem ser reaberto; é redesenhado ao guardar e não a cada tecla premida porque a topologia é compilada a partir do que está em disco. É também redesenhado quando o lockfile da Release selecionada é escrito — por Aggrega: Pull, por um build com Auto pull ou por aggrega pull num terminal —, porque o grafo está fixado a esse lockfile, e é ainda redesenhado quando o language server volta a responder, pelo que um grafo deixado aberto durante um reinício recupera por si próprio.
Um redesenho que não foi pedido deixa a vista onde foi colocada: o deslocamento e o zoom existentes são mantidos, quer a topologia reconstruída seja diferente quer não, pelo que um nó que a disposição reconstruída coloca onde estava permanece sob a mesma parte do painel, e um que coloca noutro sítio — um componente acrescentado pode deslocar os que o rodeiam — move-se dentro da vista mantida em vez de arrastar a vista consigo. Isto inclui um redesenho que ocorre enquanto o grafo está atrás de outro separador, ao qual se regressa tal como foi deixado.
Aggrega: Show topology graph volta a ajustar o desenho ao painel, que é a forma de regressar à forma completa depois de ampliar uma parte. Uma topologia grande é ajustada por inteiro em vez de recortada, pelo que uma grande chega pequena: vê-se como está composta, e chega-se aos nomes ampliando. Onde dois ou mais agrupamentos contidos numa caixa ficariam mais altos do que largos, são desenhados lado a lado em vez de empilhados numa coluna, pelo que uma topologia grande usa a largura do painel e o seu primeiro ajuste desenha-a maior do que uma única coluna permitiria.
Uma reconstrução que o compilador recusa mantém o desenho existente em vez de o apagar — a topologia continua a valer a leitura e continua onde se estava a trabalhar — e esbate-o, para que um desenho que já não está atualizado não seja confundido com um que está; o aviso por cima dele contém o motivo dado pelo próprio compilador. O desenho volta à intensidade total assim que é construído um novo. A disposição é calculada na vista; o compilador entrega topologia, nunca coordenadas.