Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma du protocole de communication du daemon en arrière-plan d’Aggrega

Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.

Identifiant du schéma : https://aggrega.ai/schemas/serve-wire-v1beta1.schema.json

Les formes des messages échangés avec un daemon de compilateur en arrière-plan démarré par aggrega serve. Un client ouvre une session sur ce daemon avec le handshake, et la session est ce qui délimite les réglages et l’espace de travail sur lesquels la conversation a été ouverte ; le daemon est le processus qui répond à une requête, envoie une notification et conserve ce qu’il a lu. Le protocole est JSON-RPC 2.0 sur l’entrée et la sortie standard, chaque message étant délimité par un en-tête Content-Length ; ce document décrit les corps des messages et ni la délimitation ni le transport. Un corps est l’une de quatre choses : une requête que le client envoie, une notification que le client envoie, une notification que le daemon envoie, ou la réponse que le daemon renvoie pour une requête. Trois propriétés de la surface déterminent la façon dont les formes ci-dessous sont écrites. Premièrement, chaque requête admet deux champs en plus de ceux que déclare sa propre méthode — workspaceRoot, qui nomme l’espace de travail sur lequel agit la requête, et workDoneToken, la valeur générée par l’appelant sous laquelle la progression est signalée — de sorte que les deux figurent ici sur chaque objet params de requête, y compris les trois méthodes dont le sujet n’est pas un espace de travail : aggrega/getSchema et aggrega/scaffoldEntity acceptent workspaceRoot et l’ignorent, et aggrega/initialize le lit comme l’espace de travail que déclare la session. Deuxièmement, le daemon refuse un objet params de requête portant un champ que la méthode n’accepte pas, en nommant ce qu’elle accepte, de sorte que chaque objet params est ici fermé à son niveau supérieur ; un objet imbriqué dans une requête n’est pas fermé, car la vérification ne lit que les noms de champs les plus externes. Troisièmement, un résultat est composé par le daemon plutôt que fourni par un appelant, de sorte que les objets de résultat sont fermés à chaque niveau dont la forme est fixe, et ouverts seulement là où la valeur est du JSON opaque que le daemon transmet sans le lire. Une conséquence de l’encodage du daemon est visible dans les messages transmis et est décrite plutôt que masquée : une collection que le daemon ne marque pas comme facultative est émise sous la forme null lorsqu’elle n’a aucune valeur à signaler et sous la forme d’une collection vide lorsque la valeur qu’elle signale est vide, de sorte que les deux formes sont admises partout où cela s’applique.

L’une des formes suivantes

  • Request
  • ClientNotification
  • DaemonNotification
  • SuccessResponse
  • ErrorResponse

Définitions

ProtocolVersion

La version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.

Type : const "2.0"

Constante : "2.0"

RequestId

L’identifiant de l’appelant pour une requête, renvoyé à l’identique sur la réponse qui y répond. Un message ne portant aucun identifiant est une notification et ne reçoit jamais de réponse.

Type : string or number

ProgressToken

Une valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.

Type : string or number

WorkspaceRootSubject

Le chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.

Type : string

WorkspaceRootAccepted

Le chemin absolu d’un espace de travail. Le sujet de cette méthode n’est pas un espace de travail — elle répond à partir de ce que le binaire lui-même contient — de sorte que le champ est accepté et non lu. Il est admis afin qu’un client puisse l’envoyer uniformément sur chaque requête sans avoir à savoir quelles méthodes le consultent.

Type : string

RequestMethod

Chaque méthode qu’une requête peut nommer. L’ensemble est fermé : une requête nommant autre chose reçoit en réponse une erreur de méthode introuvable.

Type : string (enum)

Valeurs autorisées : "aggrega/activeRelease", "aggrega/attachCandidates", "aggrega/attachmentContainer", "aggrega/build", "aggrega/buildPreview", "aggrega/cacheClear", "aggrega/cacheEvict", "aggrega/cachePrune", "aggrega/cacheStatus", "aggrega/catalogIndex", "aggrega/completion", "aggrega/configCapture", "aggrega/configInit", "aggrega/connectionAtPosition", "aggrega/connectionCandidates", "aggrega/deprecateArtifact", "aggrega/diagnostics", "aggrega/editDocument", "aggrega/effectiveConfiguration", "aggrega/entityDefinition", "aggrega/explainError", "aggrega/findImplementations", "aggrega/findReferences", "aggrega/getSchema", "aggrega/hover", "aggrega/import", "aggrega/initialize", "aggrega/insertionPoint", "aggrega/invalidate", "aggrega/irGraph", "aggrega/lint", "aggrega/logout", "aggrega/pin", "aggrega/pluginAdd", "aggrega/pluginGenCatalog", "aggrega/pluginRemove", "aggrega/pluginSync", "aggrega/publishArtifact", "aggrega/publishEntity", "aggrega/registryAdd", "aggrega/registryList", "aggrega/registryRemove", "aggrega/registryUpdate", "aggrega/releaseCandidates", "aggrega/releaseClosure", "aggrega/resolve", "aggrega/resolveDependencies", "aggrega/scaffoldEntity", "aggrega/search", "aggrega/setActiveRelease", "aggrega/signArtifacts", "aggrega/skillsInstall", "aggrega/skillsList", "aggrega/validate"

ClientNotificationMethod

Chaque méthode qu’une notification du client peut nommer. L’ensemble est fermé, et aucune des deux notifications ne reçoit de réponse.

Type : string (enum)

Valeurs autorisées : "$/cancelRequest", "aggrega/shutdown"

DaemonNotificationMethod

Chaque méthode qu’une notification envoyée par le daemon peut nommer. L’ensemble est fermé.

Type : string (enum)

Valeurs autorisées : "$/progress", "aggrega/publishDiagnostics"

Request

Une requête que le client envoie et à laquelle le daemon répond. La méthode nomme ce qui est demandé ; l’objet params porte les champs propres à cette méthode plus les deux que toute méthode admet. Une requête qui omet entièrement params est lue comme une requête dont tous les champs sont absents.

PropriétéTypeObligatoireDescription
jsonrpcProtocolVersionouiLa version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.
idRequestIdouiL’identifiant de l’appelant pour une requête, renvoyé à l’identique sur la réponse qui y répond. Un message ne portant aucun identifiant est une notification et ne reçoit jamais de réponse.
methodRequestMethodouiChaque méthode qu’une requête peut nommer. L’ensemble est fermé : une requête nommant autre chose reçoit en réponse une erreur de méthode introuvable.
paramsobjectnon

Les propriétés supplémentaires ne sont pas autorisées.

params pour chaque method :

methodparamsObligatoire
"aggrega/initialize"InitializeParamsnon
"aggrega/validate"ValidateParamsnon
"aggrega/invalidate"InvalidateParamsnon
"aggrega/diagnostics"DiagnosticsParamsnon
"aggrega/irGraph"IrGraphParamsnon
"aggrega/build"BuildParamsnon
"aggrega/buildPreview"BuildPreviewParamsnon
"aggrega/entityDefinition"EntityDefinitionParamsnon
"aggrega/releaseClosure"ReleaseClosureParamsnon
"aggrega/resolveDependencies"ResolveDependenciesParamsnon
"aggrega/pin"PinParamsnon
"aggrega/cacheStatus"WorkspaceAndProgressParamsnon
"aggrega/cachePrune"WorkspaceAndProgressParamsnon
"aggrega/cacheEvict"CacheEvictParamsnon
"aggrega/cacheClear"WorkspaceAndProgressParamsnon
"aggrega/registryList"WorkspaceAndProgressParamsnon
"aggrega/search"SearchParamsnon
"aggrega/registryAdd"RegistryAddParamsnon
"aggrega/registryRemove"RegistryRemoveParamsnon
"aggrega/registryUpdate"RegistryUpdateParamsnon
"aggrega/logout"LogoutParamsnon
"aggrega/publishEntity"PublishEntityParamsnon
"aggrega/publishArtifact"PublishArtifactParamsnon
"aggrega/signArtifacts"SignArtifactsParamsnon
"aggrega/deprecateArtifact"DeprecateArtifactParamsnon
"aggrega/resolve"ResolveParamsnon
"aggrega/findReferences"FindReferencesParamsnon
"aggrega/findImplementations"FindImplementationsParamsnon
"aggrega/hover"HoverParamsnon
"aggrega/completion"CompletionParamsnon
"aggrega/catalogIndex"CatalogIndexParamsnon
"aggrega/attachCandidates"AttachCandidatesParamsnon
"aggrega/connectionCandidates"ConnectionCandidatesParamsnon
"aggrega/insertionPoint"InsertionPointParamsnon
"aggrega/attachmentContainer"AttachmentContainerParamsnon
"aggrega/connectionAtPosition"ConnectionAtPositionParamsnon
"aggrega/releaseCandidates"WorkspaceAndProgressParamsnon
"aggrega/activeRelease"WorkspaceAndProgressParamsnon
"aggrega/setActiveRelease"SetActiveReleaseParamsnon
"aggrega/editDocument"EditDocumentParamsnon
"aggrega/effectiveConfiguration"WorkspaceAndProgressParamsnon
"aggrega/configInit"ConfigInitParamsnon
"aggrega/configCapture"ConfigCaptureParamsnon
"aggrega/import"ImportParamsnon
"aggrega/scaffoldEntity"ScaffoldEntityParamsnon
"aggrega/lint"LintParamsnon
"aggrega/pluginAdd"PluginAddParamsnon
"aggrega/pluginRemove"PluginRemoveParamsnon
"aggrega/pluginSync"PluginSyncParamsnon
"aggrega/pluginGenCatalog"PluginGenCatalogParamsnon
"aggrega/explainError"ExplainErrorParamsnon
"aggrega/getSchema"GetSchemaParamsnon
"aggrega/skillsInstall"SkillsInstallParamsnon
"aggrega/skillsList"WorkspaceAndProgressParamsnon

ClientNotification

Une notification que le client envoie. Elle ne porte aucun identifiant et ne reçoit jamais de réponse.

PropriétéTypeObligatoireDescription
jsonrpcProtocolVersionouiLa version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.
methodClientNotificationMethodouiChaque méthode qu’une notification du client peut nommer. L’ensemble est fermé, et aucune des deux notifications ne reçoit de réponse.
paramsobjectnon

Les propriétés supplémentaires ne sont pas autorisées.

params pour chaque method :

methodparamsObligatoire
"$/cancelRequest"CancelRequestParamsoui
"aggrega/shutdown"ShutdownParamsnon

DaemonNotification

Une notification que le daemon envoie. Elle ne porte aucun identifiant et ne reçoit jamais de réponse.

PropriétéTypeObligatoireDescription
jsonrpcProtocolVersionouiLa version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.
methodDaemonNotificationMethodouiChaque méthode qu’une notification envoyée par le daemon peut nommer. L’ensemble est fermé.
paramsobjectoui

Les propriétés supplémentaires ne sont pas autorisées.

params pour chaque method :

methodparamsObligatoire
"$/progress"ProgressParamsoui
"aggrega/publishDiagnostics"PublishDiagnosticsParamsoui

CancelRequestParams

Demande au daemon d’abandonner une requête déjà en cours, en la nommant par l’identifiant que portait la requête. Pour une requête déjà terminée, ou jamais envoyée, il n’y a simplement rien à annuler, et rien n’est signalé.

PropriétéTypeObligatoireDescription
idRequestIdouiL’identifiant de l’appelant pour une requête, renvoyé à l’identique sur la réponse qui y répond. Un message ne portant aucun identifiant est une notification et ne reçoit jamais de réponse.

Les propriétés supplémentaires ne sont pas autorisées.

ShutdownParams

Demande au daemon de cesser d’accepter du travail et de terminer ce qu’il a déjà pris en charge. La notification ne porte aucun champ, et la notification elle-même est généralement envoyée sans aucun objet params. Une seconde notification abandonne le travail encore en cours au lieu de l’attendre.

Cet objet ne déclare aucune propriété fixe et n’en autorise aucune.

ProgressParams

Un rapport de travail en cours, envoyé uniquement pour une requête qui a généré un jeton de progression dans une session ayant déclaré pouvoir les recevoir.

PropriétéTypeObligatoireDescription
tokenProgressTokenouiUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
valueProgressBegin ou ProgressReport ou ProgressEndouiLe rapport lui-même. Un rapport d’ouverture, puis un nombre quelconque de lignes, puis un rapport de clôture.

Les propriétés supplémentaires ne sont pas autorisées.

ProgressBegin

Ouvre un rapport, en indiquant ce qui a commencé dans les termes qu’utilise l’opération elle-même.

PropriétéTypeObligatoireDescription
kindconst “begin”ouiMarque ce payload comme l’ouverture d’un rapport. Constante : "begin"
titlestringouiCe qui a commencé.

Les propriétés supplémentaires ne sont pas autorisées.

ProgressReport

Une ligne du compte rendu que l’opération fait d’elle-même. Elle ne porte aucune fraction : les opérations qui rendent compte ici parcourent un ensemble dont la taille n’est pas connue au début du travail, de sorte qu’une fraction devrait être inventée.

PropriétéTypeObligatoireDescription
kindconst “report”ouiMarque ce payload comme une ligne d’un rapport ouvert. Constante : "report"
messagestringouiUne ligne de la sortie propre de l’opération, sans les espaces blancs qui l’entourent.

Les propriétés supplémentaires ne sont pas autorisées.

ProgressEnd

Clôt un rapport. Il ne porte rien d’autre que le type, car l’issue voyage dans la réponse que l’appelant attend déjà.

PropriétéTypeObligatoireDescription
kindconst “end”ouiMarque ce payload comme la clôture d’un rapport. Constante : "end"

Les propriétés supplémentaires ne sont pas autorisées.

PublishDiagnosticsParams

Les constats concernant un fichier, envoyés par le daemon lorsqu’une validation les a produits pour un document autre que celui que nommait la requête.

PropriétéTypeObligatoireDescription
filestringouiLe fichier que concernent les constats.
diagnosticsDiagnostic[] ou nullouiLes constats, dans l’ordre où ils ont été produits.

Les propriétés supplémentaires ne sont pas autorisées.

SuccessResponse

La réponse à une requête qui a abouti, portant l’identifiant de la requête à laquelle elle répond. Une réponse ne porte aucune méthode, de sorte que la forme de résultat applicable est fixée par la requête à laquelle appartient l’identifiant plutôt que par quoi que ce soit dans la réponse elle-même.

PropriétéTypeObligatoireDescription
jsonrpcProtocolVersionouiLa version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.
idRequestIdouiL’identifiant de l’appelant pour une requête, renvoyé à l’identique sur la réponse qui y répond. Un message ne portant aucun identifiant est une notification et ne reçoit jamais de réponse.
resultInitializeResult ou ValidateResult ou InvalidateResult ou DiagnosticsResult ou IrGraphResult ou BuildResult ou BuildPreviewResult ou EntityDefinitionResult ou ReleaseClosureResult ou ResolveDependenciesResult ou PinResult ou CacheStatusResult ou CachePruneResult ou CacheEvictResult ou CacheClearResult ou RegistryListResult ou SearchResult ou RegistryAddResult ou RegistryRemoveResult ou RegistryUpdateResult ou LogoutResult ou PublishEntityResult ou PublishArtifactResult ou SignArtifactsResult ou DeprecateArtifactResult ou ResolveResult ou FindReferencesResult ou FindImplementationsResult ou HoverResult ou CompletionResult ou CatalogIndexResult ou AttachCandidatesResult ou ConnectionCandidatesResult ou InsertionPointResult ou AttachmentContainerResult ou ConnectionAtPositionResult ou ReleaseCandidatesResult ou ActiveReleaseResult ou EditDocumentResult ou EffectiveConfigurationResult ou ConfigInitResult ou ConfigCaptureResult ou ImportResult ou ScaffoldEntityResult ou LintResult ou PluginAddResult ou PluginRemoveResult ou PluginSyncResult ou PluginGenCatalogResult ou ExplainErrorResult ou GetSchemaResult ou SkillsInstallResult ou SkillsListResultouiLa réponse, sous la forme que renvoie la méthode demandée.

Les propriétés supplémentaires ne sont pas autorisées.

ErrorResponse

La réponse à une requête qui a été refusée ou a échoué, portant l’identifiant de la requête à laquelle elle répond.

PropriétéTypeObligatoireDescription
jsonrpcProtocolVersionouiLa version de JSON-RPC que porte chaque message. Seule la 2.0 est parlée.
idRequestIdouiL’identifiant de l’appelant pour une requête, renvoyé à l’identique sur la réponse qui y répond. Un message ne portant aucun identifiant est une notification et ne reçoit jamais de réponse.
errorErrorObjectouiCe qui s’est mal passé : un code sur lequel un client peut aiguiller son traitement, un message écrit pour être lu par une personne et — lorsque la condition en a une — les artefacts et la position dans la source auxquels le message se réfère.

Les propriétés supplémentaires ne sont pas autorisées.

ErrorObject

Ce qui s’est mal passé : un code sur lequel un client peut aiguiller son traitement, un message écrit pour être lu par une personne et — lorsque la condition en a une — les artefacts et la position dans la source auxquels le message se réfère.

PropriétéTypeObligatoireDescription
codeErrorCodeouiLa condition que signale la réponse. Les codes négatifs sont l’ensemble réservé propre au protocole ; les codes à quatre chiffres sont des conditions que lève ce daemon, chacune nommant un état sur lequel un client peut agir. L’ensemble est fermé.
messagestringouiCe qui s’est mal passé, en prose. C’est la même formulation que porte la même condition sur toute autre surface qui la signale.
dataErrorDatanonLes artefacts et la position dans la source auxquels le message se réfère, portés de façon structurée afin qu’un client n’ait pas à les extraire de la prose. Chaque champ est facultatif et une condition ne renseigne que ce dont elle dispose ; aucun champ ne tient lieu d’un autre, de sorte qu’un client apprend ce qu’il a reçu à partir du champ qu’il a lu plutôt que du code qui l’accompagne.

Les propriétés supplémentaires ne sont pas autorisées.

ErrorCode

La condition que signale la réponse. Les codes négatifs sont l’ensemble réservé propre au protocole ; les codes à quatre chiffres sont des conditions que lève ce daemon, chacune nommant un état sur lequel un client peut agir. L’ensemble est fermé.

Type : const -32700 or const -32600 or const -32601 or const -32602 or const -32603 or const 1001 or const 1003 or const 1004 or const 1005 or const 1006

Valeurs autorisées :

  • -32700 — Le message n’a pas pu être analysé comme du JSON.
  • -32600 — Le message a été analysé mais n’est pas une requête bien formée.
  • -32601 — Aucune méthode de ce nom n’existe.
  • -32602 — Les params que portait la requête ne sont pas admissibles : un champ que la méthode n’accepte pas, un champ du mauvais type ou une valeur que la méthode refuse.
  • -32603 — Le daemon a échoué pendant l’exécution du travail.
  • 1001 — Le daemon ne détient aucune lecture du fichier et n’en produit aucune. Le client en amorce une en demandant une validation, puis réessaie.
  • 1003 — Le fichier de verrouillage de la Release que nommait la requête est absent, et l’opération en a besoin.
  • 1004 — L’entité que nommait la requête n’a pu être résolue ni depuis le catalogue ni depuis la Release que nommait la requête.
  • 1005 — Le daemon est en cours d’arrêt et refuse tout nouveau travail. Le client ne réessaie pas auprès du même daemon.
  • 1006 — Une validation du fichier est en cours et ne s’est pas terminée dans le délai que la requête en attente accordait. Le client attend et redemande, sans rien envoyer entre-temps.

ErrorData

Les artefacts et la position dans la source auxquels le message se réfère, portés de façon structurée afin qu’un client n’ait pas à les extraire de la prose. Chaque champ est facultatif et une condition ne renseigne que ce dont elle dispose ; aucun champ ne tient lieu d’un autre, de sorte qu’un client apprend ce qu’il a reçu à partir du champ qu’il a lu plutôt que du code qui l’accompagne.

PropriétéTypeObligatoireDescription
filestringnonLe document source que localisent les champs de position — le document en cours de vérification, ou la Release dont le chargement a échoué.
lineintegernonLa ligne à laquelle se réfère la condition, comptée à partir de un.
columnintegernonLa colonne à laquelle se réfère la condition, comptée à partir de un.
end_lineintegernonLa ligne située une position après la fin du jeton auquel se réfère la condition. Absent là où le jeton n’a pas de fin récupérable, auquel cas un client affiche la position comme un point.
end_columnintegernonLa colonne située une position après la fin du jeton auquel se réfère la condition.
releasestringnonLa Release à laquelle se réfère la condition, écrite de la façon dont la requête l’a nommée, afin qu’un client puisse composer le remède sans avoir à la réassembler.
lockfilestringnonLe fichier de verrouillage que concerne une condition portant sur le fichier de verrouillage : le chemin qui a été cherché et n’a pas été trouvé, ou n’a pas pu être lu.
unreachablebooléennonIndique si le refus porte sur un registre nommé par la requête qui n’a pas pu être atteint : son nom ne s’est pas résolu, une connexion vers lui a été refusée ou n’a pas pu être ouverte, ou une connexion sécurisée vers lui n’a pas pu être établie. Il est lu à partir de l’échec lui-même plutôt que du message, et il n’est défini que là où l’échec montre que le registre n’a jamais été atteint. Un rafraîchissement d’index refusé qui nomme un registre le porte ; un registre qui a répondu, quoi qu’il ait répondu, le laisse absent.
codestringnonLe nom descriptif de la condition que nomme le refus, stable d’une version à l’autre : la même valeur que porte dans son propre code un diagnostic signalant cette condition. C’est sur lui qu’un client aiguille son traitement, plutôt que sur le message ou sur le code numérique qui l’accompagne, lequel nomme l’état de la requête et reste ce qu’il est pour chaque condition. Présent exactement lorsque le refus nomme une condition enregistrée, et absent lorsqu’il n’en nomme aucune.
shortCodestringnonLe code court de la condition, la lettre E suivie de quatre chiffres : la forme qu’un lecteur cite et recherche, et celle qui ouvre le message d’un refus nommant une condition. Présent exactement lorsque code l’est.

Les propriétés supplémentaires ne sont pas autorisées.

Diagnostic

Un constat sur un document : où il se trouve, quelle est sa gravité, ce qu’il dit, et le code citable qui nomme la condition qu’il signale.

PropriétéTypeObligatoireDescription
lineintegerouiLa ligne que concerne le constat, comptée à partir de un.
columnintegerouiLa colonne que concerne le constat, comptée à partir de un.
severityconst “error” ou const “warning” ou const “info”ouiLa gravité du constat. Valeurs autorisées : "error" — Le constat est une erreur. Un constat de plugin de sévérité halt est signalé à ce niveau. "warning" — Le constat est signalé et n’est pas une erreur. Un constat de plugin de sévérité warn est signalé à ce niveau. "info" — Le constat est une information, comme l’est un constat de plugin de sévérité info.
messagestringouiCe que dit le constat, en prose.
codestringnonLe nom descriptif de la condition, stable d’une version à l’autre et citable dans une suppression.
shortCodestringnonLe code court de la condition, la forme qui ouvre un diagnostic bloquant.
codeDescriptionCodeDescriptionnonL’endroit où est expliquée la condition que nomme le constat.
classificationstringnonLa façon dont le constat a été obtenu, là où la condition fait cette distinction.
suggeststringnonL’orthographe que propose le constat, là où la condition peut en nommer une — un identifiant presque correct, par exemple.
keyPathstringnonLe chemin à travers le document jusqu’à la clé que concerne le constat.
sourcestringouiCe qui a produit le constat.
end_lineintegernonLa ligne située une position après la fin du jeton que concerne le constat, afin qu’un client puisse afficher le jeton entier plutôt qu’un seul caractère. Absent pour un jeton qui s’étend sur plusieurs lignes.
end_columnintegernonLa colonne située une position après la fin du jeton que concerne le constat.

Les propriétés supplémentaires ne sont pas autorisées.

CodeDescription

L’endroit où est expliquée la condition que nomme le constat.

PropriétéTypeObligatoireDescription
hrefstringouiL’adresse publiée à laquelle la condition est expliquée.

Les propriétés supplémentaires ne sont pas autorisées.

Position

Un endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.

PropriétéTypeObligatoireDescription
lineintegerouiLa ligne, comptée à partir de zéro.
characterintegerouiLe décalage dans la ligne, compté à partir de zéro, dans les unités de l’encodage dont la session a convenu.

Les propriétés supplémentaires ne sont pas autorisées.

Range

Une étendue entre deux endroits d’un document.

PropriétéTypeObligatoireDescription
startPositionouiUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
endPositionouiUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.

Les propriétés supplémentaires ne sont pas autorisées.

Location

Une étendue dans un document nommé.

PropriétéTypeObligatoireDescription
uristringouiLe document dans lequel se trouve l’étendue, adressé sous forme d’URI.
rangeRangeouiUne étendue entre deux endroits d’un document.

Les propriétés supplémentaires ne sont pas autorisées.

WorkspaceAndProgressParams

L’objet params d’une méthode qui ne déclare aucun champ propre. Il admet tout de même les deux champs que toute requête admet : l’espace de travail sur lequel elle agit, et un jeton de progression.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

InitializeParams

Ouvre une session sur un espace de travail et indique ce que le client sait traiter. C’est la seule méthode pour laquelle workspaceRoot est une déclaration plutôt qu’un sujet : absent, vide et un chemin sont trois choses différentes, et une session ouverte sans chemin est une session que le client n’a pas encore dirigée vers un espace de travail.

PropriétéTypeObligatoireDescription
capabilitiesClientCapabilitiesnonCe que le client sait traiter. Ce qui n’est pas indiqué est considéré comme non pris en charge. Les membres inconnus sont ignorés plutôt que refusés, de sorte qu’un client peut indiquer une capacité que ce daemon ne lit pas encore.
workspaceRootstringnonLe chemin absolu de l’espace de travail à ouvrir. S’il est absent, la session reste sans espace de travail ; une chaîne vide est un chemin fourni par le client et n’équivaut pas à n’en envoyer aucun.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

ClientCapabilities

Ce que le client sait traiter. Ce qui n’est pas indiqué est considéré comme non pris en charge. Les membres inconnus sont ignorés plutôt que refusés, de sorte qu’un client peut indiquer une capacité que ce daemon ne lit pas encore.

PropriétéTypeObligatoireDescription
generalobjectnonCapacités qui ne sont pas liées à un seul type de réponse.
windowobjectnonCapacités relatives à ce que le client peut afficher pendant qu’un travail est en cours.

Les propriétés supplémentaires sont autorisées.

ClientCapabilities.general

Capacités qui ne sont pas liées à un seul type de réponse.

PropriétéTypeObligatoireDescription
positionEncodingsstring[]nonLes encodages de position que le client sait lire, le meilleur en premier.

Les propriétés supplémentaires sont autorisées.

ClientCapabilities.window

Capacités relatives à ce que le client peut afficher pendant qu’un travail est en cours.

PropriétéTypeObligatoireDescription
workDoneProgressbooléennonIndique si le client peut recevoir des notifications de progression. Une requête qui génère un jeton de progression dans une session qui ne l’a pas déclaré est refusée.

Les propriétés supplémentaires sont autorisées.

ValidateParams

Vérifie l’espace de travail, ou un document qu’il contient, et répond avec les constats.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document à vérifier. S’il est absent, ce que contient l’espace de travail est vérifié.
contentstringnonLe texte du document tel que le client le détient actuellement, pour vérifier un tampon qui n’a pas été enregistré. S’il est absent, les octets sur disque sont lus.
releasestringnonLa Release par rapport à laquelle vérifier, sous forme de chemin relatif à la racine de l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

InvalidateParams

Indique au daemon qu’un document dont il détient une lecture a changé, de sorte que la prochaine réponse le concernant soit calculée à partir des nouveaux octets.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document qui a changé.
granularitystringnonLa part de ce que détient le daemon à abandonner : file abandonne uniquement ce qu’il détient pour le document nommé ; workspace, la valeur par défaut et la façon dont toute autre valeur est lue, abandonne en plus ce qu’il détient pour l’ensemble de l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

DiagnosticsParams

Répond avec les constats que le daemon détient déjà pour un document, sans le vérifier à nouveau.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document sur lequel rendre compte. Le daemon doit déjà en détenir une lecture.

Les propriétés supplémentaires ne sont pas autorisées.

IrGraphParams

Répond avec le graphe résolu vers lequel une Release se compile, sans en effectuer le rendu.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à résoudre, sous forme de chemin relatif à la racine de l’espace de travail. Un chemin absolu est refusé.
unredactedbooléennonIndique s’il faut répondre en clair avec les valeurs qu’un auteur a déclarées sensibles. Absent ou false, chacune d’elles est retenue hors du graphe et un marqueur indiquant pourquoi figure à sa place, comme la sortie du graphe de la ligne de commande les retient ; true répond avec le graphe tel que la Release se compile vers lui, ces valeurs comprises.

Les propriétés supplémentaires ne sont pas autorisées.

BuildParams

Compile une Release et écrit les artefacts rendus dans l’espace de travail.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à construire, sous forme de chemin relatif à la racine de l’espace de travail. Un chemin absolu est refusé.
outputParentstringnonLe répertoire dans lequel le répertoire de sortie est créé, sous forme de chemin relatif à la racine de l’espace de travail. Les artefacts arrivent dans le répertoire de sortie situé en dessous, disposés comme ils le sont sous la racine de l’espace de travail lorsque rien n’est nommé — ce champ nomme donc le parent du répertoire de sortie et jamais le répertoire de sortie lui-même. Absent, ou vide, le répertoire de sortie est écrit sous la racine de l’espace de travail, comme le fait aggrega build quel que soit l’endroit d’où il est exécuté. Un chemin absolu, ou un chemin qui remonte hors de l’espace de travail, est refusé.
autoPullbooléennonIndique s’il faut d’abord résoudre les dépendances de la Release. Le demander atteint les registres configurés et écrit le fichier de verrouillage ; sans demande, la construction n’atteint aucun registre.
policyInputstringnonLe répertoire dans lequel écrire, à côté des artefacts, le payload que chaque rôle de gouvernance remet à un plugin rattaché à cet endroit, sous forme de chemin relatif à la racine de l’espace de travail — les fichiers qu’écrit aggrega build --policy-input, sous les mêmes noms, écrits que la construction se termine ou s’arrête. Les avis de la réponse indiquent combien ont été écrits et nomment chaque rôle pour lequel aucun fichier n’a été écrit. Sur une requête qui échoue, les fichiers écrits sont sur le disque et ce bilan ne figure pas dans la réponse : l’erreur ne porte que le refus. Absent, aucun n’est écrit. Un chemin absolu, ou un chemin qui remonte hors de l’espace de travail, est refusé.

Les propriétés supplémentaires ne sont pas autorisées.

BuildPreviewParams

Compile une Release et indique ce qu’aurait produit l’écriture des artefacts, sans en écrire aucun. Elle décline le champ de résolution des dépendances qu’accepte la construction qui écrit, car une requête qui n’écrit rien ne peut pas remplir un fichier de verrouillage.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à compiler, sous forme de chemin relatif à la racine de l’espace de travail.
autoPullbooléennonAccepté dans les messages transmis et refusé par la méthode : cette requête n’écrit rien, elle ne peut donc pas remplir un fichier de verrouillage et rester ce qu’elle dit être.
policyInputstringnonLe répertoire dans lequel écrire le payload que chaque rôle de gouvernance remet à un plugin rattaché à cet endroit, sous forme de chemin relatif à la racine de l’espace de travail — les fichiers qu’écrit aggrega build --dry-run --policy-input, sous les mêmes noms. Lorsqu’il est envoyé, ils sont la seule chose qu’écrit cette requête ; le répertoire de sortie et le fichier de verrouillage restent intacts. Les avis de la réponse indiquent combien ont été écrits et nomment chaque rôle pour lequel aucun fichier n’a été écrit. Sur une requête qui échoue, les fichiers écrits sont sur le disque et ce bilan ne figure pas dans la réponse : l’erreur ne porte que le refus. Un chemin absolu, ou un chemin qui remonte hors de l’espace de travail, est refusé.

Les propriétés supplémentaires ne sont pas autorisées.

EntityDefinitionParams

Répond avec ce vers quoi se résout un nom d’entité et l’endroit où se trouve le document qui la définit.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
namestringnonL’entité à résoudre, par son nom — ou une référence de registre, oci://<host>/<repository>:<tag> ou @<digest> à la place de :<tag>, pour lire l’entité publiée à cette coordonnée.
releasestringnonLa Release dans les termes de laquelle résoudre le nom, sous forme de chemin relatif à la racine de l’espace de travail. Le nom est alors résolu au moyen des répertoires de catalogue que la configuration de l’espace de travail attribue à cette Release, de sorte qu’un nom que plusieurs variantes déclarent dans un même espace de travail, une par Release, se résout vers la variante avec laquelle cette Release est construite, et qu’un nom qu’elle ne résout pas est refusé avec une explication nommant l’entrée de cette Release sous workspace.releases. Absent, le nom est résolu sur les propres répertoires de catalogue de l’espace de travail. Une référence de registre n’accepte aucune Release et est refusée si elle en porte une, de même qu’une valeur qui ne nomme aucun fichier de Release.

Les propriétés supplémentaires ne sont pas autorisées.

CatalogIndexParams

Répond avec les entités que contient l’espace de travail : chaque entité que déclarent ses documents, et les Features que déclarent ses répertoires de catalogue.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release dans les termes de laquelle lister les entités, sous forme de chemin relatif à la racine de l’espace de travail. Les Features sont alors celles que déclarent les répertoires de catalogue que la configuration de l’espace de travail attribue à cette Release, et un document situé sous un répertoire de catalogue que seules d’autres Releases lisent est écarté, de sorte qu’un espace de travail qui conserve côte à côte des variantes d’une même entité, une par Release, est listé avec la variante avec laquelle cette Release est construite. Absent, la liste est celle propre à l’espace de travail. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

ReleaseClosureParams

Répond avec tout ce dont dépend une Release, tel que la résolution l’a atteint.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à inspecter, sous forme de chemin relatif à la racine de l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

ResolveDependenciesParams

Résout les dépendances d’une Release, en les épinglant dans le fichier de verrouillage et en acquérant les entrées externes que consomme son rendu. Elle atteint les registres configurés et elle écrit.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à résoudre, sous forme de chemin relatif à la racine de l’espace de travail.
upgradebooléennonIndique s’il faut résoudre à nouveau dans les plages déclarées plutôt que de respecter ce que le fichier de verrouillage épingle déjà.
targetsstring[]nonLes références à résoudre à nouveau, le reste restant épinglé tel quel. Vide, tout est résolu.
verifybooléennonIndique s’il faut comparer le fichier de verrouillage enregistré à la résolution que cette requête effectuerait sans lui, en respectant les épinglages que cette requête respecterait, au lieu de l’écrire. Une vérification n’écrit ni fichier de verrouillage, ni enregistrement de confiance des plugins, ni entity.lock ; le cache de contenu est lu et rempli comme cette résolution le lirait et le remplirait. Une dérive, ainsi qu’un fichier de verrouillage manquant, font échouer la requête. Il ne peut pas être combiné avec upgrade, targets ou pinSources, quelle que soit la valeur que porte pinSources : une requête qui envoie l’un d’eux à côté de lui est refusée comme params invalides avant que quoi que ce soit ne soit résolu.
pinSourcesbooléennonIndique s’il faut exécuter l’étape d’épinglage qu’exécute aggrega/pin sur les Recipes et les FeatureRecipes que la Release construit à partir des répertoires de catalogue de l’espace de travail, en écrivant l’entity.lock à côté de chacune, plutôt que de refuser la requête à cause de l’une d’elles dont le verrou n’enregistre pas un épinglage dont une entrée a besoin. Absent, suit le pin_sources_at_pull de l’espace de travail ; l’une ou l’autre valeur remplace ce réglage pour cette requête.

Les propriétés supplémentaires ne sont pas autorisées.

PinParams

Enregistre, dans l’entity.lock situé à côté d’une Recipe ou d’une FeatureRecipe, l’épinglage de contenu de chaque entrée que l’entité lit hors de son propre document. Aucune Release n’est nommée : une entrée dont l’entité écrit l’identité en entier nomme un seul artefact pour chaque Release qui utilise l’entité, de sorte que rien de ce que fournit une Release n’est nécessaire pour l’épingler. Elle atteint les hôtes que nomment les sources de l’entité et elle écrit à côté de l’entité ; le document de l’entité lui-même n’est jamais écrit.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
entitystringnonLe document d’entité à épingler, sous forme de chemin relatif à la racine de l’espace de travail.
dryRunbooléennonIndique s’il faut répondre avec le verrou que l’étape écrirait plutôt que de l’écrire. Les entrées sont tout de même résolues, de sorte que le cache de contenu se remplit tout de même.

Les propriétés supplémentaires ne sont pas autorisées.

CacheEvictParams

Récupère de l’espace sur le contenu en cache jusqu’à ce que ce qui reste tienne sous une taille que nomme la requête.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
maxSizestringnonLa taille à laquelle ramener l’espace occupé, écrite comme une personne l’écrit — par exemple 500MB.

Les propriétés supplémentaires ne sont pas autorisées.

SearchParams

Recherche ce qu’offrent les index locaux des registres configurés. Elle lit l’index déjà présent sur le disque et ne contacte aucun registre.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
querystringnonLe texte à comparer au nom et à la description d’un enregistrement.
kindsstring[]nonLes types d’entités à conserver. Vide, tous les types sont conservés.
selectorstringnonUn sélecteur d’étiquettes que les enregistrements conservés doivent satisfaire.
capabilitiesstring[]nonLes capacités qu’un enregistrement de plugin conservé doit déclarer.
pluginTypestringnonLe type de plugin à conserver.
registrystringnonL’unique hôte de registre dans lequel rechercher. Absent, chaque hôte configuré est parcouru.
limitintegernonLe nombre maximal d’enregistrements dans la réponse.
includeRetractedbooléennonIndique s’il faut conserver les versions qu’un marqueur publié a dépréciées.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryAddParams

Enregistre un registre et la politique de confiance que la résolution applique à ce qu’il sert. Elle écrit le fichier de configuration de toute la machine sauf si la requête demande autre chose, de sorte que chaque espace de travail de la machine résout au moyen de l’entrée.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
hoststringnonL’hôte de registre à enregistrer.
namestringnonUn alias convivial qui se résout vers l’hôte.
identitiesstring[]nonLes identités de signature considérées comme fiables pour ce que sert ce registre.
keyPathstringnonLe chemin d’une clé publique à considérer comme fiable, pour un registre signé avec une clé plutôt qu’avec une identité keyless.
trustedRootstringnonLe chemin de l’ancre de confiance par rapport à laquelle vérifier les signatures.
requireSignaturesbooléennonIndique si un artefact provenant de ce registre doit porter une signature vérifiée. Absent, rien n’est indiqué et la valeur par défaut résolue reste en place.
advisorybooléennonIndique si une vérification qui échoue est signalée plutôt que d’arrêter l’exécution.
fetchTrustbooléennonIndique s’il faut lire la politique de confiance qu’annonce le registre et l’épingler. Absent, rien n’est indiqué et la valeur par défaut résolue reste en place.
globalbooléennonÉcrit le fichier de configuration de toute la machine, qui est la valeur par défaut propre à cette méthode.
workspacebooléennonÉcrit le fichier de configuration propre à cet espace de travail au lieu de celui de toute la machine.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryRemoveParams

Supprime un registre enregistré. Elle écrit le fichier de configuration de toute la machine sauf si la requête demande autre chose.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
registrystringnonLe registre à supprimer, par hôte ou par alias.
globalbooléennonÉcrit le fichier de configuration de toute la machine, qui est la valeur par défaut propre à cette méthode.
workspacebooléennonÉcrit le fichier de configuration propre à cet espace de travail au lieu de celui de toute la machine.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryUpdateParams

Rafraîchit l’index local que lit une recherche, en atteignant le registre pour ce faire. Ce qu’elle écrit est l’index situé sous le répertoire de cache configuré propre à cet espace de travail. Un registre qui nécessite un identifiant de connexion qu’aucune source de l’environnement ne fournit est refusé avec cet identifiant nommé, plutôt que de le demander de façon interactive.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
registrystringnonL’unique registre à rafraîchir. Absent, chaque hôte configuré est rafraîchi.
upgradebooléennonIndique s’il faut reconstruire l’index plutôt que d’ajouter à ce qu’il contient déjà.

Les propriétés supplémentaires ne sont pas autorisées.

LogoutParams

Supprime un identifiant de connexion de registre stocké. Le magasin est partagé par tous les projets de la machine, et la réponse le signale.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
registrystringnonLe registre dont supprimer l’identifiant de connexion stocké.

Les propriétés supplémentaires ne sont pas autorisées.

PublishEntityParams

Publie une entité dans un registre. Ce qu’elle y dépose est ce que résout chaque consommateur de ce registre, et une version publiée ne peut pas être rappelée auprès de quiconque l’a déjà récupérée. Rien n’est demandé de façon interactive : l’identité est résolue à partir de ce que la requête a fourni ou de ce que l’environnement porte déjà.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
entitystringnonLe document d’entité à publier, sous la forme d’un chemin relatif à la racine de l’espace de travail.
registrystringnonLe registre dans lequel publier. En son absence, le registre par défaut configuré est utilisé.
dryRunbooléennonIndique s’il faut signaler ce que la publication déposerait sans le déposer.
signbooléennonIndique s’il faut signer ce qui est publié. Absent, rien n’est indiqué et la valeur par défaut résolue reste en place.
pluginstringnonLe module de plugin à publier avec une entité Plugin.
fulcioUrlstringnonL’autorité de certification auprès de laquelle obtenir un certificat de signature.
rekorUrlstringnonLe journal de transparence dans lequel enregistrer la signature.
timestampUrlstringnonL’autorité d’horodatage avec laquelle contresigner.
identityTokenstringnonLe jeton d’identité avec lequel signer, fourni par l’appelant plutôt qu’obtenu dans un terminal.
pinSourcesbooléennonIndique s’il faut exécuter sur l’entité, avant qu’elle soit empaquetée, l’étape d’épinglage qu’exécute aggrega/pin, de sorte que le entity.lock que l’étape écrit à côté d’elle fasse partie de ce qui est publié. L’étape s’exécute avant tout refus qui juge l’entité, et sous dryRun elle signale le verrou qu’elle écrirait et n’écrit rien. En son absence, le pin_sources_at_push de l’espace de travail s’applique ; l’une ou l’autre valeur remplace ce réglage pour cette requête.

Les propriétés supplémentaires ne sont pas autorisées.

PublishArtifactParams

Publie un fichier arbitraire dans un registre sous un nom et un tag que la requête lui donne.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe fichier à publier, sous la forme d’un chemin relatif à la racine de l’espace de travail.
namestringnonLe nom de dépôt sous lequel publier.
tagstringnonLe tag sous lequel publier.
mediaTypestringnonLe type de média à enregistrer pour les octets publiés.
registrystringnonLe registre dans lequel publier. En son absence, le registre par défaut configuré est utilisé.
dryRunbooléennonIndique s’il faut signaler ce que la publication déposerait sans le déposer.

Les propriétés supplémentaires ne sont pas autorisées.

SignArtifactsParams

Signe ce qui est déjà publié. Une signature ne peut pas être rappelée auprès de quiconque l’a déjà récupérée.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
referencesstring[]nonLes références publiées à signer.
fulcioUrlstringnonL’autorité de certification auprès de laquelle obtenir un certificat de signature.
rekorUrlstringnonLe journal de transparence dans lequel enregistrer la signature.
timestampUrlstringnonL’autorité d’horodatage avec laquelle contresigner.
identityTokenstringnonLe jeton d’identité avec lequel signer, fourni par l’appelant plutôt qu’obtenu dans un terminal.
jobsintegernonLe nombre de références signées à la fois. En son absence, elles sont signées l’une après l’autre. Chaque référence est néanmoins signée exactement comme elle le serait seule — en mode keyless, avec son propre certificat et sa propre entrée dans le journal de transparence — et la réponse conserve l’ordre dans lequel les références ont été données. Minimum : 1.

Les propriétés supplémentaires ne sont pas autorisées.

DeprecateArtifactParams

Marque une version publiée comme dépréciée, afin que la résolution puisse la signaler ou la refuser. Le marqueur est lui-même publié et signé. Une requête envoie soit une référence avec son contenu, soit un fichier de lot dont les entrées portent le leur — jamais les deux, et jamais de contenu à côté du fichier de lot.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
referencestringnonLa référence publiée à marquer. Une alternative à from : une requête portant les deux est refusée.
severityconst “warning” ou const “error” ou const “retracted”nonLa force avec laquelle le marqueur s’exprime — si la résolution signale la version ou la refuse. Requis avec reference ; refusé à côté de from, dont le fichier de lot porte celui propre à chaque marqueur. Valeurs autorisées : "warning" — Dépréciée, au plus modéré des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "error" — Dépréciée, au plus fort des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "retracted" — Retirée : exclue lorsqu’une version est choisie.
reasonstringnonLa raison pour laquelle la version est dépréciée. Requis avec reference ; refusé à côté de from, dont le fichier de lot porte celle propre à chaque marqueur.
replacementstringnonLa référence à utiliser à la place. Refusé à côté de from, dont le fichier de lot porte celle propre à chaque marqueur.
messagestringnonCe qui est dit à un consommateur qui rencontre le marqueur. Refusé à côté de from, dont le fichier de lot porte celui propre à chaque marqueur.
fromstringnonUn fichier de lot d’entrées de retrait, sous la forme d’un chemin relatif à la racine de l’espace de travail, attachant un marqueur par entrée. Chaque entrée porte sa propre référence, sa propre sévérité et sa propre raison, et éventuellement un remplacement et un message. Une alternative à reference : une requête portant les deux, ou portant à côté une sévérité, une raison, un remplacement ou un message, est refusée.
fulcioUrlstringnonL’autorité de certification auprès de laquelle obtenir un certificat de signature.
rekorUrlstringnonLe journal de transparence dans lequel enregistrer la signature.
timestampUrlstringnonL’autorité d’horodatage avec laquelle contresigner.
identityTokenstringnonLe jeton d’identité avec lequel signer, fourni par l’appelant plutôt qu’obtenu dans un terminal.

Les propriétés supplémentaires ne sont pas autorisées.

ResolveParams

Répond en indiquant où est défini l’élément sous le curseur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
uristringnonLe document dans lequel se trouve le curseur.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
releasestringnonLa Release dans les termes de laquelle répondre, sous la forme d’un chemin relatif à la racine de l’espace de travail. La définition est alors le document vers lequel la référence se résout à travers les répertoires de catalogue que la configuration de l’espace de travail attribue à cette Release, dans cet ordre, de sorte qu’un nom que plusieurs variantes d’un même espace de travail déclarent, une par Release, renvoie à la variante de cette Release ; lorsque ces répertoires ne déclarent aucune entité de ce type, les documents de l’espace de travail sont parcourus, en laissant de côté ceux situés sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas. En son absence, les documents de l’espace de travail sont parcourus en premier, et les répertoires de catalogue propres à l’espace de travail seulement lorsqu’aucun document ne déclare le nom. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

FindReferencesParams

Répond en indiquant où il est fait référence à l’élément sous le curseur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
uristringnonLe document dans lequel se trouve le curseur.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
releasestringnonLa Release dans les termes de laquelle répondre, sous la forme d’un chemin relatif à la racine de l’espace de travail. Une référence faite dans un document situé sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas n’est alors pas signalée, de sorte que des variantes qu’un espace de travail conserve côte à côte, une par Release, ne sont jamais signalées comme références les unes des autres. En son absence, chaque document de l’espace de travail est parcouru. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

FindImplementationsParams

Répond en indiquant quels documents implémentent l’élément sous le curseur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
uristringnonLe document dans lequel se trouve le curseur.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
releasestringnonLa Release dans les termes de laquelle répondre, sous la forme d’un chemin relatif à la racine de l’espace de travail. Un document situé sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas n’est alors pas signalé, de sorte qu’une variante avec laquelle une autre Release est construite n’est jamais listée parmi celles de cette Release. En son absence, chaque document de l’espace de travail est parcouru. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

HoverParams

Répond avec ce qu’il faut afficher à propos de l’élément sous le curseur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
uristringnonLe document dans lequel se trouve le curseur.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
releasestringnonLa Release dans les termes de laquelle répondre, sous la forme d’un chemin relatif à la racine de l’espace de travail. L’entité affichée est alors celle vers laquelle la référence se résout à travers les répertoires de catalogue que la configuration de l’espace de travail attribue à cette Release, dans cet ordre ; lorsque ces répertoires ne déclarent aucune entité de ce type, les documents de l’espace de travail sont parcourus, en laissant de côté ceux situés sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas. En son absence, les documents de l’espace de travail sont parcourus en premier, et les répertoires de catalogue propres à l’espace de travail seulement lorsqu’aucun document ne déclare le nom. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

CompletionParams

Répond avec ce qui peut être écrit à l’emplacement du curseur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
uristringnonLe document dans lequel se trouve le curseur.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
contextCompletionContextnonCe qui a déclenché la requête, lorsque le client le suit.
releasestringnonLa Release dans les termes de laquelle répondre, sous la forme d’un chemin relatif à la racine de l’espace de travail. Les noms proposés sont alors ceux que déclarent les documents de l’espace de travail, moins les documents situés sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas, ainsi que les Components et les Features que déclarent les répertoires de catalogue attribués à cette Release par la configuration de l’espace de travail. En son absence, ce sont les documents de l’espace de travail et les Components et les Features que déclarent ses propres répertoires de catalogue. Une valeur qui ne nomme aucun fichier de Release est refusée.

Les propriétés supplémentaires ne sont pas autorisées.

CompletionContext

Ce qui a déclenché la requête, lorsque le client le suit.

PropriétéTypeObligatoireDescription
triggerKindintegernonPourquoi la complétion a été demandée.
triggerCharacterstringnonLe caractère qui l’a déclenchée, lorsque c’est un caractère qui l’a fait.

Les propriétés supplémentaires sont autorisées.

AttachCandidatesParams

Répond en indiquant quelles Features peuvent être rattachées à une entité, jugées d’après les étiquettes de cette entité, et, pour une connexion que trace le composant d’un nœud du graphe, lesquelles peuvent remplir chaque slot que déclare le socket de la connexion.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
nodestringnonL’entité d’après laquelle juger les candidats, par nom, lue dans ce que déclarent les documents de l’espace de travail.
graphNodestringnonLe nœud du graphe d’après lequel juger les candidats, dont les étiquettes sont l’ensemble finalisé avec lequel le build lui-même évalue l’applicabilité. Une réponse calculée sur cette base dit ce que fera le build.
releasestringnonLa Release au graphe de laquelle appartient le nœud, sous la forme d’un chemin relatif à la racine de l’espace de travail. Les candidats sont alors tirés dans les termes de cette Release : les Features que déclarent les répertoires de catalogue attribués à cette Release par la configuration de l’espace de travail, et les documents de l’espace de travail moins ceux situés sous l’un des répertoires de catalogue de l’espace de travail que la Release ne lit pas, de sorte qu’une Feature conservée pour une autre Release n’est jamais proposée pour un nœud du graphe de celle-ci.
labelsmap de stringnonÉtiquettes d’après lesquelles juger directement, au lieu de les lire dans une entité ou un nœud du graphe.
connectionConnectionCoordinatenonUne connexion que trace le composant du nœud que nomme graphNode, pour laquelle répondre en plus de ce nœud : la réponse porte alors aussi slots, chaque slot que déclare le socket de la connexion avec les Features qui peuvent le remplir, ou noSlotReason lorsqu’aucun slot ne peut être rempli. Elle n’est envoyée qu’avec graphNode et release, car une connexion n’existe que sur un graphe compilé ; envoyée avec node ou labels, elle est refusée. Les candidats à côté d’elle gardent leur sens, les Features qui peuvent se rattacher au nœud lui-même. Son document est accepté et ne change pas cette réponse : les slots sont ceux du socket et les candidats ceux des Features, les mêmes quel que soit le document dans lequel un rattachement est écrit.

Les propriétés supplémentaires ne sont pas autorisées.

ConnectionCandidatesParams

Répond en indiquant à quelles entités un socket d’une entité peut être relié.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
nodestringnonL’entité dont les sockets font l’objet de la question.
socketstringnonLe socket unique pour lequel répondre. En son absence, la réponse porte sur chaque socket que déclare l’entité.

Les propriétés supplémentaires ne sont pas autorisées.

InsertionPointParams

Répond en indiquant où, dans un document, se place une nouvelle entrée sous un conteneur nommé, en laissant la composition et l’application de l’entrée à l’appelant qui possède le tampon.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document sur lequel répondre.
containerstring[]nonLe chemin à travers le document jusqu’au conteneur sous lequel se place l’entrée.

Les propriétés supplémentaires ne sont pas autorisées.

AttachmentContainerParams

Répond en indiquant dans quel document, et à quel endroit de celui-ci, se place un rattachement sur un nœud du graphe, ou sur une connexion que trace son composant.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
graphNodestringnonLe nœud du graphe auquel le rattachement est destiné.
releasestringnonLa Release au graphe de laquelle appartient le nœud, sous la forme d’un chemin relatif à la racine de l’espace de travail.
connectionConnectionCoordinatenonUne connexion que trace le composant du nœud du graphe, lorsque le rattachement concerne cette connexion plutôt que le nœud : la réponse nomme alors le conteneur features propre à la connexion dans le document que nomme son champ document, un champ requis ici. Dans l’Aggregate, il s’agit de l’entrée de la connexion dans le document dans lequel le nœud a été écrit, refusée pour une connexion que la Release a tracée, pour laquelle l’Aggregate ne contient aucune entrée. Dans la Release, il s’agit de l’entrée par arête sous l’entrée propre de la Release pour le nœud, que la Release en écrive déjà une pour cette connexion ou non, refusée lorsque la Release n’écrit aucune entrée pour le nœud. Une connexion qu’une Feature a tracée est refusée dans l’un et l’autre document, car un rattachement n’est écrit que sur une connexion que trace un composant ou la Release.

Les propriétés supplémentaires ne sont pas autorisées.

ConnectionAtPositionParams

Répond en indiquant dans l’entrée de quelle connexion tombe une position dans un Aggregate ou une Release : le nœud du graphe et la connexion, dans les termes sous lesquels les requêtes de candidature et de conteneur les prennent, ou pourquoi aucune connexion n’y est écrite. Les entrées sont celles dans lesquelles un rattachement est écrit — l’entrée avec laquelle un composant trace une connexion, sous l’alias de la connexion, dans le document dans lequel le composant a été écrit, et chaque entrée par arête qu’écrit la Release — chacune là où le graphe compilé l’enregistre, de sorte que le fait qu’une clé soit une connexion n’est jamais déduit de son nom.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document dans lequel se trouve la position : la Release, ou un document dans lequel le graphe de la Release enregistre des composants comme écrits — son Aggregate, ou le document d’un module qu’importe cet Aggregate. Il est lu d’abord dans ce que la session conserve pour lui, et sinon depuis le disque.
positionPositionnonUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
releasestringnonLa Release dont le graphe compilé enregistre les connexions, sous la forme d’un chemin relatif à la racine de l’espace de travail. Elle est requise aussi pour une position dans l’Aggregate, car un nœud du graphe et une connexion n’existent que sur un graphe compilé.

Les propriétés supplémentaires ne sont pas autorisées.

ConnectionCoordinate

Une connexion que trace le composant d’un nœud du graphe, adressée par le socket à travers lequel elle est reliée et l’alias qu’elle porte dans ce socket, et le document dans lequel un rattachement sur elle est écrit. Une connexion porte des rattachements qui remplissent les slots que déclare son socket, et l’Aggregate comme la Release peuvent les écrire.

PropriétéTypeObligatoireDescription
socketstringouiLe socket de dépendance à travers lequel la connexion est reliée.
aliasstringouiLe nom que porte la connexion au sein de son socket.
documentconst “aggregate” ou const “release”nonLe document dans lequel un rattachement sur la connexion est écrit. L’ensemble est fermé, et une valeur extérieure à celui-ci est refusée. Valeurs autorisées : "aggregate" — L’Aggregate, où le développeur écrit un rattachement sur l’entrée de la connexion. "release" — La Release, où l’opérateur écrit un rattachement sur l’entrée par arête de la connexion.

Les propriétés supplémentaires sont autorisées.

SetActiveReleaseParams

Enregistre une Release comme valeur par défaut de l’espace de travail en écrivant un marqueur dans le répertoire .aggrega : le choix que signale aggrega/activeRelease lit ce marqueur après la Release d’authoring de la configuration. Le marqueur est écrit à l’intérieur de l’espace de travail et nulle part ailleurs : lorsque le répertoire .aggrega ou le marqueur est un lien menant hors de l’espace de travail, que l’endroit auquel il mène existe déjà ou non, l’écriture est refusée en nommant le lien et rien n’est écrit. La réponse est celle que donne aggrega/activeRelease une fois le marqueur écrit, de sorte qu’elle nomme une Release différente lorsque la Release d’authoring de la configuration prime sur le marqueur.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
releasestringnonLa Release à enregistrer, sous la forme d’un chemin relatif à la racine de l’espace de travail. Un chemin absolu, et un chemin qui remonte hors de l’espace de travail, sont refusés ; de même pour un chemin qui en sort par un lien, sauf si la configuration de l’espace de travail nomme cette Release.

Les propriétés supplémentaires ne sont pas autorisées.

EditDocumentParams

Applique une seule modification délimitée à un document que contient l’espace de travail : une entrée ajoutée sous un conteneur, ou un scalaire défini. Le document composé est vérifié par rapport au schéma de son type et n’atteint le disque que si cette vérification réussit, de sorte que cette méthode ne peut pas écrire ce que refuse le schéma d’authoring. Une modification refusée laisse le fichier identique octet pour octet à ce qu’il était.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
filestringnonLe document à modifier.
editconst “add-component” ou const “attach-feature” ou const “wire-edge” ou const “set-value”nonQuelle modification appliquer. Valeurs autorisées : "add-component" — Ajoute une instance de composant sous un conteneur components : name est le nom de l’instance, value le Component qu’elle demande. "attach-feature" — Rattache une Feature au nœud que nomme la requête : name est le nom d’instance du rattachement, value la Feature qu’il demande. "wire-edge" — Relie une connexion de dépendance depuis le nœud que nomme la requête, à l’intérieur de socket : name est l’alias par lequel la connexion est adressée, value le nœud vers lequel elle pointe. "set-value" — Définit une valeur sur le nœud que nomme la requête : name est la clé de la valeur, value un scalaire.
nodestring[]nonLe chemin à travers le document jusqu’à l’entrée en cours de modification.
socketstringnonLe socket que concerne la modification, pour une modification qui en relie un.
namestringnonLe nom qu’écrit la modification.
valueanynonLa valeur qu’écrit la modification, sous la forme que prend la modification, quelle qu’elle soit.
dryRunbooléennonIndique s’il faut répondre avec le document composé plutôt que de l’écrire.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigInitParams

Initialise un document de configuration. Il écrit par défaut le fichier de toute la machine, car un registre et les identités de confiance sur celui-ci relèvent d’un outillage à l’échelle de la machine. Il contacte le registre nommé pour lire la politique de confiance qu’il annonce ; un registre qui n’annonce rien est signalé comme tel et l’initialisation se poursuit, sur la base de référence intégrée pour le hub officiel et sans aucune politique pour tout autre registre.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
registrystringnonLe registre pour lequel initialiser la configuration.
forcebooléennonIndique s’il faut écraser un document de configuration qui existe déjà.
globalbooléennonÉcrit le fichier de configuration de toute la machine, qui est la valeur par défaut propre à cette méthode.
workspacebooléennonÉcrit le fichier de configuration propre à cet espace de travail au lieu de celui de toute la machine.
dryRunbooléennonIndique s’il faut répondre avec le contenu du document plutôt que de l’écrire, pour un client qui gère son propre modèle de document.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigCaptureParams

Fige la configuration résolue dans le document propre de cet espace de travail, de sorte que l’espace de travail soit autonome. Il écrit toujours le fichier de cet espace de travail et n’atteint rien en dehors de celui-ci.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
allPluginsbooléennonIndique s’il faut figer chaque plugin rattaché plutôt que seulement ceux que l’espace de travail a lui-même configurés.

Les propriétés supplémentaires ne sont pas autorisées.

ImportParams

Convertit une description de source étrangère en documents d’authoring à l’état de brouillon, et écrit à côté d’eux .aggrega-import.json, l’enregistrement de ce que l’import a écrit — la cible qui lui a été donnée, lorsqu’une cible lui a été donnée, l’instantané du catalogue qu’il a lu, lorsqu’il en a lu un, chaque fichier rédigé et chaque clé d’un Aggregate ou d’une Release rédigés, à toute profondeur — que lit une synchronisation ultérieure. Une source qu’il n’a pas pu convertir entièrement est une réponse plutôt qu’un échec : les brouillons qu’il a produits sont écrits et les constats disent ce qu’il n’a pas pu convertir — sauf sous sync, qui n’écrit rien à partir d’une conversion qui s’est arrêtée.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
sourcestringnonLe fichier ou le répertoire à convertir, sous la forme d’un chemin absolu ou relatif à la racine de l’espace de travail ; une requête qui n’en a pas est refusée. Il est lu là où il se trouve, à l’intérieur de l’espace de travail ou non, et un répertoire est lu en ceux de ses fichiers que sélectionnent les motifs de fichiers déclarés par l’importateur.
outputDirstringnonLe répertoire sous l’espace de travail dans lequel écrire les brouillons, relatif à la racine de l’espace de travail ; une valeur absolue, ou une valeur qui sort de l’espace de travail telle qu’elle est écrite ou par un lien, est refusée. En son absence, l’écriture se fait sous la racine de l’espace de travail, là où écrit la même conversion exécutée dans un terminal sans nommer de destination. Chaque chemin rédigé est relatif au répertoire que la réponse nomme comme outputDir, sous dryRun également.
formatstringnonLe format de la source. En son absence, la conversion le détermine.
targetstringnonUne capacité du fournisseur, telle que compose ou helm — le mot auquel se lie le spec.capability d’une Recipe — pour laquelle rédiger un Manifest à côté des brouillons, sous la forme de manifest.yaml : chaque type de composant et chaque type de fonctionnalité dont les brouillons ont besoin, y compris les types d’un Aggregate du catalogue que compose celui rédigé, est associé à la Recipe ou à la recette de fonctionnalité de cette capacité que propose pour lui le catalogue de l’espace de travail — celle qui existe, ou parmi plusieurs celle qui porte le nom du type —, un type qui n’en a aucune, ou qui en a plusieurs dont aucune ne porte ce nom, reste non associé avec un constat d’avertissement qui le nomme, une association qu’un importateur a rédigée lui-même est conservée là où le catalogue la propose pour ce type et cette capacité, et abandonnée sinon avec un constat d’avertissement, et le spec.manifest de la Release rédigée est défini sur le Manifest. Une capacité à laquelle aucune Recipe du catalogue ne se lie est refusée avant l’exécution de la conversion, et rien n’est écrit. En son absence, aucun Manifest n’est rédigé, sauf sous sync, qui rédige pour la cible que nomme l’enregistrement de l’import précédent ; une synchronisation qui nomme une cible rédige pour celle-ci, et l’enregistrement la nomme alors.
dryRunbooléennonIndique s’il faut répondre avec le contenu de chaque fichier que la requête écrirait plutôt que de l’écrire. Tout autre comportement est celui de l’écriture, de sorte qu’une requête que l’écriture refuserait est refusée dans ce cas également ; avec sync, la réponse porte ce que la synchronisation écrirait et chaque partie qui dériverait.
syncbooléennonIndique s’il faut mettre à jour par rapport à la source ce qu’un import précédent a rédigé sous outputDir, plutôt que d’écrire le brouillon en entier. Seul ce que l’import a écrit change, tel que l’enregistrement situé à côté des brouillons le liste : une partie que la source a laissée telle quelle reste comme elle est sur le disque, modifiée ou non ; une partie que la source a modifiée, abandonnée ou gagnée est réécrite, supprimée — un fichier rédigé effacé en entier — ou ajoutée, là où ce qui se trouve sur le disque est ce que l’import a écrit en dernier ; et tout le reste, une clé qu’un auteur a ajoutée — dont l’environnement qu’une Release rédigée laisse à son auteur — ou un commentaire qui n’est pas écrit directement au-dessus d’une clé rédigée, reste identique octet pour octet. Une synchronisation qui modifierait ou supprimerait ce qu’un auteur a modifié ou ajouté, ou qui ajouterait une partie là où un auteur en a déjà écrit une, est refusée en nommant chaque partie, de même qu’une synchronisation sur un Aggregate qu’aucun enregistrement ne liste ; rien n’est écrit dans un cas comme dans l’autre. Sans ce champ, une requête dont les brouillons seraient écrits par-dessus un Aggregate déjà présent dans outputDir est refusée, sous dryRun également.
upgradebooléennonIndique s’il faut récupérer l’instantané du catalogue le plus récent que publie le registre par défaut de l’espace de travail et importer par rapport à lui, en le conservant dès lors à la place de celui que contient l’espace de travail ou de celui que nomme l’enregistrement placé à côté des brouillons ; cela ne change rien lorsque l’espace de travail nomme un dossier de catalogue, et c’est refusé hors ligne.
answersstringnonLe fichier de réponses à partir duquel sont lues, et dans lequel sont écrites, les valeurs que les brouillons laissent vides et qu’aucune source ne peut contenir, relatif à la racine de l’espace de travail ; une valeur absolue, ou une valeur qui sort de l’espace de travail telle qu’écrite ou par un lien, est refusée. Il contient, sous le chemin de chaque fichier rédigé, le chemin de la clé dans ce document et sa réponse, et les réponses sont écrites dans les brouillons. En son absence, le fichier lu est celui que nomme l’enregistrement à côté des brouillons, ou à défaut import-answers.yaml à côté du fichier source ou dans le répertoire source. La réponse d’un secret nomme la provenance du secret — un nom de variable, ${NAME}, ou le nom d’un Kubernetes Secret — et toute autre chose est refusée sans que rien ne soit écrit. Rien n’est demandé : chaque valeur encore due est une entrée de owed de la réponse et un constat d’avertissement qui nomme le fichier rédigé, la clé et ce qu’elle est, sa réponse est envoyée comme answered, et là où les brouillons sont écrits, le dernier constat indique combien de valeurs sont dues et où. Lorsque les brouillons comprennent une Release, ne doivent plus rien et que la conversion est terminée, ses dépendances sont alors récupérées, ce qui écrit son fichier de verrouillage, et un pull qui échoue clôt les constats en indiquant pourquoi, les brouillons étant écrits ; hors ligne, rien n’est récupéré et un constat nomme le pull à exécuter. Une réponse pour une clé que ces brouillons ne laissent pas vide est conservée dans le fichier et non appliquée, de sorte qu’un seul fichier de réponses sert pour toutes les cibles.
answeredImportAnswered[]nonRéponses pour des valeurs que owed de la réponse a listées, chacune nommant le fichier rédigé et les clés telles que owed les a nommées. Chacune est évaluée, conservée dans le fichier de réponses et écrite dans les brouillons exactement comme l’est une réponse saisie dans un terminal : la réponse d’un secret nomme la provenance du secret — un nom de variable, ${NAME}, ou le nom d’un Kubernetes Secret — et une réponse qui ne le fait pas n’est ni conservée ni écrite, sa valeur restant due avec la raison comme secretAdvice. Une valeur à laquelle le fichier de réponses répond déjà reçoit sa réponse du fichier ; une réponse vide, ou une réponse nommant une valeur que les brouillons ne doivent pas, n’est pas appliquée. Envoyez-la avec sync une fois les brouillons écrits, car une requête qui n’est pas un sync est refusée sur un Aggregate déjà présent dans outputDir. Sous dryRun, qui ne conserve aucune réponse, et sous un sync dont la conversion s’est arrêtée, qui n’écrit rien, aucune réponse envoyée n’est appliquée.

Les propriétés supplémentaires ne sont pas autorisées.

ScaffoldEntityParams

Rédige un document de départ pour un type d’entité, ou écrit l’un des exemples exécutables de la documentation dans un nouveau répertoire de l’espace de travail, ou les liste. La rédaction dérive le squelette de l’ensemble de schémas que porte le binaire, de sorte que rien n’est lu dans un espace de travail et rien n’est écrit — la réponse est du texte, et sa destination relève du client. L’écriture d’un exemple écrit le nouveau répertoire et rien d’autre, et les exemples sont lus dans le bundle de documentation signé publié pour la version du binaire, ou dans le plus récent publié avant celle-ci lorsqu’il n’y en a pas, vérifié par rapport à la politique de signature de l’espace de travail avant d’être conservé ou lu : un bundle qui ne passe pas la vérification est refusé, et hors ligne seule une copie déjà en cache est lue. Une requête qui envoie ensemble les champs de deux formes — kind avec example ou list, list avec example, name avec example ou list, dir sans example — est refusée avant que quoi que ce soit ne soit lu.

PropriétéTypeObligatoireDescription
workspaceRootstringnonLe chemin absolu de l’espace de travail. La rédaction ne le lit pas. L’écriture ou le listage d’un exemple l’exige : la configuration de l’espace de travail décide d’où la documentation est récupérée et quelles signatures elle doit porter, et un exemple est écrit à l’intérieur de celui-ci.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
kindstringnonLe type d’entité à rédiger, désigné par son jeton en minuscules, tel que component, aggregate, release, recipe ou featurerecipe — le jeton que aggrega/getSchema liste pour lui.
namestringnonLe nom à écrire dans le document rédigé. Envoyé uniquement avec kind.
examplestringnonL’exemple exécutable à écrire, sous le nom que lui donne la liste des exemples. Envoyé à la place de kind.
listbooléennonIndique s’il faut répondre avec chaque exemple exécutable que publie la documentation, sans rien écrire. Envoyé sans example et sans kind.
dirstringnonLe nouveau répertoire dans lequel écrire l’exemple, relatif à la racine de l’espace de travail ; en son absence, l’exemple est écrit là dans un répertoire nommé d’après lui. Il ne doit pas encore exister ou doit être vide : un répertoire contenant quoi que ce soit est refusé et laissé tel quel, et une valeur absolue, ou une valeur qui sort de l’espace de travail telle qu’elle est écrite ou par un lien, est refusée avant que quoi que ce soit ne soit lu. Envoyé uniquement avec example.

Les propriétés supplémentaires ne sont pas autorisées.

LintParams

Vérifie les conventions de publication du catalogue sur une seule entité, sur tout ce qu’atteint la fermeture d’une Release, ou sur tout ce qui se trouve sous les répertoires de catalogue configurés. Rien n’est écrit, quel que soit le mode. Ne nommer ni une entité ni une Release vérifie tout le catalogue : dans un espace de travail dont la configuration ne donne à aucune Release de répertoires de catalogue propres, une fois sur les répertoires de l’espace de travail ; dans un espace de travail qui nomme des Releases sous workspace.releases, une fois pour chaque Release sur les répertoires que lit cette Release, jamais sur tous ensemble.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
entitystringnonL’unique document d’entité à vérifier.
releasestringnonLa Release dont vérifier la fermeture, sous la forme d’un chemin relatif à la racine de l’espace de travail.
prePublishbooléennonIndique s’il faut comparer chaque entité à sa version publiée précédemment, ce qui atteint les registres configurés.

Les propriétés supplémentaires ne sont pas autorisées.

PluginAddParams

Rattache un plugin à un socket que configure l’espace de travail. Elle atteint un registre pour résoudre la recherche en un seul plugin et pour épingler une version. L’unique décision qu’obtiendrait un terminal — accepter les capacités déclarées d’un plugin d’extension de commandes — arrive ici sous forme de champ, de sorte que le client interroge celui qui le pilote et que cette surface n’attend jamais une invite.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
typestringnonLe socket auquel le plugin se rattache.
querystringnonCe qu’il faut résoudre en un seul plugin.
capabilitystringnonLa capacité à laquelle est destiné le rattachement, lorsque le socket en porte plusieurs.
rolestringnonLe rôle dans lequel s’exécute le rattachement, qui fixe ce qu’il peut émettre.
globalbooléennonÉcrit le fichier de configuration de toute la machine.
workspacebooléennonÉcrit le fichier de configuration propre à cet espace de travail.
acceptCapabilitiesbooléennonIndique si l’appelant accepte les capacités que déclare un plugin d’extension de commandes.
dryRunbooléennonIndique s’il faut répondre avec le contenu du document de configuration plutôt que de l’écrire.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRemoveParams

Détache un plugin d’un socket que configure l’espace de travail.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
typestringnonLe socket auquel le plugin est rattaché.
querystringnonQuel rattachement supprimer.
globalbooléennonÉcrit le fichier de configuration de toute la machine.
workspacebooléennonÉcrit le fichier de configuration propre à cet espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

PluginSyncParams

Aligne les enregistrements gérés par la machine d’une entité Plugin sur le module vers lequel elle pointe. Elle réécrit ces enregistrements et reporte inchangé chaque autre octet du document.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
entitystringnonLe document de l’entité Plugin à aligner.
pluginstringnonLe module de plugin dans lequel lire les enregistrements.

Les propriétés supplémentaires ne sont pas autorisées.

PluginGenCatalogParams

Génère des documents de catalogue Plugin à partir des métadonnées déclarées par le plugin lui-même, plus un overlay rédigé par l’auteur. Régénérer sur des entrées inchangées produit des documents identiques octet pour octet.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
fromEmbeddedbooléennonIndique s’il faut lire les métadonnées dans les plugins que le binaire porte déjà.
pluginstringnonLe module de plugin dans lequel lire les métadonnées.
outputDirstringnonLe répertoire sous l’espace de travail dans lequel écrire les documents.
overlaystringnonLe document rédigé par l’auteur dont le contenu est fusionné par-dessus les métadonnées générées.
dryRunbooléennonIndique s’il faut répondre avec le contenu des documents plutôt que de les écrire.

Les propriétés supplémentaires ne sont pas autorisées.

ExplainErrorParams

Développe un code que portait un constat pour donner ce que le compilateur déclare à propos de cette condition et les entrées publiées qui enseignent la correction d’authoring. Elle acquiert la documentation publiée lorsque l’espace de travail n’en a pas de copie ; si elle ne peut pas l’acquérir, elle répond tout de même avec ce que déclare le binaire, et dit pourquoi le texte explicatif manque.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
codestringnonLa condition à développer, désignée soit par le code que portait un constat, soit par son code court.

Les propriétés supplémentaires ne sont pas autorisées.

GetSchemaParams

Répond avec le schéma d’un type, ou — lorsqu’aucun type n’est nommé — avec les types qui peuvent être nommés. Elle répond pour le binaire en cours d’exécution plutôt que pour une copie installée ailleurs, de sorte qu’elle n’a besoin d’aucun espace de travail et n’en lit aucun.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootAcceptednonLe chemin absolu d’un espace de travail. Le sujet de cette méthode n’est pas un espace de travail — elle répond à partir de ce que le binaire lui-même contient — de sorte que le champ est accepté et non lu. Il est admis afin qu’un client puisse l’envoyer uniformément sur chaque requête sans avoir à savoir quelles méthodes le consultent.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
kindstringnonLe type dont renvoyer le schéma. En son absence, la réponse porte à la place sur les types qui peuvent être nommés.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsInstallParams

Écrit la skill d’assistant intégrée au binaire dans le dossier de skills de chaque assistant que nomme la requête ou, pour une requête globale qui n’en nomme aucun, de chaque assistant trouvé sur cette machine. Sans global, elle écrit le dossier de projet de chaque assistant à l’intérieur de l’espace de travail que nomme la requête, et chaque chemin qu’elle y écrirait est cantonné à cet espace de travail ; avec global, elle écrit le dossier par utilisateur de chaque assistant sous le répertoire personnel. Chaque cible est vérifiée avant que quoi que ce soit ne soit écrit, de sorte qu’un refus laisse chaque dossier tel qu’il était.

PropriétéTypeObligatoireDescription
workspaceRootWorkspaceRootSubjectouiLe chemin absolu de l’espace de travail sur lequel agit cette requête. C’est le sujet de la requête : le daemon le résout avant l’exécution de la méthode, et une requête qui l’omet ou l’écrit autrement que comme une chaîne est refusée.
workDoneTokenProgressTokennonUne valeur que l’appelant génère afin de pouvoir associer les notifications de progression à l’appel qui les a demandées. Elle est renvoyée inchangée sur chaque notification, de sorte qu’un appelant peut la comparer à la valeur qu’il a envoyée. Elle est acceptée sur chaque requête, et une requête qui en envoie une dans une session n’ayant déclaré aucune capacité de progression est refusée.
agentsstring[]nonLes assistants pour lesquels installer la skill, par les identifiants que rapporte le listage. Une requête de projet qui n’en nomme aucun est refusée. Une requête globale qui n’en nomme aucun installe la skill pour les assistants trouvés sur cette machine, chacun de ceux dont le dossier de configuration se trouve dans le répertoire personnel ou dont la commande se trouve dans le PATH, et elle est refusée sans rien écrire lorsqu’aucun n’est trouvé. Un identifiant pour lequel aucun dossier de skills n’est connu est refusé, nommément, et un identifiant donné deux fois est installé une seule fois.
globalbooléennonÉcrit le dossier de skills par utilisateur de chaque assistant sous le répertoire personnel, qu’il lit dans chaque projet, au lieu de son dossier de projet dans l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

ServerCapabilities

Ce que le daemon fera dans cette session, convenu par rapport à ce que le client a dit pouvoir prendre en charge.

PropriétéTypeObligatoireDescription
positionEncodingstringouiL’encodage dans lequel chaque position de cette session est exprimée.
workDoneProgressbooléennonIndique si le daemon enverra des notifications de progression dans cette session. Présent uniquement lorsque le client a déclaré pouvoir les recevoir.

Les propriétés supplémentaires ne sont pas autorisées.

ClosureEntity

Une entité dont dépend une Release, à la version que la résolution a arrêtée.

PropriétéTypeObligatoireDescription
uristringouiLa référence à partir de laquelle l’entité se résout.
versionstringouiLa version qui a été arrêtée.
kindstringnonLe type d’entité.
sourcestringnonD’où l’exécution qui a produit cette entrée a pris l’entité, avec le même mot que aggrega pull --detail affiche pour elle : fetched-fresh (récupérée d’un registre pendant cette exécution), cache-reuse (une copie déjà dans le cache, réutilisée sans récupération), local (trouvée sur le système de fichiers local, comme un répertoire de catalogue), in-binary (la copie à l’intérieur du binaire du compilateur) ou external (l’Aggregate ou le Manifest propre à la Release, lu depuis le fichier ou l’entrée que nomme la Release plutôt que résolu comme l’une de ses dépendances ; un Aggregate que l’exécution a récupéré d’un registre est fetched-fresh à la place). Présent sur les entrées du rapport d’une résolution de dépendances, où il décrit ce que cette exécution a fait sur cette machine, et absent d’un listage des dépendances résolues d’une Release, qui décrit ce dont la Release dépend. Le fichier de verrouillage n’enregistre aucune source. Omis pour une entité dont l’exécution n’a pas enregistré la source.

Les propriétés supplémentaires ne sont pas autorisées.

ToolchainCorePlugin

Un plugin que le compilateur porte lui-même, et la version de celui-ci qui a été utilisée.

PropriétéTypeObligatoireDescription
pluginstringouiLa référence du plugin.
versionstringouiLa version qui a été utilisée.

Les propriétés supplémentaires ne sont pas autorisées.

ToolchainReport

Le compilateur qui a effectué la résolution, et les plugins qu’il porte.

PropriétéTypeObligatoireDescription
compilerVersionstringouiLa version du compilateur qui a effectué la résolution.
corePluginsToolchainCorePlugin[]nonLes plugins que porte le compilateur, avec la version de chacun qui a été utilisée.

Les propriétés supplémentaires ne sont pas autorisées.

DependencyResolutionReport

Ce qu’une résolution de dépendances a épinglé et acquis.

PropriétéTypeObligatoireDescription
lockfilestringouiLe fichier de verrouillage que la résolution a écrit, ou celui auquel une vérification a comparé.
verifiedbooléennonIndique si la requête était une vérification, qui a comparé le fichier de verrouillage enregistré et n’a écrit ni fichier de verrouillage, ni enregistrement de confiance des plugins, ni entity.lock.
entitiesClosureEntity[] ou nullouiLes entités que la résolution a épinglées, ou qu’une vérification a comparées.
librariesClosureEntity[] ou nullouiLes bibliothèques que la résolution a épinglées, ou qu’une vérification a comparées.
pluginsClosureEntity[] ou nullouiLes plugins que la résolution a épinglés, ou qu’une vérification a comparés.
sourceArtifactsintegerouiLe nombre d’artefacts sources acquis.
trustedPluginsintegerouiLe nombre de plugins épinglés qui portaient une signature vérifiée.
toolchainToolchainReportnonLe compilateur qui a effectué la résolution, et les plugins qu’il porte.
externalInputsintegerouiLe nombre d’entrées externes consommées par le rendu qui ont été acquises.
incompleteExternalInputsstringnonLes entrées externes qui n’ont pas pu être acquises, lorsque certaines n’ont pas pu l’être.

Les propriétés supplémentaires ne sont pas autorisées.

BuildNotice

Une chose que le build veut faire savoir à l’appelant, qui n’est ni un constat sur un document ni un échec.

PropriétéTypeObligatoireDescription
classstringouiLe genre d’avis dont il s’agit.
textstringouiCe que dit l’avis.

Les propriétés supplémentaires ne sont pas autorisées.

CacheScope

Jusqu’où porte une réponse sur le cache. Deux des classes de cache sont partagées par tous les projets de la machine, de sorte que chaque réponse sur le cache nomme celles qu’elle a touchées — sinon, une session ouverte sur un espace de travail serait lue comme ne rendant compte que de cet espace de travail.

PropriétéTypeObligatoireDescription
machineWideClassesstring[] ou nullouiLes classes de cache touchées par cette réponse qui sont partagées entre tous les projets de la machine.
workspaceRootstringouiL’espace de travail que la requête a nommé.

Les propriétés supplémentaires ne sont pas autorisées.

CacheElement

Une chose que contient un cache.

PropriétéTypeObligatoireDescription
labelstringouiCe sur quoi porte l’entrée.
sizeintegerouiLe nombre d’octets qu’elle occupe.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.
digeststringnonLe digest de contenu sous lequel l’entrée est indexée, lorsqu’elle en a un.
notestringnonTout ce qui mérite encore d’être dit sur l’entrée.

Les propriétés supplémentaires ne sont pas autorisées.

CacheClass

Un cache dont le daemon rend compte.

PropriétéTypeObligatoireDescription
namestringouiDe quel cache il s’agit.
reachstringouiIndique si le cache appartient à cet espace de travail ou est partagé sur la machine.
prunablebooléenouiIndique si récupérer l’espace de ce cache est quelque chose que fera le daemon.
elementsCacheElement[] ou nullouiCe que contient le cache.

Les propriétés supplémentaires ne sont pas autorisées.

CacheProvenance

Sous quelles identités un artefact en cache a été acquis, et à quel point il est partagé.

PropriétéTypeObligatoireDescription
identitiesstring[] ou nullouiLes identités auxquelles l’artefact est attribué.
sharedByintegernonLe nombre de détenteurs qui partagent l’artefact.

Les propriétés supplémentaires ne sont pas autorisées.

CacheRemoval

Une chose qu’une récupération d’espace a supprimée — ou, dans une liste de ce qu’elle a laissé en place, une chose qu’elle aurait supprimée.

PropriétéTypeObligatoireDescription
classstringouiLe cache auquel elle appartient.
labelstringouiCe que c’est.
reachstringouiIndique si ce cache appartient à cet espace de travail ou est partagé sur la machine.
sizeintegerouiLe nombre d’octets qu’elle occupe, ou occupait avant d’être supprimée.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.

Les propriétés supplémentaires ne sont pas autorisées.

CacheShortfall

Ce qu’une récupération d’espace a laissé derrière elle, et ce qui le récupérerait, de sorte qu’un appelant qui lit un chiffre plus petit que prévu en apprend la raison plutôt que de la déduire.

PropriétéTypeObligatoireDescription
classstringouiLe cache qui contient ce qui a été laissé.
countintegerouiLe nombre d’entrées laissées.
sizeintegerouiLe nombre d’octets qu’elles occupent.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.
reachstringouiIndique si ce cache appartient à cet espace de travail ou est partagé sur la machine.
reclaimedBystring[] ou nullouiCe qui les récupérerait.

Les propriétés supplémentaires ne sont pas autorisées.

CacheCleared

Un cache qu’un nettoyage a vidé.

PropriétéTypeObligatoireDescription
classstringouiQuel cache a été vidé.
reachstringouiIndique s’il appartient à cet espace de travail ou s’il est partagé sur la machine.
sizeintegerouiCombien d’octets y ont été récupérés.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.
heldOpenFilesintegerouiCombien de fichiers le nettoyage a laissés dans ce cache parce qu’un autre processus les avait ouverts. Seul Windows refuse de supprimer un fichier ouvert, de sorte que partout ailleurs cette valeur vaut zéro. Un nettoyage ultérieur les supprime une fois que ce processus en a terminé avec eux.
heldOpenBytesintegerouiCombien d’octets occupent ces fichiers. Ils ne sont pas comptés dans size, qui est ce que le nettoyage a récupéré.
heldOpenBytesTextstringouiLe même chiffre écrit de la manière dont une personne le lit.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigWriteScope

Quel document de configuration a été écrit et jusqu’où il porte. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour une écriture à l’échelle de toute la machine, cette lecture est fausse.

PropriétéTypeObligatoireDescription
configFilestringouiLe document qui a été écrit.
machineWidebooléenouiIndique si ce document est celui au moyen duquel résout chaque espace de travail de la machine.
workspaceRootstringouiL’espace de travail que la requête a nommé.

Les propriétés supplémentaires ne sont pas autorisées.

PluginWriteScope

Dans quel document de configuration une modification de plugin a été écrite et jusqu’où elle porte. La valeur par défaut propre au socket d’extension de commandes est le document de toute la machine, de sorte que chaque réponse indique lequel elle a écrit.

PropriétéTypeObligatoireDescription
configFilestringouiLe document qui a été écrit.
machineWidebooléenouiIndique si ce document est celui au moyen duquel résout chaque espace de travail de la machine.
workspaceRootstringouiL’espace de travail que la requête a nommé.

Les propriétés supplémentaires ne sont pas autorisées.

CredentialStoreScope

Jusqu’où porte une modification d’identifiant de connexion. Le magasin est partagé par chaque projet de la machine et par tout autre outil qui s’adresse aux mêmes registres, de sorte que la réponse le signale plutôt que de laisser déduire une lecture limitée à la session.

PropriétéTypeObligatoireDescription
machineWidebooléenouiIndique si le magasin que la modification a touché est partagé sur la machine.
workspaceRootstringouiL’espace de travail que la requête a nommé.

Les propriétés supplémentaires ne sont pas autorisées.

SkillFolderScope

Jusqu’où porte une installation de skill. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour les dossiers par utilisateur, qu’un assistant lit dans chaque projet, cette lecture est fausse.

PropriétéTypeObligatoireDescription
machineWidebooléenouiIndique si les dossiers écrits sont ceux par utilisateur sous le répertoire personnel, que l’assistant lit dans chaque projet de la machine.
workspaceRootstringouiL’espace de travail que la requête a nommé.

Les propriétés supplémentaires ne sont pas autorisées.

PublicationReach

Jusqu’où une publication a porté. Ces réponses portent entièrement au-delà de cette machine — ce qu’elles attachent est ce que résout chaque consommateur de ce registre — de sorte que chacune nomme chaque registre auquel elle s’est adressée et indique si l’appel y a attaché quoi que ce soit.

PropriétéTypeObligatoireDescription
registriesstring[]ouiChaque hôte de registre auquel l’appel s’est adressé, chacun nommé une seule fois, dans l’ordre dans lequel l’appel s’y est adressé pour la première fois. Un appel portant sur une seule référence en nomme un ; une exécution à blanc nomme la destination à laquelle elle se serait adressée.
beyondThisMachinebooléenouiIndique si l’appel a attaché quoi que ce soit qu’un registre sert désormais à d’autres : du contenu téléversé, une signature, une date de publication ou un marqueur de dépréciation. Vaut false lors d’une exécution à blanc, et lors d’un appel qui a trouvé déjà présent tout ce qu’il aurait attaché — une publication exécutée à nouveau sur une version complète, ou un lot de signature dont chaque référence portait déjà une signature qui se vérifie.

Les propriétés supplémentaires ne sont pas autorisées.

WorkspaceEntityRef

Une entité, par type et par nom, avec le document qui la déclare.

PropriétéTypeObligatoireDescription
kindstringouiLe type d’entité.
namestringouiLe nom de l’entité.
filestringouiLe document qui la déclare, sous la forme d’un chemin relatif à la racine de l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

SourcedEntityRef

Une entité, avec l’endroit d’où elle a été lue. Un document de l’espace de travail signale son chemin relatif à l’espace de travail ; une entité résolue depuis les répertoires de catalogue configurés signale un chemin vide, car le seul chemin qu’elle possède ne signifierait rien pour un client. L’origine indique lequel des deux cas s’applique, plutôt que de laisser un chemin vide être lu comme un champ que personne n’a rempli.

PropriétéTypeObligatoireDescription
kindstringouiLe type d’entité.
namestringouiLe nom de l’entité.
filestringouiLe document qui la déclare, sous la forme d’un chemin relatif à la racine de l’espace de travail, ou vide lorsqu’elle provient des répertoires de catalogue configurés.
originstringouiL’endroit d’où l’entité a été lue.

Les propriétés supplémentaires ne sont pas autorisées.

SocketCandidacy

Un socket sur une entité, et ce qui peut y être relié.

PropriétéTypeObligatoireDescription
socketstringouiLe nom du socket.
declarationstringouiL’endroit où le socket est déclaré.
selectorstringouiLe sélecteur d’étiquettes qu’une cible doit satisfaire.
requiredbooléenouiIndique si le socket doit être relié pour que le build se poursuive.
targetsWorkspaceEntityRef[] ou nullouiLes entités qui peuvent y être reliées.

Les propriétés supplémentaires ne sont pas autorisées.

SlotCandidacy

Un slot que déclare le socket d’une connexion, tel que le Component consommateur le déclare sur le socket, et les Features qui peuvent le remplir sur cette connexion.

PropriétéTypeObligatoireDescription
slotstringouiLe nom du slot, qui est la clé sous laquelle un rattachement qui le remplit est écrit dans les features de la connexion.
selectorstringouiLe sélecteur d’étiquettes qu’une Feature qui remplit le slot doit satisfaire avec ses propres étiquettes. Vide lorsque le slot n’en déclare aucun, ce qui admet n’importe quelle Feature.
requiredbooléenouiIndique si chaque connexion reliée à travers le socket doit remplir le slot pour que le build se poursuive.
injectstring[]ouiLes mécanismes de livraison que le slot autorise pour ce qui le remplit, dans l’ordre dans lequel le Component les déclare. Vide lorsqu’il n’en déclare aucun.
sensitivebooléenouiIndique si le slot déclare que ce qui le remplit manipule du matériel secret. Il marque le rattachement qui le remplit et ne refuse rien.
descriptionstringouiCe à quoi sert le slot selon le Component. Vide lorsqu’il ne dit rien.
candidatesSourcedEntityRef[]ouiChaque Feature qui peut remplir le slot sur cette connexion : celle dont les étiquettes du nœud du graphe satisfont l’applicabilité déclarée, exigence à laquelle est tenu chaque rattachement que porte le nœud, et dont les propres étiquettes satisfont le sélecteur du slot. Une Feature dont l’applicabilité ou les étiquettes ne peuvent pas être lues par rapport au sélecteur n’est pas proposée, car un build la refuse plutôt que de l’admettre.

Les propriétés supplémentaires ne sont pas autorisées.

CatalogEntity

Une entité que contient l’index de l’espace de travail.

PropriétéTypeObligatoireDescription
kindstringouiLe type d’entité.
namestringouiLe nom de l’entité.
apiVersionstringouiLa version de schéma que déclare le document.
descriptionstringouiCe à quoi sert l’entité selon le document.
labelsmap de string ou nullouiLes étiquettes que déclare le document.
filestringouiLe document qui la déclare, sous la forme d’un chemin relatif à la racine de l’espace de travail.
originstringouiL’endroit d’où l’entité a été lue.

Les propriétés supplémentaires ne sont pas autorisées.

CompletionItem

Un élément qui peut être écrit à la position du curseur.

PropriétéTypeObligatoireDescription
labelstringouiLe texte à écrire.
kindintegernonLe genre d’élément dont il s’agit, afin qu’un client puisse lui choisir une icône.
detailstringnonUn court qualificatif affiché à côté du libellé.
documentationstringnonCe qu’est l’élément, en détail.
sortTextstringnonLa valeur selon laquelle trier, lorsqu’elle diffère du libellé.

Les propriétés supplémentaires ne sont pas autorisées.

MarkupContent

Du texte à afficher, et la façon dont il est balisé.

PropriétéTypeObligatoireDescription
kindstringouiLa façon dont le texte est balisé.
valuestringouiLe texte.

Les propriétés supplémentaires ne sont pas autorisées.

EntityKindDescriptor

Un type dont un auteur écrit un document, qui associe le jeton que nomme une requête au type que déclare le document lui-même, et qui indique quelles opérations acceptent un document de ce type.

PropriétéTypeObligatoireDescription
kindstringouiLe jeton en minuscules que nomme une requête, comme component ou featurerecipe.
documentKindstringouiLe type que déclare l’en-tête propre du document.
acceptedByEntityKindAcceptanceouiQuelles opérations acceptent un document de ce type nommé seul — par son chemin, ou par son nom pour une inspection — sans rien d’autre envoyé à côté. Un champ vaut true lorsque cette opération ne refuse pas un document du fait qu’il est de ce type ; un document qu’elle accepte peut tout de même être refusé pour ce que dit le document.

Les propriétés supplémentaires ne sont pas autorisées.

EntityKindAcceptance

Pour un type qu’écrit un auteur, indique si chaque opération accepte un document de ce type nommé seul. Chaque champ est présent dans chaque entrée, de sorte que false est une affirmation plutôt qu’une omission.

PropriétéTypeObligatoireDescription
singleEntityValidationbooléenouiIndique si la portée à entité unique de aggrega validate — la commande à laquelle on donne le chemin d’un seul document — vérifie un document de ce type. Un type qu’elle refuse est vérifié à la place par la portée du catalogue entier ou par la portée de la Release.
publicationbooléenouiIndique si aggrega/publishEntity, nommant le document seul, publie un document de ce type. Un type dont la publication lie aussi un exécutable nommé à côté du document — un Plugin — vaut false, car une requête nommant le document seul est refusée pour lui ; un Manifest et une Release valent false car aucun de ces types n’est publié.
inspectionByNamebooléenouiIndique si aggrega/entityDefinition résout un nom vers une entité de ce type, le nom étant envoyé tel qu’il est écrit là où une entité en référence une autre.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryTrust

La politique de confiance que la résolution applique à ce que sert un registre.

PropriétéTypeObligatoireDescription
signaturesRequiredbooléenouiIndique si un artefact provenant de ce registre doit porter une signature vérifiée.
verificationSkippedbooléennonIndique si la vérification est ignorée.
advisorybooléennonIndique si une vérification qui échoue est signalée plutôt que d’arrêter l’exécution.
anchorstringnonL’ancre de confiance par rapport à laquelle les signatures sont vérifiées.
keylessIdentitiesintegernonCombien d’identités de signature sont considérées comme fiables pour ce registre.

Les propriétés supplémentaires ne sont pas autorisées.

Registry

Un registre configuré. Aucun champ ici ne porte de matériel d’identification, sa longueur, sa forme ni aucune représentation de celui-ci — la présence est tout ce qui est signalé, ce qui permet de coller la valeur sans risque dans un ticket.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte du registre, qui constitue son identité.
namestringnonL’alias convivial qui se résout vers l’hôte, lorsqu’il en est configuré un.
defaultbooléenouiIndique si c’est le registre auquel s’adresse une opération qui ne nomme aucun registre.
authStatestringouiIndique si un identifiant de connexion pour cet hôte est présent dans le magasin de toute la machine. Il est signalé même lorsqu’il est vide, de sorte qu’un appelant peut distinguer « aucun identifiant de connexion n’est présent » de « la liste n’a pas regardé ».
trustRegistryTrustouiLa politique de confiance que la résolution applique à ce que sert un registre.

Les propriétés supplémentaires ne sont pas autorisées.

TrustFetchOutcome

Ce qu’a donné la lecture de la politique de confiance annoncée par un registre. Les résultats sont tenus séparés parce qu’ils signifient des choses différentes : la politique annoncée a été adoptée, le registre n’a rien annoncé — ce qui n’est pas un échec —, la base de référence intégrée a été épinglée à sa place, ou aucune lecture n’a été tentée. Lorsque rien n’a été annoncé, il est indiqué à côté si le registre a pu être atteint ou non.

PropriétéTypeObligatoireDescription
pinnedbooléenouiIndique si la politique annoncée a été adoptée.
notAdvertisedbooléennonIndique si le registre a été interrogé et n’a annoncé aucune politique, auquel cas l’opération se poursuit sur ce qu’a indiqué la requête. Un registre que le mode hors ligne a empêché d’interroger n’est jamais signalé ainsi. Un registre qui n’a pas pu être atteint est lui aussi signalé ainsi, puisqu’aucune politique n’en est revenue, et porte unreachable à côté ; lisez unreachable pour distinguer les deux.
unreachablebooléennonIndique si le registre n’a pas pu être atteint lorsque sa politique annoncée a été demandée : son nom ne s’est pas résolu, une connexion vers lui a été refusée ou n’a pas pu être ouverte, ou une connexion sécurisée vers lui n’a pas pu être établie. Il est lu dans l’échec lui-même plutôt que dans reason, il figure à côté de notAdvertised, et il n’est défini que lorsque l’échec montre que le registre n’a jamais été atteint ; un registre qui a répondu — sans politique, ou par un échec — le laisse absent.
baselinebooléennonIndique si la base de référence intégrée, que seul le hub officiel porte, a été épinglée parce qu’aucune politique annoncée n’a été adoptée. Il figure à côté de notAdvertised lorsque le hub a été interrogé et n’a rien annoncé, et seul lorsque le mode hors ligne a empêché d’interroger le hub.
skippedbooléennonIndique si aucune lecture n’a été tentée, parce qu’une politique indiquée l’a remplacée ou que la requête n’en demandait aucune.
identitiesintegernonCombien d’identités de signature portait la politique annoncée.
reasonstringnonPourquoi la politique annoncée n’a pas été adoptée : ce qu’a fait le point de terminaison du registre, ou le refus hors ligne qui a empêché de l’interroger.

Les propriétés supplémentaires ne sont pas autorisées.

SkippedRepo

Un dépôt que le parcours de l’index a ignoré, et pourquoi.

PropriétéTypeObligatoireDescription
repostringouiLe dépôt qui a été ignoré.
reasonstringouiPourquoi il a été ignoré.

Les propriétés supplémentaires ne sont pas autorisées.

DeprecationNote

Un marqueur de dépréciation que le parcours de l’index a rencontré, et ce qu’il en a fait. Un marqueur qui a été respecté et un marqueur présent qui a été écarté sont signalés sur un pied d’égalité, de sorte qu’en enregistrer beaucoup ne passe pas sous silence tandis qu’en écarter un se fait remarquer.

PropriétéTypeObligatoireDescription
repostringouiLe dépôt sur lequel se trouve le marqueur.
versionstringouiLa version que couvre le marqueur.
recordedbooléenouiIndique si la signature propre du marqueur a été vérifiée, et si l’index le porte donc.
severityconst “warning” ou const “error” ou const “retracted”nonLa force avec laquelle le marqueur s’exprime. Valeurs autorisées : "warning" — Dépréciée, au plus modéré des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "error" — Dépréciée, au plus fort des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "retracted" — Retirée : exclue lorsqu’une version est choisie.
reasonstringnonLa raison pour laquelle la version est dépréciée.

Les propriétés supplémentaires ne sont pas autorisées.

HostUpdate

Ce qu’un rafraîchissement de l’index a fait pour un registre.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte de registre qui a été rafraîchi.
indexedintegerouiCombien d’enregistrements ont été écrits.
deprecationsExaminedbooléenouiIndique si le parcours a même cherché des marqueurs de dépréciation. Il est distinct du décompte parce que « ce registre n’en a publié aucun » et « cette exécution n’avait aucune base pour en juger un » sont des faits différents.
deprecationsRecordedintegerouiCombien de marqueurs ont été respectés.
skippedSkippedRepo[] ou nullouiLes dépôts que le parcours a ignorés.
deprecationsDeprecationNote[] ou nullouiLes marqueurs que le parcours a rencontrés.
readsRetriedintegerouiCombien des lectures du parcours le registre a refusées ou abandonnées en cours de route et ont été redemandées, chaque lecture comptée une seule fois quel que soit le nombre de tentatives qu’elle a nécessité et qu’elle ait ensuite réussi ou non ; zéro lorsqu’il n’y en a eu aucune. Un parcours dont les lectures ont toutes fini par réussir ne liste aucun dépôt sous skipped, de sorte que c’est ce décompte qui dit à quel point il a été près d’en laisser un de côté. Minimum : 0.
errorstringnonCe qui a échoué pour cet hôte, de sorte qu’un parcours sur plusieurs hôtes signale lesquels ont échoué sans que l’appelant ait à corréler quoi que ce soit.
unreachablebooléennonIndique si ce registre n’a pas pu être atteint : son nom ne s’est pas résolu, une connexion vers lui a été refusée ou n’a pas pu être ouverte, ou une connexion sécurisée vers lui n’a pas pu être établie. Il est lu dans l’échec lui-même plutôt que dans error, il n’est défini qu’à côté de error, et seulement lorsque l’échec montre que le registre n’a jamais été atteint ; un registre qui a répondu, quoi qu’il ait répondu, le laisse absent.

Les propriétés supplémentaires ne sont pas autorisées.

PublishedVersion

Une version que l’index contient pour une référence : le digest du manifeste vers lequel son tag se résolvait lorsque l’index a été construit ; lorsque la politique de confiance sous laquelle l’index a été construit a vérifié la signature propre de la version, le signataire établi par cette vérification ; et, lorsque quelque chose l’enregistre, le moment où la version a été publiée, avec la source qui l’indique. Le signataire est absent pour une version sans signature, pour une version dont aucune des signatures n’a été vérifiée, et lorsque cette politique n’épingle ni une clé publique ni une identité de confiance ou désactive la vérification des signatures. Aucun de ces cas ne fournit de base pour nommer un signataire, et son absence ne dit rien de plus. La date de publication est absente lorsque la publication n’en a indiqué aucune et qu’aucune signature keyless vérifiée par cette politique n’en enregistre une.

PropriétéTypeObligatoireDescription
versionstringouiLa version, telle que la nomme son tag.
manifestDigeststringouiLe digest du manifeste vers lequel le tag de la version se résolvait lorsque l’index a été construit, qui désigne la version par les octets qu’il nomme plutôt que par son tag.
signerVerifiedSignaturenonUne signature vérifiée par rapport à la politique de confiance d’un registre : la façon dont elle a été vérifiée, le signataire établi par la vérification, et le digest du bundle de signature qui a été vérifié.
publishedAtstringnonLe moment où la version a été publiée, sous la forme d’un horodatage RFC 3339 en UTC à la seconde près. Sa provenance est publishedAtSource, et les deux sont présents ensemble ou pas du tout.
publishedAtSourceconst “transparency-log” ou const “publisher”nonLa provenance de publishedAt, afin qu’un moment qu’atteste un journal de transparence ne soit jamais confondu avec un moment qu’indique l’éditeur. L’ensemble est fermé. Valeurs autorisées : "transparency-log" — Le moment où un journal de transparence a enregistré la signature keyless de la version, que la politique de confiance sous laquelle l’index a été construit a vérifiée avec la promesse signée du journal quant à ce moment. Pour une version signée au moment de sa publication, c’est la publication ; pour une version signée ensuite, c’est le moment où cette signature a été faite. "publisher" — Le moment que la publication a indiqué à côté de ce qu’elle a publié, d’après l’horloge propre de la machine qui publie. Rien ne l’atteste. Une publication en indique un lorsque sa signature ne porte aucun moment attesté : une signature à clé, ou aucune signature. Lorsque plusieurs sont attachés, le plus ancien est retenu.

Les propriétés supplémentaires ne sont pas autorisées.

VerifiedSignature

Une signature vérifiée par rapport à la politique de confiance d’un registre : la façon dont elle a été vérifiée, le signataire établi par la vérification, et le digest du bundle de signature qui a été vérifié.

PropriétéTypeObligatoireDescription
bundleDigeststringouiLe digest du bundle de signature qui a été vérifié, sous la forme de sha256: suivi de 64 caractères hexadécimaux en minuscules.
identitystringnonLe signataire établi par la vérification de la signature : pour une signature keyless, l’identité pour laquelle le certificat de signature a été émis, c’est-à-dire son subject alternative name ; pour une signature à clé, keyed:sha256: suivi du SHA-256 en hexadécimal minuscule du texte PEM de la clé publique épinglée.
issuerstringnonL’émetteur OIDC enregistré dans le certificat de signature, pour une signature keyless. Il est absent pour une signature à clé.
modeconst “keyless” ou const “keyed”ouiLa façon dont la signature a été vérifiée. L’ensemble est fermé. Valeurs autorisées : "keyless" — Par rapport à un certificat de signature dont l’identité et l’émetteur correspondent à ceux auxquels la politique fait confiance, qui remonte par sa chaîne jusqu’à la racine de confiance qu’épingle la politique ou, lorsqu’elle n’en épingle aucune, jusqu’à la racine public-good de Sigstore, et dont un journal de transparence enregistre la signature. "keyed" — Par rapport à la clé publique qu’épingle la politique.

Les propriétés supplémentaires ne sont pas autorisées.

RegistrySearchRecord

Un enregistrement auquel une recherche a correspondu, tel que l’index local le contient, ainsi que celles de ses versions qu’un marqueur publié a dépréciées.

PropriétéTypeObligatoireDescription
uristringouiLa référence à partir de laquelle l’enregistrement se résout.
namestringouiLe nom de l’entité.
versionstringouiLa version sous laquelle l’enregistrement est indexé.
versionsstring[]nonChaque version que l’index contient pour cette référence.
kindstringnonLe type d’entité.
descriptionstringnonCe à quoi sert l’entité.
categorystringnonLa catégorie sous laquelle l’entité est publiée.
labelsmap de stringnonLes étiquettes que déclare l’entité.
pluginTypestringnonLe socket auquel se rattache un enregistrement de plugin.
capabilitiesstring[]nonLes capacités que déclare un enregistrement de plugin.
manifestDigeststringnonLe digest du manifeste publié.
listingDigeststringnonLe digest de la liste dans laquelle l’enregistrement a été lu.
deprecationsobject[]nonLes marqueurs de dépréciation que l’index porte pour cette référence, chacun avec la version qu’il couvre et le marqueur vérifié lui-même.
publishedPublishedVersion[]nonChaque version que l’index contient pour cette référence, dans le même ordre que versions, chacune avec le digest du manifeste vers lequel son tag se résolvait lorsque l’index a été construit, avec son signataire vérifié lorsque la politique de confiance sous laquelle l’index a été construit a vérifié la signature propre de cette version, et avec sa date de publication et la source de cette date lorsque quelque chose les enregistre. Une version enregistrée sans signataire ne porte aucune signature vérifiée par cette politique, et rien de plus n’en est dit. Pour enregistrer cela, seuls des manifestes, des attachements de signature et des attachements de date de publication sont lus depuis le registre ; le contenu d’aucune entité n’est récupéré.
retractedstring[]nonLes versions qu’un marqueur publié a dépréciées.

Les propriétés supplémentaires ne sont pas autorisées.

RegistrySearchIndex

La fraîcheur d’un hôte interrogé.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte dont l’index a été interrogé.
lastUpdatedstringnonLe moment où l’index a été rafraîchi pour la dernière fois. Il est absent plutôt que nul lorsque l’instantané ne porte aucune heure, de sorte qu’un appelant peut distinguer « non enregistré » de l’epoch.

Les propriétés supplémentaires ne sont pas autorisées.

EffectiveConfigurationSetting

Un réglage résolu, et le document dont il provient.

PropriétéTypeObligatoireDescription
fieldstringouiLe réglage.
valuestringouiLa valeur qui a été résolue.
sourcestringouiLa provenance de la valeur.

Les propriétés supplémentaires ne sont pas autorisées.

ImportedFile

Un fichier qu’écrit un import : un document à l’état de brouillon, ou l’enregistrement de ce que l’import a écrit.

PropriétéTypeObligatoireDescription
pathstringouiL’emplacement du fichier, sous la forme d’un chemin relatif au outputDir de la réponse.
contentstringouiLe texte du fichier.

Les propriétés supplémentaires ne sont pas autorisées.

ImportDrift

Une partie qu’une synchronisation a mise à jour par rapport à la source, ou mettrait à jour sous dryRun.

PropriétéTypeObligatoireDescription
changestringouiLa façon dont la partie a dérivé : added, pour une partie que la source a gagnée ; removed, pour une partie qu’elle a abandonnée ; ou changed, pour une partie qu’elle a modifiée.
filestringouiLe fichier rédigé dans lequel se trouve la partie, sous la forme d’un chemin relatif au outputDir de la réponse.
keystring[]ouiLes clés qui mènent à la partie depuis le sommet d’un Aggregate ou d’une Release rédigés, une entrée par clé, de sorte qu’une clé contenant un point reste une seule entrée. Vide lorsque la partie est le fichier entier.

Les propriétés supplémentaires ne sont pas autorisées.

ImportOwed

Une valeur que les brouillons laissent encore vide, qu’aucune source n’a pu fournir et qu’aucune réponse n’a fournie.

PropriétéTypeObligatoireDescription
filestringouiLe fichier rédigé dans lequel se trouve la valeur, sous forme de chemin relatif à l’outputDir de la réponse.
keystring[]ouiLes clés menant à la valeur depuis le haut de ce document, une entrée par clé, de sorte qu’une clé contenant un point reste une seule entrée. Une réponse envoyée comme answered nomme la valeur par ces clés.
questionstringouiCe qu’est la valeur : la description de son schéma, sinon le commentaire que le brouillon écrit au-dessus de sa clé, sinon ce que son schéma dit qu’elle accepte.
sensitivebooléenouiSi la valeur est celle d’un secret, dont la réponse nomme la provenance du secret et ne contient jamais le secret lui-même.
secretAdvicestringnonPrésent sur la valeur d’un secret : ce que doit être sa réponse, dans la phrase présentée à une personne qui y répond dans un terminal — ou, lorsque la réponse envoyée pour elle comme answered a été refusée, pourquoi elle a été refusée.

Les propriétés supplémentaires ne sont pas autorisées.

ImportAnswered

Une réponse pour une valeur que owed de la réponse a listée.

PropriétéTypeObligatoireDescription
filestringouiLe fichier rédigé dans lequel se trouve la valeur, tel que owed le nomme.
keystring[]ouiLes clés menant à la valeur, telles que owed les nomme.
answerstringouiLa réponse. Une réponse vide laisse la valeur due.

Les propriétés supplémentaires ne sont pas autorisées.

ImportDiagnostic

Une chose qu’une conversion n’a pas pu convertir. Ce sont les sorties les plus utiles de la conversion, de sorte qu’elles sont signalées en entier plutôt que réduites à un verdict.

PropriétéTypeObligatoireDescription
severitystringouiSa gravité.
messagestringouiCe qui n’a pas pu être converti.
codestringnonLe nom citable de la condition, lorsqu’elle en a un.

Les propriétés supplémentaires ne sont pas autorisées.

ImportDecision

La façon dont une conversion a associé un nœud source : les Components du catalogue que l’importateur a évalués, celui qu’il a choisi, pourquoi, et comment remplacer ce choix.

PropriétéTypeObligatoireDescription
sourceNodeDecisionSourceNodeouiLe nœud source sur lequel porte une décision d’association.
candidatesImportCandidate[]nonLes Components du catalogue que l’importateur a évalués pour le nœud, chacun avec son score. Absent lorsqu’il n’en a évalué aucun.
chosenDecisionChoicenonCe que l’importateur a choisi pour un nœud source. Absent d’une décision dans laquelle il n’a fait aucun choix.
rationalestringnonPourquoi l’importateur a fait ce choix, dans ses propres mots. Absent lorsqu’il n’en a écrit aucun.
swapHintstringnonComment remplacer le choix par une alternative, dans les propres mots de l’importateur. Absent lorsqu’il n’en a écrit aucun.

Les propriétés supplémentaires ne sont pas autorisées.

DecisionSourceNode

Le nœud source sur lequel porte une décision d’association.

PropriétéTypeObligatoireDescription
idstringouiL’identifiant du nœud dans la source.
typestringouiLe type du nœud, tel que le nomme la source.
paramsSummarystringouiUn résumé des paramètres du nœud, à afficher à côté de la décision.

Les propriétés supplémentaires ne sont pas autorisées.

ImportCandidate

Un Component du catalogue que l’importateur a évalué pour un nœud source.

PropriétéTypeObligatoireDescription
componentNamestringouiLe nom du Component.
scorenumberouiDans quelle mesure le Component correspond au nœud, selon le score de l’importateur.
tierstringouiLe niveau de correspondance dans lequel tombe le score.
signalsCandidateSignalsouiCe que chacun des signaux de l’importateur a apporté au score d’un candidat.

Les propriétés supplémentaires ne sont pas autorisées.

CandidateSignals

Ce que chacun des signaux de l’importateur a apporté au score d’un candidat.

PropriétéTypeObligatoireDescription
tablenumberouiL’apport du signal de la table de correspondance.
categorynumberouiL’apport du signal de catégorie.
domainLabelsnumberouiL’apport du signal des étiquettes de domaine.
shapenumberouiL’apport du signal de forme.
namenumberouiL’apport du signal de nom.

Les propriétés supplémentaires ne sont pas autorisées.

DecisionChoice

Ce que l’importateur a choisi pour un nœud source. Absent d’une décision dans laquelle il n’a fait aucun choix.

PropriétéTypeObligatoireDescription
targetstringouiLe nom du Component choisi : un Component existant du catalogue, ou celui rédigé pour le nœud.
modestringouiLa façon dont le choix est écrit : comme une référence à un Component existant, ou sous une forme nouvellement rédigée.
tierstringouiLe niveau de correspondance du choix.

Les propriétés supplémentaires ne sont pas autorisées.

LintFileFindings

Ce qu’une vérification des conventions a trouvé dans un document.

PropriétéTypeObligatoireDescription
filestringouiLe document.
diagnosticsDiagnostic[] ou nullouiLes constats qu’il contient.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRetractionExclusion

Une version qui était disponible et n’a pas été choisie.

PropriétéTypeObligatoireDescription
versionstringouiLa version qui a été ignorée.
reasonstringnonPourquoi il a été ignoré.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRetractionProvenance

La provenance de la connaissance de ce qui est déprécié.

PropriétéTypeObligatoireDescription
sourcestringouiCe qui a été consulté.
lastUpdatedstringnonLe moment où cela a été rafraîchi pour la dernière fois.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRetraction

La façon dont un marqueur de dépréciation a déterminé quelle version du plugin a été épinglée.

PropriétéTypeObligatoireDescription
referencestringouiLa référence à laquelle appartiennent les versions.
selectedstringnonLa version qui a été épinglée.
excludedPluginRetractionExclusion[]nonLes versions qui étaient disponibles et ont été ignorées.
unscreenedstringnonCe qui n’a pas pu être contrôlé par rapport à un marqueur, et pourquoi.
provenancePluginRetractionProvenancenonLa provenance de la connaissance de ce qui est déprécié.

Les propriétés supplémentaires ne sont pas autorisées.

PluginGeneratedDocument

Un document de catalogue qu’une génération a produit.

PropriétéTypeObligatoireDescription
pathstringouiL’emplacement du document, sous la forme d’un chemin relatif à la racine de l’espace de travail.
contentstringouiLe texte du document.

Les propriétés supplémentaires ne sont pas autorisées.

PluginCommandFlag

Un flag qu’un plugin déclare sur une commande qu’il fournit.

PropriétéTypeObligatoireDescription
namestringouiLe nom long du flag.
shorthandstringnonL’alias d’un seul caractère du flag, lorsqu’il en a un.
descriptionstringnonLe texte d’aide d’une ligne du flag.
typestringnonLe type de valeur du flag.
defaultstringnonLa valeur utilisée lorsque le flag n’est pas passé.

Les propriétés supplémentaires ne sont pas autorisées.

PluginCLICommand

Un verbe de commande de premier niveau qu’un plugin fournit.

PropriétéTypeObligatoireDescription
namestringouiLe verbe de la commande.
descriptionstringnonLe texte d’aide d’une ligne de la commande.
flagsPluginCommandFlag[]nonLes flags de la commande, dans l’ordre déclaré.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigCapturedAttachment

Un rattachement qu’un figement a écrit dans la configuration propre à cet espace de travail.

PropriétéTypeObligatoireDescription
uristringnonLa référence à partir de laquelle le rattachement se résout.
capabilitystringnonLa capacité à laquelle est destiné le rattachement.
functionstringnonL’export vers lequel le rattachement est acheminé.
rolestringnonLe rôle dans lequel s’exécute le rattachement, qui fixe ce qu’il peut émettre.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigCapturedSocket

Un socket qu’un figement a écrit, avec les rattachements qu’il y a figés.

PropriétéTypeObligatoireDescription
socketstringouiLe socket.
fieldstringouiLe champ de configuration sous lequel le socket est écrit.
attachmentsConfigCapturedAttachment[] ou nullouiLes rattachements qui y ont été figés.

Les propriétés supplémentaires ne sont pas autorisées.

ExplainErrorEntry

Un passage publié qui enseigne la correction d’authoring pour une condition.

PropriétéTypeObligatoireDescription
headingstringouiLe titre du passage.
bodystringouiLe passage.

Les propriétés supplémentaires ne sont pas autorisées.

SignedArtifact

Un artefact publié qu’une signature a couvert.

PropriétéTypeObligatoireDescription
referencestringouiLa référence qui a été signée.
digeststringouiLe digest de ce qui a été signé.

Les propriétés supplémentaires ne sont pas autorisées.

DeprecationMarked

Une version publiée qu’une dépréciation a marquée.

PropriétéTypeObligatoireDescription
referencestringouiLa référence qui a été marquée.
severityconst “warning” ou const “error” ou const “retracted”ouiLa force avec laquelle le marqueur s’exprime. Valeurs autorisées : "warning" — Dépréciée, au plus modéré des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "error" — Dépréciée, au plus fort des deux niveaux consultatifs : toujours sélectionnée lorsqu’une version est choisie. "retracted" — Retirée : exclue lorsqu’une version est choisie.
issuedOnstringouiLe moment où le marqueur a été émis.
digeststringouiLe digest du marqueur qui a été publié.

Les propriétés supplémentaires ne sont pas autorisées.

InitializeResult

Ce que la session a arrêté pour ce client, et la couche de configuration à partir de laquelle elle a résolu.

PropriétéTypeObligatoireDescription
capabilitiesServerCapabilitiesouiCe que le daemon fera dans cette session, convenu par rapport à ce que le client a dit pouvoir prendre en charge.
workspaceRootstringouiL’espace de travail sur lequel la session s’est ouverte.
configSourcestringouiLa couche de configuration à partir de laquelle la session a résolu ses réglages.
workspaceMarkerstringnonLe fichier qui a identifié la racine de l’espace de travail, lorsqu’il y en a eu un.
versionstringouiLa version du binaire qui répond à cette session : la même valeur que celle que aggrega version rapporte pour ce binaire. Elle décrit le processus en cours d’exécution, de sorte qu’une fois que le fichier à partir duquel le daemon a été démarré a été remplacé, ceci nomme toujours la version en cours d’exécution, tandis qu’interroger le fichier nomme la version qui l’a remplacé.

Les propriétés supplémentaires ne sont pas autorisées.

ValidateResult

Ce que la vérification a trouvé, et ce qui a été vérifié.

PropriétéTypeObligatoireDescription
diagnosticsDiagnostic[] ou nullouiLes constats. Il vaut null plutôt qu’une liste vide lorsque la vérification n’a rien trouvé.
checkedstringnonCe qui a été vérifié — un document, ou ce que contient l’espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

InvalidateResult

Indique si le daemon conservait quoi que ce soit au sujet du document à abandonner.

PropriétéTypeObligatoireDescription
invalidatedbooléenouiIndique si quoi que ce soit a été abandonné.

Les propriétés supplémentaires ne sont pas autorisées.

DiagnosticsResult

Les constats que le daemon conserve déjà pour le document.

PropriétéTypeObligatoireDescription
diagnosticsDiagnostic[] ou nullouiLes constats. Il vaut null plutôt qu’une liste vide lorsqu’il n’y en a aucun.

Les propriétés supplémentaires ne sont pas autorisées.

IrGraphResult

Le graphe résolu vers lequel une Release se compile.

PropriétéTypeObligatoireDescription
graphanyouiLe document du graphe. Les valeurs qu’un auteur a déclarées sensibles en sont retenues à moins que la requête ne les ait demandées avec unredacted ; tout le reste est transmis tel que le compilateur l’a émis. Sa propre forme est le contrat publié du graphe et n’est pas répétée ici.

Les propriétés supplémentaires ne sont pas autorisées.

BuildResult

Ce qu’un build a écrit.

PropriétéTypeObligatoireDescription
outputDirectorystringouiLe répertoire dans lequel les artefacts ont été écrits.
filesstring[] ou nullouiLes artefacts qui ont été écrits, sous la forme de chemins relatifs au répertoire de sortie.
noticesBuildNotice[]nonTout ce que le build veut faire savoir à l’appelant et qui n’est ni un constat ni un échec.
dependencyResolutionDependencyResolutionReportnonCe qu’une résolution de dépendances a épinglé et acquis.

Les propriétés supplémentaires ne sont pas autorisées.

BuildPreviewResult

Ce qu’un build aurait écrit. Rien n’a été écrit, il n’y a donc aucun répertoire de sortie à nommer.

PropriétéTypeObligatoireDescription
filesstring[] ou nullouiLes artefacts que l’écriture aurait produits.
noticesBuildNotice[]nonTout ce que la compilation veut faire savoir à l’appelant et qui n’est ni un constat ni un échec.

Les propriétés supplémentaires ne sont pas autorisées.

EntityDefinitionResult

Ce vers quoi se résout un nom d’entité, et le document qui la définit. Une réponse lue depuis une référence de registre porte published, et une réponse que le catalogue a résolue par nom ne le porte jamais.

PropriétéTypeObligatoireDescription
kindstringouiLe type d’entité.
namestringouiLe nom de l’entité.
versionstringouiLa version qui a été résolue.
descriptionstringnonCe à quoi sert l’entité selon le document.
publishScopestringnonL’étendue de la publication de l’entité.
filestringouiLe document qui la définit.
authoredLengthintegerouiLe nombre d’octets que contient le document rédigé par l’auteur, afin qu’un client puisse distinguer un document rédigé par l’auteur d’un rendu résolu de celui-ci.
definitionstringouiLe texte de la définition.
publishedPublishedArtifactnonCe qu’une référence de registre a lu : la coordonnée, la façon dont elle contenait l’entité, et le manifeste à travers lequel elle a été lue. Chaque champ est présent partout où ceci l’est.

Les propriétés supplémentaires ne sont pas autorisées.

PublishedArtifact

Ce qu’une référence de registre a lu : la coordonnée, la façon dont elle contenait l’entité, et le manifeste à travers lequel elle a été lue. Chaque champ est présent partout où ceci l’est.

PropriétéTypeObligatoireDescription
referencestringouiLa référence de registre qui a été lue.
archivebooléenouiIndique si les octets de la coordonnée étaient une archive dont le document d’entité a été extrait. False lorsque la coordonnée contenait le document d’entité lui-même.
mediaTypestringouiLe type d’artefact que déclare le manifeste.
manifestDigeststringouiLe digest du manifeste à travers lequel l’entité a été lue — la valeur à nommer après @ pour relire exactement les mêmes octets.

Les propriétés supplémentaires ne sont pas autorisées.

ReleaseClosureResult

Tout ce dont dépend une Release, tel que la résolution l’a atteint. Il rend compte de la fermeture plutôt que du graphe qui en est dérivé : un document différent sur la même Release.

PropriétéTypeObligatoireDescription
releasestringouiLa Release qui a été inspectée.
aggregatestringouiL’Aggregate qu’elle déploie.
manifeststringouiLe Manifest à travers lequel elle se résout.
environmentstringouiL’environnement qu’elle nomme.
entitiesClosureEntity[] ou nullouiLes entités qu’atteint la fermeture.
librariesClosureEntity[] ou nullouiLes bibliothèques qu’atteint la fermeture.
pluginsClosureEntity[] ou nullouiLes plugins qu’atteint la fermeture.
mappingDiagnosticsstring[] ou nullouiCe que la résolution des correspondances du Manifest avait à dire.
deprecationsstring[] ou nullouiLes marqueurs de dépréciation que la fermeture a rencontrés.

Les propriétés supplémentaires ne sont pas autorisées.

ResolveDependenciesResult

Ce qu’une résolution de dépendances a épinglé et acquis, ainsi que tout ce qu’elle veut faire savoir à l’appelant. Les champs propres du rapport sont portés directement sur cette réponse plutôt qu’imbriqués sous l’un de ses champs.

PropriétéTypeObligatoireDescription
lockfilestringouiLe fichier de verrouillage que la résolution a écrit, ou celui auquel une vérification a comparé.
verifiedbooléennonIndique si la requête était une vérification, qui a comparé le fichier de verrouillage enregistré et n’a écrit ni fichier de verrouillage, ni enregistrement de confiance des plugins, ni entity.lock.
entitiesClosureEntity[] ou nullouiLes entités que la résolution a épinglées, ou qu’une vérification a comparées.
librariesClosureEntity[] ou nullouiLes bibliothèques que la résolution a épinglées, ou qu’une vérification a comparées.
pluginsClosureEntity[] ou nullouiLes plugins que la résolution a épinglés, ou qu’une vérification a comparés.
sourceArtifactsintegerouiLe nombre d’artefacts sources acquis.
trustedPluginsintegerouiLe nombre de plugins épinglés qui portaient une signature vérifiée.
toolchainToolchainReportnonLe compilateur qui a effectué la résolution, et les plugins qu’il porte.
externalInputsintegerouiLe nombre d’entrées externes consommées par le rendu qui ont été acquises.
incompleteExternalInputsstringnonLes entrées externes qui n’ont pas pu être acquises, lorsque certaines n’ont pas pu l’être.
noticesstring[]nonTout ce que la résolution veut faire savoir à l’appelant.

Les propriétés supplémentaires ne sont pas autorisées.

PinResult

Ce que l’étape d’épinglage a fait au verrou situé à côté d’une entité, ou ferait lors d’une exécution à blanc. C’est la réponse à aggrega/pin, et une publication qui a exécuté l’étape la porte comme son pin.

PropriétéTypeObligatoireDescription
entitystringouiLe document d’entité que l’étape a lu, sous la forme d’un chemin relatif à la racine de l’espace de travail.
kindstringouiLe type de l’entité, tel que le déclare son document.
namestringouiLe nom de l’entité, tel que le déclare son document.
pinnablebooléenouiIndique si une entité de ce type lit quoi que ce soit pour lequel un verrou enregistre un épinglage, ce que font une Recipe et une FeatureRecipe. Lorsqu’il vaut false, rien à côté de l’entité n’a été touché, changed vaut false, et lock, removed, pins et content sont absents.
lockstringnonLe verrou que l’étape a écrit, ou écrirait, sous la forme d’un chemin relatif à la racine de l’espace de travail.
changedbooléenouiIndique si le verrou a changé, ou changerait lors d’une exécution à blanc. False lorsque le verrou enregistrait déjà chaque épinglage dont l’entité a besoin et a été laissé identique octet pour octet.
removedbooléennonIndique si le changement est une suppression : l’entité ne lit rien pour lequel un verrou enregistre un épinglage, de sorte qu’aucun verrou n’est laissé à côté d’elle.
dryRunbooléennonIndique si ceci rend compte de ce que l’étape ferait plutôt que de ce qu’elle a fait.
pinsPinClassCount[]nonLe nombre d’épinglages de chaque classe que contient le verrou après l’étape, ou contiendrait après une exécution à blanc. Chaque classe que le verrou peut contenir est listée, y compris une classe sans épinglage.
contentstringnonLe verrou qu’une exécution à blanc écrirait. Absent lorsque le verrou serait laissé tel quel ou supprimé, et dans toute réponse qui n’est pas une exécution à blanc.

Les propriétés supplémentaires ne sont pas autorisées.

PinClassCount

Le nombre d’épinglages d’une classe que contient un verrou.

PropriétéTypeObligatoireDescription
classstringouiLa classe de l’épinglage, dans les mots qu’emploie un refus qui en nomme un manquant — remote source ou imported file, par exemple.
pinsintegerouiLe nombre d’épinglages de cette classe que contient le verrou.

Les propriétés supplémentaires ne sont pas autorisées.

CacheStatusResult

Ce que contiennent les caches qui servent cet espace de travail.

PropriétéTypeObligatoireDescription
classesCacheClass[] ou nullouiChaque cache et ce qu’il contient.
provenanceCacheProvenance[] ou nullouiSous quelles identités les artefacts en cache ont été acquis.
totalCountintegerouiLe nombre total d’entrées que contiennent les caches.
totalSizeintegerouiLe nombre total d’octets qu’ils occupent.
totalSizeTextstringouiLe même total écrit de la manière dont une personne le lit.
scopeCacheScopeouiJusqu’où porte une réponse sur le cache. Deux des classes de cache sont partagées par tous les projets de la machine, de sorte que chaque réponse sur le cache nomme celles qu’elle a touchées — sinon, une session ouverte sur un espace de travail serait lue comme ne rendant compte que de cet espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

CachePruneResult

Ce qu’une récupération d’espace a supprimé, ce qu’elle a conservé et ce qu’elle n’a pas pu récupérer.

PropriétéTypeObligatoireDescription
removedCacheRemoval[] ou nullouiCe qui a été supprimé.
heldOpenCacheRemoval[] ou nullouiCe que l’élagage aurait supprimé mais a laissé en place parce qu’un autre processus l’avait ouvert. Seul Windows refuse de supprimer un fichier ouvert, de sorte que partout ailleurs ceci est vide. Ces entrées ne sont comptées ni comme supprimées ni comme conservées, aucun de leurs octets ne compte comme récupéré, et un élagage ultérieur les récupère ; une entrée qui est un répertoire peut avoir déjà perdu les fichiers qu’elle contenait et qui n’étaient pas ouverts.
retainedCountintegerouiLe nombre d’entrées conservées.
reclaimedBytesintegerouiLe nombre d’octets récupérés.
reclaimedBytesTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
unattributedCountintegerouiLe nombre d’entrées qu’aucun détenteur ne revendique.
unattributedSizeintegerouiLe nombre d’octets que celles-ci occupent.
unattributedSizeTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
notPruneEligibleCacheShortfall[] ou nullouiCe qui a été laissé derrière, et ce qui le récupérerait.
scopeCacheScopeouiJusqu’où porte une réponse sur le cache. Deux des classes de cache sont partagées par tous les projets de la machine, de sorte que chaque réponse sur le cache nomme celles qu’elle a touchées — sinon, une session ouverte sur un espace de travail serait lue comme ne rendant compte que de cet espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

CacheEvictResult

Ce que la récupération d’espace jusqu’à une taille a supprimé, et ce qui reste.

PropriétéTypeObligatoireDescription
withinCapBeforebooléenouiIndique si ce qui était conservé tenait déjà sous la taille, de sorte que rien n’a eu besoin d’être supprimé.
removedCacheRemoval[] ou nullouiCe qui a été supprimé.
heldOpenCacheRemoval[] ou nullouiCe que la récupération d’espace aurait supprimé mais a laissé en place parce qu’un autre processus l’avait ouvert ; elle est passée à la place à l’entrée suivante la plus ancienne. Seul Windows refuse de supprimer un fichier ouvert, de sorte que partout ailleurs ceci est vide. Ces entrées comptent toujours dans les octets qui restent, et une récupération d’espace ultérieure peut les supprimer.
totalBeforeintegerouiLe nombre d’octets conservés auparavant.
totalBeforeTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
reclaimedBytesintegerouiLe nombre d’octets récupérés.
reclaimedBytesTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
remainingBytesintegerouiLe nombre d’octets qui restent.
remainingBytesTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
capBytesintegerouiLa taille jusqu’à laquelle l’espace a été récupéré, en octets.
capBytesTextstringouiLa même taille écrite de la manière dont une personne la lit.
scopeCacheScopeouiJusqu’où porte une réponse sur le cache. Deux des classes de cache sont partagées par tous les projets de la machine, de sorte que chaque réponse sur le cache nomme celles qu’elle a touchées — sinon, une session ouverte sur un espace de travail serait lue comme ne rendant compte que de cet espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

CacheClearResult

Ce que le vidage des caches a récupéré.

PropriétéTypeObligatoireDescription
clearedCacheCleared[] ou nullouiChaque cache qui a été vidé.
reclaimedBytesintegerouiLe nombre d’octets récupérés.
reclaimedBytesTextstringouiLe même chiffre écrit de la manière dont une personne le lit.
scopeCacheScopeouiJusqu’où porte une réponse sur le cache. Deux des classes de cache sont partagées par tous les projets de la machine, de sorte que chaque réponse sur le cache nomme celles qu’elle a touchées — sinon, une session ouverte sur un espace de travail serait lue comme ne rendant compte que de cet espace de travail.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryListResult

Les registres au moyen desquels résout cet espace de travail.

PropriétéTypeObligatoireDescription
registriesRegistry[] ou nullouiChaque registre configuré.
credentialStateIsMachineWidebooléenouiIndique si la présence d’identifiants de connexion signalée pour chaque registre est un fait à l’échelle de toute la machine plutôt qu’un fait de l’espace de travail. Il est signalé afin qu’une réponse limitée à la session ne soit pas lue comme niant la portée plus large.

Les propriétés supplémentaires ne sont pas autorisées.

SearchResult

Ce que les index locaux des registres ont proposé pour la recherche.

PropriétéTypeObligatoireDescription
recordsRegistrySearchRecord[] ou nullouiLes enregistrements qui ont correspondu.
indexesRegistrySearchIndex[] ou nullouiChaque hôte interrogé et le moment où son index a été rafraîchi pour la dernière fois.
missingIndexHostsstring[] ou nullouiLes hôtes configurés sans index local à interroger, de sorte qu’une réponse courte est expliquée plutôt que laissée à déduire.
stalebooléenouiIndique si un index interrogé est assez ancien pour qu’il vaille la peine de le rafraîchir.
registriesConfiguredbooléenouiIndique si au moins un registre est configuré, ce qui distingue « rien n’a correspondu » de « rien n’a été interrogé ».

Les propriétés supplémentaires ne sont pas autorisées.

RegistryAddResult

Ce que l’enregistrement d’un registre a écrit, où, et ce qu’il a lu depuis le registre lui-même.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte sous lequel l’entrée est indexée, qui n’est pas toujours la graphie qu’a utilisée la requête.
scopeConfigWriteScopeouiQuel document de configuration a été écrit et jusqu’où il porte. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour une écriture à l’échelle de toute la machine, cette lecture est fausse.
trustTrustFetchOutcomeouiCe qu’a donné la lecture de la politique de confiance annoncée par un registre. Les résultats sont tenus séparés parce qu’ils signifient des choses différentes : la politique annoncée a été adoptée, le registre n’a rien annoncé — ce qui n’est pas un échec —, la base de référence intégrée a été épinglée à sa place, ou aucune lecture n’a été tentée. Lorsque rien n’a été annoncé, il est indiqué à côté si le registre a pu être atteint ou non.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryRemoveResult

Ce que la suppression d’un registre a écrit, et où.

PropriétéTypeObligatoireDescription
hoststringouiL’hôte dont l’entrée a été supprimée.
scopeConfigWriteScopeouiQuel document de configuration a été écrit et jusqu’où il porte. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour une écriture à l’échelle de toute la machine, cette lecture est fausse.

Les propriétés supplémentaires ne sont pas autorisées.

RegistryUpdateResult

Ce que le rafraîchissement des index locaux a fait, par hôte.

PropriétéTypeObligatoireDescription
hostsHostUpdate[] ou nullouiCe que le rafraîchissement a fait pour chaque hôte.
failedstring[] ou nullouiLes hôtes pour lesquels le rafraîchissement n’a pas pu aboutir.
indexRootstringouiLe répertoire sous lequel les index ont été écrits.
registriesConfiguredbooléenouiIndique si au moins un registre est configuré.
reachedRegistriesbooléenouiToujours true sur cette réponse : le rafraîchissement des index s’adresse aux registres eux-mêmes, alors que leur listage et la recherche répondent à partir de la configuration et d’un index local. Le fait qu’un registre donné ait effectivement été atteint est indiqué dans sa propre entrée dans hosts, par unreachable.

Les propriétés supplémentaires ne sont pas autorisées.

LogoutResult

Quel identifiant de connexion stocké a été supprimé, et jusqu’où porte le magasin.

PropriétéTypeObligatoireDescription
registrystringouiLe registre dont l’identifiant de connexion a été supprimé.
scopeCredentialStoreScopeouiJusqu’où porte une modification d’identifiant de connexion. Le magasin est partagé par chaque projet de la machine et par tout autre outil qui s’adresse aux mêmes registres, de sorte que la réponse le signale plutôt que de laisser déduire une lecture limitée à la session.

Les propriétés supplémentaires ne sont pas autorisées.

PublishEntityResult

Ce qu’a déposé la publication d’une entité, et où. Une publication qui a d’abord exécuté l’étape d’épinglage porte aussi ce que cette étape a fait, sous la forme de pin, qui est absent lorsque l’étape ne s’est pas exécutée.

PropriétéTypeObligatoireDescription
referencestringouiLa référence sous laquelle l’entité a été publiée.
tagstringouiLe tag sous lequel elle a été publiée.
kindstringouiLe type d’entité qui a été publié.
mediaTypestringouiLe type de média enregistré pour les octets publiés.
sizeintegerouiCombien d’octets ont été publiés.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.
pluginSizeintegernonCombien d’octets occupe le module de plugin publié avec une entité Plugin.
pluginSizeTextstringnonLa même taille écrite de la manière dont une personne la lit.
digeststringouiLe digest de ce qui a été publié. Lors d’une exécution à blanc, le digest qu’une publication du même contenu déposerait, calculé à partir du seul contenu : celui qu’affiche aggrega push --dry-run.
signedbooléenouiIndique si cette publication a attaché une signature : celle qu’elle a créée avant de publier ou, sur une version déjà publiée, une signature qui manquait à la version.
alreadyPublishedbooléenouiIndique si les mêmes octets étaient déjà présents, de sorte qu’aucun contenu n’a été téléversé. Seul ce qui manquait encore à cette publication-là a été attaché à côté : sa date de publication et, lorsque cette publication signe, sa signature ; signed indique si une signature a été attachée.
dryRunbooléenouiIndique si ceci rend compte de ce que la publication aurait déposé plutôt que de ce qu’elle a déposé.
reachPublicationReachouiJusqu’où une publication a porté. Ces réponses portent entièrement au-delà de cette machine — ce qu’elles attachent est ce que résout chaque consommateur de ce registre — de sorte que chacune nomme chaque registre auquel elle s’est adressée et indique si l’appel y a attaché quoi que ce soit.
pinPinResultnonCe que l’étape d’épinglage a fait au verrou situé à côté d’une entité, ou ferait lors d’une exécution à blanc. C’est la réponse à aggrega/pin, et une publication qui a exécuté l’étape la porte comme son pin.
wholeDirectorySourcestringnonLa source locale de l’entité telle qu’écrite, présente lorsqu’elle est écrite sous forme de template. Une telle source ne nomme son répertoire qu’une fois qu’une Release remplit le template, de sorte que la publication porte chaque fichier du répertoire de l’entité plutôt que seulement les fichiers que nomme l’entité. Absent lorsqu’elle ne porte que ces fichiers.
windowsUnusableEntriesstring[]nonLes entrées de l’archive publiée dont le chemin contient une partie que Windows ne peut pas contenir telle qu’écrite — un nom que Windows réserve à un périphérique, comme CON, AUX ou NUL, quelle que soit la casse et quelle que soit l’extension qui suit, ou une partie se terminant par un point ou une espace —, le nom de fichier propre au document de l’entité en premier, puis les fichiers qu’il porte. Un espace de travail sous Windows refuse de les décompresser, et ne peut donc pas utiliser la version ; la publication se poursuit ou s’arrête exactement comme elle le ferait sans elles. Absent lorsqu’il n’y en a aucune, ce qui inclut une entité publiée sous la forme de son seul document.

Les propriétés supplémentaires ne sont pas autorisées.

PublishArtifactResult

Ce qu’a déposé la publication d’un fichier, et où.

PropriétéTypeObligatoireDescription
referencestringouiLa référence sous laquelle le fichier a été publié.
tagstringouiLe tag sous lequel elle a été publiée.
mediaTypestringouiLe type de média enregistré pour les octets publiés.
sizeintegerouiCombien d’octets ont été publiés.
sizeTextstringouiLa même taille écrite de la manière dont une personne la lit.
digeststringouiLe digest de ce qui a été publié.
alreadyPublishedbooléenouiIndique si les mêmes octets étaient déjà présents, de sorte qu’aucun contenu n’a été téléversé. Une date de publication a été attachée à côté seulement lorsque l’artefact n’en avait pas.
dryRunbooléenouiIndique si ceci rend compte de ce que la publication aurait déposé plutôt que de ce qu’elle a déposé.
reachPublicationReachouiJusqu’où une publication a porté. Ces réponses portent entièrement au-delà de cette machine — ce qu’elles attachent est ce que résout chaque consommateur de ce registre — de sorte que chacune nomme chaque registre auquel elle s’est adressée et indique si l’appel y a attaché quoi que ce soit.

Les propriétés supplémentaires ne sont pas autorisées.

SignArtifactsResult

Ce qui a été signé, et où les signatures ont été déposées.

PropriétéTypeObligatoireDescription
signedSignedArtifact[] ou nullouiChaque référence qui a été signée.
reachPublicationReachouiJusqu’où une publication a porté. Ces réponses portent entièrement au-delà de cette machine — ce qu’elles attachent est ce que résout chaque consommateur de ce registre — de sorte que chacune nomme chaque registre auquel elle s’est adressée et indique si l’appel y a attaché quoi que ce soit.

Les propriétés supplémentaires ne sont pas autorisées.

DeprecateArtifactResult

Ce qui a été marqué comme déprécié, et où les marqueurs ont été déposés.

PropriétéTypeObligatoireDescription
markedDeprecationMarked[] ou nullouiChaque version qui a été marquée.
reachPublicationReachouiJusqu’où une publication a porté. Ces réponses portent entièrement au-delà de cette machine — ce qu’elles attachent est ce que résout chaque consommateur de ce registre — de sorte que chacune nomme chaque registre auquel elle s’est adressée et indique si l’appel y a attaché quoi que ce soit.

Les propriétés supplémentaires ne sont pas autorisées.

ResolveResult

Où est défini l’élément sous le curseur.

PropriétéTypeObligatoireDescription
locationnull ou LocationouiOù il est défini. Il vaut null lorsque rien sous le curseur ne se résout vers une définition.

Les propriétés supplémentaires ne sont pas autorisées.

FindReferencesResult

Où il est fait référence à l’élément sous le curseur.

PropriétéTypeObligatoireDescription
locationsLocation[] ou nullouiChaque endroit où il y est fait référence.

Les propriétés supplémentaires ne sont pas autorisées.

FindImplementationsResult

Quels documents implémentent l’élément sous le curseur.

PropriétéTypeObligatoireDescription
locationsLocation[] ou nullouiChaque endroit où il est implémenté.

Les propriétés supplémentaires ne sont pas autorisées.

HoverResult

Ce qu’il faut afficher à propos de l’élément sous le curseur.

PropriétéTypeObligatoireDescription
contentsnull ou MarkupContentouiCe qu’il faut afficher. Il vaut null lorsqu’il n’y a rien à dire sur ce qui se trouve sous le curseur.

Les propriétés supplémentaires ne sont pas autorisées.

CompletionResult

Ce qui peut être écrit à l’emplacement du curseur.

PropriétéTypeObligatoireDescription
itemsCompletionItem[] ou nullouiChaque élément qui peut être écrit.

Les propriétés supplémentaires ne sont pas autorisées.

CatalogIndexResult

Chaque entité que contient l’index de l’espace de travail, et les liens menant hors de l’espace de travail, vers des répertoires et vers des fichiers, qui n’ont pas été lus pour lui.

PropriétéTypeObligatoireDescription
entitiesCatalogEntity[] ou nullouiChaque entité.
unreadLinkedDirsstring[]ouiChaque lien sous la racine de l’espace de travail qui mène à un répertoire situé hors de celle-ci, nommé relativement à la racine à l’endroit où se trouve le lien lui-même, dans l’ordre dans lequel l’espace de travail est parcouru. Aucun répertoire hors de la racine n’est parcouru, de sorte qu’aucun document derrière l’un de ces liens ne figure parmi entities comme propre à l’espace de travail, et un client qui liste les entités peut dire pourquoi. Non nommés : un lien vers un répertoire situé à l’intérieur de la racine, qui est parcouru, ou laissé de côté, là où il se trouve réellement ; un lien partout où un répertoire serait laissé de côté, que ce soit en raison de l’endroit où il se trouve, de son nom ou d’un .gitignore ; un lien qui ne peut pas être résolu, parce qu’il ne mène nulle part ou tourne en boucle ; et, dans une réponse donnée dans les termes d’une Release, un lien situé sous un répertoire de catalogue que seules d’autres Releases lisent. Vide lorsque l’espace de travail n’en contient aucun.
unreadLinkedFilesstring[]ouiChaque lien sous la racine de l’espace de travail qui est nommé comme un fichier YAML, son propre nom se terminant par .yaml ou .yml, et qui mène à un fichier situé hors de la racine, nommé relativement à la racine à l’endroit où se trouve le lien lui-même, dans l’ordre dans lequel l’espace de travail est parcouru. Un tel fichier n’est pas lu pour l’index, quoi qu’il déclare, de sorte que l’entité qu’il déclare ne figure pas parmi entities comme propre à l’espace de travail, et un client qui liste les entités peut dire pourquoi ; les répertoires de catalogue configurés sont le moyen par lequel les entités situées hors de l’espace de travail sont lues. Non nommés : un lien vers un fichier que la configuration de l’espace de travail nomme comme Release, comme build.authoring_release ou comme clé de workspace.releases, et qui en déclare une, lequel est lu et listé dans entities à l’endroit propre au lien ; un lien vers un fichier situé à l’intérieur de la racine, qui est lu à l’endroit propre au lien ; un lien qu’un .gitignore laisse de côté, ou un lien situé dans un répertoire que la recherche laisse de côté ; un lien qui ne mène à aucun fichier, que ce soit vers un répertoire, que nomme unreadLinkedDirs lorsqu’il mène hors de la racine, nulle part, ou en boucle ; et, dans une réponse donnée dans les termes d’une Release, un lien situé sous un répertoire de catalogue que seules d’autres Releases lisent. Un fichier de configuration de l’espace de travail qui est un lien menant hors de l’espace de travail, son propre .aggrega-config.yaml ou l’overlay détenu par la CI à côté de lui, est nommé que la recherche l’ait rencontré ou non, après les liens que la recherche a nommés : la configuration de l’espace de travail n’est alors pas lue du tout, cette réponse est l’index propre à l’espace de travail lu sans rien de configuré, de sorte qu’aucun répertoire de catalogue n’est lu pour lui, et chaque requête que décide la configuration, un index dans les termes d’une Release compris, est refusée pour cet espace de travail avec la condition du blocage de lecture.

Les propriétés supplémentaires ne sont pas autorisées.

AttachCandidatesResult

Quelles Features peuvent être rattachées à l’entité, et les étiquettes d’après lesquelles elles ont été jugées ; et, pour une connexion que la requête a nommée, les slots que déclare son socket avec les Features qui peuvent remplir chacun d’eux.

PropriétéTypeObligatoireDescription
nodestringouiL’entité pour laquelle les candidats ont été jugés.
nodeLabelsmap de string ou nullouiLes étiquettes d’après lesquelles le jugement a été rendu.
labelSourcestringouiQuel ensemble d’étiquettes a été utilisé, ce qui n’est pas anodin : les étiquettes déclarées d’un document sont ce qu’une lecture de la source peut voir, tandis que celles d’un nœud du graphe sont l’ensemble finalisé d’après lequel le build lui-même juge. Une réponse calculée sur le second est une affirmation sur ce que fera le build.
candidatesSourcedEntityRef[] ou nullouiChaque Feature qui peut être rattachée.
slotsSlotCandidacy[]nonPrésent uniquement lorsque la requête a nommé une connexion : chaque slot que déclare le socket de la connexion, dans l’ordre dans lequel le Component les déclare, avec les Features qui peuvent le remplir. Vide lorsqu’aucun slot ne peut être rempli sur la connexion, et noSlotReason dit alors pourquoi — ce qu’un client lit plutôt que de prendre une liste vide pour des slots auxquels aucune Feature ne correspondait.
noSlotReasonconst “feature-created-connection” ou const “ad-hoc-socket” ou const “no-slot-declared”nonPrésent uniquement lorsque la requête a nommé une connexion et qu’aucun slot ne peut y être rempli : pourquoi rien ne peut s’y rattacher. Absent partout où le socket déclare un slot. L’ensemble est fermé. Valeurs autorisées : "feature-created-connection" — Une Feature a tracé la connexion, et un rattachement n’est écrit que sur une connexion que trace un composant ou la Release. "ad-hoc-socket" — Le socket est un socket que le Component ne déclare pas, de sorte qu’il ne déclare aucun slot qu’une connexion puisse remplir. "no-slot-declared" — Le Component déclare le socket et ne déclare aucun slot sur celui-ci.

Les propriétés supplémentaires ne sont pas autorisées.

ConnectionCandidatesResult

À quelles entités chaque socket de l’entité peut être relié.

PropriétéTypeObligatoireDescription
nodestringouiL’entité dont ce sont les sockets.
adHocSocketsAcceptedbooléenouiIndique si un socket que la définition propre de l’entité ne déclare pas à l’avance peut tout de même être écrit.
socketsSocketCandidacy[] ou nullouiChaque socket et ce qui peut y être relié.

Les propriétés supplémentaires ne sont pas autorisées.

InsertionPointResult

Où, dans le document, se place une nouvelle entrée sous le conteneur nommé, et ce dont un client a besoin pour l’y écrire : le point lui-même, si un saut de ligne doit ouvrir le texte, les clés de conteneur encore manquantes, et l’indentation que prend chaque ligne.

PropriétéTypeObligatoireDescription
filestringouiLe document.
containerstring[] ou nullouiLe chemin à travers le document jusqu’au conteneur.
positionEncodingstringouiL’encodage dans lequel sont exprimées les positions de cette réponse.
positionPositionouiUn endroit dans un document : une ligne et un décalage de caractère dans celle-ci, tous deux comptés à partir de zéro. Le décalage est mesuré dans les unités de l’encodage dont la session a convenu à son ouverture, qui est UTF-16 sauf si le client en a demandé un autre.
precededByLineBreakbooléenouiIndique si le texte écrit à la position doit commencer par un saut de ligne, parce que la position se trouve à la fin d’une ligne que le document contient déjà. Il ne vaut false que lorsque le document ne contient rien que l’entrée puisse suivre.
missingContainerKeysstring[] ou nullouiLes segments du chemin du conteneur que le document ne contient pas encore, le plus externe en premier. Chacun doit être écrit comme une clé à part entière, indenté d’un cran de plus que le précédent, avant que l’entrée puisse aller à l’intérieur du plus interne. Il vaut null lorsque le chemin entier est déjà présent.
entryIndentintegerouiLa colonne à laquelle commence la première ligne propre de l’entrée, comptée en espaces depuis le début de la ligne.
indentStepintegerouiDe combien chaque niveau d’imbrication est indenté en plus.
indentStepMeasuredbooléenouiIndique si le pas a été mesuré d’après l’imbrication propre de ce document. Lorsqu’il vaut false, le document ne présente aucune imbrication à mesurer et le pas est une valeur de repli, de sorte qu’un client qui préférerait imposer le sien sait qu’il est libre de le faire.
entryShapeconst “mapping” ou const “sequence” ou const “unknown”ouiLa forme sous laquelle le conteneur porte ses entrées, ce qui décide de la façon dont le texte propre de l’entrée est composé. Elle est lue sur le conteneur que le document contient déjà et n’est jamais déduite du nom du conteneur. L’ensemble est fermé. Valeurs autorisées : "mapping" — Le conteneur est un mapping de bloc, de sorte qu’une entrée qui lui est ajoutée est une clé et sa valeur. "sequence" — Le conteneur est une séquence de bloc, de sorte qu’une entrée qui lui est ajoutée est un tiret et sa valeur. "unknown" — Le document ne contient pas le conteneur, ou le contient sans rien à l’intérieur, de sorte qu’il revient au client de décider quelle forme prend une entrée.

Les propriétés supplémentaires ne sont pas autorisées.

AttachmentContainerResult

Dans quel document, et à quel endroit de celui-ci, se place un rattachement sur le nœud du graphe, ou sur la connexion que la requête a nommée.

PropriétéTypeObligatoireDescription
nodestringouiLe nœud du graphe auquel le rattachement est destiné.
filestringouiLe document dans lequel se place le rattachement.
containerstring[] ou nullouiLe chemin à travers ce document jusqu’à l’endroit où il se place.

Les propriétés supplémentaires ne sont pas autorisées.

ConnectionAtPositionResult

La connexion dans l’entrée de laquelle tombe la position, ou pourquoi aucune n’est signalée. Exactement une moitié est présente : graphNode et connection ensemble, ou noConnectionReason seul. Une position n’importe où à l’intérieur d’une entrée — sur son alias, sa cible ou ses rattachements — est à l’intérieur de cette entrée, la plus interne là où des entrées s’imbriquent ; une position sur la clé propre d’un socket, au-dessus des entrées écrites sous celle-ci, n’est à l’intérieur d’aucune.

PropriétéTypeObligatoireDescription
graphNodestringnonL’id du nœud dont le composant trace la connexion, tel que le graphe compilé l’indexe — la valeur que les requêtes de candidature et de conteneur prennent comme graphNode.
connectionConnectionCoordinatenonLa connexion, par son socket et son alias, avec document nommant le document dans lequel la position a été lue — la valeur que les requêtes de candidature et de conteneur prennent comme connection.
noConnectionReasonconst “no-connection-entry” ou const “feature-created-connection” ou const “unknown-connection”nonPrésent uniquement lorsqu’aucune connexion n’est signalée : pourquoi. L’ensemble est fermé. Valeurs autorisées : "no-connection-entry" — La position ne se trouve sur aucune entrée dans laquelle un rattachement est écrit : ni une connexion que trace un composant, écrite sous son alias, ni une entrée par arête dans la Release. Une connexion écrite sous forme de liste de cibles, et une connexion que trace le bloc propre d’une Feature, ne portent aucune entrée de ce genre. "feature-created-connection" — La position se trouve sur l’entrée de la Release pour une connexion qu’une Feature a tracée, et un rattachement n’est écrit que sur une connexion que trace un composant ou la Release. "unknown-connection" — La position se trouve sur une entrée qu’écrit la Release pour une connexion que le graphe compilé ne contient pas.

Les propriétés supplémentaires ne sont pas autorisées.

ReleaseCandidatesResult

Les Releases que contient l’espace de travail, et les liens menant hors de celui-ci, vers des répertoires et vers des fichiers, qui n’ont pas été lus pour elles.

PropriétéTypeObligatoireDescription
releasesstring[] ou nullouiChaque document de Release.
lockfilesmap de stringouiLe fichier de verrouillage de chaque Release listée, indexé par la Release exactement telle qu’elle est listée. Chacun est le fichier qu’un pull écrit pour cette Release et qu’un build lit, de sorte qu’un client lit l’endroit où il se trouve plutôt que de le déduire. Vide lorsque l’espace de travail ne contient aucune Release.
unreadLinkedDirsstring[]ouiChaque lien sous la racine de l’espace de travail qui mène à un répertoire situé hors de celle-ci, nommé relativement à la racine à l’endroit où se trouve le lien lui-même, dans l’ordre dans lequel l’espace de travail est parcouru. Aucun répertoire hors de la racine n’est parcouru, de sorte qu’une Release atteinte uniquement par l’un de ces liens ne figure pas dans releases, et un client qui propose des Releases peut dire pourquoi. Non nommés : un lien vers un répertoire situé à l’intérieur de la racine, qui est parcouru, ou laissé de côté, là où il se trouve réellement ; un lien partout où un répertoire serait laissé de côté, que ce soit en raison de l’endroit où il se trouve ou de son nom ; et un lien qui ne peut pas être résolu, parce qu’il ne mène nulle part ou tourne en boucle. Vide lorsque l’espace de travail n’en contient aucun.
unreadLinkedFilesstring[]ouiChaque lien sous la racine de l’espace de travail qui est nommé comme un fichier YAML, son propre nom se terminant par .yaml ou .yml, et qui mène à un fichier situé hors de la racine, nommé relativement à la racine à l’endroit où se trouve le lien lui-même, dans l’ordre dans lequel l’espace de travail est parcouru. Un tel fichier n’est pas lu, de sorte qu’une Release atteinte uniquement par l’un de ces liens ne figure pas dans releases, et un client qui propose des Releases peut dire pourquoi. Le fait qu’un fichier soit une Release n’est pas connu sans le lire, de sorte que chacun de ces liens est nommé quel que soit le contenu du fichier. Non nommés : un lien vers un fichier que la configuration de l’espace de travail nomme comme Release, comme build.authoring_release ou comme clé de workspace.releases, lequel est lu et listé dans releases à l’endroit propre au lien ; un lien vers un fichier situé à l’intérieur de la racine, qui est lu ; un lien situé dans un répertoire que la recherche laisse de côté ; et un lien qui ne mène à aucun fichier, que ce soit vers un répertoire, que nomme unreadLinkedDirs lorsqu’il mène hors de la racine, nulle part, ou en boucle. Un fichier de configuration de l’espace de travail qui est un lien menant hors de l’espace de travail, son propre .aggrega-config.yaml ou l’overlay détenu par la CI à côté de lui, est nommé que la recherche l’ait rencontré ou non, après les liens que la recherche a nommés : la configuration de l’espace de travail n’est alors pas lue du tout, cette réponse est lue sans rien de configuré, de sorte qu’aucune Release que la configuration nomme par un lien n’est listée, et chaque requête que décide la configuration est refusée pour cet espace de travail avec la condition du blocage de lecture.

Les propriétés supplémentaires ne sont pas autorisées.

ActiveReleaseResult

Sur quelle Release un client devrait agir par défaut. Un espace de travail qui ne pointe vers aucune Release est un état ordinaire plutôt qu’un échec, de sorte qu’il est signalé ici avec un compte rendu de la manière dont le choix a été tenté plutôt que levé comme une erreur.

PropriétéTypeObligatoireDescription
releasestringouiLa Release sur laquelle le choix s’est arrêté, ou vide lorsqu’il ne s’est arrêté sur aucune.
lockfilestringnonLe fichier de verrouillage de la Release sur laquelle le choix s’est arrêté : le fichier qu’un pull écrit pour elle et qu’un build lit. Absent lorsque le choix ne s’est arrêté sur aucune Release.
reasonstringnonPourquoi le choix ne s’est arrêté sur aucune Release.
tracestringnonChaque étape du choix et ce qu’elle a trouvé, de sorte qu’un appelant peut voir laquelle l’aurait tranché.

Les propriétés supplémentaires ne sont pas autorisées.

EditDocumentResult

Ce qu’a écrit la modification, et où. Après une écriture, la lecture du document que détient le daemon est abandonnée, de sorte que la prochaine réponse le concernant est calculée à partir des octets que la modification a produits.

PropriétéTypeObligatoireDescription
filestringouiLe document qui a été modifié.
editstringouiQuelle modification a été appliquée.
containerstring[] ou nullouiLe chemin à travers le document jusqu’à l’endroit où la modification a abouti.
createdContainersstring[] ou nullouiLes conteneurs que la modification a dû créer en chemin.
writtenstring[] ou nullouiLes documents qui ont été écrits.
contentstringouiLe document composé, pour une requête qui a demandé à voir le résultat plutôt qu’à le faire écrire.

Les propriétés supplémentaires ne sont pas autorisées.

EffectiveConfigurationResult

La configuration que l’espace de travail a résolue, et le document dont provient chaque réglage.

PropriétéTypeObligatoireDescription
layersstring[] ou nullouiLes documents de configuration qui ont été fusionnés, dans l’ordre dans lequel ils ont été fusionnés.
settingsEffectiveConfigurationSetting[] ou nullouiChaque réglage résolu et sa provenance.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigInitResult

Ce qu’a écrit l’initialisation d’une configuration, où, et ce qu’elle a lu dans le registre.

PropriétéTypeObligatoireDescription
hoststringouiLe registre pour lequel la configuration a été initialisée.
scopeConfigWriteScopeouiQuel document de configuration a été écrit et jusqu’où il porte. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour une écriture à l’échelle de toute la machine, cette lecture est fausse.
trustTrustFetchOutcomeouiCe qu’a donné la lecture de la politique de confiance annoncée par un registre. Les résultats sont tenus séparés parce qu’ils signifient des choses différentes : la politique annoncée a été adoptée, le registre n’a rien annoncé — ce qui n’est pas un échec —, la base de référence intégrée a été épinglée à sa place, ou aucune lecture n’a été tentée. Lorsque rien n’a été annoncé, il est indiqué à côté si le registre a pu être atteint ou non.
writtenbooléenouiIndique si le document a été écrit, par opposition à renvoyé pour que l’appelant le place.
existedbooléennonPrésent et vaut true lorsque le document était déjà là, de sorte que l’entrée de registre y a été fusionnée plutôt qu’un nouveau document soit créé. Seule une requête envoyant force poursuit sur un document existant, de sorte qu’il est absent de toute réponse à une requête qui ne l’a pas fait.
contentstringnonLe texte du document, pour une requête qui a demandé à le voir plutôt qu’à le faire écrire.

Les propriétés supplémentaires ne sont pas autorisées.

ConfigCaptureResult

Ce que le figement de la configuration résolue a écrit dans le document propre de cet espace de travail.

PropriétéTypeObligatoireDescription
configFilestringouiLe document qui a été écrit. C’est toujours celui de cet espace de travail, puisque tout l’objet est de rendre un espace de travail autonome.
workspaceRootstringouiL’espace de travail que la requête a nommé.
capturedbooléenouiIndique si quoi que ce soit a été figé.
socketsConfigCapturedSocket[] ou nullouiChaque socket qui a été figé, avec ses rattachements.
catalogDirsstring[] ou nullouiLes répertoires de catalogue qui ont été figés.

Les propriétés supplémentaires ne sont pas autorisées.

ImportResult

Ce qu’a produit la conversion d’une source étrangère, et ce qu’elle n’a pas pu convertir.

PropriétéTypeObligatoireDescription
formatstringouiLe format source qui a été converti.
outputDirstringouiLe répertoire auquel chaque chemin de la réponse est relatif, et celui dans lequel les fichiers ont été écrits.
writtenstring[] ou nullouiChaque fichier qui a atteint le disque, dans l’ordre d’écriture : les brouillons, puis l’enregistrement de ce que l’import a écrit. Sous sync, uniquement les brouillons que la synchronisation a modifiés et l’enregistrement lorsqu’il a changé. Vide sous dryRun.
filesImportedFile[] ou nullouiChaque fichier que la requête écrit, avec son texte, sous dryRun et sans : chaque brouillon, puis l’enregistrement de ce que l’import a écrit. Sous sync, chaque brouillon que la synchronisation modifie, avec son nouveau texte, puis l’enregistrement lorsqu’il change aussi, de sorte qu’une synchronisation déjà à jour répond par une liste vide.
driftImportDrift[]ouiChaque partie qu’une synchronisation a mise à jour par rapport à la source, ou mettrait à jour sous dryRun, dans l’ordre dans lequel le brouillon les nomme ; un fichier rédigé que la synchronisation supprime en fait partie, retiré sans clés. Une liste vide pour une requête qui n’est pas une synchronisation, pour une synchronisation déjà à jour, et pour une synchronisation dont la conversion s’est arrêtée, qui n’écrit rien.
diagnosticsImportDiagnostic[] ou nullouiCe qui n’a pas pu être converti.
decisionsImportDecision[]ouiLa façon dont l’importateur a associé chaque nœud source, dans l’ordre de l’importateur et exactement tel qu’il l’a signalé : ce qui vous indique où la conversion a deviné. Présent avec les deux modes de livraison, que la conversion se soit arrêtée ou non, et une liste vide pour un importateur qui n’en signale aucune.
owedImportOwed[]nonChaque valeur que les ébauches laissent encore vide, qu’aucune source n’a pu fournir et qu’aucune réponse n’a fournie, dans l’ordre où les ébauches sont écrites — les valeurs que nomment les constats d’avertissement. Chaque réponse le contient, sous forme de liste vide lorsque les ébauches ne doivent rien.
haltedbooléenouiIndique si la conversion s’est arrêtée plutôt que de se terminer avec des constats.

Les propriétés supplémentaires ne sont pas autorisées.

ScaffoldEntityResult

Le document de départ rédigé, la liste des exemples exécutables, ou l’exemple écrit — chaque forme répondant avec ses propres champs et laissant les autres absents.

PropriétéTypeObligatoireDescription
kindstringnonLe type d’entité qui a été rédigé. Présent sur un brouillon.
skeletonstringnonLe texte du document rédigé. Présent sur un brouillon.
examplesScaffoldExample[]nonChaque exemple exécutable que publie la documentation, chacun une fois, dans l’ordre des noms. Présent sur une liste qui en a trouvé.
examplestringnonL’exemple qui a été écrit. Présent sur une écriture.
dirstringnonLe répertoire dans lequel l’exemple a été écrit, relatif à la racine de l’espace de travail, tel que la requête l’a nommé ou, lorsqu’elle n’en a nommé aucun, comme le nom de l’exemple. Présent sur une écriture.
filesstring[]nonChaque fichier écrit, relatif à dir et séparé par des barres obliques, dans l’ordre dans lequel la documentation les présente. Présent sur une écriture.
nextstring[]nonLes commandes que la page de l’exemple donne pour le construire, ligne par ligne telles que la page les écrit, commentaires compris : le premier bloc shell sous son titre Build. Absent lorsque la page n’en donne aucune.
versionstringnonLa version de la documentation à partir de laquelle l’exemple a été lu : celle du binaire lorsqu’une version est publiée pour lui, sinon la plus récente publiée avant lui. Présent sur une écriture.

Les propriétés supplémentaires ne sont pas autorisées.

ScaffoldExample

Un exemple exécutable que publie la documentation.

PropriétéTypeObligatoireDescription
namestringouiLe nom de l’exemple, qu’une requête envoie comme example pour l’écrire.
levelstringouiLe niveau que la page de l’exemple déclare pour lui.
summarystringouiLa première phrase de la page de l’exemple.

Les propriétés supplémentaires ne sont pas autorisées.

LintResult

Ce qu’a trouvé la vérification des conventions, compté par gravité et listé par document. Une vérification de tout le catalogue exécutée une fois pour chaque Release porte aussi passes ; les décomptes et files couvrent alors toutes les passes ensemble.

PropriétéTypeObligatoireDescription
entitystringnonL’unique entité qui a été vérifiée, lorsque la requête en a nommé une.
releasestringnonLa Release dont la fermeture a été vérifiée, lorsque la requête en a nommé une.
checkedintegerouiLe nombre de documents vérifiés. Lorsque la vérification a été exécutée une fois pour chaque Release, la somme sur les passes : un document que lisent deux passes est compté dans chacune.
findingsintegerouiLe nombre total de constats.
errorsintegerouiCombien d’entre eux sont des erreurs.
warningsintegerouiCombien d’entre eux sont des avertissements.
infosintegerouiCombien d’entre eux sont informatifs.
filesLintFileFindings[] ou nullouiLes constats, par document.
haltedbooléenouiIndique si la vérification s’est arrêtée plutôt que de se terminer avec des constats.
passesLintPass[] ou nullnonLa vérification de tout le catalogue une passe à la fois, présente uniquement lorsqu’elle a été exécutée une fois pour chaque Release parce que l’espace de travail nomme des Releases sous workspace.releases. Chaque passe indique pour quelles Releases ses constats ont été trouvés. Absente pour un espace de travail qui n’en nomme aucune, lequel est vérifié une fois sur ses propres répertoires, et pour une vérification d’une seule entité ou de la fermeture d’une Release.

Les propriétés supplémentaires ne sont pas autorisées.

LintPass

Une passe d’une vérification des conventions de tout le catalogue dans un espace de travail qui donne à ses Releases des répertoires de catalogue qui leur sont propres : les Releases pour lesquelles elle a été exécutée, les répertoires qu’elle a lus, et ce qu’elle y a trouvé.

PropriétéTypeObligatoireDescription
releasesstring[] ou nullouiLes Releases pour lesquelles la passe a été exécutée, chacune sous la forme d’un chemin relatif à la racine de l’espace de travail. Les Releases qui lisent les mêmes répertoires de catalogue partagent une passe.
catalogDirsstring[] ou nullouiLes répertoires de catalogue que la passe a lus, dans l’ordre dans lequel ils sont parcourus, chacun relatif à la racine de l’espace de travail lorsqu’il se trouve à l’intérieur de celle-ci. Vide lorsque ses Releases ne lisent aucun répertoire de catalogue, de sorte que la passe n’a rien vérifié et n’a fait échouer aucune des autres.
checkedintegerouiLe nombre de documents que la passe a vérifiés.
findingsintegerouiLe nombre de constats que la passe a trouvés.
errorsintegerouiCombien d’entre eux sont des erreurs.
warningsintegerouiCombien d’entre eux sont des avertissements.
infosintegerouiCombien d’entre eux sont informatifs.
filesLintFileFindings[] ou nullouiLes constats de la passe, par document.

Les propriétés supplémentaires ne sont pas autorisées.

PluginAddResult

Ce qu’a écrit le rattachement d’un plugin, où, et quelle version il a épinglée.

PropriétéTypeObligatoireDescription
typestringouiLe socket auquel le plugin a été rattaché.
identitystringnonL’identité en laquelle le rattachement s’est résolu.
uristringnonLa référence à partir de laquelle le rattachement se résout.
capabilitystringnonLa capacité à laquelle est destiné le rattachement.
referencestringnonLa référence épinglée, version comprise.
scopePluginWriteScopeouiDans quel document de configuration une modification de plugin a été écrite et jusqu’où elle porte. La valeur par défaut propre au socket d’extension de commandes est le document de toute la machine, de sorte que chaque réponse indique lequel elle a écrit.
writtenbooléenouiIndique si le document de configuration a été écrit, par opposition à renvoyé pour que l’appelant le place.
contentstringnonLe texte du document de configuration, pour une requête qui a demandé à le voir plutôt qu’à le faire écrire.
retractionPluginRetractionnonLa façon dont un marqueur de dépréciation a déterminé quelle version du plugin a été épinglée.
withdrawnbooléennonVaut true lorsque la requête a nommé la version épinglée et qu’une rétractation à laquelle cet espace de travail fait confiance a retiré cette version. Une version nommée est épinglée malgré tout, car la nommer constitue la surcharge. Absent sinon, et l’absence ne signifie pas que la version n’est pas retirée : là où les marqueurs de retrait d’une version nommée n’ont pas pu être lus, retraction.unscreened indique pourquoi, et sans version nommée, la dernière version publiée est choisie et retraction indique ce que la vérification de retrait a conclu au sujet de ce choix.

Les propriétés supplémentaires ne sont pas autorisées.

PluginRemoveResult

Ce qu’a écrit le détachement d’un plugin, et où.

PropriétéTypeObligatoireDescription
typestringouiLe socket auquel le plugin a été rattaché.
querystringouiQuel rattachement a été retiré.
scopePluginWriteScopeouiDans quel document de configuration une modification de plugin a été écrite et jusqu’où elle porte. La valeur par défaut propre au socket d’extension de commandes est le document de toute la machine, de sorte que chaque réponse indique lequel elle a écrit.

Les propriétés supplémentaires ne sont pas autorisées.

PluginSyncResult

Ce qu’a modifié l’alignement des enregistrements gérés par la machine d’une entité Plugin sur son module.

PropriétéTypeObligatoireDescription
entitystringouiLe document de l’entité Plugin qui a été aligné.
hostFunctionsstring[] ou nullouiLes fonctions hôtes dont le module déclare avoir besoin.
commandsPluginCLICommand[] ou nullouiLes commandes que le module fournit.
changedbooléenouiIndique si quoi que ce soit dans le document a effectivement changé.

Les propriétés supplémentaires ne sont pas autorisées.

PluginGenCatalogResult

Les documents de catalogue qu’une génération a produits.

PropriétéTypeObligatoireDescription
documentsPluginGeneratedDocument[]nonChaque document généré et son texte.
noticesstringnonTout ce que la génération veut faire savoir à l’appelant.
dryRunbooléenouiIndique si les documents ont été renvoyés plutôt qu’écrits.

Les propriétés supplémentaires ne sont pas autorisées.

ExplainErrorResult

Ce que le compilateur déclare au sujet d’une condition, et les passages publiés qui enseignent la correction d’authoring.

PropriétéTypeObligatoireDescription
shortCodestringouiLe code court de la condition.
codestringouiLe nom descriptif de la condition.
messagestringouiCe que dit la condition lorsqu’elle est levée.
entriesExplainErrorEntry[]nonLes passages publiés qui enseignent la correction.
referencestringouiL’adresse publiée à laquelle la condition est expliquée.
notestringnonPourquoi les passages publiés manquent, lorsqu’ils n’ont pas pu être acquis. Ce que le binaire lui-même déclare reçoit tout de même une réponse.

Les propriétés supplémentaires ne sont pas autorisées.

GetSchemaResult

Le schéma d’un type, ou — lorsque la requête n’en a nommé aucun — quels types peuvent être nommés. Les deux largeurs passent par une seule réponse plutôt que par deux méthodes, parce que « que puis-je nommer » et « desquels un auteur écrit-il des documents » sont la même question à deux largeurs, et que deux réponses devraient être maintenues en accord.

PropriétéTypeObligatoireDescription
kindstringnonLe type auquel s’applique le schéma.
schemaanynonLe schéma lui-même, transmis tel que le binaire le détient.
kindsstring[]nonChaque jeton auquel ce binaire répond.
entityKindsEntityKindDescriptor[]nonL’ensemble plus restreint dont un auteur écrit un document, chacun associant le jeton que nomme une requête au type que déclare l’en-tête propre du document.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsInstallResult

Ce qu’a écrit l’installation de la skill de l’assistant, et où.

PropriétéTypeObligatoireDescription
skillstringouiLa skill qui a été écrite.
installedSkillsInstalledFolder[]ouiChaque dossier de skills écrit, dans l’ordre dans lequel la requête a nommé les assistants. Les assistants qui lisent un même dossier partagé partagent une entrée, parce que la skill y est écrite une seule fois.
scopeSkillFolderScopeouiJusqu’où porte une installation de skill. Une requête nomme un espace de travail, de sorte qu’une réponse qui ne dirait rien serait lue comme portant sur cet espace de travail — et pour les dossiers par utilisateur, qu’un assistant lit dans chaque projet, cette lecture est fausse.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsInstalledFolder

Un dossier de skills qu’une installation a écrit.

PropriétéTypeObligatoireDescription
agentsstring[]ouiLes identifiants des assistants nommés qui lisent ce dossier, dans l’ordre dans lequel la requête les a nommés.
folderstringouiLe dossier de la skill, sous la forme d’un chemin absolu.
replacedbooléenouiIndique si une copie portant la ligne de commentaire que porte chaque copie écrite de la skill — une qu’une installation antérieure a écrite, ou une prise dans le dépôt de skills publié — se trouvait là et a été remplacée. Un fichier qui s’y trouve sans cette ligne est refusé plutôt que remplacé.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsListResult

Les skills que le binaire embarque et chaque assistant pour lequel une installation peut les écrire. Rien n’est écrit et rien n’est atteint.

PropriétéTypeObligatoireDescription
skillsSkillsListedSkill[]ouiChaque skill que le binaire embarque, dans un ordre fixe.
agentsSkillsListedAgent[]ouiChaque assistant pour lequel une installation connaît un dossier de skills, trié par identifiant.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsListedSkill

Une skill que le binaire embarque.

PropriétéTypeObligatoireDescription
namestringouiLe nom de la skill, qui est aussi le nom du dossier qu’une installation écrit.
descriptionstringouiLe moment où un assistant utilise la skill, tel que la skill elle-même le déclare.

Les propriétés supplémentaires ne sont pas autorisées.

SkillsListedAgent

Un assistant pour lequel une installation peut écrire une skill, avec les deux dossiers dans lesquels il lit les skills.

PropriétéTypeObligatoireDescription
idstringouiL’identifiant par lequel une requête nomme l’assistant.
namestringouiLe nom propre de l’assistant.
projectFolderstringouiLe dossier, relatif à la racine d’un projet et séparé par des barres obliques, dans lequel l’assistant lit les skills d’un projet. Une installation de projet écrit le dossier de la skill à l’intérieur de celui-ci, dans l’espace de travail que nomme la requête.
userFolderstringouiLe dossier, relatif au répertoire personnel et séparé par des barres obliques, dans lequel l’assistant lit les skills propres de l’utilisateur dans chaque projet. Une installation avec global écrit le dossier de la skill à l’intérieur de celui-ci.

Les propriétés supplémentaires ne sont pas autorisées.