La frontière du workspace
Un workspace est l’arborescence de répertoires que marque une racine de projet — la racine dans laquelle se trouve le bloc workspace: de votre configuration, celle que désigne --workspace-root, le dossier qu’un éditeur a ouvert, ou celui au-dessus duquel le serveur d’un assistant a été démarré. Tout ce qu’Aggrega lit et écrit pour son propre compte est tenu à cette arborescence, sauf là où vous, ou la configuration du workspace, désignez un emplacement extérieur. Un lien symbolique qui s’y trouve peut pointer n’importe où sur la machine ; un lien n’est donc jamais considéré comme faisant partie du workspace simplement parce qu’il s’y trouve : ce qui compte, c’est où il mène.
Cette page énonce la règle en entier. Les pages de chaque surface — la ligne de commande, le serveur de langage et les outils de l’assistant — indiquent comment leurs propres requêtes s’y confrontent.
Ce qui se trouve à l’intérieur du workspace
Un chemin est à l’intérieur du workspace lorsque sa partie existante la plus profonde, liens suivis, est la racine du workspace ou se trouve en dessous — les liens propres à la racine étant suivis de la même façon, de sorte qu’un workspace que vous atteignez par un lien qui lui est propre contient toujours tout ce qui se trouve en dessous.
Une racine que vous ouvrez par un lien est le workspace vers lequel mène le lien. Que le dossier que vous ouvrez soit lui-même un lien ou qu’il soit atteint par un lien situé plus haut, Aggrega liste, lit et écrit exactement ce qu’il ferait dans le workspace vers lequel mène le lien — ses Releases, ses documents, ses lockfiles — et juge de la même façon chaque lien qui s’y trouve. Chaque chemin d’une réponse reste écrit à partir de la racine telle qu’elle a été donnée — le dossier qu’un éditeur a ouvert, le --workspace-root que vous avez saisi, le répertoire dans lequel votre shell indique que vous travaillez —, de sorte que ce qui vous est montré correspond aux chemins avec lesquels vous travaillez.
Cette lecture unique couvre tous les types de chemins :
- C’est l’endroit où mène un chemin qui tranche, pas la façon dont il est écrit.
./shared/app.yamlest à l’extérieur lorsquesharedest un lien vers un répertoire situé ailleurs, bien que chacune de ses parties soit écrite à l’intérieur du workspace. Un paramètre de requête peut tout de même exiger une écriture qui lui est propre — un chemin relatif à la racine, par exemple — et sa propre page le précise ; c’est une règle qui porte sur le paramètre, pas sur la frontière. - Un chemin qui n’existe pas encore est jugé d’après les répertoires qui y mènent. Un fichier qu’un build s’apprête à créer sous un
distqui est un lien menant à l’extérieur est à l’extérieur avant même d’être écrit. - Un lien qui ne mène nulle part, ou qui tourne en boucle, n’est pas quelque chose qui existe. C’est le répertoire qui le contient qui est jugé à la place, et rien n’est suivi pour découvrir où le lien était censé mener. Lorsqu’un tel lien se trouve exactement là où un fichier est sur le point d’être créé, l’endroit vers lequel il pointe est aussi vérifié, puisque c’est là que le fichier aboutirait.
- Un lien vers un autre endroit à l’intérieur du workspace est suivi comme d’habitude. Seul un lien menant à l’extérieur est retenu.
La règle juge l’endroit où mène un chemin sur le disque, et rien d’autre. Elle ne lit aucune valeur et ne déduit rien d’un nom.
Ce que fait un lien qui mène à l’extérieur
Ce qui arrive à un chemin qui mène à l’extérieur dépend du type de chemin. Il y a trois issues.
Signalé comme non lu
Là où Aggrega liste ce que contient le workspace, un lien qui mène à l’extérieur n’est pas lu, et la liste le signale. Les Releases qu’un éditeur propose au choix, l’index des entités et les complétions et candidats qu’un éditeur en tire, ainsi que list-releases et list-entities d’un assistant ne parcourent aucun répertoire hors du workspace et ne lisent aucun fichier hors de celui-ci, quoi que ce fichier déclare — de sorte qu’une entité que votre éditeur affiche sous un tel lien n’est pas listée comme appartenant au workspace. Les listes de Release et les listes d’entités nomment chacun de ces liens par sa propre place dans le workspace, jamais par l’endroit où il mène : unreadLinkedDirs et unreadLinkedFiles côté serveur de langage, unread_linked_dirs et unread_linked_files côté outils de l’assistant. Un lien vers un répertoire que votre configuration liste sous catalog_dirs, vers un répertoire situé sous l’un d’eux, ou vers une Release qu’elle nomme, n’est pas nommé : la configuration a atteint cet endroit — un répertoire listé est lu avec tout ce qu’il contient — comme le décrivent les exceptions ci-dessous. Un .gitignore qui est un lien menant à l’extérieur n’est pas lu non plus, de sorte qu’un fichier situé ailleurs sur la machine ne décide jamais lesquels des documents du workspace sont parcourus. Un fichier de configuration du workspace qui est un lien menant à l’extérieur est lui aussi nommé parmi les fichiers non lus : ces listes répondent toujours pour ce workspace, lu sans rien de configuré, tandis que toute requête que décide la configuration s’arrête, comme le décrit la configuration propre du workspace ci-dessous.
Refusé
Un chemin qu’une requête nomme, lorsque l’appelant n’est pas le propriétaire de la machine qui le saisit, est refusé. Hormis les exceptions ci-dessous, tout chemin qu’une requête d’un éditeur à aggrega serve nomme pour que le serveur le lise ou l’écrive, et tout chemin qu’un assistant nomme à un serveur joint via HTTP, doit mener à l’intérieur du workspace ; un chemin qui mène à l’extérieur est refusé sans que rien ne soit lu ou écrit, et le refus nomme le paramètre, comme l’expose la page de chaque surface. La modification de document est refusée de cette façon sur chaque surface, ligne de commande comprise — voir La modification de document reste à l’intérieur.
Arrêté
Lorsqu’une opération lirait ou écrirait de son propre chef à travers un lien qui mène à l’extérieur, elle s’arrête. Ce sont les chemins que le produit détermine lui-même plutôt que des chemins que vous avez nommés, et en ignorer un en silence pourrait changer ce que signifie un build ; chacun arrête donc l’opération, nomme le lien et l’endroit où il mène, et laisse l’endroit vers lequel pointe le lien exactement tel qu’il était :
- Ce que lit une recherche — un document sous un répertoire de catalogue, ou à côté d’une Release qui nomme son Aggregate ou son Manifest par identité, ou à côté d’un Manifest qui nomme de cette façon le Manifest qu’il étend. La Release ou le Manifest nommé à l’opération ne fait pas partie de ces documents : il a été lu là où il a été nommé — voir Une Release ou un Manifest nommé à travers un lien. Une recherche qui sauterait un tel lien pourrait résoudre à sa place une autre entité du même nom provenant d’un répertoire ultérieur ; ainsi un build, un pull, une validation, une inspection qui lit le catalogue, un lint d’une seule Release ou du catalogue entier, et les requêtes de l’éditeur et d’un assistant qui compilent, prévisualisent, représentent en graphe, valident, passent au lint ou décrivent une Release s’arrêtent tous avant que quoi que ce soit ne soit résolu ou vérifié :
E0321. - Le lockfile d’une Release — lu à côté de la Release pour les pins par rapport auxquels se résolvent un build, un pull, une validation, un lint, une inspection,
aggrega cache pruneet les requêtes de l’éditeur et d’un assistant. Il est soumis à la même règle là où il est lu exactement comme là où il est écrit, de sorte qu’un lockfile qui est un lien menant à l’extérieur arrête chacun d’eux plutôt que de leur prêter des pins conservés ailleurs sur la machine :E0321. - Un fichier lu à côté d’une entité — les autres documents du répertoire d’une entité que vous épinglez ou publiez, lus pour déterminer si une autre entité partage ce répertoire, et le
.wasmcompilé à partir duquel est chargée une entité Plugin dans un répertoire de catalogue. Chacun n’est lu que depuis l’intérieur du répertoire sous lequel le document propre de l’entité a été lu : le workspace, un répertoire de catalogue que vous avez nommé hors de celui-ci, ou le répertoire d’un document que vous avez nommé hors de celui-ci. Ainsi, un fichier qui est un lien menant à l’extérieur arrêteaggrega pin,aggrega push(exécution à blanc comprise), un pull qui épingle, ainsi que l’épinglage et la publication par l’éditeur et par un assistant — un document resté non lu pourrait être l’entité qui fait obstacle — et arrête un build ou un pull qui charge le plugin plutôt que d’exécuter des octets conservés ailleurs sur la machine :E0321. - Le cache d’artefacts — tout ce qu’Aggrega lit dans le cache sous
artifact_cache_dir: une entité, un plugin ou une bibliothèque en cache et le manifeste à côté, une archive source et ses métadonnées, une entrée externe épinglée, un bundle de signature et l’index de recherche local d’un registre, ainsi que chaque entrée de workspace que listentaggrega cache status,aggrega cache pruneetaggrega cache clear. Le cache n’est lu que depuis l’intérieur du répertoire de cache, l’endroit où il est écrit, de sorte que tout élément qui s’y trouve et qui est un lien menant hors de ce répertoire — vers un autre endroit du workspace comme vers n’importe où ailleurs — arrête un build, un pull, une validation, une recherche, chacune des trois commandes de cache, et les requêtes de l’éditeur et d’un assistant qui lisent le cache, plutôt que de leur remettre des octets conservés en un endroit que le cache ne possède pas — y compris un contenu vérifié par rapport à un digest enregistré, car un digest dit ce que sont les octets, non d’où ils peuvent être lus. L’avis de dépréciation qu’afficheaggrega inspect, qui ne décide de rien, est laissé de côté. Un prune ou un clear traite l’un des répertoires propres du cache qui est un tel lien, ou un répertoire de cache qui est lui-même un lien menant hors du workspace, comme la suppression qu’il serait, avecE0320, avant de lister quoi que ce soit :E0321. - Un dépôt qu’une source récupère — le checkout qu’un pull archive pour une source
git-repository. Le checkout est un répertoire à part entière, de sorte qu’un lien que contient le dépôt n’est archivé comme ce vers quoi il pointe que là où cela se trouve à l’intérieur du dépôt ; un lien qui en sort, et qui pourrait atteindre n’importe quel fichier de la machine qui exécute le pull, arrête le pull en nommant le lien et l’endroit où il mène, sans rien mettre en cache —module_subdirlui-même compris, lorsqu’il est un tel lien :E0321. Le checkout disparaît dès que le pull s’arrête, si bien que le message nomme le lien par sa place dans le dépôt, ainsi que le dépôt et la révision que nomme la source. Unmodule_subdirqui, tel qu’il est écrit, remonte au-dessus du dépôt est refusé avant que le dépôt ne soit récupéré, de sorte que rien n’est lu à côté du checkout :E0307. - Les fichiers d’un répertoire que vous importez —
aggrega import, l’outil d’import de l’assistant etaggrega/importde la session, lorsqu’on leur donne un répertoire, en lisent les fichiers que sélectionnent les motifs de fichiers de l’importeur. Le répertoire est une racine à part entière où qu’il se trouve — voir Un répertoire que vous importez — de sorte qu’un lien parmi ces fichiers qui mène hors de celui-ci, ou un lien vers un répertoire qui mène hors de celui-ci, arrête l’import en nommant le lien avant qu’aucun fichier du répertoire ne soit lu :E0321. - La configuration propre de l’espace de travail — chaque
.aggrega-config.yamldepuis la racine jusqu’au répertoire où une commande s’exécute, et le.aggrega-config-append-ci.yamld’un pipeline à côté de l’un quelconque d’entre eux. Chaque commande qui lit la configuration, le serveur de langage et les outils d’un assistant la lisent avant toute autre chose, de sorte qu’un de ces fichiers qui est un lien menant à l’extérieur arrête chacun d’eux à cet endroit plutôt que de les laisser s’exécuter sur une configuration constituée de ce qui restait :E0321. Les commandesaggregaqui ne la lisent jamais —version,help,completion,explain,get-schema,scaffoldlorsqu’il rédige un document de départ,skills list,plugin run-local,plugin sync,auth tokenetlogout— s’exécutent normalement, avec un avertissement nommant le lien.scaffold --examplela lit, pour le registre par défaut et la politique de signature, et s’arrête là comme tout autre lecteur. Le serveur de langage, ainsi que le serveur d’un assistant qui communique par ses propres flux, démarrent malgré tout sur un tel espace de travail, afin que son contenu puisse être listé : les listes de Release et d’entités répondent, lues sans aucun répertoire de catalogue ni rien d’autre de configuré, et nomment le fichier parmi les liens non lus. Toute autre requête que la configuration détermine — un build, un aperçu, un graphe, une validation, un lint, une description, la configuration effective, la Release par défaut — s’arrête avecE0321en nommant le lien, de même que le serveur d’un assistant auquel on demande d’écouter via HTTP, dont la configuration aurait défini l’adresse et l’autorisation. - Ce qu’une opération écrit ou supprime — le répertoire de sortie d’un build, ses répertoires de frontière et chaque fichier qui y est écrit, la trace ; le lockfile d’une Release et l’enregistrement de confiance des plugins à côté de celui-ci ; un
entity.lock; le fichier de configuration de l’espace de travail qu’une commande écrit ; le cache d’artefacts et chacune de ses parties qu’un pull remplit ou queaggrega cache clearetaggrega cache prunevident ; les brouillons qu’un import écrit et les entités Plugin queaggrega plugin gen-catalogécrit ; et le marqueur.aggrega/active-releasedans lequel un éditeur enregistre une Release par défaut, que le serveur de langage écrit pour lui. Undistqui serait un lien transformerait sinon « reconstruire la sortie » en la suppression d’un répertoire ailleurs sur la machine :E0320. - Ce qu’un document nomme par un chemin — voir Une référence qu’écrit un document :
E0324. - Le contenu qu’une entité déclare — un
source:ou un$import:dont le chemin passe par un répertoire qui est un lien menant hors du répertoire propre de l’entité, et qu’une publication emporterait sinon sous un nom à l’intérieur de l’entité :E0304.
Cela vaut quel que soit l’initiateur de l’opération — la ligne de commande, un éditeur ou un assistant sur l’un ou l’autre transport — car le chemin appartient à l’espace de travail et au produit, et non à l’appelant.
Une référence qu’écrit un document
Une Release et un Manifest peuvent nommer un autre fichier par un chemin : les aggregate: et manifest: d’une Release écrits sous la forme ./… ou ../…, son extends:, le extends: d’un Manifest écrit sous forme de chemin, et le parameters: { $import: … } d’une Release. Un document de l’espace de travail n’atteint de cette manière que des fichiers situés dans l’espace de travail — un chemin qui remonte vers l’extérieur tel qu’il est écrit est refusé, tout comme celui qui reste à l’intérieur tel qu’il est écrit mais rencontre en chemin un lien menant à l’extérieur. Rien n’est lu dans le fichier que l’un ou l’autre nomme.
Un espace de travail que vous avez cloné porte les références de son auteur ; restreindre ce que vous nommez tout en suivant ce vers quoi un document mène ensuite laisserait donc la frontière à un seul ../. Lorsqu’un document a besoin d’une entité conservée ailleurs, il nomme l’entité plutôt qu’un fichier — aggregate: payments — et la configuration de l’espace de travail liste le répertoire de catalogue qui la contient. Un nom est recherché, et non suivi, il n’est donc jamais refusé ici.
Une Release ou un Manifest situé hors de l’espace de travail, admis parce que vous l’avez nommé, n’atteint que des fichiers de son propre répertoire — voir Une exception atteint le répertoire qu’elle nomme, et pas au-delà.
Les exceptions, et pourquoi chacune en est une
Un chemin relevant de l’une de ces classes est honoré là où il mène, dans l’espace de travail ou non. Chacune est une classe de chemins plutôt qu’une liste d’emplacements, et chacune est une exception pour une raison qui lui est propre.
- Ce que nomme la configuration de l’espace de travail. Ses répertoires de catalogue —
catalog_dirsetcatalog_dirs_append, pour l’espace de travail ou pour une Release sousworkspace.releases— les fichiers de Release indexés comme clés sousworkspace.releases,build.authoring_release, le.wasmlocal d’un plugin attaché et les fichiers sous sonwith.sources,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, la racine de confiance épinglée d’un registre, et unartifact_cache_dirqui remonte hors de la racine de l’espace de travail. Nommer un chemin dans la configuration est la manière délibérée dont un espace de travail atteint l’extérieur de lui-même : il est écrit une fois, conservé avec le projet et lu par quiconque l’examine. Le répertoirecatalogconventionnel de l’espace de travail compte comme nommé lorsque la configuration le liste ou que vous le passez avec--catalog— ou que la configuration liste, ou que vous passez, l’emplacement vers lequel il mène, sous n’importe quelle graphie, ou un répertoire au-dessus de cet emplacement, qui lit alors une seule fois ce qui s’y trouve, à travers le répertoire que vous avez nommé. Lu seulement parce qu’il est là, il constitue le contenu propre de l’espace de travail, de sorte qu’uncatalogqui est un lien menant hors de l’espace de travail n’est pas lu tant que vous ne le nommez pas, lui ou l’emplacement vers lequel il mène. - Un chemin que vous saisissez sur la ligne de commande.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, un fichier à valider, à analyser avec lint, à épingler ou à publier : chacun est utilisé là où il mène — hormis la modification de document, ci-dessous. Vous possédez la machine sur laquelle la commande s’exécute et pouvez déjà lire et écrire tout ce que vous saisiriez, de sorte que vous restreindre à un répertoire n’apporterait rien. - Un chemin qu’un assistant nomme via les flux propres du processus. Un client qui a lancé
aggrega mcpsur votre machine s’exécute en votre nom, et son hôte lui fournit généralement ses propres outils de fichiers et de shell, de sorte qu’un chemin qu’il nomme est honoré comme si vous l’aviez saisi — voir Les deux transports de l’assistant. - Les magasins du produit à l’échelle de la machine — le fichier de configuration global, le magasin des modules compilés, le cache des descripteurs de plugins, le paquet de documentation et le magasin des identifiants de registre. Ils appartiennent à la machine plutôt qu’à un espace de travail, de sorte qu’aucun espace de travail ne les contient.
- Un fichier ou un répertoire choisi dans une boîte de dialogue, lu là où il se trouve. Un éditeur envoie sous forme de chemin absolu le fichier de clé ou la racine de confiance de l’enregistrement d’un registre, la description que
aggrega/importconvertit — un fichier, ou un répertoire dont l’importeur lit les fichiers — et le module pour lequelaggrega/pluginGenCataloggénère une entité, avec l’overlay à côté. Une personne a choisi chacun d’eux, où qu’elle le conserve. Ils sont seulement lus : rien de ce qu’écrit une requête ne va vers un chemin choisi de cette manière. Un répertoire choisi de cette manière est limité à lui-même, comme l’est tout répertoire que vous importez. - Un document que votre éditeur garde ouvert. Sa validation, la demande ou l’abandon de ses diagnostics, le survol, la complétion, la résolution ainsi que la recherche de références et d’implémentations dans celui-ci reçoivent une réponse à partir du contenu envoyé par l’éditeur, de sorte qu’aucun fichier n’est lu au chemin qui le nomme, et que le chemin n’est jamais refusé en raison de l’endroit où il mène. Une requête qui lit effectivement le document sur le disque relève du type refusé décrit plus haut.
Les chemins saisis sur la ligne de commande et les magasins à l’échelle de la machine ne sont jamais évalués ; les autres sont admis en raison de leur classe, jamais de la requête qui se trouve les porter.
Une exception atteint le répertoire qu’elle nomme, et pas au-delà
Un répertoire que vous avez nommé hors de l’espace de travail est une racine à part entière pour tout ce qui est lu ou écrit sous lui. Le répertoire lui-même est utilisé tel que vous l’avez nommé — s’il est un lien, il est suivi jusqu’à sa cible — et un lien sous lui menant hors de lui est traité exactement comme un lien à l’intérieur de l’espace de travail : non lu dans une liste, et arrêtant une recherche ou une écriture. Ainsi, un répertoire de catalogue que vous listez hors de l’espace de travail, un répertoire de sortie que vous passez à aggrega plugin gen-catalog ou à aggrega import, et un artifact_cache_dir qui remonte hors de l’espace de travail retiennent chacun pour eux-mêmes ce qui se trouve sous eux. Lorsqu’un répertoire que vous avez nommé se trouve dans l’espace de travail, la racine est l’espace de travail — hormis un répertoire que vous importez, qui est une racine à part entière où qu’il se trouve.
Un répertoire que vous nommez est résolu par rapport au dossier dans lequel vous exécutez la commande avant que quoi que ce soit ne soit placé sous lui. Un répertoire de sortie que vous passez à aggrega import, saisi en relatif, est le dossier de ce nom dans le dossier où vous exécutez la commande, et un lecteur que vous nommez seul sous Windows — D: — est le dossier courant sur ce lecteur. Le répertoire est d’abord converti en chemin complet et chaque fichier est placé sous ce chemin complet, de sorte qu’un fichier dont le nom commence par un séparateur, \notes.txt par exemple, aboutit dans le répertoire que vous avez nommé plutôt qu’à la racine du lecteur, et que le répertoire indiqué par la commande est celui dans lequel elle a écrit.
Une Release ou un Manifest que vous avez nommé hors de l’espace de travail relève de la même règle appliquée à un fichier : son propre répertoire est la racine, de sorte que ce qu’il nomme par un chemin — et ce que nomme chaque Release vers laquelle mène sa chaîne extends: — doit rester dans ce répertoire. Une Release conservée à côté de son Aggregate et de son Manifest se construit depuis n’importe où ; une Release dans la disposition habituelle releases/, qui nomme ../aggregates/app.yaml, se construit plutôt depuis son propre espace de travail.
Une Release ou un Manifest nommé par un lien
Une Release que vous nommez par un lien est lue là où mène le lien, et résolue là où vous l’avez nommée. Saisie sous la forme --release release.yaml, où release.yaml est un lien vers un fichier conservé ailleurs — ou nommée de cette manière sous workspace.releases, ou comme build.authoring_release — la Release est lue à l’emplacement vers lequel mène le lien. L’Aggregate et le Manifest qu’elle nomme, par identité ou par un chemin, sont recherchés à côté du lien, dans le répertoire où vous l’avez nommée, et limités à la racine de ce répertoire : l’espace de travail, ou le répertoire lui-même lorsqu’il se trouve hors de l’espace de travail. Son lockfile est lui aussi lu et écrit à côté du lien, jamais là où mène le lien. La Release ne fait pas partie des documents que sa propre recherche rencontre à côté d’elle, elle n’arrête donc jamais cette recherche ; une autre Release conservée à côté d’elle qui est un lien menant à l’extérieur l’arrête toujours. Un Manifest que vous inspectez seul par un lien est lu et résolu de la même manière.
Le répertoire du cache d’artefacts est une racine à part entière, où qu’il se trouve. Tout ce que contient le cache est écrit, lu et supprimé uniquement à l’intérieur du répertoire du cache, de sorte qu’un des répertoires propres du cache, ou un fichier de l’un d’eux, qui est un lien menant hors du répertoire du cache est bloqué — même lorsqu’il mène ailleurs dans l’espace de travail — tandis qu’un lien menant ailleurs dans le répertoire du cache est suivi. L’emplacement du répertoire du cache lui-même se déduit de la façon dont sa valeur est écrite. Écrit à l’intérieur de la racine de l’espace de travail — y compris la valeur par défaut .aggrega/cache — il est un répertoire propre de l’espace de travail : un répertoire du cache qui est un lien vers un autre endroit de l’espace de travail est suivi, et un répertoire qui mène hors de l’espace de travail est refusé, en lecture comme en écriture. Écrit en remontant vers l’extérieur (../shared-cache), c’est un répertoire que nomme la configuration, lu et écrit là où il mène.
Un répertoire que vous importez
Un répertoire que vous importez est une racine à part entière, où qu’il se trouve — à l’intérieur de l’espace de travail comme à l’extérieur, et c’est en cela qu’il diffère de tout autre répertoire que vous nommez dans l’espace de travail. aggrega import, l’outil d’import de l’assistant et aggrega/import de la session transmettent à l’importeur chaque fichier du répertoire sous sa place dans ce répertoire, de sorte que ce qu’ils lui transmettent n’est lu qu’à l’intérieur du répertoire. Ce qui est évalué, c’est ce dont l’import tirerait quelque chose : un lien vers un fichier que sélectionne un motif de l’importeur — de n’importe quel importeur, lorsque le format est reconnu plutôt que nommé — et un lien vers un répertoire, dans lequel on n’entre jamais. L’un de ceux-ci menant hors du répertoire est refusé avant qu’aucun fichier ne soit lu, même lorsqu’il mène ailleurs dans l’espace de travail, tandis qu’un lien sélectionné vers un fichier situé ailleurs dans le répertoire est lu là où il pointe, sous le nom propre du lien. Un lien vers un fichier qu’aucun motif ne sélectionne n’est ni évalué ni lu. Le répertoire lui-même est utilisé tel que vous l’avez nommé ; s’il est un lien, il est suivi jusqu’à sa cible.
La modification de document reste à l’intérieur
aggrega edit-document, la modification de document et le point d’insertion du serveur de langage, ainsi que edit-document et insertion-point de l’assistant n’agissent que sur un document que contient l’espace de travail. Un document hors de l’espace de travail, tel qu’il est écrit ou par un lien menant hors de celui-ci, est refusé sur chaque surface sans que rien ne soit lu ni écrit — y compris là où un chemin que vous nommez est par ailleurs honoré.
Les deux transports de l’assistant
aggrega mcp sert les mêmes outils de deux manières, et la frontière diffère entre elles parce que l’appelant diffère.
- Via les flux propres du processus, le client a lancé le serveur sur votre machine, de sorte qu’un appel équivaut à une saisie de votre part sur la ligne de commande : un argument de chemin peut être absolu et se trouver hors de l’espace de travail, un appel peut nommer ses propres
workspace_rootetcatalog_dirs, et les outils qui exécutent une commandeaggregadans un processus séparé sont proposés. Seul le chemin qu’un appel nomme est honoré tel qu’il est nommé. Ce que l’opération lit et écrit ensuite pour son propre compte est traité comme dans un terminal : une liste ne lit pas à travers un lien menant à l’extérieur, une référence qu’écrit un document ne quitte pas l’espace de travail, et une écriture ne passe pas par un répertoire de sortie ou de cache lié. Le contenu de l’espace de travail peut orienter ce que demande un assistant ; ainsi, sur un hôte où ces outils sont son seul accès à vos fichiers, un document d’un espace de travail que vous avez cloné peut tout de même l’amener à nommer un chemin hors de l’espace de travail et à le faire lire ou écrire ; ce qu’un assistant peut faire sans vous demander d’abord est l’endroit où vous réglez ce qu’il fait de sa propre initiative. - Via HTTP, l’appelant ne possède pas la machine sur laquelle le serveur s’exécute. L’espace de travail est celui sur lequel le serveur a été démarré et il reste fixe pendant toute sa durée de vie ; chaque argument de chemin est maintenu à l’intérieur, évalué comme ci-dessus ; un appel nommant
workspace_rootoucatalog_dirs, ou sélectionnant une clé de signature détenue sur l’hôte, est refusé ; et les outils qui exécutent une commandeaggregane sont pas proposés. Un refus nomme l’argument et cite une valeur relative telle qu’elle a été envoyée, mais ne nomme ni la racine de l’espace de travail ni l’endroit où un chemin aurait mené.
Lorsque quelque chose est refusé ou s’arrête
| Ce que vous voyez | Que faire |
|---|---|
| Un listage nomme un lien parmi ceux qu’il n’a pas lus | Remplacez le lien par une copie de ce vers quoi il mène ; ou, pour des entités conservées ailleurs, listez le répertoire vers lequel mène le lien sous catalog_dirs ; pour une Release conservée ailleurs, nommez-la sous workspace.releases ou comme build.authoring_release. |
E0321, une lecture à travers un lien sortant d’un répertoire de catalogue ou du répertoire d’une Release | Listez le répertoire vers lequel mène le lien comme répertoire de catalogue, ou passez-le avec --catalog, plutôt que de l’atteindre par un lien situé sous l’un d’eux ; ou remplacez le lien par une copie. Lorsque le lien est le répertoire conventionnel catalog lui-même, listez catalog ou le répertoire vers lequel il mène, ou passez l’un ou l’autre avec --catalog. |
E0321 sur le fichier de verrouillage d’une Release | Supprimez le lien et refaites le pull de la Release, ce qui écrit un nouveau fichier de verrouillage à côté d’elle. Un fichier de verrouillage n’a pas d’autre emplacement. |
E0321 sur un fichier à côté d’une entité | Remplacez le lien par le fichier lui-même : déplacez un document qui est une entité dans un répertoire qui lui est propre, et placez le .wasm compilé à côté de son entité Plugin plutôt qu’un lien vers celui-ci. |
E0321 sur un fichier de configuration | Remplacez le lien par une copie conservée dans l’espace de travail. Une configuration partagée entre espaces de travail se lit en la désignant comme fichier de configuration global, avec --config ou AGGREGA_CONFIG, en dessous des fichiers propres à chaque espace de travail. |
E0321 sur le cache d’artefacts | Supprimez le lien ; un pull remplit à nouveau le cache. Pour conserver le cache ailleurs, définissez artifact_cache_dir sur ce répertoire, écrit relativement à la racine de l’espace de travail (../shared-cache), plutôt que de le lier. |
E0321 sur un lien dans un dépôt récupéré | Le lien est commité dans le dépôt que nomme la source — le message le désigne par son emplacement dans celui-ci : modifiez-le là — faites-le pointer à l’intérieur du dépôt, ou commitez le fichier lui-même — et nommez la révision qui contient la modification. |
E0321 sur un lien dans un répertoire que vous importez | Conservez le fichier lui-même dans le répertoire plutôt qu’un lien vers celui-ci, ou importez le répertoire vers lequel mène le lien. Un répertoire que vous importez n’est lu que depuis son propre intérieur, où qu’il se trouve. |
E0307 sur un module_subdir | Nommez un répertoire à l’intérieur du dépôt : la valeur peut descendre sous le sommet du dépôt mais ne peut pas remonter au-dessus. |
E0320, une écriture ou une suppression à travers un lien | Supprimez le lien que nomme le message, ou faites-le mener quelque part à l’intérieur du répertoire que nomme le message, puis relancez l’opération. Rien dans vos fichiers d’entité n’en est la cause. |
E0324, une référence menant vers l’extérieur | Nommez un Aggregate conservé ailleurs par son metadata.name et listez son répertoire de catalogue ; conservez un Manifest, une Release que nomme un extends: et un fichier de paramètres à l’intérieur de l’espace de travail — ou, pour un document que vous avez nommé depuis l’extérieur, dans son propre répertoire ; ou ouvrez l’espace de travail sur un répertoire contenant les deux documents. |
E0304, du contenu à travers un lien | Remplacez le lien par une copie de ce vers quoi il mène, à l’intérieur du répertoire propre de l’entité. |
| Une requête du serveur de langage refusée pour un chemin menant vers l’extérieur | Envoyez un chemin à l’intérieur de l’espace de travail, relatif à sa racine. Une Release conservée hors de l’espace de travail s’atteint en la nommant dans la configuration, sous workspace.releases ou comme build.authoring_release, et en nommant dans la requête le lien à l’intérieur de l’espace de travail qui y mène — l’emplacement où le listage des Release la propose. |
| Un appel d’assistant via HTTP refusé pour un chemin | Envoyez un chemin relatif à la racine de l’espace de travail que sert le serveur ; lorsque le refus propose l’écriture relative d’un chemin absolu, envoyez celle-ci. |
| Une modification de document refusée | Modifiez un document que contient l’espace de travail ; un lien vers un document situé ailleurs n’est pas suivi pour la modification. |
Voir aussi
- Configuration — où s’écrit chacun des paramètres ci-dessus, et comment un chemin relatif qui s’y trouve est résolu.
aggrega serveetaggrega mcp— chaque requête et chaque outil, et lesquels de leurs paramètres nomment un chemin.- Arrêts fatals — l’entrée complète pour chaque condition ci-dessus.