Le graphe de topologie
Topology graph — affiche l’IR compilée de la Release sélectionnée sous forme de graphe interactif : conteneurs de frontière et de sous-système, chaque frontière ou sous-système déclaré à l’intérieur d’un autre étant dessiné à l’intérieur de celui-ci, arêtes stylisées selon leur provenance, panoramique et zoom, clic sur un nœud pour le sélectionner et double-clic pour ouvrir son fichier source, et clic sur une arête pour sélectionner la connexion qu’elle représente.

Le titre de chaque conteneur indique sa nature en plus de son regroupement, de sorte que le cadre extérieur et le cadre intérieur se distinguent même dans un workspace qui ne déclare ni l’un ni l’autre — où tous deux porteraient sinon le même nom. Un regroupement que personne n’a déclaré, que le compilateur crée pour les composants qu’une Release ou un Aggregate liste au niveau supérieur, porte un titre indiquant qu’aucun n’est déclaré, et son cadre est dessiné différemment de celui d’un regroupement déclaré — une bordure pointillée et neutre — afin qu’il ne se lise pas comme un regroupement portant ce nom ; un regroupement que vous avez déclaré conserve son nom quel qu’il soit, default compris.
Chaque arête porte une pointe de flèche à l’extrémité vers laquelle elle pointe : une arête va du composant consommateur vers sa cible, et la pointe de flèche est dessinée dans la couleur et le tireté propres à l’arête. Le cadre d’un nœud est dimensionné en mesurant le texte qu’il affiche, à la fois le nom du nœud et le composant en dessous, de sorte qu’aucun des deux ne dépasse sa bordure, quelle que soit la longueur du nom du composant.
Une légende en bas à gauche nomme chaque regroupement d’après le document qui le déclare — une frontière d’après la Release, un sous-système d’après l’Aggregate — et, lorsque le dessin en comporte un, le cadre contenant les nœuds qui n’appartiennent à aucun, avec ce qu’il contient ; elle indique quelle extrémité d’une arête est sa cible ; et elle nomme la barre de couleur le long du bord avant d’un nœud et chaque couleur que le dessin lui donne, à côté de la valeur de component.aggrega.ai/type que représente cette couleur, exactement telle que le label est écrit, avec une ligne pour les nœuds dépourvus d’un tel label lorsqu’il y en a. Elle indique aussi ce que ces couleurs ne signifient pas : elles sont attribuées à chaque dessin d’un graphe, elles regroupent donc les nœuds par type au sein d’un graphe, et la même couleur dans un autre graphe ne correspond pas au même type. La légende reste à sa place quoi que vous fassiez au dessin ; chaque fois que le dessin est ajusté au panneau — lors de son premier dessin, et chaque fois que vous demandez le graphe — il est donc ajusté à la partie du panneau située au-dessus de la légende : dans toute la largeur du panneau et la hauteur restante au-dessus de la légende, centré horizontalement, de sorte que la légende ne recouvre aucune partie du dessin, quel que soit son nombre de lignes. Dans un panneau trop bas pour laisser de la place au-dessus de la légende, le dessin est ajusté au panneau entier.
Sélectionner un nœud ouvre un panneau qui liste ce qui lui est attaché : pour chaque attachement, la Feature et sa version résolue, le slot qu’il occupe ou le fait qu’il n’occupe aucun slot déclaré, la FeatureRecipe qui le réalise, avec son nom et sa version, lorsque le graphe compilé en nomme une, sa provenance, les labels qu’il déclare et les valeurs écrites par son auteur. Un attachement écrit sur l’une des connexions du composant — sous features: dans une entrée uses, dans l’Aggregate ou dans la Release — ne figure pas dans cette liste : il est dessiné sur la connexion à laquelle il appartient, tel que le graphe compilé l’enregistre, et le panneau du nœud indique lorsque ses connexions en portent.
Cliquer sur une arête sélectionne la connexion qu’elle représente et ouvre le panneau sur celle-ci, intitulé d’après le composant consommateur et sa cible et nommant le socket et l’alias, les attachements de cette connexion étant présentés comme ceux d’un nœud — pour chacun, la Feature et sa version résolue, le slot qu’il occupe, la FeatureRecipe qui le réalise lorsque le graphe compilé en nomme une, et ses valeurs — ou une phrase indiquant que rien n’y est attaché. Sélectionner un nœud annule la sélection d’une connexion et inversement ; Escape ou le bouton de fermeture du panneau annule l’une ou l’autre, et un nouveau dessin conserve la sélection tant que le graphe reconstruit dessine encore le nœud, ou la connexion partant du même composant par le même socket sous le même alias.
Sous les attachements d’un nœud, dans May attach, le panneau liste les Features dont l’applicabilité déclarée est satisfaite par les labels de ce nœud sur le graphe de la Release qu’affiche le panneau — les Features déclarées par les documents du workspace que lit cette Release, toutes sauf celles d’un répertoire de catalogue que seules d’autres Releases lisent, et celles contenues dans les répertoires de catalogue sur lesquels cette Release est construite — chacune nommée avec sa nature et soit le fichier du workspace qui la déclare, soit le catalogue configuré à partir duquel elle a été résolue. Cette liste indique ce à quoi ces Features déclarent s’appliquer, et non une décision selon laquelle en attacher une produira un build réussi — et lorsqu’elle est vide, elle indique que l’applicabilité déclarée d’aucune Feature ne correspond à ces labels, ce qui est une affirmation plus restreinte que le fait que rien ne puisse être attaché. Une requête à laquelle le serveur de langage n’a pas pu répondre le signale à la place de la liste plutôt que de la laisser vide. Une Feature déclarée derrière un lien menant hors du workspace — un lien vers un répertoire extérieur, ou un lien nommé comme un fichier YAML qui mène à un fichier extérieur — n’est pas proposée, car le serveur de langage ne lit aucune entité à travers un tel lien, même si l’arborescence de fichiers de votre éditeur affiche la Feature. Lorsque le workspace contient un tel lien, une ligne sous la liste, ou sous la phrase qui remplace une liste vide, le signale : Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Les Features atteintes par ce lien ne sont pas proposées, car il mène hors du workspace Aggrega :) suivi du chemin du lien relatif au workspace — ou Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Les Features atteintes par ces liens ne sont pas proposées, car chacun mène hors du workspace Aggrega :) pour plusieurs liens, les liens vers des répertoires en premier. Elle nomme les liens que signale le serveur de langage dans les termes de la Release qu’affiche le panneau, comme le fait le panneau Catalog dans ceux de la Release sélectionnée. Lorsque ce signalement ne peut pas être lu, la liste est dessinée sans la ligne et la raison est écrite dans le canal de sortie Aggrega ; une liste qui n’a pas pu être produite ne comporte aucune ligne.

Chaque ligne comporte un contrôle Attach qui la valide : le compilateur est interrogé pour savoir quel document déclare le composant sélectionné et où, dans ce document, un tel attachement doit se placer, et l’entrée y est écrite par l’intermédiaire de l’éditeur — elle rejoint ainsi l’historique d’annulation, arrive dans le tampon que vous regardez plutôt que dans la dernière version enregistrée sur le disque, et laisse les commentaires et la mise en forme alentour tels que vous les avez écrits. Rien n’est enregistré à votre place ; la modification est une modification comme une autre, et le compilateur la revalide comme il le ferait après toute modification. Le graphe est redessiné lorsque vous enregistrez, car la topologie est compilée à partir des documents tels qu’ils sont sur le disque, et un attachement encore dans le tampon n’en fait pas encore partie. L’attachement est nommé d’après la Feature, et attacher une Feature déjà attachée sous ce nom est refusé plutôt qu’écrit deux fois. Un composant déclaré dans un sous-système s’attache par la même action qu’un composant déclaré au niveau supérieur, et les deux fonctionnent pour la même raison : le graphe identifie un composant par sa position dans la topologie compilée, cette position n’indique pas quelles clés l’auteur du composant a écrites, et l’extension pose donc la question plutôt que de reconstruire — la réponse nomme le document et le chemin du bloc qu’il contient, et tous deux sont repris dans la modification tels qu’ils sont arrivés. Lorsqu’il n’y a pas de tel emplacement à nommer — un identifiant que le graphe ne porte pas, un nœud pour lequel il n’enregistre aucun document, ou un composant dont le bloc propre ne peut pas être nommé dans le document où il a été écrit — le panneau affiche la raison donnée par le compilateur, et non une formulation propre à cette extension.
Le panneau d’une connexion sélectionnée a sa propre section May attach : les slots que déclare le socket de cette connexion, dans l’ordre où le composant les déclare, chacun avec l’indication s’il est obligatoire, si ce qui le remplit traite des éléments sensibles, la livraison qu’il permet, son sélecteur et sa description, et sous chaque slot les Features dont le language server répond qu’elles peuvent le remplir sur cette connexion — celles dont les labels du composant consommateur satisfont l’applicabilité déclarée et dont les propres labels satisfont le sélecteur du slot. Là où aucun slot ne peut être rempli, le panneau dit pourquoi dans les termes du language server — une Feature a tracé la connexion, le socket n’est pas l’un de ceux que déclare le composant, ou le socket ne déclare aucun slot — et ne propose rien à attacher. Appuyer sur Attach sous un slot écrit la Feature sous le nom du slot, une entrée <slot>: dont le type: nomme la Feature, dans l’entrée de cette connexion dans le document qui a tracé la connexion : la Release pour une connexion tracée par la Release, l’Aggregate sinon. Une connexion sélectionnée depuis son entrée dans un document, par Aggrega: Attach a Feature to the connection at the cursor, est écrite dans ce document à la place — la Release, pour l’entrée propre de la Release relative à une connexion tracée par l’Aggregate — et la ligne du panneau sous May attach indique alors que la Feature est écrite dans l’entrée de cette connexion dans le document où la commande a été exécutée. Le compilateur est interrogé sur l’emplacement de cette entrée dans ce document, toute partie du chemin que le document ne contient pas encore est écrite avec elle, et la modification arrive dans l’éditeur comme celle d’un nœud, non enregistrée. Un slot que le graphe montre déjà rempli sur cette connexion est refusé avant toute question, et un refus du compilateur est affiché dans ses propres termes.
Une valeur que le compilateur signale comme sensible est retenue par le language server dans le graphe qu’il envoie, puis retenue à nouveau par l’extension avant même que le graphe soit transmis à la vue, de sorte qu’elle n’est pas dans la vue pour y être affichée — le panneau nomme le champ et dit pourquoi il est retenu, et un attachement dont le marquage de sensibilité a une forme que le panneau ne reconnaît pas retient toutes les valeurs plutôt que de deviner. Un attachement tracé sur une connexion est retenu selon exactement la même règle qu’un attachement tracé sur un nœud, sous le même paramètre. aggrega.graph.showSensitiveValues désactive cette rétention pour un auteur qui a besoin de relire ce qu’il a écrit : c’est seulement lorsqu’il est activé que la requête du graphe demande ces valeurs au language server, et la page des paramètres indique ce qui est alors affiché.
Les nœuds sont disposés dans l’ordre dans lequel les vagues de la Release sont mises en service, de sorte qu’une boundary qui déclare un syncWave: apparaît avant les boundaries qui l’attendent. Le survol d’un nœud indique son composant et sa version résolue, ses labels, sa vague déclarée et les métadonnées propres de l’entité du catalogue — licence, dépôt, page d’accueil, mots-clés et mainteneurs — en n’affichant que les champs que l’entité déclare réellement.
Un graphe ouvert se réaffiche chaque fois qu’un document rédigé dans le workspace est enregistré, si bien qu’il suit vos modifications sans être rouvert ; il se redessine à l’enregistrement plutôt qu’à chaque frappe, car la topologie est compilée à partir de ce qui se trouve sur le disque. Il se redessine aussi lorsque le lockfile de la Release sélectionnée est écrit — par Aggrega: Pull, par un build avec Auto pull, ou par aggrega pull dans un terminal — car le graphe est épinglé à ce lockfile, et il se redessine également lorsque le language server redevient joignable, de sorte qu’un graphe laissé ouvert pendant un redémarrage se rétablit de lui-même.
Un redessin que vous n’avez pas demandé laisse votre vue là où vous l’avez placée : le panoramique et le zoom que vous aviez sont conservés, que la topologie reconstruite diffère ou non, de sorte qu’un nœud que la disposition reconstruite place là où il était reste sous la même partie du panneau, et qu’un nœud qu’elle place ailleurs — un composant ajouté peut décaler ceux qui l’entourent — se déplace à l’intérieur de la vue que vous avez conservée au lieu d’entraîner la vue avec lui. Cela inclut un redessin qui survient pendant que le graphe se trouve derrière un autre onglet, que vous retrouvez tel que vous l’avez laissé.
Aggrega: Show topology graph ajuste de nouveau le dessin au panneau, ce qui permet de revenir à la forme entière après avoir zoomé sur une partie. Une grande topologie est ajustée en entier plutôt que rognée, si bien qu’une topologie volumineuse arrive petite : vous voyez comment elle est construite, et vous atteignez les noms en zoomant. Là où deux regroupements ou plus contenus dans une même boîte se disposeraient plus hauts que larges, ils sont dessinés côte à côte plutôt qu’empilés dans une colonne, de sorte qu’une grande topologie utilise la largeur du panneau et que son premier ajustement la dessine plus grande qu’une seule colonne ne le permettrait.
Une reconstruction que le compilateur refuse conserve le dessin que vous aviez plutôt que de l’effacer — la topologie mérite toujours d’être lue et reste là où vous travailliez — et l’atténue, afin qu’un dessin qui n’est plus à jour ne soit pas pris pour un dessin actuel ; l’avis au-dessus porte la raison donnée par le compilateur lui-même. Le dessin retrouve sa pleine intensité dès qu’un nouveau est construit. La disposition est calculée dans la vue ; le compilateur fournit la topologie, jamais des coordonnées.