Aggrega arka plan arka plan hizmeti tel protokolü şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/serve-wire-v1beta1.schema.json
aggrega serve ile başlatılan arka plan derleyici hizmetiyle (daemon) alınıp verilen ileti biçimleri. İstemci, el sıkışmayla bu hizmet üzerinde bir oturum açar; oturum, ayarların ve konuşmanın açıldığı çalışma alanının kapsamını belirler. Hizmet ise bir isteği yanıtlayan, bildirim gönderen ve okuduklarını tutan süreçtir. Protokol, standart girdi ve çıktı üzerinden JSON-RPC 2.0’dır ve her ileti bir Content-Length başlığıyla çerçevelenir; bu belge ileti gövdelerini açıklar, çerçevelemeyi ve taşıma katmanını açıklamaz. Bir gövde dört şeyden biridir: istemcinin gönderdiği bir istek, istemcinin gönderdiği bir bildirim, hizmetin gönderdiği bir bildirim ya da hizmetin bir istek için döndürdüğü yanıt. Yüzeyin üç özelliği, aşağıdaki biçimlerin nasıl yazıldığını belirler. Birincisi, her istek kendi yönteminin bildirdiklerinin ötesinde iki alan kabul eder: isteğin üzerinde işlem yaptığı çalışma alanını adlandıran workspaceRoot ve ilerlemenin altında raporlandığı, çağıranın ürettiği değer olan workDoneToken. Bu nedenle ikisi de buradaki her istek params nesnesinde yer alır; konusu bir çalışma alanı olmayan üç yöntem de buna dahildir: aggrega/getSchema ve aggrega/scaffoldEntity, workspaceRoot alanını kabul edip yok sayar, aggrega/initialize ise onu oturumun bildirdiği çalışma alanı olarak okur. İkincisi, hizmet, yöntemin kabul etmediği bir alan taşıyan istek params nesnesini reddeder ve neleri kabul ettiğini belirtir; bu nedenle buradaki her params nesnesi en üst düzeyinde kapalıdır. Bir istek içindeki iç içe nesne kapalı değildir, çünkü denetim yalnızca en dıştaki alan adlarını okur. Üçüncüsü, sonuç bir çağıran tarafından sağlanmaz, hizmet tarafından oluşturulur; bu nedenle sonuç nesneleri biçimi sabit olan her düzeyde kapalıdır ve yalnızca değerin, hizmetin okumadan ilettiği opak JSON olduğu yerlerde açıktır. Hizmetin kodlamasının bir sonucu tel üzerinde görünür ve gizlenmek yerine açıklanır: hizmetin isteğe bağlı olarak işaretlemediği bir koleksiyon, raporlanacak değeri olmadığında null olarak, raporladığı değer boş olduğunda ise boş bir koleksiyon olarak yayımlanır; bu nedenle bunun geçerli olduğu her yerde iki biçim de kabul edilir.
Aşağıdaki biçimlerden biri
RequestClientNotificationDaemonNotificationSuccessResponseErrorResponse
Tanımlar
ProtocolVersion
Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir.
Tür: const "2.0"
Sabit: "2.0"
RequestId
Çağıranın bir istek için verdiği tanımlayıcı; isteği yanıtlayan yanıtta aynen geri döndürülür. Tanımlayıcı taşımayan bir ileti bir bildirimdir ve hiçbir zaman yanıtlanmaz.
Tür: string or number
ProgressToken
Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir.
Tür: string or number
WorkspaceRootSubject
Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir.
Tür: string
WorkspaceRootAccepted
Bir çalışma alanının mutlak yolu. Bu yöntemin konusu bir çalışma alanı değildir — yanıtını ikili dosyanın kendi taşıdıklarından verir — bu nedenle alan kabul edilir ama okunmaz. Bir istemcinin, hangi yöntemlerin ona başvurduğunu bilmek zorunda kalmadan onu her istekte tek tip olarak gönderebilmesi için kabul edilir.
Tür: string
RequestMethod
Bir isteğin adlandırabileceği her yöntem. Küme kapalıdır: başka bir şey adlandıran bir istek, yöntem bulunamadı hatasıyla yanıtlanır.
Tür: string (enum)
İzin verilen değerler: "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
Bir istemci bildiriminin adlandırabileceği her yöntem. Küme kapalıdır ve bildirimlerin hiçbiri yanıtlanmaz.
Tür: string (enum)
İzin verilen değerler: "$/cancelRequest", "aggrega/shutdown"
DaemonNotificationMethod
Daemon’un gönderdiği bir bildirimin adlandırabileceği her yöntem. Küme kapalıdır.
Tür: string (enum)
İzin verilen değerler: "$/progress", "aggrega/publishDiagnostics"
Request
İstemcinin gönderdiği ve daemon’un yanıtladığı bir istek. Yöntem, ne istendiğini adlandırır; params nesnesi o yöntemin kendi alanlarını ve her yöntemin kabul ettiği iki alanı taşır. params’ı tamamen atlayan bir istek, tüm alanları yokmuş gibi okunur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
jsonrpc | ProtocolVersion | evet | Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir. |
id | RequestId | evet | Çağıranın bir istek için verdiği tanımlayıcı; isteği yanıtlayan yanıtta aynen geri döndürülür. Tanımlayıcı taşımayan bir ileti bir bildirimdir ve hiçbir zaman yanıtlanmaz. |
method | RequestMethod | evet | Bir isteğin adlandırabileceği her yöntem. Küme kapalıdır: başka bir şey adlandıran bir istek, yöntem bulunamadı hatasıyla yanıtlanır. |
params | object | hayır |
Ek özelliklere izin verilmez.
Her method için params:
method | params | Zorunlu |
|---|---|---|
"aggrega/initialize" | InitializeParams | hayır |
"aggrega/validate" | ValidateParams | hayır |
"aggrega/invalidate" | InvalidateParams | hayır |
"aggrega/diagnostics" | DiagnosticsParams | hayır |
"aggrega/irGraph" | IrGraphParams | hayır |
"aggrega/build" | BuildParams | hayır |
"aggrega/buildPreview" | BuildPreviewParams | hayır |
"aggrega/entityDefinition" | EntityDefinitionParams | hayır |
"aggrega/releaseClosure" | ReleaseClosureParams | hayır |
"aggrega/resolveDependencies" | ResolveDependenciesParams | hayır |
"aggrega/pin" | PinParams | hayır |
"aggrega/cacheStatus" | WorkspaceAndProgressParams | hayır |
"aggrega/cachePrune" | WorkspaceAndProgressParams | hayır |
"aggrega/cacheEvict" | CacheEvictParams | hayır |
"aggrega/cacheClear" | WorkspaceAndProgressParams | hayır |
"aggrega/registryList" | WorkspaceAndProgressParams | hayır |
"aggrega/search" | SearchParams | hayır |
"aggrega/registryAdd" | RegistryAddParams | hayır |
"aggrega/registryRemove" | RegistryRemoveParams | hayır |
"aggrega/registryUpdate" | RegistryUpdateParams | hayır |
"aggrega/logout" | LogoutParams | hayır |
"aggrega/publishEntity" | PublishEntityParams | hayır |
"aggrega/publishArtifact" | PublishArtifactParams | hayır |
"aggrega/signArtifacts" | SignArtifactsParams | hayır |
"aggrega/deprecateArtifact" | DeprecateArtifactParams | hayır |
"aggrega/resolve" | ResolveParams | hayır |
"aggrega/findReferences" | FindReferencesParams | hayır |
"aggrega/findImplementations" | FindImplementationsParams | hayır |
"aggrega/hover" | HoverParams | hayır |
"aggrega/completion" | CompletionParams | hayır |
"aggrega/catalogIndex" | CatalogIndexParams | hayır |
"aggrega/attachCandidates" | AttachCandidatesParams | hayır |
"aggrega/connectionCandidates" | ConnectionCandidatesParams | hayır |
"aggrega/insertionPoint" | InsertionPointParams | hayır |
"aggrega/attachmentContainer" | AttachmentContainerParams | hayır |
"aggrega/connectionAtPosition" | ConnectionAtPositionParams | hayır |
"aggrega/releaseCandidates" | WorkspaceAndProgressParams | hayır |
"aggrega/activeRelease" | WorkspaceAndProgressParams | hayır |
"aggrega/setActiveRelease" | SetActiveReleaseParams | hayır |
"aggrega/editDocument" | EditDocumentParams | hayır |
"aggrega/effectiveConfiguration" | WorkspaceAndProgressParams | hayır |
"aggrega/configInit" | ConfigInitParams | hayır |
"aggrega/configCapture" | ConfigCaptureParams | hayır |
"aggrega/import" | ImportParams | hayır |
"aggrega/scaffoldEntity" | ScaffoldEntityParams | hayır |
"aggrega/lint" | LintParams | hayır |
"aggrega/pluginAdd" | PluginAddParams | hayır |
"aggrega/pluginRemove" | PluginRemoveParams | hayır |
"aggrega/pluginSync" | PluginSyncParams | hayır |
"aggrega/pluginGenCatalog" | PluginGenCatalogParams | hayır |
"aggrega/explainError" | ExplainErrorParams | hayır |
"aggrega/getSchema" | GetSchemaParams | hayır |
"aggrega/skillsInstall" | SkillsInstallParams | hayır |
"aggrega/skillsList" | WorkspaceAndProgressParams | hayır |
ClientNotification
İstemcinin gönderdiği bir bildirim. Tanımlayıcı taşımaz ve hiçbir zaman yanıtlanmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
jsonrpc | ProtocolVersion | evet | Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir. |
method | ClientNotificationMethod | evet | Bir istemci bildiriminin adlandırabileceği her yöntem. Küme kapalıdır ve bildirimlerin hiçbiri yanıtlanmaz. |
params | object | hayır |
Ek özelliklere izin verilmez.
Her method için params:
method | params | Zorunlu |
|---|---|---|
"$/cancelRequest" | CancelRequestParams | evet |
"aggrega/shutdown" | ShutdownParams | hayır |
DaemonNotification
Daemon’un gönderdiği bir bildirim. Tanımlayıcı taşımaz ve hiçbir zaman yanıtlanmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
jsonrpc | ProtocolVersion | evet | Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir. |
method | DaemonNotificationMethod | evet | Daemon’un gönderdiği bir bildirimin adlandırabileceği her yöntem. Küme kapalıdır. |
params | object | evet |
Ek özelliklere izin verilmez.
Her method için params:
method | params | Zorunlu |
|---|---|---|
"$/progress" | ProgressParams | evet |
"aggrega/publishDiagnostics" | PublishDiagnosticsParams | evet |
CancelRequestParams
Daemon’dan, hâlihazırda yürütülmekte olan bir isteği, isteğin taşıdığı tanımlayıcıyla adlandırarak bırakmasını ister. Zaten tamamlanmış ya da hiç gönderilmemiş bir istek için sessizce iptal edilecek bir şey yoktur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | RequestId | evet | Çağıranın bir istek için verdiği tanımlayıcı; isteği yanıtlayan yanıtta aynen geri döndürülür. Tanımlayıcı taşımayan bir ileti bir bildirimdir ve hiçbir zaman yanıtlanmaz. |
Ek özelliklere izin verilmez.
ShutdownParams
Daemon’dan iş kabul etmeyi bırakmasını ve hâlihazırda aldığı işi bitirmesini ister. Bildirim hiçbir alan taşımaz ve bildirimin kendisi genellikle hiç params nesnesi olmadan gönderilir. İkinci bir bildirim, yürütülmekte olan işi beklemek yerine bırakır.
Bu nesne sabit bir özellik bildirmez ve hiçbirine izin vermez.
ProgressParams
Süren işe ilişkin tek bir rapor; yalnızca, ilerleme bildirimlerini alabileceğini bildirmiş bir oturumda ilerleme belirteci üretmiş bir istek için gönderilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
token | ProgressToken | evet | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
value | ProgressBegin veya ProgressReport veya ProgressEnd | evet | Raporun kendisi. Bir açılış raporu, ardından herhangi sayıda satır, ardından bir kapanış raporu. |
Ek özelliklere izin verilmez.
ProgressBegin
Bir raporu açar ve neyin başladığını işlemin kendi kullandığı terimlerle söyler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | const “begin” | evet | Bu yükü bir raporun açılışı olarak işaretler. Sabit: "begin" |
title | string | evet | Neyin başladığı. |
Ek özelliklere izin verilmez.
ProgressReport
İşlemin kendi hakkındaki anlatımından bir satır. Oran taşımaz: burada rapor veren işlemler, iş başladığında boyutu bilinmeyen bir küme üzerinde çalışır; bu yüzden bir oranın uydurulması gerekirdi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | const “report” | evet | Bu yükü açık bir raporun bir satırı olarak işaretler. Sabit: "report" |
message | string | evet | İşlemin kendi çıktısından, çevresindeki boşluklar kaldırılmış bir satır. |
Ek özelliklere izin verilmez.
ProgressEnd
Bir raporu kapatır. Türün ötesinde bir şey taşımaz, çünkü sonuç, çağıranın zaten beklediği yanıtla iletilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | const “end” | evet | Bu yükü bir raporun kapanışı olarak işaretler. Sabit: "end" |
Ek özelliklere izin verilmez.
PublishDiagnosticsParams
Bir doğrulama, isteğin adlandırdığı belgeden başka bir belge için bulgular ürettiğinde daemon’un gönderdiği, tek bir dosyaya ait bulgular.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Bulguların ilgili olduğu dosya. |
diagnostics | Diagnostic[] veya null | evet | Üretildikleri sırayla bulgular. |
Ek özelliklere izin verilmez.
SuccessResponse
Başarılı olan bir isteğin yanıtı; yanıtladığı isteğin tanımlayıcısını taşır. Bir yanıt yöntem taşımaz; bu nedenle hangi sonuç biçiminin geçerli olduğu, yanıtın içindeki herhangi bir şeyle değil, tanımlayıcının ait olduğu istekle belirlenir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
jsonrpc | ProtocolVersion | evet | Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir. |
id | RequestId | evet | Çağıranın bir istek için verdiği tanımlayıcı; isteği yanıtlayan yanıtta aynen geri döndürülür. Tanımlayıcı taşımayan bir ileti bir bildirimdir ve hiçbir zaman yanıtlanmaz. |
result | InitializeResult veya ValidateResult veya InvalidateResult veya DiagnosticsResult veya IrGraphResult veya BuildResult veya BuildPreviewResult veya EntityDefinitionResult veya ReleaseClosureResult veya ResolveDependenciesResult veya PinResult veya CacheStatusResult veya CachePruneResult veya CacheEvictResult veya CacheClearResult veya RegistryListResult veya SearchResult veya RegistryAddResult veya RegistryRemoveResult veya RegistryUpdateResult veya LogoutResult veya PublishEntityResult veya PublishArtifactResult veya SignArtifactsResult veya DeprecateArtifactResult veya ResolveResult veya FindReferencesResult veya FindImplementationsResult veya HoverResult veya CompletionResult veya CatalogIndexResult veya AttachCandidatesResult veya ConnectionCandidatesResult veya InsertionPointResult veya AttachmentContainerResult veya ConnectionAtPositionResult veya ReleaseCandidatesResult veya ActiveReleaseResult veya EditDocumentResult veya EffectiveConfigurationResult veya ConfigInitResult veya ConfigCaptureResult veya ImportResult veya ScaffoldEntityResult veya LintResult veya PluginAddResult veya PluginRemoveResult veya PluginSyncResult veya PluginGenCatalogResult veya ExplainErrorResult veya GetSchemaResult veya SkillsInstallResult veya SkillsListResult | evet | İstenen yöntemin döndürdüğü biçimde yanıt. |
Ek özelliklere izin verilmez.
ErrorResponse
Reddedilen veya başarısız olan bir isteğe verilen yanıt; yanıtladığı isteğin tanımlayıcısını taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
jsonrpc | ProtocolVersion | evet | Her iletinin taşıdığı JSON-RPC sürümü. Yalnızca 2.0 desteklenir. |
id | RequestId | evet | Çağıranın bir istek için verdiği tanımlayıcı; isteği yanıtlayan yanıtta aynen geri döndürülür. Tanımlayıcı taşımayan bir ileti bir bildirimdir ve hiçbir zaman yanıtlanmaz. |
error | ErrorObject | evet | Neyin yanlış gittiği: bir istemcinin dallanmak için kullanabileceği bir kod, bir kişinin okuması için yazılmış bir ileti ve — durumun böyle bir şeyi olduğunda — iletinin başvurduğu yapıtlar ve kaynak konumu. |
Ek özelliklere izin verilmez.
ErrorObject
Neyin yanlış gittiği: bir istemcinin dallanmak için kullanabileceği bir kod, bir kişinin okuması için yazılmış bir ileti ve — durumun böyle bir şeyi olduğunda — iletinin başvurduğu yapıtlar ve kaynak konumu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
code | ErrorCode | evet | Yanıtın bildirdiği durum. Negatif kodlar protokolün kendi ayrılmış kümesidir; dört basamaklı kodlar bu daemon’un ortaya çıkardığı durumlardır ve her biri bir istemcinin üzerine işlem yapabileceği bir durumu adlandırır. Küme kapalıdır. |
message | string | evet | Neyin yanlış gittiği, düz metin olarak. Aynı durumun, onu bildiren diğer her yüzeyde taşıdığı ifadenin aynısıdır. |
data | ErrorData | hayır | İletinin başvurduğu yapıtlar ve kaynak konumu; bir istemcinin bunları düz metinden geri okuması gerekmesin diye yapısal olarak taşınır. Her alan isteğe bağlıdır ve bir durum yalnızca elindekini doldurur; hiçbir alan bir başkasının yerine geçmez, böylece bir istemci ne aldığını yanındaki koddan değil, okuduğu alandan öğrenir. |
Ek özelliklere izin verilmez.
ErrorCode
Yanıtın bildirdiği durum. Negatif kodlar protokolün kendi ayrılmış kümesidir; dört basamaklı kodlar bu daemon’un ortaya çıkardığı durumlardır ve her biri bir istemcinin üzerine işlem yapabileceği bir durumu adlandırır. Küme kapalıdır.
Tür: 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
İzin verilen değerler:
-32700— İleti JSON olarak ayrıştırılamadı.-32600— İleti ayrıştırıldı ancak düzgün biçimli bir istek değil.-32601— Bu adda bir yöntem yok.-32602— İsteğin taşıdığı params kabul edilebilir değil: yöntemin kabul etmediği bir alan, yanlış türde bir alan ya da yöntemin reddettiği bir değer.-32603— Hizmet, işi yaparken başarısız oldu.1001— Hizmet dosyaya ait bir okuma tutmuyor ve bir okuma da üretmiyor. İstemci bir doğrulama isteyerek okumayı başlatır, ardından yeniden dener.1003— İsteğin adlandırdığı Release’in kilit dosyası yok ve işlemin buna ihtiyacı var.1004— İsteğin adlandırdığı varlık ne katalogdan ne de isteğin adlandırdığı Release’ten çözümlenebildi.1005— Hizmet kapanıyor ve yeni işleri reddediyor. İstemci aynı hizmete karşı yeniden denemez.1006— Dosyanın doğrulaması şu anda çalışıyor ve bekleyen isteğin tanıdığı süre içinde tamamlanmadı. İstemci bekler ve bu arada hiçbir şey göndermeden yeniden sorar.
ErrorData
İletinin başvurduğu yapıtlar ve kaynak konumu; bir istemcinin bunları düz metinden geri okuması gerekmesin diye yapısal olarak taşınır. Her alan isteğe bağlıdır ve bir durum yalnızca elindekini doldurur; hiçbir alan bir başkasının yerine geçmez, böylece bir istemci ne aldığını yanındaki koddan değil, okuduğu alandan öğrenir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | hayır | Konum alanlarının yerini belirttiği kaynak belge — denetlenen belge ya da yüklenmesi başarısız olan Release. |
line | integer | hayır | Durumun başvurduğu satır, birden başlayarak sayılır. |
column | integer | hayır | Durumun başvurduğu sütun, birden başlayarak sayılır. |
end_line | integer | hayır | Durumun başvurduğu belirtecin sonundan bir sonraki satır. Belirtecin kurtarılabilir bir sonu olmadığında bulunmaz; bu durumda istemci konumu bir nokta olarak gösterir. |
end_column | integer | hayır | Durumun başvurduğu belirtecin sonundan bir sonraki sütun. |
release | string | hayır | Durumun başvurduğu Release, isteğin onu adlandırdığı biçimde yazılır; böylece bir istemci çözümü yeniden birleştirmek zorunda kalmadan oluşturabilir. |
lockfile | string | hayır | Kilit dosyası kapsamlı bir durumun ilgili olduğu kilit dosyası: aranıp bulunamayan ya da okunamayan yol. |
unreachable | boolean | hayır | Reddin, isteğin adlandırdığı ve ulaşılamayan bir kayıt defteri olup olmadığı: adı çözümlenmedi, ona yapılan bir bağlantı reddedildi ya da açılamadı veya ona güvenli bir bağlantı kurulamadı. İletiden değil, hatanın kendisinden okunur ve yalnızca hata kayıt defterine hiç ulaşılmadığını gösterdiğinde ayarlanır. Tek bir kayıt defterini adlandıran reddedilmiş bir dizin yenilemesi bunu taşır; yanıt veren bir kayıt defteri, yanıtı ne olursa olsun, bunu boş bırakır. |
code | string | hayır | Reddin adlandırdığı durumun açıklayıcı adı, sürümler arasında kararlıdır: o durumu bildiren bir tanılamanın kendi kodunda taşıdığı değerin aynısıdır. Bir istemcinin dallanmak için kullandığı şey budur; iletiye ya da yanındaki sayısal koda değil; sayısal kod isteğin durumunu adlandırır ve her durum için aynı kalır. Ret kayıtlı bir durumu adlandırdığında tam olarak bulunur, hiçbirini adlandırmadığında bulunmaz. |
shortCode | string | hayır | Durumun kısa kodu, E harfi ve dört basamak: bir okuyucunun alıntıladığı ve aradığı biçim ve bir durumu adlandıran bir reddin iletisini açan biçim. Tam olarak code bulunduğunda bulunur. |
Ek özelliklere izin verilmez.
Diagnostic
Bir belge hakkında bir bulgu: nerede olduğu, ne kadar ciddi olduğu, ne söylediği ve bildirdiği durumu adlandıran alıntılanabilir kod.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
line | integer | evet | Bulgunun ilgili olduğu satır, birden başlayarak sayılır. |
column | integer | evet | Bulgunun ilgili olduğu sütun, birden başlayarak sayılır. |
severity | const “error” veya const “warning” veya const “info” | evet | Bulgunun ne kadar ciddi olduğu. İzin verilen değerler: "error" — Bulgu bir hatadır. halt önem düzeyindeki bir plugin bulgusu bu kademede raporlanır. "warning" — Bulgu raporlanır ve bir hata değildir. warn önem düzeyindeki bir plugin bulgusu bu kademede raporlanır. "info" — Bulgu, info önem düzeyindeki bir plugin bulgusu gibi bilgi niteliğindedir. |
message | string | evet | Bulgunun ne söylediği, düz metin olarak. |
code | string | hayır | Durumun açıklayıcı adı; sürümler arasında kararlıdır ve bir bastırmada alıntılanabilir. |
shortCode | string | hayır | Durumun kısa kodu; durduran bir tanılamayı açan biçim. |
codeDescription | CodeDescription | hayır | Bulgunun adlandırdığı durumun açıklandığı yer. |
classification | string | hayır | Durum bunu ayırt ettiğinde, bulguya nasıl varıldığı. |
suggest | string | hayır | Durum bir yazım adlandırabildiğinde bulgunun önerdiği yazım — örneğin bir tanımlayıcıdaki yakın bir yazım hatası. |
keyPath | string | hayır | Belge içinde bulgunun ilgili olduğu anahtara giden yol. |
source | string | evet | Bulguyu neyin ürettiği. |
end_line | integer | hayır | Bulgunun ilgili olduğu belirtecin sonundan bir sonraki satır; böylece bir istemci tek bir karakter yerine belirtecin tamamını gösterebilir. Birkaç satıra yayılan bir belirteç için bulunmaz. |
end_column | integer | hayır | Bulgunun ilgili olduğu belirtecin sonundan bir sonraki sütun. |
Ek özelliklere izin verilmez.
CodeDescription
Bulgunun adlandırdığı durumun açıklandığı yer.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
href | string | evet | Durumun açıklandığı yayımlanmış adres. |
Ek özelliklere izin verilmez.
Position
Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
line | integer | evet | Satır, sıfırdan başlayarak sayılır. |
character | integer | evet | Satır içindeki uzaklık, sıfırdan başlayarak, oturumun üzerinde karar kıldığı kodlamanın birimleriyle sayılır. |
Ek özelliklere izin verilmez.
Range
Bir belgedeki iki yer arasındaki bir aralık.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
start | Position | evet | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
end | Position | evet | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
Ek özelliklere izin verilmez.
Location
Adı belirtilmiş bir belgedeki bir aralık.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | evet | Aralığın bulunduğu belge, bir URI olarak adreslenir. |
range | Range | evet | Bir belgedeki iki yer arasındaki bir aralık. |
Ek özelliklere izin verilmez.
WorkspaceAndProgressParams
Kendi alanlarını bildirmeyen bir yöntemin params nesnesi. Yine de her isteğin kabul ettiği iki alanı kabul eder: üzerinde çalıştığı çalışma alanı ve bir ilerleme belirteci.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
Ek özelliklere izin verilmez.
InitializeParams
Bir çalışma alanı üzerinde oturum açar ve istemcinin neleri işleyebildiğini bildirir. workspaceRoot’un bir konu değil bir bildirim olduğu tek yöntem budur: bulunmaması, boş olması ve bir yol olması üç farklı şeydir; yol olmadan açılan oturum, istemcinin henüz bir çalışma alanına yöneltmediği bir oturumdur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
capabilities | ClientCapabilities | hayır | İstemcinin neleri işleyebildiği. Belirtilmeyen, desteklenmiyor kabul edilir. Bilinmeyen üyeler reddedilmez, yok sayılır; böylece istemci bu daemon’un henüz okumadığı bir yeteneği belirtebilir. |
workspaceRoot | string | hayır | Açılacak çalışma alanının mutlak yolu. Bulunmazsa oturum çalışma alanı olmadan kalır; boş bir string, istemcinin sağladığı bir yoldur ve hiç göndermemekle aynı şey değildir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
Ek özelliklere izin verilmez.
ClientCapabilities
İstemcinin neleri işleyebildiği. Belirtilmeyen, desteklenmiyor kabul edilir. Bilinmeyen üyeler reddedilmez, yok sayılır; böylece istemci bu daemon’un henüz okumadığı bir yeteneği belirtebilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
general | object | hayır | Tek bir yanıt türüne bağlı olmayan yetenekler. |
window | object | hayır | İş sürerken istemcinin neler gösterebildiğine ilişkin yetenekler. |
Ek özelliklere izin verilir.
ClientCapabilities.general
Tek bir yanıt türüne bağlı olmayan yetenekler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
positionEncodings | string[] | hayır | İstemcinin okuyabildiği konum kodlamaları, en iyisi önce. |
Ek özelliklere izin verilir.
ClientCapabilities.window
İş sürerken istemcinin neler gösterebildiğine ilişkin yetenekler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workDoneProgress | boolean | hayır | İstemcinin ilerleme bildirimleri alıp alamayacağı. Bunu bildirmemiş bir oturumda ilerleme belirteci üreten bir istek reddedilir. |
Ek özelliklere izin verilir.
ValidateParams
Çalışma alanını ya da içindeki bir belgeyi denetler ve bulgularla yanıt verir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Denetlenecek belge. Bulunmazsa çalışma alanının içerdikleri denetlenir. |
content | string | hayır | Kaydedilmemiş bir arabelleği denetlemek için, belgenin istemcide o anda bulunan metni. Bulunmazsa diskteki baytlar okunur. |
release | string | hayır | Denetimin karşısında yapılacağı Release, çalışma alanı köküne göre bir yol olarak. |
Ek özelliklere izin verilmez.
InvalidateParams
Daemon’a, okumasını tuttuğu bir belgenin değiştiğini bildirir; böylece o belgeyle ilgili sonraki yanıt yeni baytlardan hesaplanır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Değişen belge. |
granularity | string | hayır | Hizmetin tuttuklarından ne kadarının bırakılacağı: file yalnızca adlandırılan belge için tuttuklarını bırakır; varsayılan olan ve başka herhangi bir değerin de öyle okunduğu workspace ise tüm çalışma alanı için tuttuklarını da bırakır. |
Ek özelliklere izin verilmez.
DiagnosticsParams
Daemon’un bir belge için hâlihazırda tuttuğu bulgularla, belgeyi yeniden denetlemeden yanıt verir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Raporlanacak belge. Daemon’un bu belgenin bir okumasını zaten tutuyor olması gerekir. |
Ek özelliklere izin verilmez.
IrGraphParams
Bir Release’in derlendiği çözümlenmiş grafikle, onu işlemeden yanıt verir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Çözümlenecek Release, çalışma alanı köküne göre bir yol olarak. Mutlak yol reddedilir. |
unredacted | boolean | hayır | Bir yazarın hassas olarak bildirdiği değerlerin açık olarak yanıtta verilip verilmeyeceği. Bulunmazsa ya da false ise, bu değerlerin her biri grafikten çıkarılır ve yerine nedenini belirten bir işaret konur, tıpkı komut satırının grafik çıktısının onları çıkarması gibi; true, grafiği Release’in derlendiği hâliyle, bu değerler dâhil verir. |
Ek özelliklere izin verilmez.
BuildParams
Bir Release’i derler ve işlenmiş yapıtları çalışma alanına yazar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Derlenecek Release, çalışma alanı köküne göre bir yol olarak. Mutlak yol reddedilir. |
outputParent | string | hayır | Çıktı dizininin içinde oluşturulduğu dizin, çalışma alanı köküne göre bir yol olarak. Yapıtlar bunun altındaki çıktı dizinine, hiçbir şey belirtilmediğinde çalışma alanı kökünün altında yerleştikleri düzende yerleşir; dolayısıyla bu, çıktı dizininin üst dizinini belirtir, asla çıktı dizininin kendisini değil. Bulunmazsa ya da boşsa, çıktı dizini çalışma alanı kökünün altına yazılır, tıpkı aggrega build’in nereden çalıştırılırsa çalıştırılsın yaptığı gibi. Mutlak bir yol ya da çalışma alanının dışına çıkan bir yol reddedilir. |
autoPull | boolean | hayır | Önce Release’in bağımlılıklarının çözümlenip çözümlenmeyeceği. İstenirse yapılandırılmış kayıt defterlerine erişilir ve kilit dosyası yazılır; istenmezse derleme hiçbir kayıt defterine erişmez. |
policyInput | string | hayır | Her yönetişim rolünün oraya eklenmiş bir plugin’e verdiği yükün, yapıtların yanına yazılacağı dizin; çalışma alanı köküne göreli bir yol olarak. Bunlar aggrega build --policy-input komutunun aynı adlarla yazdığı dosyalardır ve derleme tamamlansa da dursa da yazılır. Yanıtın bildirimleri kaç dosya yazıldığını söyler ve dosya yazılmayan her rolü adlandırır. Başarısız olan bir istekte yazılan dosyalar diskte kalır ve bu döküm yanıtta yer almaz: hata yalnızca reddi taşır. Belirtilmezse hiçbir şey yazılmaz. Mutlak bir yol ya da çalışma alanının dışına çıkan bir yol reddedilir. |
Ek özelliklere izin verilmez.
BuildPreviewParams
Bir Release’i derler ve yapıtları yazmanın neler üreteceğini, hiçbirini yazmadan bildirir. Yazan derlemenin aldığı bağımlılık çözümleme alanını reddeder, çünkü hiçbir şey yazmayan bir istek bir kilit dosyasını dolduramaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Derlenecek Release, çalışma alanı köküne göreli bir yol olarak. |
autoPull | boolean | hayır | Kablo üzerinde kabul edilir ve yöntem tarafından reddedilir: bu istek hiçbir şey yazmaz, dolayısıyla bir kilit dosyasını doldurup kendini tanımladığı şey olarak kalamaz. |
policyInput | string | hayır | Her yönetişim rolünün oraya eklenmiş bir plugin’e verdiği yükün yazılacağı dizin; çalışma alanı köküne göreli bir yol olarak. Bunlar aggrega build --dry-run --policy-input komutunun aynı adlarla yazdığı dosyalardır. Gönderildiğinde bu istek yalnızca bunları yazar; çıktı dizinine ve kilit dosyasına dokunulmaz. Yanıtın bildirimleri kaç dosya yazıldığını söyler ve dosya yazılmayan her rolü adlandırır. Başarısız olan bir istekte yazılan dosyalar diskte kalır ve bu döküm yanıtta yer almaz: hata yalnızca reddi taşır. Mutlak bir yol ya da çalışma alanının dışına çıkan bir yol reddedilir. |
Ek özelliklere izin verilmez.
EntityDefinitionParams
Bir varlık adının neye çözümlendiğini ve onu tanımlayan belgenin nerede bulunduğunu yanıt olarak verir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
name | string | hayır | Ada göre çözümlenecek varlık — ya da o koordinatta yayımlanmış varlığı okumak için bir kayıt defteri başvurusu: oci://<host>/<repository>:<tag> veya :<tag> yerine @<digest>. |
release | string | hayır | Adın kendi terimleriyle çözümleneceği Release, çalışma alanı köküne göreli bir yol olarak. Ad bu durumda çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri üzerinden çözümlenir; böylece bir çalışma alanında her Release için bir tane olmak üzere birkaç varyantın bildirdiği bir ad, o Release’in derlemede kullandığı varyanta çözümlenir ve çözümlenemeyen bir ad, o Release’in workspace.releases altındaki girdisini adlandıran bir açıklamayla reddedilir. Verilmezse ad, çalışma alanının kendi katalog dizinleri üzerinden çözümlenir. Bir kayıt defteri başvurusu Release almaz ve Release ile birlikte gönderilirse reddedilir; hiçbir Release dosyasını adlandırmayan bir değer de reddedilir. |
Ek özelliklere izin verilmez.
CatalogIndexParams
Çalışma alanının barındırdığı varlıkları yanıt olarak verir: belgelerinin bildirdiği her varlığı ve katalog dizinlerinin bildirdiği Features’ı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Varlıkların kendi terimleriyle listeleneceği Release, çalışma alanı köküne göreli bir yol olarak. Features bu durumda çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinlerinin bildirdikleridir ve yalnızca başka Releases’ın okuduğu bir katalog dizini altındaki belge dışarıda bırakılır; böylece bir varlığın her Release için bir tane olmak üzere varyantlarını yan yana tutan bir çalışma alanı, o Release’in derlemede kullandığı varyantla listelenir. Verilmezse liste çalışma alanının kendi listesidir. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
ReleaseClosureParams
Bir Release’in bağımlı olduğu her şeyi, çözümlemenin ulaştığı biçimiyle yanıt olarak verir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | İncelenecek Release, çalışma alanı köküne göreli bir yol olarak. |
Ek özelliklere izin verilmez.
ResolveDependenciesParams
Bir Release’in bağımlılıklarını çözümler; bunları kilit dosyasında sabitler ve işlemesinin tükettiği dış girdileri edinir. Yapılandırılmış kayıt defterlerine ulaşır ve yazma yapar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Çözümlenecek Release, çalışma alanı köküne göreli bir yol olarak. |
upgrade | boolean | hayır | Kilit dosyasının zaten sabitlediklerine uymak yerine bildirilen aralıklar içinde yeniden çözümleme yapılıp yapılmayacağı. |
targets | string[] | hayır | Yeniden çözümlenecek başvurular; geri kalanlar oldukları gibi sabit kalır. Boş olursa her şey çözümlenir. |
verify | boolean | hayır | Kaydedilmiş kilit dosyasını yazmak yerine, bu isteğin kilit dosyası olmadan gerçekleştireceği çözümlemeyle, o isteğin uyacağı sabitlemelere uyarak karşılaştırılıp karşılaştırılmayacağı. Bir doğrulama hiçbir kilit dosyası, Plugin güven kaydı veya entity.lock yazmaz; içerik önbelleği o çözümlemenin okuyup dolduracağı gibi okunur ve doldurulur. Sapma ve eksik bir kilit dosyası isteği başarısız kılar. upgrade, targets veya pinSources ile, pinSources hangi değeri taşırsa taşısın, birleştirilemez: yanında bunlardan birini gönderen bir istek, herhangi bir şey çözümlenmeden önce geçersiz parametre olarak reddedilir. |
pinSources | boolean | hayır | Bir girdinin ihtiyaç duyduğu sabitlemeyi kilidi kaydetmeyen bir öğe yüzünden isteği reddetmek yerine, aggrega/pin’in çalıştırdığı sabitleme adımının, Release’in çalışma alanının katalog dizinlerinden derlediği Recipes ve FeatureRecipes üzerinde çalıştırılıp her birinin yanına entity.lock yazılıp yazılmayacağı. Verilmezse çalışma alanının pin_sources_at_pull ayarı izlenir; her iki değer de bu istek için o ayarı geçersiz kılar. |
Ek özelliklere izin verilmez.
PinParams
Bir Recipe veya FeatureRecipe’in yanındaki entity.lock içine, varlığın kendi belgesi dışından okuduğu her girdinin içerik sabitlemesini kaydeder. Hiçbir Release adlandırılmaz: kimliğini varlığın tam olarak yazdığı bir girdi, varlığı kullanan her Release için tek bir yapıtı adlandırır; bu nedenle onu sabitlemek için bir Release’in sağladığı hiçbir şeye gerek yoktur. Varlığın kaynaklarının adlandırdığı ana makinelere erişir ve varlığın yanına yazar; varlık belgesinin kendisine asla yazılmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
entity | string | hayır | Sabitlenecek varlık belgesi, çalışma alanı köküne göreli bir yol olarak. |
dryRun | boolean | hayır | Adımın yazacağı kilidin, yazılmak yerine yanıt olarak döndürülüp döndürülmeyeceği. Girdiler yine de çözümlenir, bu nedenle içerik önbelleği yine de dolar. |
Ek özelliklere izin verilmez.
CacheEvictParams
Kalan içerik isteğin belirttiği bir boyutun altına sığana kadar önbellekteki içeriği geri kazanır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
maxSize | string | hayır | Geri kazanımın ineceği boyut, bir insanın yazdığı biçimde yazılır; örneğin 500MB. |
Ek özelliklere izin verilmez.
SearchParams
Yapılandırılmış kayıt defterlerinin yerel dizinlerinin sunduklarında arama yapar. Diskte zaten bulunan dizini okur ve hiçbir kayıt defterine bağlanmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
query | string | hayır | Bir kaydın adı ve açıklamasıyla eşleştirilecek metin. |
kinds | string[] | hayır | Tutulacak varlık türleri. Boş bırakılırsa her tür tutulur. |
selector | string | hayır | Tutulan kayıtların karşılaması gereken bir etiket seçici. |
capabilities | string[] | hayır | Tutulan bir eklenti kaydının bildirmesi gereken yetenekler. |
pluginType | string | hayır | Tutulacak eklenti türü. |
registry | string | hayır | Aranacak tek kayıt defteri ana makinesi. Belirtilmezse yapılandırılmış her ana makinede arama yapılır. |
limit | integer | hayır | Yanıtta döndürülecek en fazla kayıt sayısı. |
includeRetracted | boolean | hayır | Yayımlanmış bir işaretçinin kullanımdan kaldırdığı sürümlerin tutulup tutulmayacağı. |
Ek özelliklere izin verilmez.
RegistryAddParams
Bir kayıt defterini ve çözümlemenin onun sunduklarına uyguladığı güven ilkesini kaydeder. İstek aksini istemedikçe makine genelindeki yapılandırma dosyasına yazar; böylece makinedeki her çalışma alanı bu girdi üzerinden çözümleme yapar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
host | string | hayır | Kaydedilecek kayıt defteri ana makinesi. |
name | string | hayır | Ana makineye çözümlenen kolay bir takma ad. |
identities | string[] | hayır | Bu kayıt defterinin sundukları için güvenilen imzalama kimlikleri. |
keyPath | string | hayır | Anahtarsız bir kimlik yerine bir açık anahtarla imzalanan bir kayıt defteri için güvenilecek açık anahtarın yolu. |
trustedRoot | string | hayır | İmzaların doğrulanacağı güven çapasının yolu. |
requireSignatures | boolean | hayır | Bu kayıt defterinden gelen bir yapıtın doğrulanmış bir imza taşımak zorunda olup olmadığı. Belirtilmezse hiçbir şey belirtmez ve çözümlenmiş varsayılanı yerinde bırakır. |
advisory | boolean | hayır | Başarısız bir doğrulamanın durdurma yerine raporlanıp raporlanmayacağı. |
fetchTrust | boolean | hayır | Kayıt defterinin duyurduğu güven ilkesinin okunup sabitlenip sabitlenmeyeceği. Belirtilmezse hiçbir şey belirtmez ve çözümlenmiş varsayılanı yerinde bırakır. |
global | boolean | hayır | Makine genelindeki yapılandırma dosyasına yaz; bu, bu yöntemin kendi varsayılanıdır. |
workspace | boolean | hayır | Makine genelindeki dosya yerine bu çalışma alanının kendi yapılandırma dosyasına yaz. |
Ek özelliklere izin verilmez.
RegistryRemoveParams
Kayıtlı bir kayıt defterini kaldırır. İstek aksini istemedikçe makine genelindeki yapılandırma dosyasına yazar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
registry | string | hayır | Kaldırılacak kayıt defteri, ana makineye veya takma ada göre. |
global | boolean | hayır | Makine genelindeki yapılandırma dosyasına yaz; bu, bu yöntemin kendi varsayılanıdır. |
workspace | boolean | hayır | Makine genelindeki dosya yerine bu çalışma alanının kendi yapılandırma dosyasına yaz. |
Ek özelliklere izin verilmez.
RegistryUpdateParams
Bir aramanın okuduğu yerel dizini yeniler ve bunun için kayıt defterine erişir. Yazdığı şey, bu çalışma alanının kendi yapılandırılmış önbellek dizini altındaki dizindir. Hiçbir ortam kaynağının taşımadığı bir kimlik bilgisine ihtiyaç duyan bir kayıt defteri, kimlik bilgisi istenmek yerine, kimlik bilgisi adlandırılarak reddedilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
registry | string | hayır | Yenilenecek tek kayıt defteri. Belirtilmezse yapılandırılmış her ana makine yenilenir. |
upgrade | boolean | hayır | Dizinin, zaten tuttuklarına ekleme yapılması yerine yeniden oluşturulup oluşturulmayacağı. |
Ek özelliklere izin verilmez.
LogoutParams
Saklanan bir kayıt defteri kimlik bilgisini kaldırır. Depo, makinedeki tüm projeler tarafından paylaşılır ve yanıt bunu belirtir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
registry | string | hayır | Saklanan kimlik bilgisi kaldırılacak kayıt defteri. |
Ek özelliklere izin verilmez.
PublishEntityParams
Bir varlığı bir kayıt defterinde yayımlar. Yayımlanan şey, o kayıt defterinin tüm tüketicilerinin çözümlediği şeydir ve yayımlanmış bir sürüm, onu zaten almış olan hiç kimseden geri çekilemez. Hiçbir şey için istemde bulunulmaz: kimlik, isteğin sağladığından ya da ortamın zaten taşıdığından çözümlenir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
entity | string | hayır | Yayımlanacak varlık belgesi; çalışma alanı köküne göreli bir yol olarak. |
registry | string | hayır | Yayımlamanın yapılacağı kayıt defteri. Belirtilmezse yapılandırılmış varsayılan kullanılır. |
dryRun | boolean | hayır | Yayımlamanın neyi yerleştireceğinin, yerleştirilmeden raporlanıp raporlanmayacağı. |
sign | boolean | hayır | Yayımlananın imzalanıp imzalanmayacağı. Belirtilmezse hiçbir şey belirtmez ve çözümlenmiş varsayılanı yerinde bırakır. |
plugin | string | hayır | Bir Plugin varlığıyla birlikte yayımlanacak plugin modülü. |
fulcioUrl | string | hayır | İmzalama sertifikasının alınacağı sertifika yetkilisi. |
rekorUrl | string | hayır | İmzanın kaydedileceği şeffaflık günlüğü. |
timestampUrl | string | hayır | Karşı imza için kullanılacak zaman damgası yetkilisi. |
identityToken | string | hayır | İmzalamada kullanılacak kimlik belirteci; bir terminalde elde edilmek yerine çağıran tarafından sağlanır. |
pinSources | boolean | hayır | aggrega/pin’in çalıştırdığı sabitleme adımının, varlık paketlenmeden önce onun üzerinde çalıştırılıp çalıştırılmayacağı; böylece adımın varlığın yanına yazdığı entity.lock yayımlananın bir parçası olur. Adım, varlığı değerlendiren her retten önce çalışır ve dryRun altında yazacağı kilidi raporlar ve hiçbir şey yazmaz. Belirtilmezse çalışma alanının pin_sources_at_push ayarı izlenir; her iki değer de bu istek için o ayarı geçersiz kılar. |
Ek özelliklere izin verilmez.
PublishArtifactParams
Rastgele bir dosyayı, isteğin verdiği bir ad ve etiket altında bir kayıt defterinde yayımlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Yayımlanacak dosya; çalışma alanı köküne göreli bir yol olarak. |
name | string | hayır | Altında yayımlanacak depo adı. |
tag | string | hayır | Altında yayımlanacak etiket. |
mediaType | string | hayır | Yayımlanan baytlar için kaydedilecek medya türü. |
registry | string | hayır | Yayımlamanın yapılacağı kayıt defteri. Belirtilmezse yapılandırılmış varsayılan kullanılır. |
dryRun | boolean | hayır | Yayımlamanın neyi yerleştireceğinin, yerleştirilmeden raporlanıp raporlanmayacağı. |
Ek özelliklere izin verilmez.
SignArtifactsParams
Zaten yayımlanmış olanı imzalar. Bir imza, onu zaten almış olan hiç kimseden geri çekilemez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
references | string[] | hayır | İmzalanacak yayımlanmış başvurular. |
fulcioUrl | string | hayır | İmzalama sertifikasının alınacağı sertifika yetkilisi. |
rekorUrl | string | hayır | İmzanın kaydedileceği şeffaflık günlüğü. |
timestampUrl | string | hayır | Karşı imza için kullanılacak zaman damgası yetkilisi. |
identityToken | string | hayır | İmzalamada kullanılacak kimlik belirteci; bir terminalde elde edilmek yerine çağıran tarafından sağlanır. |
jobs | integer | hayır | Aynı anda kaç başvurunun imzalandığı. Belirtilmezse birbiri ardına imzalanır. Her başvuru yine tek başına imzalanacağı gibi imzalanır — anahtarsız olduğunda kendi sertifikası ve kendi şeffaflık günlüğü girdisiyle — ve yanıt, başvuruların verildiği sırayı korur. En az: 1. |
Ek özelliklere izin verilmez.
DeprecateArtifactParams
Yayımlanmış bir sürümü kullanımdan kaldırılmış olarak işaretler; böylece çözümleme onu raporlayabilir ya da reddedebilir. İşaretin kendisi de yayımlanır ve imzalanır. Bir istek ya içeriğiyle birlikte tek bir başvuru ya da girdileri kendi içeriklerini taşıyan bir toplu iş dosyası gönderir; hiçbir zaman ikisini birden ve hiçbir zaman toplu iş dosyasının yanında içerik göndermez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
reference | string | hayır | İşaretlenecek yayımlanmış başvuru. from alanının alternatifidir: ikisini birden taşıyan bir istek reddedilir. |
severity | const “warning” veya const “error” veya const “retracted” | hayır | İşaretçinin ne kadar güçlü konuştuğu — çözümlemenin sürümü bildirip bildirmeyeceği ya da reddedip reddetmeyeceği. reference ile birlikte zorunludur; toplu iş dosyası her işaretçinin kendi değerini taşıyan from alanının yanında reddedilir. İzin verilen değerler: "warning" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha hafif olanında: bir sürüm seçilirken yine de seçilir. "error" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha güçlü olanında: bir sürüm seçilirken yine de seçilir. "retracted" — Geri çekilmiş: bir sürüm seçilirken dışlanır. |
reason | string | hayır | Sürümün neden kullanımdan kaldırıldığı. reference ile birlikte zorunludur; toplu iş dosyası her işaretçinin kendi değerini taşıyan from alanının yanında reddedilir. |
replacement | string | hayır | Bunun yerine kullanılacak başvuru. Toplu iş dosyası her işaretçinin kendi değerini taşıyan from alanının yanında reddedilir. |
message | string | hayır | İşaretle karşılaşan bir tüketiciye ne söyleneceği. Toplu iş dosyası her işaretin kendi değerini taşıyan from alanının yanında reddedilir. |
from | string | hayır | Geri çekme girdilerinden oluşan, çalışma alanı köküne göreli bir yol olarak verilen ve girdi başına bir işaretçi ekleyen toplu iş dosyası. Her girdi kendi başvurusunu, önem derecesini ve gerekçesini, isteğe bağlı olarak da bir ikameyi ve bir iletiyi taşır. reference alanının alternatifidir: ikisini birden taşıyan ya da onun yanında bir önem derecesi, gerekçe, ikame veya ileti taşıyan bir istek reddedilir. |
fulcioUrl | string | hayır | İmzalama sertifikasının alınacağı sertifika yetkilisi. |
rekorUrl | string | hayır | İmzanın kaydedileceği şeffaflık günlüğü. |
timestampUrl | string | hayır | Karşı imza için kullanılacak zaman damgası yetkilisi. |
identityToken | string | hayır | İmzalamada kullanılacak kimlik belirteci; bir terminalde elde edilmek yerine çağıran tarafından sağlanır. |
Ek özelliklere izin verilmez.
ResolveParams
İmlecin altındaki öğenin nerede tanımlandığını yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
uri | string | hayır | İmlecin bulunduğu belge. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
release | string | hayır | Yanıtın hangi Release’in terimleriyle verileceği, çalışma alanı köküne göre bir yol olarak. Bu durumda tanım, başvurunun, çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri üzerinden, bu sırayla çözümlendiği belgedir; böylece tek bir çalışma alanında her Release için bir tane olmak üzere birkaç varyantın bildirdiği bir ad, o Release’in varyantına gider; bu dizinler böyle bir varlık bildirmiyorsa, çalışma alanının belgeleri aranır ve Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındaki belgeler dışarıda bırakılır. Belirtilmezse önce çalışma alanının belgeleri aranır, çalışma alanının kendi katalog dizinleri ise yalnızca hiçbir belge adı bildirmiyorsa aranır. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
FindReferencesParams
İmlecin altındaki öğeye nerelerde başvurulduğunu yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
uri | string | hayır | İmlecin bulunduğu belge. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
release | string | hayır | Yanıtın hangi Release’in terimleriyle verileceği, çalışma alanı köküne göre bir yol olarak. Bu durumda, Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındaki bir belgede yapılan başvuru bildirilmez; böylece bir çalışma alanının yan yana tuttuğu, her Release için bir tane olan varyantlar hiçbir zaman birbirinin başvuruları olarak bildirilmez. Belirtilmezse çalışma alanının tüm belgeleri aranır. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
FindImplementationsParams
İmlecin altındaki öğeyi hangi belgelerin uyguladığını yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
uri | string | hayır | İmlecin bulunduğu belge. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
release | string | hayır | Yanıtın hangi Release’in terimleriyle verileceği, çalışma alanı köküne göre bir yol olarak. Bu durumda, Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındaki bir belge bildirilmez; böylece başka bir Release’in derlemede kullandığı bir varyant hiçbir zaman bu Release’inkiler arasında listelenmez. Belirtilmezse çalışma alanının tüm belgeleri aranır. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
HoverParams
İmlecin altındaki öğe hakkında neyin gösterileceğini yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
uri | string | hayır | İmlecin bulunduğu belge. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
release | string | hayır | Yanıtın hangi Release’in terimleriyle verileceği, çalışma alanı köküne göre bir yol olarak. Bu durumda gösterilen varlık, başvurunun, çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinleri üzerinden, bu sırayla çözümlendiği varlıktır; bu dizinler böyle bir varlık bildirmiyorsa, çalışma alanının belgeleri aranır ve Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındaki belgeler dışarıda bırakılır. Belirtilmezse önce çalışma alanının belgeleri aranır, çalışma alanının kendi katalog dizinleri ise yalnızca hiçbir belge adı bildirmiyorsa aranır. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
CompletionParams
İmlecin bulunduğu yere neyin yazılabileceğini yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
uri | string | hayır | İmlecin bulunduğu belge. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
context | CompletionContext | hayır | İstemci izliyorsa, isteğe neyin yol açtığı. |
release | string | hayır | Yanıtın hangi Release’in terimleriyle verileceği, çalışma alanı köküne göre bir yol olarak. Bu durumda önerilen adlar, Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındaki belgeler çıkarılmak üzere çalışma alanı belgelerinin bildirdiği adlar ile çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinlerinin bildirdiği Components ve Features’tır. Belirtilmezse bunlar, çalışma alanının belgeleri ile kendi katalog dizinlerinin bildirdiği Components ve Features’tır. Hiçbir Release dosyasını adlandırmayan bir değer reddedilir. |
Ek özelliklere izin verilmez.
CompletionContext
İstemci izliyorsa, isteğe neyin yol açtığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
triggerKind | integer | hayır | Tamamlamanın neden istendiği. |
triggerCharacter | string | hayır | Bir karakter yol açtıysa, buna yol açan karakter. |
Ek özelliklere izin verilir.
AttachCandidatesParams
Bir varlığa hangi Features’ın eklenebileceğini, o varlığın etiketlerine göre değerlendirerek yanıtlar; ayrıca bir grafik düğümünün bileşeninin çizdiği tek bir bağlantı için, bağlantının soketinin bildirdiği her yuvayı hangilerinin doldurabileceğini yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
node | string | hayır | Adaylarla karşılaştırılacak varlık; adıyla belirtilir ve çalışma alanı belgelerinin bildirdiklerinden okunur. |
graphNode | string | hayır | Adaylarla karşılaştırılacak grafik düğümü; etiketleri, derlemenin uygulanabilirliği değerlendirirken kullandığı kesinleşmiş kümedir. Bunun üzerinden hesaplanan bir yanıt, derlemenin ne yapacağını söyler. |
release | string | hayır | Düğümün ait olduğu grafiğin Release’i; çalışma alanı köküne göre göreli bir yol olarak verilir. Adaylar bu durumda o Release’in terimleriyle belirlenir: çalışma alanı yapılandırmasının o Release’e verdiği katalog dizinlerinin bildirdiği Features ile, Release’in okumadığı çalışma alanı katalog dizinlerinden birinin altındakiler çıkarılmış çalışma alanı belgeleri; böylece başka bir Release için tutulan bir Feature, bu Release’in grafiğindeki bir düğüm için hiçbir zaman önerilmez. |
labels | string eşlemi | hayır | Bir varlıktan veya grafik düğümünden okumak yerine doğrudan karşılaştırılacak etiketler. |
connection | ConnectionCoordinate | hayır | graphNode’un adlandırdığı düğümün bileşeninin çizdiği, o düğümün yanı sıra yanıtlanacak tek bir bağlantı: yanıt bu durumda slots’u da taşır; bu, bağlantının soketinin bildirdiği her yuvayı onu doldurabilecek Features ile birlikte içerir, hiçbir yuva doldurulamıyorsa noSlotReason taşır. Yalnızca graphNode ve release ile gönderilir, çünkü bağlantı yalnızca derlenmiş bir grafikte bulunur; node veya labels ile gönderilirse reddedilir. Yanındaki adaylar anlamlarını korur: düğümün kendisine eklenebilecek Features. Belgesi kabul edilir ve bu yanıtı değiştirmez: yuvalar soketin, adaylar Features’ındır; bir ekin hangi belgeye yazıldığından bağımsız olarak aynıdır. |
Ek özelliklere izin verilmez.
ConnectionCandidatesParams
Bir varlık üzerindeki bir soketin hangi varlıklara bağlanabileceğini yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
node | string | hayır | Soketleri sorgulanan varlık. |
socket | string | hayır | Yanıtlanacak tek soket. Verilmezse varlığın bildirdiği her soket için yanıt verilir. |
Ek özelliklere izin verilmez.
InsertionPointParams
Adı verilen bir kapsayıcının altına eklenecek yeni bir girdinin belgede nereye ait olduğunu yanıtlar; girdiyi oluşturmayı ve uygulamayı arabelleğin sahibi olan çağırana bırakır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Hakkında yanıt verilecek belge. |
container | string[] | hayır | Belge içinde, girdinin altına ait olduğu kapsayıcıya giden yol. |
Ek özelliklere izin verilmez.
AttachmentContainerParams
Bir grafik düğümü üzerindeki ya da bileşeninin çizdiği bir bağlantı üzerindeki bir ekin hangi belgeye ve belgenin neresine ait olduğunu yanıtlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
graphNode | string | hayır | Ekin ait olduğu grafik düğümü. |
release | string | hayır | Düğümün ait olduğu grafiğin Release’i; çalışma alanı köküne göre göreli bir yol olarak verilir. |
connection | ConnectionCoordinate | hayır | Ek düğüm için değil de o bağlantı için olduğunda, grafik düğümünün bileşeninin çizdiği tek bir bağlantı: yanıt bu durumda bağlantının kendi features kapsayıcısını, document alanının adlandırdığı belgede belirtir; bu alan burada zorunludur. Aggregate’te bu, düğümün yazıldığı belgedeki bağlantı girdisidir; Release’in çizdiği ve Aggregate’in girdi tutmadığı bir bağlantı için reddedilir. Release’te bu, Release’in düğüm için kendi girdisinin altındaki kenar başına girdidir; Release o bağlantı için henüz bir girdi yazmış olsun ya da olmasın geçerlidir, Release’in düğüm için hiç girdi yazmadığı yerde reddedilir. Bir Feature’ın çizdiği bağlantı her iki belgede de reddedilir, çünkü ek yalnızca bir bileşenin veya Release’in çizdiği bağlantıya yazılır. |
Ek özelliklere izin verilmez.
ConnectionAtPositionParams
Bir Aggregate veya Release içindeki bir konumun hangi bağlantının girdisine düştüğünü yanıtlar: aday ve kapsayıcı isteklerinin aldığı terimlerle grafik düğümü ve bağlantı ya da orada neden hiçbir bağlantı yazılmadığı. Girdiler, bir ekin yazıldığı girdilerdir — bir bileşenin bir bağlantıyı, bağlantının takma adı altında, bileşenin yazıldığı belgede çizdiği girdi ve Release’in yazdığı her kenar başına girdi —; her biri derlenmiş grafiğin kaydettiği yerdedir, böylece bir anahtarın bağlantı olup olmadığı hiçbir zaman adından çıkarılmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Konumun bulunduğu belge: Release ya da Release’in grafiğinin bileşenleri içinde yazılmış olarak kaydettiği bir belge — onun Aggregate’i veya o Aggregate’in içe aktardığı bir modülün belgesi. Önce oturumun onun için tuttuğu içerikten, aksi halde diskten okunur. |
position | Position | hayır | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
release | string | hayır | Derlenmiş grafiği bağlantıları kaydeden Release; çalışma alanı köküne göre göreli bir yol olarak verilir. Aggregate’teki bir konum için de zorunludur, çünkü grafik düğümü ve bağlantı yalnızca derlenmiş bir grafikte bulunur. |
Ek özelliklere izin verilmez.
ConnectionCoordinate
Bir grafik düğümünün bileşeninin çizdiği tek bir bağlantı; bağlandığı soket, o soketteki takma adı ve üzerindeki bir eklentinin yazıldığı belge ile adreslenir. Bir bağlantı, soketinin bildirdiği yuvaları dolduran eklentiler taşır ve bunları Aggregate ya da Release yazabilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
socket | string | evet | Bağlantının üzerinden bağlandığı bağımlılık soketi. |
alias | string | evet | Bağlantının soketi içinde taşıdığı ad. |
document | const “aggregate” veya const “release” | hayır | Bağlantı üzerindeki bir eklentinin yazıldığı belge. Küme kapalıdır ve bunun dışındaki bir değer reddedilir. İzin verilen değerler: "aggregate" — Geliştiricinin eklentiyi bağlantının girdisine yazdığı Aggregate. "release" — Operatörün eklentiyi bağlantı için kenar başına girdiye yazdığı Release. |
Ek özelliklere izin verilir.
SetActiveReleaseParams
.aggrega dizinine bir işaretçi yazarak bir Release’i çalışma alanının varsayılanı olarak kaydeder: aggrega/activeRelease isteğinin bildirdiği seçim, bu işaretçiyi yapılandırmanın yazım Release’inden sonra okur. İşaretçi yalnızca çalışma alanının içine yazılır: .aggrega dizini veya işaretçi çalışma alanının dışına çıkan bir bağlantıysa, gösterdiği yer henüz var olsun ya da olmasın, yazma işlemi bağlantıyı adlandırarak reddedilir ve hiçbir şey yazılmaz. Yanıt, işaretçi yazıldıktan sonra aggrega/activeRelease isteğinin verdiği yanıttır; bu nedenle yapılandırmanın yazım Release’i işaretçiden öncelikli olduğunda farklı bir Release adlandırır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
release | string | hayır | Kaydedilecek Release, çalışma alanı köküne göre bir yol olarak. Mutlak bir yol ve çalışma alanının dışına çıkan bir yol reddedilir; çalışma alanı yapılandırması o Release’i adlandırmadıkça, bir bağlantı üzerinden dışarı çıkan yol da reddedilir. |
Ek özelliklere izin verilmez.
EditDocumentParams
Çalışma alanının taşıdığı bir belgeye sınırlı tek bir düzenleme uygular: bir kapsayıcının altına eklenen tek bir girdi ya da ayarlanan tek bir skaler değer. Oluşturulan belge kendi türünün şemasına göre denetlenir ve yalnızca bu denetimi geçerse diske ulaşır; bu nedenle yazım şemasının reddettiği bir şey yazılamaz. Reddedilen bir düzenleme dosyayı bayt bayt olduğu gibi bırakır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
file | string | hayır | Düzenlenecek belge. |
edit | const “add-component” veya const “attach-feature” veya const “wire-edge” veya const “set-value” | hayır | Hangi düzenlemenin uygulanacağı. İzin verilen değerler: "add-component" — Bir components kapsayıcısının altına bir bileşen örneği ekler: name örnek adıdır, value istediği Component’tir. "attach-feature" — İsteğin adlandırdığı düğüme bir Feature ekler: name eklentinin örnek adıdır, value istediği Feature’dır. "wire-edge" — İsteğin adlandırdığı düğümden, socket içinde bir bağımlılık bağlantısı kurar: name bağlantının adreslendiği takma addır, value işaret ettiği düğümdür. "set-value" — İsteğin adlandırdığı düğümde bir değer ayarlar: name değerin anahtarıdır, value bir skalerdir. |
node | string[] | hayır | Belge içinde düzenlenen girdiye giden yol. |
socket | string | hayır | Bir soketi bağlayan düzenleme için, düzenlemenin ilgili olduğu soket. |
name | string | hayır | Düzenlemenin yazdığı ad. |
value | herhangi | hayır | Düzenlemenin yazdığı değer, düzenleme hangi biçimi alıyorsa o biçimde. |
dryRun | boolean | hayır | Oluşturulan belgeyi yazmak yerine onunla yanıt verilip verilmeyeceği. |
Ek özelliklere izin verilmez.
ConfigInitParams
Bir yapılandırma belgesi oluşturur. Bir kayıt defteri ve onda güvenilen kimlikler makine genelindeki araçlar olduğundan, varsayılan olarak makine genelindeki dosyayı yazar. Duyurduğu güven politikasını okumak için adı verilen kayıt defterine erişir; hiçbir şey duyurmayan bir kayıt defteri bu şekilde bildirilir ve oluşturma işlemi devam eder: resmî hub için yerleşik temel politikayla, diğer kayıt defterleri için ise hiçbir politika olmadan.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
registry | string | hayır | Yapılandırmanın oluşturulacağı kayıt defteri. |
force | boolean | hayır | Zaten var olan bir yapılandırma belgesinin üzerine yazılıp yazılmayacağı. |
global | boolean | hayır | Makine genelindeki yapılandırma dosyasına yaz; bu, bu yöntemin kendi varsayılanıdır. |
workspace | boolean | hayır | Makine genelindeki dosya yerine bu çalışma alanının kendi yapılandırma dosyasına yaz. |
dryRun | boolean | hayır | Kendi belge modelini tutan bir istemci için, belgeyi yazmak yerine içeriğiyle yanıt verilip verilmeyeceği. |
Ek özelliklere izin verilmez.
ConfigCaptureParams
Çözümlenmiş yapılandırmayı bu çalışma alanının kendi belgesine dondurur; böylece çalışma alanı kendi kendine yeterli olur. Her zaman o çalışma alanının dosyasını yazar ve onun dışındaki hiçbir şeye erişmez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
allPlugins | boolean | hayır | Yalnızca çalışma alanının kendisinin yapılandırdıkları yerine, eklenmiş her eklentinin dondurulup dondurulmayacağı. |
Ek özelliklere izin verilmez.
ImportParams
Yabancı bir kaynak tanımını taslak yazım belgelerine dönüştürür ve bunların yanına, içe aktarmanın ne yazdığının kaydı olan .aggrega-import.json dosyasını yazar — verildiği yerde kendisine verilen hedef, okuduğu yerde okuduğu katalog anlık görüntüsü, taslağı oluşturulan her dosya ve taslağı oluşturulan bir Aggregate ya da Release’in her derinlikteki her anahtarı —; bu kaydı daha sonraki bir eşitleme okur. Tam olarak dönüştürülemeyen bir kaynak bir hata değil, bir yanıttır: üretilen taslaklar yazılır ve bulgular neyin dönüştürülemediğini söyler — durmuş bir dönüştürmeden hiçbir şey yazmayan eşitleme (sync) dışında.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
source | string | hayır | Dönüştürülecek dosya ya da dizin; mutlak bir yol ya da çalışma alanı köküne göre bir yol olarak. Bunu içermeyen bir istek reddedilir. Çalışma alanının içinde olsun ya da olmasın bulunduğu yerde okunur ve bir dizin, içindeki dosyalardan içe aktarıcının bildirdiği dosya kalıplarının seçtiği dosyalar olarak okunur. |
outputDir | string | hayır | Taslakların yazılacağı, çalışma alanı altındaki dizin; çalışma alanı köküne göre. Mutlak bir değer ya da yazıldığı biçimiyle veya bir bağlantı üzerinden çalışma alanının dışına çıkan bir değer reddedilir. Verilmediğinde, aynı dönüştürmenin hedef belirtmeden bir terminalde çalıştırıldığında yazdığı yere, yani çalışma alanı kökünün altına yazılır. Taslağı oluşturulan her yol, dryRun altında da, yanıtın outputDir olarak adlandırdığı dizine göredir. |
format | string | hayır | Kaynak biçimi. Verilmediğinde biçimi dönüştürme belirler. |
target | string | hayır | Taslakların yanına manifest.yaml olarak bir Manifest taslağı oluşturulacak, compose ya da helm gibi bir provider yeteneği — bir Recipe’in spec.capability alanının bağlandığı sözcük —: taslakların ihtiyaç duyduğu her bileşen türü ve özellik türü, taslağı oluşturulan Aggregate’in oluşturduğu bir katalog Aggregate’inin türleri de dahil olmak üzere, çalışma alanının kataloğunun o tür için sunduğu, o yeteneğe ait Recipe’e ya da özellik tarifine eşlenir — tek bir tane varsa o, birkaç tane varsa türün adını taşıyan —; hiç olmayan ya da birkaç tane olup hiçbiri bu şekilde adlandırılmamış bir tür eşlenmeden bırakılır ve onu adlandıran bir uyarı bulgusu verilir; bir içe aktarıcının kendisinin taslağını oluşturduğu bir eşleme, katalog onu o tür ve yetenek için sunuyorsa korunur, aksi halde bir uyarı bulgusuyla atılır; taslağı oluşturulan Release’in spec.manifest alanı da bu Manifest’e ayarlanır. Katalogdaki hiçbir Recipe’in bağlanmadığı bir yetenek, dönüştürme çalışmadan reddedilir ve hiçbir şey yazılmaz. Verilmediğinde hiçbir Manifest taslağı oluşturulmaz; ancak eşitleme (sync) altında, önceki içe aktarmanın kaydının adlandırdığı hedef için taslak oluşturulur. Bir hedef adlandıran eşitleme o hedef için taslak oluşturur ve kayıt bundan sonra onu adlandırır. |
dryRun | boolean | hayır | İsteğin yazacağı her dosyanın içeriğinin, yazılmak yerine yanıt olarak verilip verilmeyeceği. Diğer her davranış yazmanınkiyle aynıdır; bu yüzden yazmanın reddedeceği bir istek bu seçenek altında da reddedilir. sync ile birlikte, eşitlemenin yazacağını ve sapma gösterecek her parçayı yanıt olarak verir. |
sync | boolean | hayır | Taslağı bütünüyle yazmak yerine, önceki bir içe aktarmanın outputDir altında oluşturduğu taslağın kaynakla güncel hâle getirilip getirilmeyeceği. Yalnızca içe aktarmanın yazdığı, taslakların yanındaki kaydın listelediği şekliyle değişir: kaynağın dokunmadığı bir parça, düzenlenmiş olsun ya da olmasın diskte olduğu gibi kalır; kaynağın değiştirdiği, çıkardığı ya da eklediği bir parça, diskte olan içe aktarmanın en son yazdığı olduğunda yeniden yazılır, kaldırılır — taslağı oluşturulan bir dosya bütünüyle silinir — ya da eklenir; geri kalan her şey, yani bir yazarın eklediği bir anahtar — taslağı oluşturulan bir Release’in yazarına bıraktığı ortam da bunlar arasındadır — ya da taslağı oluşturulan bir anahtarın hemen üstüne yazılmamış bir yorum, bayt bayt aynı kalır. Bir yazarın düzenlediğini ya da eklediğini değiştirecek veya kaldıracak ya da bir yazarın zaten bir parça yazdığı yere parça ekleyecek bir eşitleme her parçayı adlandırarak reddedilir; hiçbir kaydın listelemediği bir Aggregate üzerindeki eşitleme de reddedilir; her iki durumda da hiçbir şey yazılmaz. Bu seçenek olmadan, taslakları outputDir içinde zaten bulunan bir Aggregate’in üzerine yazılacak bir istek, dryRun altında da reddedilir. |
upgrade | boolean | hayır | Çalışma alanının varsayılan kayıt defterinin yayımladığı en yeni katalog anlık görüntüsünün getirilip içe aktarmanın ona göre yapılıp yapılmayacağı; getirilen görüntü bundan sonra çalışma alanının tuttuğu ya da taslakların yanındaki kaydın belirttiği görüntünün yerine tutulur. Çalışma alanı bir katalog klasörü belirtiyorsa hiçbir şeyi değiştirmez ve çevrimdışıyken reddedilir. |
answers | string | hayır | Taslakların boş bıraktığı ve hiçbir kaynağın tutamayacağı değerlerin okunduğu ve yazıldığı yanıtlar dosyası, çalışma alanı köküne göreli; mutlak bir değer ya da yazıldığı haliyle veya bir bağlantı üzerinden çalışma alanının dışına çıkan bir değer reddedilir. Dosya, taslağı oluşturulan her dosyanın yolu altında o belgedeki anahtar yolunu ve yanıtını tutar ve yanıtlar taslaklara yazılır. Verilmediğinde taslakların yanındaki kaydın adlandırdığı dosya, o da yoksa kaynak dosyanın yanındaki ya da kaynak dizinin içindeki import-answers.yaml okunur. Bir gizli bilginin yanıtı, gizli bilginin nereden geldiğini adlandırır — bir değişken adı, ${NAME} ya da bir Kubernetes Secret nesnesinin adı — ve başka her şey reddedilir, hiçbir şey yazılmaz. Hiçbir şey sorulmaz: hâlâ eksik olan her değer, yanıtın owed alanındaki bir girdi ve taslak dosyayı, anahtarı ve ne olduğunu adlandıran bir uyarı bulgusudur, yanıtı answered olarak gönderilir; taslakların yazıldığı durumda son bulgu kaç değerin eksik olduğunu ve nerede olduğunu söyler. Taslaklar bir Release içerdiğinde, hiçbir eksik kalmadığında ve dönüştürme tamamlandığında, ardından bağımlılıkları çekilir ve kilit dosyası yazılır; başarısız olan bir çekme işlemi bulguları nedenini söyleyerek kapatır, taslaklar ise yazılmış olur; çevrimdışıyken hiçbir şey çekilmez ve bir bulgu çalıştırılacak çekme işlemini adlandırır. Bu taslakların boş bırakmadığı bir anahtar için verilen yanıt dosyada tutulur ve uygulanmaz; böylece tek bir yanıtlar dosyası her hedefe hizmet eder. |
answered | ImportAnswered[] | hayır | Yanıtın owed alanının listelediği değerler için yanıtlar; her biri taslak dosyayı ve anahtarları owed’un adlandırdığı gibi adlandırır. Her biri, bir terminalde yazılan bir yanıtla tam olarak aynı şekilde değerlendirilir, yanıtlar dosyasında tutulur ve taslaklara yazılır: bir gizli bilginin yanıtı, gizli bilginin nereden geldiğini adlandırır — bir değişken adı, ${NAME} ya da bir Kubernetes Secret nesnesinin adı — ve bunu yapmayan bir yanıt ne tutulur ne de yazılır, değeri ise neden secretAdvice olarak verilerek eksik kalır. Yanıtlar dosyasının zaten yanıtladığı bir değer dosyadan yanıtlanır; boş bir yanıt ya da taslakların eksik bırakmadığı bir değeri adlandıran bir yanıt uygulanmaz. Taslaklar yazıldıktan sonra bunu sync ile gönderin, çünkü sync olmayan bir istek outputDir içinde zaten bulunan bir Aggregate üzerinde reddedilir. Hiçbir yanıtı tutmayan dryRun altında ve dönüştürmesi durmuş, hiçbir şey yazmayan bir sync altında gönderilen hiçbir yanıt uygulanmaz. |
Ek özelliklere izin verilmez.
ScaffoldEntityParams
Bir varlık türü için başlangıç belgesinin taslağını oluşturur ya da dokümantasyonun çalıştırılabilir örneklerinden birini çalışma alanındaki yeni bir dizine yazar ya da bunları listeler. Taslak oluşturma, iskeleti ikili dosyanın taşıdığı şema kümesinden türetir; bu nedenle bir çalışma alanından hiçbir şey okunmaz ve hiçbir şey yazılmaz — yanıt metindir ve nereye gideceği istemciye kalmıştır. Bir örneği yazmak yalnızca yeni dizini yazar, başka hiçbir şeyi yazmaz; örnekler, ikili dosyanın sürümü için yayımlanmış imzalı dokümantasyon paketinden ya da böyle bir paket yoksa ondan önce yayımlanmış en yeni paketten okunur ve paket saklanmadan veya okunmadan önce çalışma alanının imza politikasına göre doğrulanır: doğrulanmayan bir paket reddedilir ve çevrimdışıyken yalnızca önbellekte zaten bulunan bir kopya okunur. İki biçimin alanlarını birlikte gönderen bir istek — example veya list ile kind, example ile list, example veya list ile name, example olmadan dir — herhangi bir şey okunmadan önce reddedilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | string | hayır | Çalışma alanının mutlak yolu. Taslak oluşturma bunu okumaz. Bir örneği yazmak veya listelemek bunu gerektirir: dokümantasyonun nereden getirileceğine ve hangi imzaları taşıması gerektiğine çalışma alanının yapılandırması karar verir ve örnek onun içine yazılır. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
kind | string | hayır | Taslağı oluşturulacak varlık türü; component, aggregate, release, recipe ya da featurerecipe gibi küçük harfli belirteciyle adlandırılır — aggrega/getSchema komutunun onun için listelediği belirteç. |
name | string | hayır | Taslağı oluşturulan belgeye yazılacak ad. Yalnızca kind ile birlikte gönderilir. |
example | string | hayır | Yazılacak çalıştırılabilir örnek, örnek listesinin ona verdiği adla. kind yerine gönderilir. |
list | boolean | hayır | Hiçbir şey yazmadan, dokümantasyonun yayımladığı her çalıştırılabilir örnekle yanıt verilip verilmeyeceği. example olmadan ve kind olmadan gönderilir. |
dir | string | hayır | Örneğin yazılacağı yeni dizin, çalışma alanının köküne göreli; verilmezse örnek orada örneğin adını taşıyan bir dizine yazılır. Dizin henüz mevcut olmamalı veya boş olmalıdır: herhangi bir şey içeren bir dizin reddedilir ve olduğu gibi bırakılır; mutlak bir değer ya da yazıldığı haliyle veya bir bağlantı üzerinden çalışma alanının dışına çıkan bir değer, herhangi bir şey okunmadan önce reddedilir. Yalnızca example ile birlikte gönderilir. |
Ek özelliklere izin verilmez.
LintParams
Katalog yayımlama uzlaşımlarını tek bir varlık, bir Release’in kapanışının ulaştığı her şey ya da yapılandırılmış katalog dizinleri altındaki her şey üzerinde denetler. Hiçbir kipte hiçbir şey yazılmaz. Ne bir varlık ne de bir Release adlandırıldığında katalogun tamamı denetlenir: yapılandırması kendine ait Release katalog dizinleri vermeyen bir çalışma alanında, çalışma alanının dizinleri üzerinde bir kez; workspace.releases altında Releases adlandıran bir çalışma alanında, her Release için o Release’in okuduğu dizinler üzerinde bir kez, hiçbir zaman hepsi birlikte değil.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
entity | string | hayır | Denetlenecek tek varlık belgesi. |
release | string | hayır | Kapanışı denetlenecek Release; çalışma alanı köküne göre bir yol olarak. |
prePublish | boolean | hayır | Her varlığın daha önce yayımlanmış sürümüyle karşılaştırılıp karşılaştırılmayacağı; bu, yapılandırılmış kayıt defterlerine erişir. |
Ek özelliklere izin verilmez.
PluginAddParams
Çalışma alanının yapılandırdığı bir sokete bir eklenti bağlar. Sorguyu tek bir eklentiye çözümlemek ve bir sürümü sabitlemek için bir kayıt defterine erişir. Bir terminalin alacağı tek karar — bir komut uzantısı eklentisinin bildirdiği yetenekleri kabul etmek — burada bir alan olarak gelir; böylece istemci kendisini kim yönetiyorsa ona sorar ve bu arayüz hiçbir zaman bir istemi beklemez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
type | string | hayır | Eklentinin bağlandığı soket. |
query | string | hayır | Tek bir eklentiye çözümlenecek olan. |
capability | string | hayır | Soket birden fazla yetenek taşıdığında, bağlamanın hangi yetenek için olduğu. |
role | string | hayır | Bağlamanın çalıştığı rol; neyi üretebileceğini bu belirler. |
global | boolean | hayır | Makine genelindeki yapılandırma dosyasına yaz. |
workspace | boolean | hayır | Bu çalışma alanının kendi yapılandırma dosyasına yaz. |
acceptCapabilities | boolean | hayır | Çağıranın, bir komut uzantısı eklentisinin bildirdiği yetenekleri kabul edip etmediği. |
dryRun | boolean | hayır | Yapılandırma belgesini yazmak yerine içeriğiyle yanıt verilip verilmeyeceği. |
Ek özelliklere izin verilmez.
PluginRemoveParams
Çalışma alanının yapılandırdığı bir soketten bir eklentiyi ayırır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
type | string | hayır | Eklentinin bağlı olduğu soket. |
query | string | hayır | Hangi bağlamanın kaldırılacağı. |
global | boolean | hayır | Makine genelindeki yapılandırma dosyasına yaz. |
workspace | boolean | hayır | Bu çalışma alanının kendi yapılandırma dosyasına yaz. |
Ek özelliklere izin verilmez.
PluginSyncParams
Bir Plugin varlığının makineye ait kayıtlarını işaret ettiği modülle hizalar. Bu kayıtları yeniden yazar ve belgenin diğer her baytını değiştirmeden korur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
entity | string | hayır | Hizalanacak Plugin varlık belgesi. |
plugin | string | hayır | Kayıtların okunacağı eklenti modülü. |
Ek özelliklere izin verilmez.
PluginGenCatalogParams
Bir eklentinin kendi bildirdiği meta verilerden ve yazılmış bir katmandan Plugin katalog belgeleri üretir. Değişmemiş girdiler üzerinde yeniden üretmek bayt bayt aynı belgeleri üretir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
fromEmbedded | boolean | hayır | Meta verilerin, ikili dosyanın zaten taşıdığı eklentilerden okunup okunmayacağı. |
plugin | string | hayır | Meta verilerin okunacağı eklenti modülü. |
outputDir | string | hayır | Belgelerin yazılacağı, çalışma alanı altındaki dizin. |
overlay | string | hayır | İçeriği üretilen meta verilerin üzerine birleştirilen yazılmış belge. |
dryRun | boolean | hayır | Belgeleri yazmak yerine içerikleriyle yanıt verilip verilmeyeceği. |
Ek özelliklere izin verilmez.
ExplainErrorParams
Bir bulgunun taşıdığı kodu, derleyicinin o durum hakkında bildirdiklerine ve yazımdaki düzeltmeyi öğreten yayımlanmış girdilere genişletir. Çalışma alanında kopya yoksa yayımlanmış belgeleri edinir; edinemediği durumda yine de ikili dosyanın bildirdiklerini yanıtlar ve açıklama metninin neden eksik olduğunu belirtir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
code | string | hayır | Genişletilecek durum; bir bulgunun taşıdığı kodla ya da kısa koduyla adlandırılır. |
Ek özelliklere izin verilmez.
GetSchemaParams
Bir türün şemasıyla ya da — hiçbir tür adlandırılmadığında — hangi türlerin adlandırılabileceğiyle yanıt verir. Başka bir yere kurulu kopya için değil, çalışan ikili dosya için yanıt verir; bu nedenle bir çalışma alanına ihtiyaç duymaz ve hiçbirini okumaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootAccepted | hayır | Bir çalışma alanının mutlak yolu. Bu yöntemin konusu bir çalışma alanı değildir — yanıtını ikili dosyanın kendi taşıdıklarından verir — bu nedenle alan kabul edilir ama okunmaz. Bir istemcinin, hangi yöntemlerin ona başvurduğunu bilmek zorunda kalmadan onu her istekte tek tip olarak gönderebilmesi için kabul edilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
kind | string | hayır | Şemasıyla yanıt verilecek tür. Belirtilmezse bunun yerine adlandırılabilecek türlerle yanıt verilir. |
Ek özelliklere izin verilmez.
SkillsInstallParams
İkili dosyaya yerleşik asistan becerisini, isteğin adlandırdığı her asistanın ya da hiçbirini adlandırmayan global bir istek için bu makinede bulunan her asistanın beceri klasörüne yazar. global olmadan, isteğin adlandırdığı çalışma alanı içindeki her asistanın proje klasörüne yazar ve orada yazacağı her yol o çalışma alanıyla sınırlanır; global ile ev dizini altındaki her asistanın kullanıcıya özgü klasörüne yazar. Herhangi bir şey yazılmadan önce her hedef denetlenir; bu nedenle bir ret, her klasörü olduğu gibi bırakır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
workspaceRoot | WorkspaceRootSubject | evet | Bu isteğin üzerinde çalıştığı çalışma alanının mutlak yolu. İsteğin konusudur: daemon, yöntem çalışmadan önce onu çözümler; onu atlayan ya da dize dışında bir biçimde yazan bir istek reddedilir. |
workDoneToken | ProgressToken | hayır | Çağıranın, ilerleme bildirimlerini onları isteyen çağrıyla eşleştirebilmek için ürettiği bir değer. Her bildirimde değiştirilmeden geri döndürülür; böylece çağıran onu gönderdiği değerle karşılaştırabilir. Her istekte kabul edilir; ilerleme yeteneği bildirmemiş bir oturumda bunu gönderen bir istek reddedilir. |
agents | string[] | hayır | Becerinin kurulacağı asistanlar, listenin bildirdiği tanımlayıcılarla. Hiçbirini adlandırmayan bir proje isteği reddedilir. Hiçbirini adlandırmayan global bir istek, beceriyi bu makinede bulunan asistanlar için, yani yapılandırma klasörü ev dizininde olan ya da komutu PATH üzerinde bulunan her asistan için kurar; hiçbiri bulunamazsa hiçbir şey yazılmadan reddedilir. Beceri klasörü bilinmeyen bir tanımlayıcı adıyla belirtilerek reddedilir ve iki kez verilen bir tanımlayıcı bir kez kurulur. |
global | boolean | hayır | Çalışma alanındaki proje klasörü yerine, her asistanın ev dizini altındaki ve her projede okuduğu kullanıcıya özgü beceri klasörüne yaz. |
Ek özelliklere izin verilmez.
ServerCapabilities
Arka plan hizmetinin bu oturumda ne yapacağı; istemcinin işleyebileceğini söylediklerine göre belirlenir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
positionEncoding | string | evet | Bu oturumdaki her konumun ifade edildiği kodlama. |
workDoneProgress | boolean | hayır | Arka plan hizmetinin bu oturumda ilerleme bildirimleri gönderip göndermeyeceği. Yalnızca istemci bunları alabileceğini bildirdiğinde bulunur. |
Ek özelliklere izin verilmez.
ClosureEntity
Bir Release’in bağımlı olduğu, çözümlemenin belirlediği sürümdeki tek bir varlık.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | evet | Varlığın çözümlendiği başvuru. |
version | string | evet | Üzerinde karar kılınan sürüm. |
kind | string | hayır | Varlık türü. |
source | string | hayır | Bu girdiyi üreten çalıştırmanın varlığı nereden aldığı; aggrega pull --detail komutunun bunun için yazdırdığı sözcükle: fetched-fresh (o çalıştırma sırasında bir registry’den getirildi), cache-reuse (önbellekte zaten bulunan, getirilmeden yeniden kullanılan bir kopya), local (yerel dosya sisteminde, örneğin bir katalog dizininde bulundu), in-binary (derleyici ikili dosyasının içindeki kopya) veya external (Release’in kendi Aggregate’i ya da Manifest’i; bağımlılıklarından biri olarak çözümlenmek yerine Release’in adlandırdığı dosyadan veya girdiden okunur; çalıştırmanın bir registry’den getirdiği bir Aggregate ise bunun yerine fetched-fresh olur). Bir bağımlılık çözümlemesi raporunun girdilerinde bulunur ve orada o çalıştırmanın bu makinede ne yaptığını açıklar; bir Release’in çözümlenmiş bağımlılıklarının listesinde ise bulunmaz, çünkü bu liste Release’in neye bağımlı olduğunu açıklar. Kilit dosyası kaynak kaydetmez. Çalıştırmanın kaynağını kaydetmediği bir varlık için atlanır. |
Ek özelliklere izin verilmez.
ToolchainCorePlugin
Derleyicinin kendi içinde taşıdığı tek bir plugin ve onun kullanılan sürümü.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
plugin | string | evet | Plugin’in başvurusu. |
version | string | evet | Kullanılan sürüm. |
Ek özelliklere izin verilmez.
ToolchainReport
Çözümlemeyi yapan derleyici ve taşıdığı plugin’ler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
compilerVersion | string | evet | Çözümlemeyi yapan derleyici sürümü. |
corePlugins | ToolchainCorePlugin[] | hayır | Derleyicinin taşıdığı plugin’ler ve her birinin kullanılan sürümü. |
Ek özelliklere izin verilmez.
DependencyResolutionReport
Bir bağımlılık çözümlemesinin sabitlediği ve edindiği şeyler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
lockfile | string | evet | Çözümlemenin yazdığı kilit dosyası veya bir doğrulamanın karşılaştırdığı kilit dosyası. |
verified | boolean | hayır | İsteğin bir doğrulama olup olmadığı; doğrulama kayıtlı kilit dosyasını karşılaştırır ve kilit dosyası, plugin güven kaydı veya entity.lock yazmaz. |
entities | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı varlıklar. |
libraries | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı kütüphaneler. |
plugins | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı plugin’ler. |
sourceArtifacts | integer | evet | Kaç kaynak yapıtın edinildiği. |
trustedPlugins | integer | evet | Sabitlenen plugin’lerden kaçının doğrulanmış bir imza taşıdığı. |
toolchain | ToolchainReport | hayır | Çözümlemeyi yapan derleyici ve taşıdığı plugin’ler. |
externalInputs | integer | evet | İşlemenin tükettiği dış girdilerden kaçının edinildiği. |
incompleteExternalInputs | string | hayır | Bazıları edinilemediğinde, hangi dış girdilerin edinilemediği. |
Ek özelliklere izin verilmez.
BuildNotice
Derlemenin çağırana bildirmek istediği, ne bir belgeyle ilgili bulgu ne de bir hata olan tek bir şey.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
class | string | evet | Bunun ne tür bir bildirim olduğu. |
text | string | evet | Bildirimin söyledikleri. |
Ek özelliklere izin verilmez.
CacheScope
Bir önbellek yanıtının ne kadar geniş bir alana eriştiği. Önbellek sınıflarından ikisi makinedeki tüm projelerce paylaşılır; bu nedenle her önbellek yanıtı hangilerine dokunduğunu belirtir — aksi hâlde tek bir çalışma alanı üzerinde açılmış bir oturum yalnızca o çalışma alanı hakkında rapor veriyor gibi okunurdu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
machineWideClasses | string[] veya null | evet | Bu yanıtın dokunduğu ve makinedeki tüm projeler arasında paylaşılan önbellek sınıfları. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
Ek özelliklere izin verilmez.
CacheElement
Bir önbelleğin tuttuğu tek bir şey.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
label | string | evet | Girdinin neye ait olduğu. |
size | integer | evet | Kaç bayt yer kapladığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
digest | string | hayır | Varsa, girdinin altında anahtarlandığı içerik özeti. |
note | string | hayır | Girdiyle ilgili belirtilmeye değer başka her şey. |
Ek özelliklere izin verilmez.
CacheClass
Daemon’un rapor verdiği tek bir önbellek.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Bunun hangi önbellek olduğu. |
reach | string | evet | Önbelleğin bu çalışma alanına mı ait olduğu, yoksa makine genelinde mi paylaşıldığı. |
prunable | boolean | evet | Bu önbelleğin geri kazanılmasının daemon’un yapacağı bir şey olup olmadığı. |
elements | CacheElement[] veya null | evet | Önbelleğin tuttukları. |
Ek özelliklere izin verilmez.
CacheProvenance
Önbelleğe alınmış bir yapıtın hangi kimlikler altında edinildiği ve ne kadar geniş paylaşıldığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
identities | string[] veya null | evet | Yapıtın atfedildiği kimlikler. |
sharedBy | integer | hayır | Yapıtı kaç sahibin paylaştığı. |
Ek özelliklere izin verilmez.
CacheRemoval
Bir geri kazanımın kaldırdığı tek bir şey — ya da yerinde bıraktıklarının listesinde, kaldıracak olduğu tek bir şey.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
class | string | evet | Hangi önbelleğe ait olduğu. |
label | string | evet | Ne olduğu. |
reach | string | evet | O önbelleğin bu çalışma alanına mı ait olduğu, yoksa makine genelinde mi paylaşıldığı. |
size | integer | evet | Kaç bayt yer kapladığı veya kaldırılmadan önce kapladığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
Ek özelliklere izin verilmez.
CacheShortfall
Bir geri kazanımın geride bıraktıkları ve bunları neyin geri kazanacağı; böylece beklediğinden küçük bir rakam okuyan çağıran, nedenini tahmin etmek yerine öğrenir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
class | string | evet | Geride kalanları hangi önbelleğin tuttuğu. |
count | integer | evet | Kaç girdinin geride kaldığı. |
size | integer | evet | Bunların kaç bayt yer kapladığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
reach | string | evet | O önbelleğin bu çalışma alanına mı ait olduğu, yoksa makine genelinde mi paylaşıldığı. |
reclaimedBy | string[] veya null | evet | Bunları neyin geri kazanacağı. |
Ek özelliklere izin verilmez.
CacheCleared
Bir temizlemenin boşalttığı tek bir önbellek.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
class | string | evet | Hangi önbelleğin boşaltıldığı. |
reach | string | evet | Bu çalışma alanına mı ait olduğu, yoksa makine genelinde mi paylaşıldığı. |
size | integer | evet | Ondan kaç bayt geri kazanıldığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
heldOpenFiles | integer | evet | Başka bir süreç açık tuttuğu için temizlemenin bu önbellekte bıraktığı dosya sayısı. Açık bir dosyayı kaldırmayı yalnızca Windows reddeder; bu nedenle diğer her yerde bu değer sıfırdır. Sonraki bir temizleme, o süreç dosyalarla işini bitirdiğinde bunları kaldırır. |
heldOpenBytes | integer | evet | Bu dosyaların kaç bayt yer kapladığı. Bunlar, temizlemenin geri kazandığını gösteren boyuta dahil edilmez. |
heldOpenBytesText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
Ek özelliklere izin verilmez.
ConfigWriteScope
Hangi yapılandırma belgesinin yazıldığı ve ne kadar geniş bir alana eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili okunurdu — makine genelindeki bir yazma için ise bu okuma yanlıştır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
configFile | string | evet | Yazılan belge. |
machineWide | boolean | evet | O belgenin, makinedeki her çalışma alanının üzerinden çözümlendiği belge olup olmadığı. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
Ek özelliklere izin verilmez.
PluginWriteScope
Bir plugin değişikliğinin hangi yapılandırma belgesine yazıldığı ve ne kadar geniş bir alana eriştiği. Komut uzantısı soketinin kendi varsayılanı makine genelindeki belgedir; bu nedenle her yanıt hangisine yazdığını belirtir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
configFile | string | evet | Yazılan belge. |
machineWide | boolean | evet | O belgenin, makinedeki her çalışma alanının üzerinden çözümlendiği belge olup olmadığı. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
Ek özelliklere izin verilmez.
CredentialStoreScope
Bir kimlik bilgisi değişikliğinin ne kadar geniş bir alana eriştiği. Depo, makinedeki tüm projelerce ve aynı registry’lere erişen diğer tüm araçlarca paylaşılır; bu nedenle yanıt, oturumla sınırlı bir okumanın çıkarsanmasına bırakmak yerine bunu bildirir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
machineWide | boolean | evet | Değişikliğin dokunduğu deponun makine genelinde paylaşılıp paylaşılmadığı. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
Ek özelliklere izin verilmez.
SkillFolderScope
Bir beceri kurulumunun ne kadar uzağa eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili olarak okunur — ve bir asistanın her projede okuduğu kullanıcıya özgü klasörler için bu okuma yanlıştır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
machineWide | boolean | evet | Yazılan klasörlerin, asistanın makinedeki her projede okuduğu, ev dizini altındaki kullanıcıya özgü klasörler olup olmadığı. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
Ek özelliklere izin verilmez.
PublicationReach
Bir yayının ne kadar uzağa ulaştığı. Bu yanıtlar tamamen bu makinenin ötesine ulaşır — ekledikleri şey, o kayıt defterinin her tüketicisinin çözümlediği şeydir — bu nedenle her biri eriştiği her kayıt defterini ve çağrının oraya bir şey ekleyip eklemediğini belirtir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
registries | string[] | evet | Çağrının eriştiği her kayıt defteri ana bilgisayarı; her biri bir kez, çağrının ona ilk eriştiği sırayla belirtilir. Tek başvurulu bir çağrı bir tane belirtir; deneme çalıştırması erişeceği hedefi belirtir. |
beyondThisMachine | boolean | evet | Çağrının, bir kayıt defterinin artık başkalarına sunduğu herhangi bir şey ekleyip eklemediği: yüklenmiş içerik, bir imza, bir yayın tarihi veya bir kullanımdan kaldırma işaretçisi. Deneme çalıştırmasında ve ekleyeceği her şeyi zaten orada bulan bir çağrıda false olur — tamamlanmış bir sürüm üzerinde yeniden çalıştırılan bir yayın ya da her başvurusu zaten doğrulanan bir imza taşıyan bir imzalama grubu gibi. |
Ek özelliklere izin verilmez.
WorkspaceEntityRef
Türü ve adıyla, onu bildiren belgeyle birlikte bir varlık.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Varlık türü. |
name | string | evet | Varlık adı. |
file | string | evet | Onu bildiren belge; çalışma alanı köküne göreli bir yol olarak. |
Ek özelliklere izin verilmez.
SourcedEntityRef
Nereden okunduğuyla birlikte bir varlık. Bir çalışma alanı belgesi, çalışma alanına göreli yolunu bildirir; yapılandırılmış katalog dizinlerinden çözümlenen bir varlık boş bir yol bildirir, çünkü sahip olduğu tek yol bir istemci için hiçbir anlam taşımaz. Köken, boş bir yolu kimsenin doldurmadığı bir alan olarak okunmaya bırakmak yerine, bunun ikisinden hangisi olduğunu söyler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Varlık türü. |
name | string | evet | Varlık adı. |
file | string | evet | Onu bildiren belge; çalışma alanı köküne göreli bir yol olarak ya da yapılandırılmış katalog dizinlerinden geldiği durumda boş. |
origin | string | evet | Varlığın nereden okunduğu. |
Ek özelliklere izin verilmez.
SocketCandidacy
Bir varlık üzerindeki bir soket ve ona nelerin bağlanabileceği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
socket | string | evet | Soketin adı. |
declaration | string | evet | Soketin bildirildiği yer. |
selector | string | evet | Bir hedefin karşılaması gereken etiket seçicisi. |
required | boolean | evet | Derlemenin ilerleyebilmesi için soketin bağlanmasının gerekip gerekmediği. |
targets | WorkspaceEntityRef[] veya null | evet | Ona bağlanabilecek varlıklar. |
Ek özelliklere izin verilmez.
SlotCandidacy
Bir bağlantının soketinin bildirdiği, tüketen Component’in soket üzerinde bildirdiği biçimdeki bir yuva ve o bağlantıda onu doldurabilecek Features.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
slot | string | evet | Yuvanın adı; bu ad, onu dolduran bir eklentinin bağlantının features alanında altına yazıldığı anahtardır. |
selector | string | evet | Yuvayı dolduran bir Feature’ın kendi etiketleriyle karşılaması gereken etiket seçicisi. Yuva hiçbir seçici bildirmediğinde boştur; bu durumda her Feature kabul edilir. |
required | boolean | evet | Derlemenin ilerleyebilmesi için soket üzerinden bağlanan her bağlantının yuvayı doldurmasının gerekip gerekmediği. |
inject | string[] | evet | Yuvanın, onu dolduran şey için izin verdiği teslim mekanizmaları; Component’in bildirdiği sırayla. Hiçbiri bildirilmediğinde boştur. |
sensitive | boolean | evet | Yuvanın, onu dolduran şeyin gizli materyal işlediğini bildirip bildirmediği. Bu, yuvayı dolduran eklentiyi işaretler ve hiçbir şeyi reddetmez. |
description | string | evet | Component’in yuvanın ne için olduğuna dair söylediği. Hiçbir şey söylemediğinde boştur. |
candidates | SourcedEntityRef[] | evet | Bu bağlantıda yuvayı doldurabilecek her Feature: bildirilmiş uygulanabilirliği graf düğümünün etiketlerince karşılanan (düğümün taşıdığı her eklenti buna tabidir) ve kendi etiketleri yuvanın seçicisini karşılayan Feature. Uygulanabilirliği ya da etiketleri seçiciye karşı okunamayan bir Feature önerilmez, çünkü bir derleme onu kabul etmek yerine reddeder. |
Ek özelliklere izin verilmez.
CatalogEntity
Çalışma alanı dizininin tuttuğu bir varlık.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Varlık türü. |
name | string | evet | Varlık adı. |
apiVersion | string | evet | Belgenin bildirdiği şema sürümü. |
description | string | evet | Belgenin, varlığın ne için olduğuna dair söylediği. |
labels | map of string veya null | evet | Belgenin bildirdiği etiketler. |
file | string | evet | Onu bildiren belge; çalışma alanı köküne göreli bir yol olarak. |
origin | string | evet | Varlığın nereden okunduğu. |
Ek özelliklere izin verilmez.
CompletionItem
İmleç konumuna yazılabilecek bir şey.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
label | string | evet | Yazılacak metin. |
kind | integer | hayır | Bir istemcinin ona bir simge seçebilmesi için ne tür bir şey olduğu. |
detail | string | hayır | Etiketin yanında gösterilen kısa bir niteleyici. |
documentation | string | hayır | Şeyin ne olduğu, ayrıntılı olarak. |
sortText | string | hayır | Etiketten farklı olduğu durumda sıralamada kullanılacak değer. |
Ek özelliklere izin verilmez.
MarkupContent
Gösterilecek metin ve nasıl biçimlendirildiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Metnin nasıl biçimlendirildiği. |
value | string | evet | Metin. |
Ek özelliklere izin verilmez.
EntityKindDescriptor
Bir yazarın belge yazdığı bir tür; bir isteğin belirttiği belirteci belgenin kendisinin bildirdiği türle eşleştirir ve hangi işlemlerin o türden bir belgeyi kabul ettiğini söyler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Bir isteğin belirttiği küçük harfli belirteç; örneğin component ya da featurerecipe. |
documentKind | string | evet | Belgenin kendi başlığının bildirdiği tür. |
acceptedBy | EntityKindAcceptance | evet | Hangi işlemlerin, tek başına belirtilen — yoluyla ya da inceleme için adıyla — ve yanında başka hiçbir şey gönderilmeyen bu türden bir belgeyi kabul ettiği. Bir üye, o işlem bir belgeyi bu türden olduğu için reddetmediğinde true olur; kabul ettiği bir belge yine de içeriği nedeniyle reddedilebilir. |
Ek özelliklere izin verilmez.
EntityKindAcceptance
Bir yazarın yazdığı bir tür için, her işlemin tek başına belirtilen o türden bir belgeyi kabul edip etmediği. Her üye her girdide bulunur; dolayısıyla false bir eksiklik değil, bir ifadedir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
singleEntityValidation | boolean | evet | aggrega validate komutunun tek varlık kapsamının — komuta tek bir belgenin yolu verildiğinde — bu türden bir belgeyi denetleyip denetlemediği. Bu kapsamın reddettiği bir tür bunun yerine tüm katalog kapsamı veya Release kapsamı tarafından denetlenir. |
publication | boolean | evet | Yalnızca belgeyi belirten aggrega/publishEntity isteğinin bu türden bir belgeyi yayımlayıp yayımlamadığı. Yayımlanması belgenin yanında belirtilen bir yürütülebilir dosyayı da bağlayan bir tür — bir Plugin — false olur, çünkü yalnızca belgeyi belirten bir istek onun için reddedilir; Manifest ve Release false olur, çünkü bu türlerin hiçbiri yayımlanmaz. |
inspectionByName | boolean | evet | aggrega/entityDefinition isteğinin, bir varlığın başka bir varlığa başvurduğu yerde yazıldığı biçimde gönderilen bir adı bu türden bir varlığa çözümleyip çözümlemediği. |
Ek özelliklere izin verilmez.
RegistryTrust
Çözümlemenin bir kayıt defterinin sunduklarına uyguladığı güven politikası.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
signaturesRequired | boolean | evet | Bu kayıt defterinden gelen bir yapıtın doğrulanmış bir imza taşımasının gerekip gerekmediği. |
verificationSkipped | boolean | hayır | Doğrulamanın atlanıp atlanmadığı. |
advisory | boolean | hayır | Başarısız bir doğrulamanın durdurma yerine raporlanıp raporlanmayacağı. |
anchor | string | hayır | İmzaların karşısında doğrulandığı güven çapası. |
keylessIdentities | integer | hayır | Bu kayıt defteri için kaç imzalama kimliğine güvenildiği. |
Ek özelliklere izin verilmez.
Registry
Yapılandırılmış bir kayıt defteri. Buradaki hiçbir alan kimlik bilgisi materyalini, uzunluğunu, biçimini ya da herhangi bir gösterimini taşımaz — bildirilen tek şey varlığıdır ve değeri bir sorun kaydına yapıştırmayı güvenli kılan da budur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Kayıt defteri ana bilgisayarı; bu, onun kimliğidir. |
name | string | hayır | Yapılandırılmışsa, ana bilgisayara çözümlenen kolay takma ad. |
default | boolean | evet | Bunun, hiçbir kayıt defteri belirtilmeyen bir işlemin eriştiği kayıt defteri olup olmadığı. |
authState | string | evet | Bu ana bilgisayar için makine genelindeki depoda bir kimlik bilgisi bulunup bulunmadığı. Boş olduğunda bile bildirilir; böylece bir çağıran “kimlik bilgisi yok” ile “listeleme bakmadı” durumlarını ayırt edebilir. |
trust | RegistryTrust | evet | Çözümlemenin bir kayıt defterinin sunduklarına uyguladığı güven politikası. |
Ek özelliklere izin verilmez.
TrustFetchOutcome
Bir kayıt defterinin duyurduğu güven politikasının okunmasının ne sonuç verdiği. Sonuçlar farklı anlamlar taşıdıkları için ayrı tutulur: duyurulan politika alındı, kayıt defteri hiçbir şey duyurmadı (bu bir hata değildir), yerine yerleşik temel politika sabitlendi ya da hiç okuma denenmedi. Hiçbir şey duyurulmadığında, kayıt defterine erişilip erişilemediği bunun yanında belirtilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
pinned | boolean | evet | Duyurulan politikanın alınıp alınmadığı. |
notAdvertised | boolean | hayır | Kayıt defterine sorulup sorulmadığı ve hiçbir politika duyurmadığı; bu durumda işlem, isteğin belirttiği şeyle devam eder. Çevrimdışı duruşun sorulmasını engellediği bir kayıt defteri hiçbir zaman bu şekilde raporlanmaz. Erişilemeyen bir kayıt defteri de, ondan hiçbir politika gelmediği için bu şekilde raporlanır ve yanında unreachable taşır; ikisini ayırt etmek için unreachable değerini okuyun. |
unreachable | boolean | hayır | Duyurulan politikası istendiğinde kayıt defterine erişilemeyip erişilemediği: adı çözümlenemedi, ona yapılan bir bağlantı reddedildi ya da açılamadı veya ona güvenli bir bağlantı kurulamadı. reason alanından değil hatanın kendisinden okunur, notAdvertised’ın yanında yer alır ve yalnızca hata, kayıt defterine hiç erişilmediğini gösterdiğinde ayarlanır; yanıt veren bir kayıt defteri (politikasız ya da bir hatayla) bunu yok bırakır. |
baseline | boolean | hayır | Hiçbir duyurulan politika alınmadığı için yerleşik temel politikanın sabitlenip sabitlenmediği; bunu yalnızca resmî hub taşır. Hub’a sorulup hiçbir şey duyurmadığında notAdvertised’ın yanında, çevrimdışı duruş hub’a sorulmasını engellediğinde ise tek başına yer alır. |
skipped | boolean | hayır | Belirtilen bir politika onu geçersiz kıldığı ya da istek hiçbirini istemediği için hiç okuma denenip denenmediği. |
identities | integer | hayır | Duyurulan politikanın kaç imzalama kimliği taşıdığı. |
reason | string | hayır | Duyurulan politikanın neden alınmadığı: kayıt defterinin uç noktasının ne yaptığı ya da sorulmasını engelleyen çevrimdışı ret. |
Ek özelliklere izin verilmez.
SkippedRepo
Dizin taramasının atladığı bir depo ve nedeni.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
repo | string | evet | Atlanan depo. |
reason | string | evet | Neden atlandığı. |
Ek özelliklere izin verilmez.
DeprecationNote
Dizin taramasının karşılaştığı bir kullanımdan kaldırma işareti ve onunla ne yaptığı. Dikkate alınan bir işaret ile mevcut olup reddedilen bir işaret aynı düzeyde raporlanır; böylece birçoğunun kaydedilmesi sessizce geçip birinin reddedilmesi kendini duyurmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
repo | string | evet | İşaretin bulunduğu depo. |
version | string | evet | İşaretin kapsadığı sürüm. |
recorded | boolean | evet | İşaretin kendi imzasının doğrulanıp doğrulanmadığı ve dolayısıyla dizinin onu taşıyıp taşımadığı. |
severity | const “warning” veya const “error” veya const “retracted” | hayır | İşaretçinin ne kadar güçlü konuştuğu. İzin verilen değerler: "warning" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha hafif olanında: bir sürüm seçilirken yine de seçilir. "error" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha güçlü olanında: bir sürüm seçilirken yine de seçilir. "retracted" — Geri çekilmiş: bir sürüm seçilirken dışlanır. |
reason | string | hayır | Sürümün neden kullanımdan kaldırıldığı. |
Ek özelliklere izin verilmez.
HostUpdate
Bir dizin yenilemesinin bir kayıt defteri için ne yaptığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Yenilenen kayıt defteri sunucusu. |
indexed | integer | evet | Kaç kaydın yazıldığı. |
deprecationsExamined | boolean | evet | Taramanın kullanımdan kaldırma işaretlerini hiç arayıp aramadığı. Sayıdan ayrıdır, çünkü “bu kayıt defteri hiç yayımlamadı” ile “bu çalıştırmanın birini değerlendirecek dayanağı yoktu” farklı olgulardır. |
deprecationsRecorded | integer | evet | Kaç işaretin dikkate alındığı. |
skipped | SkippedRepo[] veya null | evet | Taramanın atladığı depolar. |
deprecations | DeprecationNote[] veya null | evet | Taramanın karşılaştığı işaretler. |
readsRetried | integer | evet | Dolaşımın okumalarından kaçının kayıt defteri tarafından reddedildiği veya yolda düşürüldüğü ve yeniden istendiği; her okuma, kaç deneme gerektirdiğinden ve ardından başarılı olup olmadığından bağımsız olarak bir kez sayılır; hiç yoksa sıfırdır. Okumalarının tümü sonunda başarılı olan bir dolaşım skipped altında hiçbir depo listelemez; bu nedenle bir depoyu dışarıda bırakmaya ne kadar yaklaştığını söyleyen bu sayıdır. En az: 0. |
error | string | hayır | Bu sunucu için neyin başarısız olduğu; böylece birkaç sunucu üzerinde yapılan bir tarama, çağıranın hiçbir şeyi ilişkilendirmesine gerek kalmadan hangilerinin başarısız olduğunu raporlar. |
unreachable | boolean | hayır | Bu kayıt defterine erişilemeyip erişilemediği: adı çözümlenemedi, ona yapılan bir bağlantı reddedildi ya da açılamadı veya ona güvenli bir bağlantı kurulamadı. error alanından değil hatanın kendisinden okunur, yalnızca error’ın yanında ve yalnızca hata, kayıt defterine hiç erişilmediğini gösterdiğinde ayarlanır; yanıt veren bir kayıt defteri, yanıtı ne olursa olsun, bunu yok bırakır. |
Ek özelliklere izin verilmez.
PublishedVersion
Dizinin bir başvuru için tuttuğu bir sürüm: dizin oluşturulduğunda etiketinin çözümlendiği manifest özeti; dizinin oluşturulduğu güven politikası sürümün kendi imzasını doğruladıysa, doğrulanan imzalayan; ve bunu herhangi bir şey kaydediyorsa, sürümün ne zaman yayımlandığı ve bunu söyleyen kaynak. İmzalayan; imzası olmayan bir sürüm için, imzalarından hiçbiri doğrulanmayan bir sürüm için ve o politika ne bir açık anahtar ne de güvenilen bir kimlik sabitlediğinde ya da imza doğrulamasını kapattığında yoktur. Bunların hiçbiri bir imzalayanı adlandırmak için dayanak değildir ve yokluğu bundan fazlasını söylemez. Yayımlama tarihi, yayın hiçbir tarih belirtmediğinde ve o politikanın doğruladığı hiçbir anahtarsız imza bir tarih kaydetmediğinde yoktur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
version | string | evet | Etiketinin adlandırdığı şekliyle sürüm. |
manifestDigest | string | evet | Dizin oluşturulduğunda sürümün etiketinin çözümlendiği manifestin özeti; sürümü etiketiyle değil adlandırdığı baytlarla adresler. |
signer | VerifiedSignature | hayır | Bir kayıt defterinin güven politikasına göre doğrulanan bir imza: nasıl doğrulandığı, doğrulanan imzalayan ve doğrulanan imza paketinin özeti. |
publishedAt | string | hayır | Sürümün ne zaman yayımlandığı; saniye hassasiyetinde, UTC’de bir RFC 3339 zaman damgası olarak. Nereden geldiği publishedAtSource alanıdır ve ikisi ya birlikte bulunur ya da hiç bulunmaz. |
publishedAtSource | const “transparency-log” veya const “publisher” | hayır | publishedAt değerinin nereden geldiği; böylece bir şeffaflık günlüğünün tasdik ettiği zaman, yayımcının belirttiği bir zamanla asla karıştırılmaz. Küme kapalıdır. İzin verilen değerler: "transparency-log" — Bir şeffaflık günlüğünün sürümün anahtarsız imzasını kaydettiği zaman; dizinin oluşturulduğu güven ilkesi bunu, günlüğün o zamana ilişkin imzalı taahhüdüyle birlikte doğrulamıştır. Yayımlanırken imzalanan bir sürüm için bu yayım zamanıdır; sonradan imzalanan bir sürüm için o imzanın atıldığı zamandır. "publisher" — Yayımın, yayımladığının yanında belirttiği zaman; yayımlayan makinenin kendi saatinden alınır. Bunu hiçbir şey tasdik etmez. Bir yayım, imzası tasdikli bir zaman taşımadığında bunu belirtir: anahtarlı bir imza ya da imza yokluğu. Birden fazlası eklenmişse en erkeni alınır. |
Ek özelliklere izin verilmez.
VerifiedSignature
Bir kayıt defterinin güven politikasına göre doğrulanan bir imza: nasıl doğrulandığı, doğrulanan imzalayan ve doğrulanan imza paketinin özeti.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
bundleDigest | string | evet | Doğrulanan imza paketinin özeti; sha256: ve ardından 64 küçük harfli onaltılık karakter olarak. |
identity | string | hayır | İmzanın doğrulandığı imzalayan: anahtarsız bir imza için, imzalama sertifikasının verildiği kimlik, yani konu alternatif adı; anahtarlı bir imza için, keyed:sha256: ve ardından sabitlenen açık anahtarın PEM metninin küçük harfli onaltılık SHA-256 değeri. |
issuer | string | hayır | Anahtarsız bir imza için imzalama sertifikasında kayıtlı OIDC vericisi. Anahtarlı bir imza için yoktur. |
mode | const “keyless” veya const “keyed” | evet | İmzanın nasıl doğrulandığı. Küme kapalıdır. İzin verilen değerler: "keyless" — Kimliği ve vereni ilkenin güvendiği biriyle eşleşen, ilkenin sabitlediği güven köküne ya da ilke bir kök sabitlemiyorsa kamu yararına Sigstore köküne zincirlenen ve imzası bir şeffaflık günlüğünce kaydedilen bir imzalama sertifikasına karşı. "keyed" — İlkenin sabitlediği açık anahtara karşı. |
Ek özelliklere izin verilmez.
RegistrySearchRecord
Bir aramanın eşleştiği, yerel dizinin tuttuğu şekliyle bir kayıt ve ek olarak yayımlanmış bir işaretin sürümlerinden hangilerini kullanımdan kaldırdığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | evet | Kaydın çözümlendiği başvuru. |
name | string | evet | Varlık adı. |
version | string | evet | Kaydın anahtarlandığı sürüm. |
versions | string[] | hayır | Dizinin bu başvuru için tuttuğu her sürüm. |
kind | string | hayır | Varlık türü. |
description | string | hayır | Varlığın ne için olduğu. |
category | string | hayır | Varlığın altında yayımlandığı kategori. |
labels | string eşlemi | hayır | Varlığın bildirdiği etiketler. |
pluginType | string | hayır | Bir eklenti kaydının bağlandığı soket. |
capabilities | string[] | hayır | Bir eklenti kaydının bildirdiği yetenekler. |
manifestDigest | string | hayır | Yayımlanan manifestin özeti. |
listingDigest | string | hayır | Kaydın okunduğu listelemenin özeti. |
deprecations | object[] | hayır | Dizinin bu başvuru için taşıdığı kullanımdan kaldırma işaretleri; her biri kapsadığı sürüm ve doğrulanmış işaretin kendisiyle birlikte. |
published | PublishedVersion[] | hayır | Dizinin bu başvuru için tuttuğu her sürüm, versions ile aynı sırada; her biri dizin oluşturulduğunda etiketinin çözümlendiği manifest özetiyle, dizinin oluşturulduğu güven politikası o sürümün kendi imzasını doğruladıysa doğrulanan imzalayanıyla ve bunu herhangi bir şey kaydediyorsa yayımlama tarihi ile o tarihin kaynağıyla birlikte. İmzalayan olmadan kaydedilen bir sürüm, o politikanın doğruladığı hiçbir imza taşımaz ve onun hakkında bundan fazlası söylenmez. Bunu kaydetmek için kayıt defterinden yalnızca manifestler, imza ekleri ve yayımlama tarihi ekleri okunur; hiçbir varlığın içeriği getirilmez. |
retracted | string[] | hayır | Yayımlanmış bir işaretin kullanımdan kaldırdığı sürümler. |
Ek özelliklere izin verilmez.
RegistrySearchIndex
Aranan bir ana makinenin güncelliği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Dizini aranan ana makine. |
lastUpdated | string | hayır | Dizinin en son ne zaman yenilendiği. Anlık görüntü bir zaman taşımadığında sıfır yerine yoktur; böylece çağıran, “kaydedilmemiş” durumunu epoch’tan ayırt edebilir. |
Ek özelliklere izin verilmez.
EffectiveConfigurationSetting
Çözümlenmiş bir ayar ve geldiği belge.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
field | string | evet | Ayar. |
value | string | evet | Çözümlenen değer. |
source | string | evet | Değerin nereden geldiği. |
Ek özelliklere izin verilmez.
ImportedFile
Bir içe aktarmanın yazdığı bir dosya: bir taslak belge ya da içe aktarmanın ne yazdığının kaydı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | Dosyanın ait olduğu yer; yanıtın outputDir’ine göre göreli bir yol olarak. |
content | string | evet | Dosyanın metni. |
Ek özelliklere izin verilmez.
ImportDrift
Bir eşitlemenin kaynakla güncel hâle getirdiği ya da dryRun altında getireceği bir parça.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
change | string | evet | Parçanın nasıl saptığı: kaynağın kazandığı bir parça için added; düşürdüğü bir parça için removed; ya da değiştirdiği bir parça için changed. |
file | string | evet | Parçanın bulunduğu taslak dosya; yanıtın outputDir’ine göre göreli bir yol olarak. |
key | string[] | evet | Taslak bir Aggregate ya da Release’in en üstünden parçaya giden anahtarlar, anahtar başına bir giriş; böylece nokta içeren bir anahtar tek bir giriş olarak kalır. Parça dosyanın tamamıysa boştur. |
Ek özelliklere izin verilmez.
ImportOwed
Taslakların hâlâ boş bıraktığı, hiçbir kaynağın sağlayamadığı ve hiçbir yanıtın sağlamadığı bir değer.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Değerin bulunduğu taslak dosya, yanıtın outputDir dizinine göreli bir yol olarak. |
key | string[] | evet | O belgenin en üstünden değere giden anahtarlar, anahtar başına bir girdi; böylece nokta içeren bir anahtar tek bir girdi olarak kalır. answered olarak gönderilen bir yanıt değeri bu anahtarlarla adlandırır. |
question | string | evet | Değerin ne olduğu: şemasının açıklaması, o yoksa taslağın anahtarının üstüne yazdığı yorum, o da yoksa şemasının aldığını söylediği şey. |
sensitive | boolean | evet | Değerin bir gizli bilgiye ait olup olmadığı; böyle bir değerin yanıtı gizli bilginin nereden geldiğini adlandırır ve gizli bilginin kendisini asla tutmaz. |
secretAdvice | string | hayır | Bir gizli bilginin değerinde bulunur: yanıtının ne olması gerektiği, onu bir terminalde yanıtlayan bir kişiye gösterilen cümleyle — ya da onun için answered olarak gönderilen yanıt reddedildiyse, neden reddedildiği. |
Ek özelliklere izin verilmez.
ImportAnswered
Yanıtın owed alanının listelediği bir değer için bir yanıt.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Değerin bulunduğu taslak dosya, owed’un adlandırdığı gibi. |
key | string[] | evet | Değere giden anahtarlar, owed’un adlandırdığı gibi. |
answer | string | evet | Yanıt. Boş bir yanıt değeri eksik bırakır. |
Ek özelliklere izin verilmez.
ImportDiagnostic
Bir dönüştürmenin dönüştüremediği bir şey. Bunlar dönüştürmenin en yararlı çıktısıdır; bu yüzden bir hükme indirgenmek yerine eksiksiz raporlanır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
severity | string | evet | Ne kadar ciddi olduğu. |
message | string | evet | Neyin dönüştürülemediği. |
code | string | hayır | Varsa, durumun alıntılanabilir adı. |
Ek özelliklere izin verilmez.
ImportDecision
Bir dönüştürmenin bir kaynak düğümü nasıl eşlediği: içe aktarıcının tarttığı katalog Components, seçtiği, nedeni ve seçimin nasıl değiştirileceği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
sourceNode | DecisionSourceNode | evet | Bir eşleme kararının ilgili olduğu kaynak düğüm. |
candidates | ImportCandidate[] | hayır | İçe aktarıcının düğüm için tarttığı katalog Components, her biri puanıyla. Hiçbirini tartmadıysa yoktur. |
chosen | DecisionChoice | hayır | İçe aktarıcının bir kaynak düğüm için seçtiği. Seçim yapmadığı bir kararda yoktur. |
rationale | string | hayır | İçe aktarıcının seçimi neden yaptığı, kendi sözleriyle. Hiçbir şey yazmadıysa yoktur. |
swapHint | string | hayır | Seçimin bir alternatifle nasıl değiştirileceği, içe aktarıcının kendi sözleriyle. Hiçbir şey yazmadıysa yoktur. |
Ek özelliklere izin verilmez.
DecisionSourceNode
Bir eşleme kararının ilgili olduğu kaynak düğüm.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | evet | Düğümün kaynaktaki tanımlayıcısı. |
type | string | evet | Düğümün türü, kaynağın adlandırdığı şekliyle. |
paramsSummary | string | evet | Kararın yanında göstermek için düğümün parametrelerinin bir özeti. |
Ek özelliklere izin verilmez.
ImportCandidate
İçe aktarıcının bir kaynak düğüm için tarttığı bir katalog Component’i.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
componentName | string | evet | Component’in adı. |
score | number | evet | Component’in düğümle ne kadar iyi eşleştiği, içe aktarıcının puanladığı şekliyle. |
tier | string | evet | Puanın düştüğü eşleşme kademesi. |
signals | CandidateSignals | evet | İçe aktarıcının her bir sinyalinin bir adayın puanına katkısı. |
Ek özelliklere izin verilmez.
CandidateSignals
İçe aktarıcının her bir sinyalinin bir adayın puanına katkısı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
table | number | evet | Eşleme tablosu sinyalinin katkısı. |
category | number | evet | Kategori sinyalinin katkısı. |
domainLabels | number | evet | Alan etiketleri sinyalinin katkısı. |
shape | number | evet | Şekil sinyalinin katkısı. |
name | number | evet | Ad sinyalinin katkısı. |
Ek özelliklere izin verilmez.
DecisionChoice
İçe aktarıcının bir kaynak düğüm için seçtiği. Seçim yapmadığı bir kararda yoktur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
target | string | evet | Seçilen Component’in adı: mevcut bir katalog Component’i ya da düğüm için taslağı hazırlanan. |
mode | string | evet | Seçimin nasıl yazıldığı: mevcut bir Component’e başvuru olarak ya da yeni taslağı hazırlanmış bir Component olarak. |
tier | string | evet | Seçimin eşleşme kademesi. |
Ek özelliklere izin verilmez.
LintFileFindings
Bir uzlaşım denetiminin bir belgede bulduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Belge. |
diagnostics | Diagnostic[] veya null | evet | İçindeki bulgular. |
Ek özelliklere izin verilmez.
PluginRetractionExclusion
Mevcut olan ve seçilmeyen bir sürüm.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
version | string | evet | Atlanan sürüm. |
reason | string | hayır | Neden atlandığı. |
Ek özelliklere izin verilmez.
PluginRetractionProvenance
Neyin kullanımdan kaldırıldığı bilgisinin nereden geldiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
source | string | evet | Neye başvurulduğu. |
lastUpdated | string | hayır | Bunun en son ne zaman yenilendiği. |
Ek özelliklere izin verilmez.
PluginRetraction
Bir kullanımdan kaldırma işaretçisinin hangi eklenti sürümünün sabitlendiğini nasıl belirlediği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | Sürümlerin ait olduğu başvuru. |
selected | string | hayır | Sabitlenen sürüm. |
excluded | PluginRetractionExclusion[] | hayır | Mevcut olan ve atlanan sürümler. |
unscreened | string | hayır | Neyin bir işaretçiye karşı taranamadığı ve nedeni. |
provenance | PluginRetractionProvenance | hayır | Neyin kullanımdan kaldırıldığı bilgisinin nereden geldiği. |
Ek özelliklere izin verilmez.
PluginGeneratedDocument
Bir üretimin oluşturduğu bir katalog belgesi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | Belgenin ait olduğu yer; çalışma alanı köküne göre göreli bir yol olarak. |
content | string | evet | Belgenin metni. |
Ek özelliklere izin verilmez.
PluginCommandFlag
Bir eklentinin katkıda bulunduğu bir komut üzerinde bildirdiği bir bayrak.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Bayrağın uzun adı. |
shorthand | string | hayır | Varsa, bayrağın tek karakterlik takma adı. |
description | string | hayır | Bayrağın tek satırlık yardım metni. |
type | string | hayır | Bayrağın değer türü. |
default | string | hayır | Bayrak verilmediğinde kullanılan değer. |
Ek özelliklere izin verilmez.
PluginCLICommand
Bir eklentinin katkıda bulunduğu bir üst düzey komut fiili.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Komut fiili. |
description | string | hayır | Komutun tek satırlık yardım metni. |
flags | PluginCommandFlag[] | hayır | Komutun bayrakları, bildirildikleri sırayla. |
Ek özelliklere izin verilmez.
ConfigCapturedAttachment
Bir dondurmanın bu çalışma alanının kendi yapılandırmasına yazdığı bir ek.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
uri | string | hayır | Ekin çözümlendiği başvuru. |
capability | string | hayır | Ekin ilgili olduğu yetenek. |
function | string | hayır | Ekin yönlendirildiği dışa aktarım. |
role | string | hayır | Bağlamanın çalıştığı rol; neyi üretebileceğini bu belirler. |
Ek özelliklere izin verilmez.
ConfigCapturedSocket
Bir dondurmanın yazdığı bir soket ve üzerine dondurduğu ekler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
socket | string | evet | Soket. |
field | string | evet | Soketin altına yazıldığı yapılandırma alanı. |
attachments | ConfigCapturedAttachment[] veya null | evet | Üzerine dondurulan ekler. |
Ek özelliklere izin verilmez.
ExplainErrorEntry
Bir durum için yazım düzeltmesini öğreten yayımlanmış bir bölüm.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
heading | string | evet | Bölümün başlığı. |
body | string | evet | Bölüm. |
Ek özelliklere izin verilmez.
SignedArtifact
Bir imzalamanın kapsadığı yayımlanmış bir yapıt.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | İmzalanan başvuru. |
digest | string | evet | İmzalananın özeti. |
Ek özelliklere izin verilmez.
DeprecationMarked
Bir kullanımdan kaldırmanın işaretlediği yayımlanmış bir sürüm.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | İşaretlenen başvuru. |
severity | const “warning” veya const “error” veya const “retracted” | evet | İşaretçinin ne kadar güçlü konuştuğu. İzin verilen değerler: "warning" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha hafif olanında: bir sürüm seçilirken yine de seçilir. "error" — Kullanımdan kaldırılmış, iki uyarı kademesinin daha güçlü olanında: bir sürüm seçilirken yine de seçilir. "retracted" — Geri çekilmiş: bir sürüm seçilirken dışlanır. |
issuedOn | string | evet | İşaretçinin ne zaman verildiği. |
digest | string | evet | Yayımlanan işaretçinin özeti. |
Ek özelliklere izin verilmez.
InitializeResult
Oturumun bu istemci için neye karar verdiği ve bunu hangi yapılandırma katmanından çözümlediği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
capabilities | ServerCapabilities | evet | Arka plan hizmetinin bu oturumda ne yapacağı; istemcinin işleyebileceğini söylediklerine göre belirlenir. |
workspaceRoot | string | evet | Oturumun üzerinde açıldığı çalışma alanı. |
configSource | string | evet | Oturumun ayarlarını hangi yapılandırma katmanından çözümlediği. |
workspaceMarker | string | hayır | Bir dosya çalışma alanı kökünü belirlediyse, o dosya. |
version | string | evet | Bu oturuma yanıt veren ikili dosyanın sürümü: aggrega version komutunun o ikili dosya için bildirdiği değerin aynısı. Çalışan süreci tanımlar; bu nedenle daemon’un başlatıldığı dosya değiştirildikten sonra bu alan hâlâ çalışan sürümü adlandırırken dosyaya sormak onun yerini alan sürümü adlandırır. |
Ek özelliklere izin verilmez.
ValidateResult
Denetimin ne bulduğu ve ne kadarının denetlendiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
diagnostics | Diagnostic[] veya null | evet | Bulgular. Denetim hiçbir şey bulmadığında boş liste yerine null olur. |
checked | string | hayır | Ne kadarının denetlendiği: tek bir belge ya da çalışma alanının içerdikleri. |
Ek özelliklere izin verilmez.
InvalidateResult
Daemon’un belgeyle ilgili bırakılacak bir şey tutup tutmadığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
invalidated | boolean | evet | Herhangi bir şeyin bırakılıp bırakılmadığı. |
Ek özelliklere izin verilmez.
DiagnosticsResult
Daemon’un belge için hâlihazırda tuttuğu bulgular.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
diagnostics | Diagnostic[] veya null | evet | Bulgular. Hiç bulgu yoksa boş liste yerine null olur. |
Ek özelliklere izin verilmez.
IrGraphResult
Bir Release’in derlendiği çözümlenmiş grafik.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
graph | herhangi | evet | Grafik belgesi. Bir yazarın hassas olarak bildirdiği değerler, istek bunları unredacted ile talep etmedikçe belgeden çıkarılır; geri kalan her şey derleyicinin ürettiği şekilde aktarılır. Belgenin kendi yapısı grafiğin yayımlanmış sözleşmesidir ve burada yinelenmez. |
Ek özelliklere izin verilmez.
BuildResult
Bir derlemenin yazdıkları.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
outputDirectory | string | evet | Yapıtların yazıldığı dizin. |
files | string[] veya null | evet | Yazılan yapıtlar, çıktı dizinine göreli yollar olarak. |
notices | BuildNotice[] | hayır | Derlemenin çağırana bildirmek istediği, ne bulgu ne de hata olan her şey. |
dependencyResolution | DependencyResolutionReport | hayır | Bir bağımlılık çözümlemesinin sabitlediği ve edindiği şeyler. |
Ek özelliklere izin verilmez.
BuildPreviewResult
Bir derlemenin yazmış olacakları. Hiçbir şey yazılmadığından adlandırılacak bir çıktı dizini yoktur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
files | string[] veya null | evet | Yazma işleminin üreteceği yapıtlar. |
notices | BuildNotice[] | hayır | Derlemenin çağırana bildirmek istediği, ne bulgu ne de hata olan her şey. |
Ek özelliklere izin verilmez.
EntityDefinitionResult
Bir varlık adının neye çözümlendiği ve onu tanımlayan belge. Bir kayıt defteri başvurusundan okunan yanıt published taşır; kataloğun adla çözümlediği bir yanıt ise hiçbir zaman taşımaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | evet | Varlık türü. |
name | string | evet | Varlık adı. |
version | string | evet | Çözümlenen sürüm. |
description | string | hayır | Belgenin, varlığın ne için olduğuna dair söylediği. |
publishScope | string | hayır | Varlığın ne kadar geniş yayımlandığı. |
file | string | evet | Onu tanımlayan belge. |
authoredLength | integer | evet | Yazılan belgenin kaç bayt içerdiği; böylece bir istemci yazılmış bir belgeyi onun çözümlenmiş bir işlenmesinden ayırt edebilir. |
definition | string | evet | Tanımın metni. |
published | PublishedArtifact | hayır | Bir kayıt defteri başvurusunun okudukları: koordinat, varlığı nasıl tuttuğu ve okumanın üzerinden yapıldığı manifest. Bu nesne bulunduğu her yerde tüm alanlar mevcuttur. |
Ek özelliklere izin verilmez.
PublishedArtifact
Bir kayıt defteri başvurusunun okudukları: koordinat, varlığı nasıl tuttuğu ve okumanın üzerinden yapıldığı manifest. Bu nesne bulunduğu her yerde tüm alanlar mevcuttur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | Okunan kayıt defteri başvurusu. |
archive | boolean | evet | Koordinatın baytlarının, varlık belgesinin içinden çıkarıldığı bir arşiv olup olmadığı. Koordinat varlık belgesinin kendisini tutuyorsa false olur. |
mediaType | string | evet | Manifest’in bildirdiği yapıt türü. |
manifestDigest | string | evet | Varlığın üzerinden okunduğu manifest’in özeti: aynı baytları tam olarak yeniden okumak için @ işaretinden sonra yazılacak değer. |
Ek özelliklere izin verilmez.
ReleaseClosureResult
Bir Release’in bağımlı olduğu her şey, çözümlemenin ulaştığı hâliyle. Kapanımdan türetilen grafiği değil kapanımın kendisini bildirir: aynı Release hakkında farklı bir belge.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release | string | evet | İncelenen Release. |
aggregate | string | evet | Dağıttığı Aggregate. |
manifest | string | evet | Üzerinden çözümlendiği Manifest. |
environment | string | evet | Adlandırdığı ortam. |
entities | ClosureEntity[] veya null | evet | Kapanımın ulaştığı varlıklar. |
libraries | ClosureEntity[] veya null | evet | Kapanımın ulaştığı kütüphaneler. |
plugins | ClosureEntity[] veya null | evet | Kapanımın ulaştığı eklentiler. |
mappingDiagnostics | string[] veya null | evet | Manifest’in eşlemelerini çözümlemenin bildirdikleri. |
deprecations | string[] veya null | evet | Kapanımın karşılaştığı kullanımdan kaldırma işaretleri. |
Ek özelliklere izin verilmez.
ResolveDependenciesResult
Bir bağımlılık çözümlemesinin sabitledikleri ve edindikleri, ayrıca çağırana bildirmek istediği her şey. Raporun kendi alanları bu yanıtın bir üyesi altında iç içe yer almak yerine doğrudan bu yanıtta taşınır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
lockfile | string | evet | Çözümlemenin yazdığı kilit dosyası veya bir doğrulamanın karşılaştırdığı kilit dosyası. |
verified | boolean | hayır | İsteğin bir doğrulama olup olmadığı; doğrulama kayıtlı kilit dosyasını karşılaştırır ve kilit dosyası, plugin güven kaydı veya entity.lock yazmaz. |
entities | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı varlıklar. |
libraries | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı kütüphaneler. |
plugins | ClosureEntity[] veya null | evet | Çözümlemenin sabitlediği veya bir doğrulamanın karşılaştırdığı plugin’ler. |
sourceArtifacts | integer | evet | Kaç kaynak yapıtın edinildiği. |
trustedPlugins | integer | evet | Sabitlenen plugin’lerden kaçının doğrulanmış bir imza taşıdığı. |
toolchain | ToolchainReport | hayır | Çözümlemeyi yapan derleyici ve taşıdığı plugin’ler. |
externalInputs | integer | evet | İşlemenin tükettiği dış girdilerden kaçının edinildiği. |
incompleteExternalInputs | string | hayır | Bazıları edinilemediğinde, hangi dış girdilerin edinilemediği. |
notices | string[] | hayır | Çözümlemenin çağırana bildirmek istediği her şey. |
Ek özelliklere izin verilmez.
PinResult
Sabitleme adımının bir varlığın yanındaki kilide ne yaptığı ya da deneme çalıştırmasında ne yapacağı. aggrega/pin isteğinin yanıtıdır ve bu adımı çalıştıran bir yayın onu kendi pin alanı olarak taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
entity | string | evet | Adımın okuduğu varlık belgesi, çalışma alanı köküne göreli bir yol olarak. |
kind | string | evet | Varlığın türü, belgesinin bildirdiği şekliyle. |
name | string | evet | Varlığın adı, belgesinin bildirdiği şekliyle. |
pinnable | boolean | evet | Bu türdeki bir varlığın, bir kilidin sabitleme kaydettiği herhangi bir şeyi okuyup okumadığı; bir Recipe ve bir FeatureRecipe okur. False olduğunda varlığın yanındaki hiçbir şeye dokunulmamıştır, changed false’tur ve lock, removed, pins ile content yoktur. |
lock | string | hayır | Adımın yazdığı ya da yazacağı kilit, çalışma alanı köküne göreli bir yol olarak. |
changed | boolean | evet | Kilidin değişip değişmediği ya da deneme çalıştırmasında değişip değişmeyeceği. Kilit varlığın gerektirdiği her sabitlemeyi zaten kaydetmişse ve bayt bayt aynı bırakıldıysa false olur. |
removed | boolean | hayır | Değişikliğin bir kaldırma olup olmadığı: varlık bir kilidin sabitleme kaydettiği hiçbir şeyi okumaz, bu yüzden yanında kilit bırakılmaz. |
dryRun | boolean | hayır | Bunun adımın yaptığını değil, yapacağını bildirip bildirmediği. |
pins | PinClassCount[] | hayır | Kilidin adımdan sonra her sınıftan kaç sabitleme tuttuğu ya da deneme çalıştırmasından sonra tutacağı. Kilidin tutabileceği her sınıf, sabitlemesi olmayan sınıflar da dâhil, listelenir. |
content | string | hayır | Deneme çalıştırmasının yazacağı kilit. Kilit olduğu gibi bırakılacak ya da kaldırılacaksa ve deneme çalıştırması olmayan her yanıtta yoktur. |
Ek özelliklere izin verilmez.
PinClassCount
Bir kilidin tek bir sınıftan kaç sabitleme tuttuğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
class | string | evet | Sabitlemenin sınıfı, eksik bir sabitlemeyi adlandıran bir reddin kullandığı sözcüklerle; örneğin remote source ya da imported file. |
pins | integer | evet | Kilidin o sınıftan kaç sabitleme tuttuğu. |
Ek özelliklere izin verilmez.
CacheStatusResult
Bu çalışma alanına hizmet eden önbelleklerin içerdikleri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
classes | CacheClass[] veya null | evet | Her önbellek ve içerdikleri. |
provenance | CacheProvenance[] veya null | evet | Önbelleğe alınmış yapıtların hangi kimlikler altında edinildiği. |
totalCount | integer | evet | Önbelleklerin toplamda kaç girdi içerdiği. |
totalSize | integer | evet | Toplamda kaç bayt kapladıkları. |
totalSizeText | string | evet | Aynı toplamın bir insanın okuyacağı biçimde yazılmışı. |
scope | CacheScope | evet | Bir önbellek yanıtının ne kadar geniş bir alana eriştiği. Önbellek sınıflarından ikisi makinedeki tüm projelerce paylaşılır; bu nedenle her önbellek yanıtı hangilerine dokunduğunu belirtir — aksi hâlde tek bir çalışma alanı üzerinde açılmış bir oturum yalnızca o çalışma alanı hakkında rapor veriyor gibi okunurdu. |
Ek özelliklere izin verilmez.
CachePruneResult
Bir geri kazanımın neyi kaldırdığı, neyi tuttuğu ve neyi geri kazanamadığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
removed | CacheRemoval[] veya null | evet | Kaldırılanlar. |
heldOpen | CacheRemoval[] veya null | evet | Budamanın kaldıracağı, ancak başka bir süreç açık tuttuğu için yerinde bıraktığı şeyler. Açık bir dosyayı kaldırmayı yalnızca Windows reddeder; bu nedenle diğer her yerde bu boştur. Bu girdiler ne kaldırılmış ne de tutulmuş sayılır, baytlarının hiçbiri geri kazanılmış sayılmaz ve sonraki bir budama bunları geri kazanır; dizin olan bir girdi, içindeki açık olmayan dosyaları zaten kaybetmiş olabilir. |
retainedCount | integer | evet | Kaç girdinin tutulduğu. |
reclaimedBytes | integer | evet | Kaç baytın geri kazanıldığı. |
reclaimedBytesText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
unattributedCount | integer | evet | Hiçbir sahibin sahiplenmediği kaç girdi olduğu. |
unattributedSize | integer | evet | Bunların kaç bayt kapladığı. |
unattributedSizeText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
notPruneEligible | CacheShortfall[] veya null | evet | Geride kalanlar ve bunları neyin geri kazanacağı. |
scope | CacheScope | evet | Bir önbellek yanıtının ne kadar geniş bir alana eriştiği. Önbellek sınıflarından ikisi makinedeki tüm projelerce paylaşılır; bu nedenle her önbellek yanıtı hangilerine dokunduğunu belirtir — aksi hâlde tek bir çalışma alanı üzerinde açılmış bir oturum yalnızca o çalışma alanı hakkında rapor veriyor gibi okunurdu. |
Ek özelliklere izin verilmez.
CacheEvictResult
Bir boyuta kadar geri kazanımın neyi kaldırdığı ve neyin kaldığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
withinCapBefore | boolean | evet | Tutulanların zaten boyutun altına sığıp sığmadığı, dolayısıyla hiçbir şeyin kaldırılmasına gerek olup olmadığı. |
removed | CacheRemoval[] veya null | evet | Kaldırılanlar. |
heldOpen | CacheRemoval[] veya null | evet | Geri kazanımın kaldıracağı, ancak başka bir süreç açık tuttuğu için yerinde bıraktığı şeyler; bunun yerine bir sonraki en eski girdiye geçti. Açık bir dosyayı kaldırmayı yalnızca Windows reddeder; bu nedenle diğer her yerde bu boştur. Bu girdiler kalan baytlara yine de sayılır ve sonraki bir geri kazanım bunları kaldırabilir. |
totalBefore | integer | evet | Önceden kaç bayt tutulduğu. |
totalBeforeText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
reclaimedBytes | integer | evet | Kaç baytın geri kazanıldığı. |
reclaimedBytesText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
remainingBytes | integer | evet | Kaç bayt kaldığı. |
remainingBytesText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
capBytes | integer | evet | Geri kazanımın inildiği boyut, bayt cinsinden. |
capBytesText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
scope | CacheScope | evet | Bir önbellek yanıtının ne kadar geniş bir alana eriştiği. Önbellek sınıflarından ikisi makinedeki tüm projelerce paylaşılır; bu nedenle her önbellek yanıtı hangilerine dokunduğunu belirtir — aksi hâlde tek bir çalışma alanı üzerinde açılmış bir oturum yalnızca o çalışma alanı hakkında rapor veriyor gibi okunurdu. |
Ek özelliklere izin verilmez.
CacheClearResult
Önbellekleri boşaltmanın neyi geri kazandığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
cleared | CacheCleared[] veya null | evet | Boşaltılan her önbellek. |
reclaimedBytes | integer | evet | Kaç baytın geri kazanıldığı. |
reclaimedBytesText | string | evet | Aynı rakamın bir insanın okuyacağı biçimde yazılışı. |
scope | CacheScope | evet | Bir önbellek yanıtının ne kadar geniş bir alana eriştiği. Önbellek sınıflarından ikisi makinedeki tüm projelerce paylaşılır; bu nedenle her önbellek yanıtı hangilerine dokunduğunu belirtir — aksi hâlde tek bir çalışma alanı üzerinde açılmış bir oturum yalnızca o çalışma alanı hakkında rapor veriyor gibi okunurdu. |
Ek özelliklere izin verilmez.
RegistryListResult
Bu çalışma alanının çözümleme için kullandığı kayıt defterleri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
registries | Registry[] veya null | evet | Yapılandırılmış her kayıt defteri. |
credentialStateIsMachineWide | boolean | evet | Her kayıt defteri için bildirilen kimlik bilgisi varlığının bir çalışma alanı olgusu değil, makine genelinde bir olgu olup olmadığı. Oturum kapsamlı bir yanıt daha geniş erişimi reddediyormuş gibi okunmasın diye bildirilir. |
Ek özelliklere izin verilmez.
SearchResult
Yerel kayıt defteri dizinlerinin arama için sunduğu sonuçlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
records | RegistrySearchRecord[] veya null | evet | Eşleşen kayıtlar. |
indexes | RegistrySearchIndex[] veya null | evet | Aranan her ana makine ve dizininin en son ne zaman yenilendiği. |
missingIndexHosts | string[] veya null | evet | Aranacak yerel dizini olmayan yapılandırılmış ana makineler; böylece kısa bir yanıt, çıkarıma bırakılmak yerine açıklanır. |
stale | boolean | evet | Aranan herhangi bir dizinin yenilenmeye değecek kadar eski olup olmadığı. |
registriesConfigured | boolean | evet | Herhangi bir kayıt defterinin yapılandırılıp yapılandırılmadığı; bu, “hiçbir şey eşleşmedi” ile “hiçbir şey aranmadı” durumlarını ayırt eder. |
Ek özelliklere izin verilmez.
RegistryAddResult
Bir kayıt defterini kaydetmenin neyi, nereye yazdığı ve kayıt defterinin kendisinden neyi okuduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Girdinin anahtarlandığı ana makine; bu her zaman isteğin kullandığı yazım değildir. |
scope | ConfigWriteScope | evet | Hangi yapılandırma belgesinin yazıldığı ve ne kadar geniş bir alana eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili okunurdu — makine genelindeki bir yazma için ise bu okuma yanlıştır. |
trust | TrustFetchOutcome | evet | Bir kayıt defterinin duyurduğu güven politikasının okunmasının ne sonuç verdiği. Sonuçlar farklı anlamlar taşıdıkları için ayrı tutulur: duyurulan politika alındı, kayıt defteri hiçbir şey duyurmadı (bu bir hata değildir), yerine yerleşik temel politika sabitlendi ya da hiç okuma denenmedi. Hiçbir şey duyurulmadığında, kayıt defterine erişilip erişilemediği bunun yanında belirtilir. |
Ek özelliklere izin verilmez.
RegistryRemoveResult
Bir kayıt defterini kaldırmanın neyi ve nereye yazdığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Girdisi kaldırılan ana makine. |
scope | ConfigWriteScope | evet | Hangi yapılandırma belgesinin yazıldığı ve ne kadar geniş bir alana eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili okunurdu — makine genelindeki bir yazma için ise bu okuma yanlıştır. |
Ek özelliklere izin verilmez.
RegistryUpdateResult
Yerel dizinleri yenilemenin her ana makine için ne yaptığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
hosts | HostUpdate[] veya null | evet | Yenilemenin her ana makine için ne yaptığı. |
failed | string[] veya null | evet | Yenilemenin tamamlayamadığı ana makineler. |
indexRoot | string | evet | Dizinlerin altına yazıldığı dizin. |
registriesConfigured | boolean | evet | Herhangi bir kayıt defterinin yapılandırılıp yapılandırılmadığı. |
reachedRegistries | boolean | evet | Bu yanıtta her zaman true: dizinleri yenilemek kayıt defterlerinin kendilerine gider; listeleme ve arama ise yapılandırmadan ve yerel bir dizinden yanıt verir. Belirli bir kayıt defterine gerçekten ulaşılıp ulaşılmadığı, hosts içindeki kendi girdisinde unreachable ile belirtilir. |
Ek özelliklere izin verilmez.
LogoutResult
Hangi saklanan kimlik bilgisinin kaldırıldığı ve deponun ne kadar geniş erişime sahip olduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
registry | string | evet | Kimlik bilgisi kaldırılan kayıt defteri. |
scope | CredentialStoreScope | evet | Bir kimlik bilgisi değişikliğinin ne kadar geniş bir alana eriştiği. Depo, makinedeki tüm projelerce ve aynı registry’lere erişen diğer tüm araçlarca paylaşılır; bu nedenle yanıt, oturumla sınırlı bir okumanın çıkarsanmasına bırakmak yerine bunu bildirir. |
Ek özelliklere izin verilmez.
PublishEntityResult
Bir varlığın yayımlanmasının neyi nereye yerleştirdiği. Önce sabitleme adımını çalıştıran bir yayın, o adımın ne yaptığını da pin olarak taşır; adım çalışmadıysa bu alan yoktur.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | Varlığın altında yayımlandığı başvuru. |
tag | string | evet | Altında yayımlandığı etiket. |
kind | string | evet | Yayımlanan varlık türü. |
mediaType | string | evet | Yayımlanan baytlar için kaydedilen medya türü. |
size | integer | evet | Kaç bayt yayımlandığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
pluginSize | integer | hayır | Bir Plugin varlığıyla birlikte yayımlanan eklenti modülünün kaç bayt kapladığı. |
pluginSizeText | string | hayır | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
digest | string | evet | Yayımlananın özeti. Deneme çalıştırmasında ise aynı içeriğin yayımlanmasıyla oluşacak, yalnızca içerikten hesaplanan özet: aggrega push --dry-run komutunun yazdırdığı özet. |
signed | boolean | evet | Bu yayının bir imza ekleyip eklemediği: yayımlamadan önce oluşturduğu imza ya da önceden yayımlanmış bir sürümde, sürümün sahip olmadığı bir imza. |
alreadyPublished | boolean | evet | Aynı baytların zaten orada olup olmadığı; öyleyse hiçbir içerik yüklenmemiştir. Yanına yalnızca o yayında hâlâ eksik olanlar eklenmiştir: yayın tarihi ve bu yayın imzalıyorsa imzası; bir imzanın eklenip eklenmediğini signed belirtir. |
dryRun | boolean | evet | Bunun, yayımlamanın ne yaptığını değil, neyi yerleştireceğini bildirip bildirmediği. |
reach | PublicationReach | evet | Bir yayının ne kadar uzağa ulaştığı. Bu yanıtlar tamamen bu makinenin ötesine ulaşır — ekledikleri şey, o kayıt defterinin her tüketicisinin çözümlediği şeydir — bu nedenle her biri eriştiği her kayıt defterini ve çağrının oraya bir şey ekleyip eklemediğini belirtir. |
pin | PinResult | hayır | Sabitleme adımının bir varlığın yanındaki kilide ne yaptığı ya da deneme çalıştırmasında ne yapacağı. aggrega/pin isteğinin yanıtıdır ve bu adımı çalıştıran bir yayın onu kendi pin alanı olarak taşır. |
wholeDirectorySource | string | hayır | Varlığın yazıldığı hâliyle yerel kaynağı; şablon olarak yazıldığında bulunur. Böyle bir kaynak dizinini ancak bir Release şablonu doldurduğunda adlandırır; bu yüzden yayın, yalnızca varlığın adlandırdığı dosyaları değil, varlığın dizinindeki her dosyayı taşır. Yalnızca o dosyaları taşıdığında yoktur. |
windowsUnusableEntries | string[] | hayır | Yayımlanan arşivin, yolunda Windows’un yazıldığı hâliyle tutamayacağı bir parça bulunan girdileri — Windows’un bir aygıt için ayırdığı bir ad, örneğin CON, AUX veya NUL; harf büyüklüğü ve ardından gelen uzantı ne olursa olsun — ya da nokta veya boşlukla biten bir parça; önce varlık belgesinin kendi dosya adı, ardından taşıdığı dosyalar. Windows üzerindeki bir çalışma alanı bunları açmayı reddeder, bu yüzden sürümü kullanamaz; yayın, bunlar olmasaydı nasıl ilerleyecek ya da duracaksa tam öyle ilerler ya da durur. Hiçbiri yoksa bulunmaz; buna yalnızca belgesi olarak yayımlanan bir varlık da dahildir. |
Ek özelliklere izin verilmez.
PublishArtifactResult
Bir dosyanın yayımlanmasının neyi nereye yerleştirdiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
reference | string | evet | Dosyanın altında yayımlandığı başvuru. |
tag | string | evet | Altında yayımlandığı etiket. |
mediaType | string | evet | Yayımlanan baytlar için kaydedilen medya türü. |
size | integer | evet | Kaç bayt yayımlandığı. |
sizeText | string | evet | Aynı boyutun bir insanın okuyacağı biçimde yazılışı. |
digest | string | evet | Yayımlananın özeti. |
alreadyPublished | boolean | evet | Aynı baytların zaten orada olup olmadığı; öyleyse hiçbir içerik yüklenmemiştir. Yanına yalnızca yapıtta yayın tarihi yoksa bir yayın tarihi eklenmiştir. |
dryRun | boolean | evet | Bunun, yayımlamanın ne yaptığını değil, neyi yerleştireceğini bildirip bildirmediği. |
reach | PublicationReach | evet | Bir yayının ne kadar uzağa ulaştığı. Bu yanıtlar tamamen bu makinenin ötesine ulaşır — ekledikleri şey, o kayıt defterinin her tüketicisinin çözümlediği şeydir — bu nedenle her biri eriştiği her kayıt defterini ve çağrının oraya bir şey ekleyip eklemediğini belirtir. |
Ek özelliklere izin verilmez.
SignArtifactsResult
Neyin imzalandığı ve imzaların nereye yerleştiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
signed | SignedArtifact[] veya null | evet | İmzalanan her başvuru. |
reach | PublicationReach | evet | Bir yayının ne kadar uzağa ulaştığı. Bu yanıtlar tamamen bu makinenin ötesine ulaşır — ekledikleri şey, o kayıt defterinin her tüketicisinin çözümlediği şeydir — bu nedenle her biri eriştiği her kayıt defterini ve çağrının oraya bir şey ekleyip eklemediğini belirtir. |
Ek özelliklere izin verilmez.
DeprecateArtifactResult
Neyin kullanımdan kaldırıldı olarak işaretlendiği ve işaretlerin nereye yerleştiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
marked | DeprecationMarked[] veya null | evet | İşaretlenen her sürüm. |
reach | PublicationReach | evet | Bir yayının ne kadar uzağa ulaştığı. Bu yanıtlar tamamen bu makinenin ötesine ulaşır — ekledikleri şey, o kayıt defterinin her tüketicisinin çözümlediği şeydir — bu nedenle her biri eriştiği her kayıt defterini ve çağrının oraya bir şey ekleyip eklemediğini belirtir. |
Ek özelliklere izin verilmez.
ResolveResult
İmlecin altındaki öğenin nerede tanımlandığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
location | null veya Location | evet | Nerede tanımlandığı. İmlecin altındaki hiçbir şey bir tanıma çözümlenmiyorsa null’dur. |
Ek özelliklere izin verilmez.
FindReferencesResult
İmlecin altındaki öğeye nerede başvurulduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
locations | Location[] veya null | evet | Ona başvurulan her yer. |
Ek özelliklere izin verilmez.
FindImplementationsResult
İmlecin altındaki öğeyi hangi belgelerin uyguladığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
locations | Location[] veya null | evet | Uygulandığı her yer. |
Ek özelliklere izin verilmez.
HoverResult
İmlecin altındaki öğe hakkında ne gösterileceği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
contents | null veya MarkupContent | evet | Ne gösterileceği. İmlecin altındaki hakkında söylenecek bir şey yoksa null’dur. |
Ek özelliklere izin verilmez.
CompletionResult
İmleçte nelerin yazılabileceği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
items | CompletionItem[] veya null | evet | Yazılabilecek her öğe. |
Ek özelliklere izin verilmez.
CatalogIndexResult
Çalışma alanı dizininin tuttuğu her varlık ve çalışma alanının dışına, dizinlere ve dosyalara giden, bunun için okunmamış bağlantılar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
entities | CatalogEntity[] veya null | evet | Her varlık. |
unreadLinkedDirs | string[] | evet | Çalışma alanı kökü altında, kökün dışındaki bir dizine giden her bağlantı; bağlantının kendisinin bulunduğu yere göre köke görece adlandırılır ve çalışma alanının arandığı sırayla verilir. Kökün dışındaki hiçbir dizin aranmaz; bu nedenle bu bağlantılardan birinin arkasındaki hiçbir belge, çalışma alanının kendi varlıkları olarak entities içinde yer almaz ve varlıkları listeleyen bir istemci nedenini söyleyebilir. Adlandırılmayanlar: kökün içindeki bir dizine giden ve gerçekte bulunduğu yerde aranan ya da dışarıda bırakılan bir bağlantı; bir dizinin, bulunduğu yer, adı ya da bir .gitignore nedeniyle dışarıda bırakılacağı her yerdeki bir bağlantı; hiçbir yere gitmediği ya da bir döngüye girdiği için çözümlenemeyen bir bağlantı; ve bir Release’in terimleriyle verilen bir yanıtta, yalnızca başka Releases’in okuduğu bir katalog dizini altındaki bir bağlantı. Çalışma alanı hiç tutmadığında boştur. |
unreadLinkedFiles | string[] | evet | Çalışma alanı kökü altında, bir YAML dosyası gibi adlandırılmış, yani kendi adı .yaml ya da .yml ile biten ve kökün dışındaki bir dosyaya giden her bağlantı; bağlantının kendisinin bulunduğu yere göre köke görece adlandırılır ve çalışma alanının arandığı sırayla verilir. Böyle bir dosya, ne bildirirse bildirsin dizin için okunmaz; bu nedenle bildirdiği varlık, çalışma alanının kendi varlıkları olarak entities içinde yer almaz ve varlıkları listeleyen bir istemci nedenini söyleyebilir; çalışma alanının dışındaki varlıklar yapılandırılmış katalog dizinleri aracılığıyla okunur. Adlandırılmayanlar: çalışma alanı yapılandırmasının bir Release olarak, build.authoring_release olarak ya da workspace.releases’in bir anahtarı olarak adlandırdığı ve bir Release bildiren, okunup bağlantının kendi yerinde entities içinde listelenen bir dosyaya giden bağlantı; kökün içindeki, bağlantının kendi yerinde okunan bir dosyaya giden bağlantı; bir .gitignore’un dışarıda bıraktığı bir bağlantı ya da aramanın dışarıda bıraktığı bir dizinin içindeki bir bağlantı; hiçbir dosyaya gitmeyen bir bağlantı, ister kökün dışına çıktığı yerde unreadLinkedDirs’in adlandırdığı bir dizine gitsin, ister hiçbir yere gitmesin, ister bir döngüye girsin; ve bir Release’in terimleriyle verilen bir yanıtta, yalnızca başka Releases’in okuduğu bir katalog dizini altındaki bir bağlantı. Çalışma alanının dışına giden bir bağlantı olan bir çalışma alanı yapılandırma dosyası, yani kendi .aggrega-config.yaml dosyası ya da yanındaki CI’a ait katman, arama ona rastlamış olsun ya da olmasın, aramanın adlandırdığı bağlantılardan sonra adlandırılır: bu durumda çalışma alanının yapılandırması hiç okunmaz, bu yanıt çalışma alanının hiçbir şey yapılandırılmadan okunan kendi dizinidir, dolayısıyla onun için hiçbir katalog dizini okunmaz ve yapılandırmanın belirlediği her istek, bir Release’in terimleriyle bir dizin de dahil, o çalışma alanı için okuma bekletmesinin koşuluyla reddedilir. Çalışma alanı hiç tutmadığında boştur. |
Ek özelliklere izin verilmez.
AttachCandidatesResult
Varlığa hangi Features’in eklenebileceği ve bunların hangi etiketlere göre değerlendirildiği; ve isteğin adlandırdığı bir bağlantı için, soketinin bildirdiği yuvalar ile her birini doldurabilecek Features.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
node | string | evet | Adayların kendisi için değerlendirildiği varlık. |
nodeLabels | map of string veya null | evet | Değerlendirmenin yapıldığı etiketler. |
labelSource | string | evet | Hangi etiket kümesinin kullanıldığı; bu görünüşle ilgili bir ayrıntı değildir: bir belgenin bildirilmiş etiketleri kaynağın okunmasıyla görülebilenlerdir, bir graf düğümününkiler ise derlemenin kendisinin değerlendirmede kullandığı kesinleşmiş kümedir. İkincisi üzerinden hesaplanan bir yanıt, derlemenin ne yapacağına dair bir ifadedir. |
candidates | SourcedEntityRef[] veya null | evet | Eklenebilecek her Feature. |
slots | SlotCandidacy[] | hayır | Yalnızca istek bir bağlantı adlandırdığında bulunur: bağlantının soketinin bildirdiği her yuva, Component’in bildirdiği sırayla, onu doldurabilecek Features ile birlikte. Bağlantıda hiçbir yuva doldurulamadığında boştur ve bu durumda noSlotReason nedenini söyler; bir istemci boş bir listeyi hiçbir Feature’in eşleşmediği yuvalar olarak almak yerine bunu okur. |
noSlotReason | const “feature-created-connection” ya da const “ad-hoc-socket” ya da const “no-slot-declared” | hayır | Yalnızca istek bir bağlantı adlandırdığında ve o bağlantıda hiçbir yuva doldurulamadığında bulunur: oraya neden hiçbir şeyin eklenemeyeceği. Soketin bir yuva bildirdiği her yerde yoktur. Küme kapalıdır. İzin verilen değerler: "feature-created-connection" — Bağlantıyı bir Feature çizmiştir ve bir eklenti yalnızca bir bileşenin ya da Release’in çizdiği bir bağlantıya yazılır. "ad-hoc-socket" — Soket, Component’in bildirmediği bir sokettir; bu nedenle bir bağlantının dolduracağı bir yuva bildirmez. "no-slot-declared" — Component soketi bildirir ve üzerinde hiçbir yuva bildirmez. |
Ek özelliklere izin verilmez.
ConnectionCandidatesResult
Varlık üzerindeki her soketin hangi varlıklara bağlanabileceği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
node | string | evet | Bu soketlerin ait olduğu varlık. |
adHocSocketsAccepted | boolean | evet | Varlığın kendi tanımının önceden bildirmediği bir soketin yine de yazılıp yazılamayacağı. |
sockets | SocketCandidacy[] veya null | evet | Her soket ve ona nelerin bağlanabileceği. |
Ek özelliklere izin verilmez.
InsertionPointResult
Adlandırılan kapsayıcı altındaki yeni bir girdinin belgede nereye ait olduğu ve bir istemcinin onu oraya yazmak için neye ihtiyaç duyduğu: noktanın kendisi, metnin bir satır sonuyla başlaması gerekip gerekmediği, hâlâ eksik olan kapsayıcı anahtarları ve her satırın aldığı girinti.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Belge. |
container | string[] veya null | evet | Belge içinden kapsayıcıya giden yol. |
positionEncoding | string | evet | Bu yanıttaki konumların ifade edildiği kodlama. |
position | Position | evet | Bir belgedeki bir yer: bir satır ve o satır içindeki bir karakter uzaklığı, ikisi de sıfırdan başlayarak sayılır. Uzaklık, oturumun açıldığında üzerinde karar kıldığı kodlamanın birimleriyle ölçülür; istemci başka birini istemediyse bu UTF-16’dır. |
precededByLineBreak | boolean | evet | Konum, belgenin zaten taşıdığı bir satırın sonunda bulunduğu için, konuma yazılan metnin bir satır sonuyla başlaması gerekip gerekmediği. Yalnızca belgenin, girdinin ardından geleceği hiçbir şey taşımadığı yerde false olur. |
missingContainerKeys | string[] veya null | evet | Kapsayıcı yolunun, belgenin henüz taşımadığı bölümleri, en dıştaki önce. Girdinin en içtekinin içine girebilmesi için her biri, kendinden öncekinden bir adım daha içeride girintilenmiş ayrı bir anahtar olarak yazılmalıdır. Yolun tamamı zaten mevcut olduğunda null olur. |
entryIndent | integer | evet | Girdinin kendi ilk satırının başladığı sütun; satırın başından itibaren boşluk olarak sayılır. |
indentStep | integer | evet | Her iç içe geçme düzeyinin ne kadar daha fazla girintilendiği. |
indentStepMeasured | boolean | evet | Adımın bu belgenin kendi iç içe yapısından ölçülüp ölçülmediği. false olduğunda belge ölçülecek bir iç içe yapı göstermez ve adım bir geri dönüş değeridir; böylece kendi adımını uygulamayı tercih eden bir istemci bunu yapmakta serbest olduğunu bilir. |
entryShape | const “mapping” ya da const “sequence” ya da const “unknown” | evet | Kapsayıcının girdilerini taşıdığı biçim; girdinin kendi metninin nasıl oluşturulacağını belirleyen budur. Belgenin zaten taşıdığı kapsayıcıdan okunur ve kapsayıcının adından asla çıkarılmaz. Küme kapalıdır. İzin verilen değerler: "mapping" — Kapsayıcı bir blok eşlemesidir; bu nedenle ona eklenen bir girdi bir anahtar ve değeridir. "sequence" — Kapsayıcı bir blok dizisidir; bu nedenle ona eklenen bir girdi bir tire ve değeridir. "unknown" — Belge kapsayıcıyı taşımaz ya da onu içi boş olarak taşır; bu nedenle bir girdinin hangi biçimi alacağına istemci karar verir. |
Ek özelliklere izin verilmez.
AttachmentContainerResult
Graf düğümü üzerindeki ya da isteğin adlandırdığı bağlantı üzerindeki bir eklentinin hangi belgeye ve o belgenin neresine ait olduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
node | string | evet | Ekin ait olduğu grafik düğümü. |
file | string | evet | Eklentinin ait olduğu belge. |
container | string[] veya null | evet | O belge içinden eklentinin ait olduğu yere giden yol. |
Ek özelliklere izin verilmez.
ConnectionAtPositionResult
Konumun, girdisinin içine düştüğü bağlantı ya da neden hiçbirinin bildirilmediği. Tam olarak bir yarı bulunur: graphNode ile connection birlikte ya da yalnızca noConnectionReason. Bir girdinin içindeki herhangi bir konum — takma adı, hedefi ya da eklentileri üzerinde — o girdinin içindedir; girdiler iç içe geçtiğinde en içtekinin içindedir; bir soketin kendi anahtarı üzerindeki, altına yazılan girdilerin üstündeki bir konum hiçbirinin içinde değildir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
graphNode | string | hayır | Bileşeni bağlantıyı çizen düğümün, derlenmiş grafın anahtarladığı şekliyle kimliği — adaylık ve kapsayıcı isteklerinin graphNode olarak aldığı değer. |
connection | ConnectionCoordinate | hayır | Soketi ve takma adıyla bağlantı; document, konumun okunduğu belgeyi adlandırır — adaylık ve kapsayıcı isteklerinin connection olarak aldığı değer. |
noConnectionReason | const “no-connection-entry” ya da const “feature-created-connection” ya da const “unknown-connection” | hayır | Yalnızca hiçbir bağlantı bildirilmediğinde bulunur: nedeni. Küme kapalıdır. İzin verilen değerler: "no-connection-entry" — Konum, bir eklentinin yazıldığı hiçbir girdinin üzerinde değildir: ne bir bileşenin takma adı altında yazarak çizdiği bir bağlantı ne de Release’teki kenar başına bir girdi. Hedef listesi olarak yazılan bir bağlantı ve bir Feature’ın kendi bloğunun çizdiği bir bağlantı böyle bir girdi taşımaz. "feature-created-connection" — Konum, Release’in bir Feature’ın çizdiği bir bağlantı için yazdığı girdinin üzerindedir ve bir eklenti yalnızca bir bileşenin ya da Release’in çizdiği bir bağlantıya yazılır. "unknown-connection" — Konum, Release’in derlenmiş grafikte bulunmayan bir bağlantı için yazdığı bir girdinin üzerindedir. |
Ek özelliklere izin verilmez.
ReleaseCandidatesResult
Çalışma alanının barındırdığı Releases ve çalışma alanının dışına, dizinlere ve dosyalara giden, bunlar için okunmamış bağlantılar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
releases | string[] veya null | evet | Her Release belgesi. |
lockfiles | string eşlemi | evet | Listelenen her Release’in kilit dosyası; anahtarı, Release’in tam olarak listelendiği biçimidir. Her biri, bir pull işleminin o Release için yazdığı ve bir derlemenin okuduğu dosyadır; böylece istemci dosyanın yerini kendisi çıkarmak yerine buradan okur. Çalışma alanı hiç Release barındırmadığında boştur. |
unreadLinkedDirs | string[] | evet | Çalışma alanı kökü altında, kökün dışındaki bir dizine giden her bağlantı; bağlantının kendisinin bulunduğu yere göre köke göreli olarak, çalışma alanının arandığı sırayla adlandırılır. Kökün dışındaki hiçbir dizin aranmaz; bu nedenle yalnızca bu bağlantılardan biri üzerinden ulaşılan bir Release releases içinde yer almaz ve Releases sunan bir istemci bunun nedenini söyleyebilir. Adlandırılmayanlar: kökün içindeki bir dizine giden ve gerçekte bulunduğu yerde aranan ya da dışarıda bırakılan bağlantı; bir dizinin, bulunduğu yer ya da adı nedeniyle dışarıda bırakılacağı her yerdeki bağlantı; ve hiçbir yere gitmediği ya da bir döngüye girdiği için çözümlenemeyen bağlantı. Çalışma alanı hiç barındırmadığında boştur. |
unreadLinkedFiles | string[] | evet | Çalışma alanı kökü altında, bir YAML dosyası gibi adlandırılmış, yani kendi adı .yaml ya da .yml ile biten ve kökün dışındaki bir dosyaya giden her bağlantı; bağlantının kendisinin bulunduğu yere göre köke göreli olarak, çalışma alanının arandığı sırayla adlandırılır. Böyle bir dosya okunmaz; bu nedenle yalnızca bu bağlantılardan biri üzerinden ulaşılan bir Release releases içinde yer almaz ve Releases sunan bir istemci bunun nedenini söyleyebilir. Bir dosyanın Release olup olmadığı okunmadan bilinemez; bu nedenle bu tür her bağlantı, dosya ne barındırırsa barındırsın adlandırılır. Adlandırılmayanlar: çalışma alanı yapılandırmasının build.authoring_release olarak ya da workspace.releases’in bir anahtarı olarak Release diye adlandırdığı, okunup releases içinde bağlantının kendi yerinde listelenen bir dosyaya giden bağlantı; kökün içindeki, okunan bir dosyaya giden bağlantı; aramanın dışarıda bıraktığı bir dizinin içindeki bağlantı; ve hiçbir dosyaya gitmeyen bağlantı: ister bir dizine (kökün dışına çıktığı yerde unreadLinkedDirs bunu adlandırır), ister hiçbir yere gitsin, ister bir döngüye girsin. Çalışma alanının dışına giden bir bağlantı olan çalışma alanı yapılandırma dosyası, yani çalışma alanının kendi .aggrega-config.yaml dosyası ya da yanındaki CI’a ait katman, arama ona rastlamış olsun ya da olmasın, aramanın adlandırdığı bağlantılardan sonra adlandırılır: bu durumda çalışma alanının yapılandırması hiç okunmaz, bu yanıt hiçbir şey yapılandırılmamış olarak okunur, dolayısıyla yapılandırmanın bir bağlantı üzerinden adlandırdığı hiçbir Release listelenmez ve yapılandırmanın belirlediği her istek, o çalışma alanı için okuma engelinin koşuluyla reddedilir. Çalışma alanı hiç barındırmadığında boştur. |
Ek özelliklere izin verilmez.
ActiveReleaseResult
Bir istemcinin varsayılan olarak hangi Release üzerinde işlem yapması gerektiği. Hiçbir Release’i göstermeyen bir çalışma alanı bir hata değil olağan bir durumdur; bu nedenle hata olarak bildirilmek yerine, seçimin nasıl denendiğinin dökümüyle birlikte burada raporlanır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release | string | evet | Üzerinde karar kılınan Release; hiçbirinde karar kılınmadıysa boş. |
lockfile | string | hayır | Üzerinde karar kılınan Release’in kilit dosyası: bir pull işleminin onun için yazdığı ve bir derlemenin okuduğu dosya. Hiçbir Release üzerinde karar kılınmadıysa bulunmaz. |
reason | string | hayır | Neden hiçbir Release üzerinde karar kılınmadığı. |
trace | string | hayır | Seçimin her adımı ve ne bulduğu; böylece çağıran, hangisinin seçimi belirleyeceğini görebilir. |
Ek özelliklere izin verilmez.
EditDocumentResult
Düzenlemenin ne yazdığı ve nereye yazdığı. Bir yazmadan sonra daemon’un belgeye ilişkin okuması atılır; böylece belge hakkındaki bir sonraki yanıt, düzenlemenin ürettiği baytlardan hesaplanır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
file | string | evet | Düzenlenen belge. |
edit | string | evet | Hangi düzenlemenin uygulandığı. |
container | string[] veya null | evet | Belge içinde düzenlemenin yerleştiği yere giden yol. |
createdContainers | string[] veya null | evet | Düzenlemenin yol üzerinde oluşturması gereken kapsayıcılar. |
written | string[] veya null | evet | Yazılan belgeler. |
content | string | evet | Sonucun yazılması yerine gösterilmesini isteyen bir istek için oluşturulan belge. |
Ek özelliklere izin verilmez.
EffectiveConfigurationResult
Çalışma alanının çözümlediği yapılandırma ve her ayarın hangi belgeden geldiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
layers | string[] veya null | evet | Birleştirilen yapılandırma belgeleri, birleştirildikleri sırayla. |
settings | EffectiveConfigurationSetting[] veya null | evet | Çözümlenen her ayar ve nereden geldiği. |
Ek özelliklere izin verilmez.
ConfigInitResult
Bir yapılandırmanın tohumlanmasının ne yazdığı, nereye yazdığı ve kayıt defterinden ne okuduğu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
host | string | evet | Yapılandırmanın tohumlandığı kayıt defteri. |
scope | ConfigWriteScope | evet | Hangi yapılandırma belgesinin yazıldığı ve ne kadar geniş bir alana eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili okunurdu — makine genelindeki bir yazma için ise bu okuma yanlıştır. |
trust | TrustFetchOutcome | evet | Bir kayıt defterinin duyurduğu güven politikasının okunmasının ne sonuç verdiği. Sonuçlar farklı anlamlar taşıdıkları için ayrı tutulur: duyurulan politika alındı, kayıt defteri hiçbir şey duyurmadı (bu bir hata değildir), yerine yerleşik temel politika sabitlendi ya da hiç okuma denenmedi. Hiçbir şey duyurulmadığında, kayıt defterine erişilip erişilemediği bunun yanında belirtilir. |
written | boolean | evet | Belgenin, çağıranın yerleştirmesi için geri verilmek yerine yazılıp yazılmadığı. |
existed | boolean | hayır | Belge zaten mevcut olduğunda, yani yeni bir belge oluşturulmak yerine kayıt defteri girdisi ona birleştirildiğinde bulunur ve true’dur. Mevcut bir belgenin üzerinden yalnızca force gönderen bir istek devam eder; bu nedenle bunu göndermeyen bir isteğe verilen her yanıtta bulunmaz. |
content | string | hayır | Belgenin yazılması yerine gösterilmesini isteyen bir istek için belgenin metni. |
Ek özelliklere izin verilmez.
ConfigCaptureResult
Çözümlenen yapılandırmanın dondurulmasının bu çalışma alanının kendi belgesine ne yazdığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
configFile | string | evet | Yazılan belge. Her zaman bu çalışma alanının kendi belgesidir, çünkü tüm amaç tek bir çalışma alanını kendi kendine yeterli kılmaktır. |
workspaceRoot | string | evet | İsteğin adlandırdığı çalışma alanı. |
captured | boolean | evet | Herhangi bir şeyin dondurulup dondurulmadığı. |
sockets | ConfigCapturedSocket[] veya null | evet | Dondurulan her soket, ekleriyle birlikte. |
catalogDirs | string[] veya null | evet | Dondurulan katalog dizinleri. |
Ek özelliklere izin verilmez.
ImportResult
Yabancı bir kaynağın dönüştürülmesinin ne ürettiği ve neyi dönüştüremediği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
format | string | evet | Dönüştürülen kaynak biçimi. |
outputDir | string | evet | Yanıttaki her yolun göreli olduğu ve dosyaların içine yazıldığı dizin. |
written | string[] veya null | evet | Diske ulaşan her dosya, yazıldığı sırayla: taslaklar, ardından içe aktarmanın ne yazdığının kaydı. sync altında yalnızca sync’in değiştirdiği taslaklar ve değiştiği durumda kayıt. dryRun altında boştur. |
files | ImportedFile[] veya null | evet | İsteğin yazdığı her dosya, metniyle birlikte, dryRun altında da onsuz da: her taslak, ardından içe aktarmanın ne yazdığının kaydı. sync altında, sync’in değiştirdiği her taslak yeni metniyle, ardından o da değişiyorsa kayıt; böylece eşit durumdaki bir sync boş bir liste yanıtlar. |
drift | ImportDrift[] | evet | Bir sync’in kaynakla güncel hâle getirdiği ya da dryRun altında getireceği her parça, taslağın onları adlandırdığı sırayla; sync’in sildiği taslak bir dosya da bunlardan biridir ve anahtarsız olarak kaldırılır. Sync olmayan bir istek, eşit durumdaki bir sync ve dönüştürmesi durmuş, hiçbir şey yazmayan bir sync için boş bir listedir. |
diagnostics | ImportDiagnostic[] veya null | evet | Neyin dönüştürülemediği. |
decisions | ImportDecision[] | evet | İçe aktarıcının her kaynak düğümü nasıl eşlediği, içe aktarıcının sırasıyla ve tam olarak raporladığı gibi: dönüştürmenin nerede tahmin yürüttüğünü size söyleyen budur. Her iki teslim biçiminde ve dönüştürme dursa da durmasa da taşınır; hiç raporlamayan bir içe aktarıcı için boş bir listedir. |
owed | ImportOwed[] | hayır | Taslakların hâlâ boş bıraktığı, hiçbir kaynağın sağlayamadığı ve hiçbir yanıtın sağlamadığı her değer, taslakların yazıldığı sırayla — uyarı bulgularının adını verdiği değerler. Her yanıt bunu taşır; taslakların hiçbir eksiği olmadığında boş bir listedir. |
halted | boolean | evet | Dönüştürmenin bulgularla tamamlanmak yerine durup durmadığı. |
Ek özelliklere izin verilmez.
ScaffoldEntityResult
Taslağı oluşturulan başlangıç belgesi, çalıştırılabilir örneklerin listesi veya yazılan örnek — her biçim kendi alanlarıyla yanıt verir ve diğerlerini yok bırakır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | hayır | Taslağı oluşturulan varlık türü. Taslakta bulunur. |
skeleton | string | hayır | Taslağı oluşturulan belgenin metni. Taslakta bulunur. |
examples | ScaffoldExample[] | hayır | Dokümantasyonun yayımladığı her çalıştırılabilir örnek, her biri bir kez, ad sırasına göre. Herhangi bir örnek bulan bir listelemede bulunur. |
example | string | hayır | Yazılan örnek. Yazmada bulunur. |
dir | string | hayır | Örneğin yazıldığı dizin, çalışma alanının köküne göreli; isteğin adlandırdığı şekilde ya da istek bir ad vermediyse örneğin adı olarak. Yazmada bulunur. |
files | string[] | hayır | Yazılan her dosya, dir’e göreli ve eğik çizgiyle ayrılmış olarak, dokümantasyonun onları taşıdığı sırayla. Yazmada bulunur. |
next | string[] | hayır | Örneğin sayfasının onu derlemek için verdiği komutlar, sayfanın yazdığı gibi satır satır, yorumlar dahil: Build başlığı altındaki ilk kabuk bloğu. Sayfa hiç komut vermiyorsa bulunmaz. |
version | string | hayır | Örneğin okunduğu dokümantasyon sürümü: ikili dosya için yayımlanmış bir sürüm varsa ikili dosyanın kendi sürümü, yoksa ondan önce yayımlanmış en yeni sürüm. Yazmada bulunur. |
Ek özelliklere izin verilmez.
ScaffoldExample
Dokümantasyonun yayımladığı bir çalıştırılabilir örnek.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Örneğin adı; bir istek örneği yazmak için bunu example olarak gönderir. |
level | string | evet | Örneğin sayfasının onun için bildirdiği düzey. |
summary | string | evet | Örneğin sayfasının ilk cümlesi. |
Ek özelliklere izin verilmez.
LintResult
Uzlaşım denetiminin bulduğu, önem derecesine göre sayılmış ve belge başına listelenmiş sonuçlar. Her Release için bir kez çalışan tüm katalog denetimi ayrıca passes taşır; sayılar ve dosyalar bu durumda tüm geçişleri birlikte kapsar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
entity | string | hayır | İstek bir varlık belirttiyse, denetlenen o tek varlık. |
release | string | hayır | İstek bir Release belirttiyse, kapanışı denetlenen Release. |
checked | integer | evet | Kaç belgenin denetlendiği. Denetim her Release için bir kez çalıştıysa, geçişler üzerinden toplam: iki geçişin okuduğu bir belge her birinde sayılır. |
findings | integer | evet | Toplamda kaç bulgu olduğu. |
errors | integer | evet | Bunlardan kaçının hata olduğu. |
warnings | integer | evet | Bunlardan kaçının uyarı olduğu. |
infos | integer | evet | Bunlardan kaçının bilgi amaçlı olduğu. |
files | LintFileFindings[] veya null | evet | Belge başına bulgular. |
halted | boolean | evet | Denetimin bulgularla tamamlanmak yerine durup durmadığı. |
passes | LintPass[] veya null | hayır | Tüm katalog denetiminin geçiş geçiş dökümü; yalnızca çalışma alanı workspace.releases altında Releases belirttiği için denetim her Release için bir kez çalıştığında bulunur. Her geçiş, bulgularının hangi Releases için bulunduğunu belirtir. Hiçbirini belirtmeyen ve kendi dizinleri üzerinde bir kez denetlenen bir çalışma alanında, ayrıca tek bir varlığın ya da bir Release kapanışının denetiminde bulunmaz. |
Ek özelliklere izin verilmez.
LintPass
Releases’ine kendi katalog dizinlerini veren bir çalışma alanında tüm katalog uzlaşım denetiminin bir geçişi: çalıştırıldığı Releases, okuduğu dizinler ve orada bulduğu sonuçlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
releases | string[] veya null | evet | Geçişin çalıştırıldığı Releases; her biri çalışma alanı köküne göreli bir yol olarak. Aynı katalog dizinlerini okuyan Releases tek bir geçişi paylaşır. |
catalogDirs | string[] veya null | evet | Geçişin okuduğu katalog dizinleri, arandıkları sırayla; kökün içinde bulunanlar çalışma alanı köküne göreli olarak. Releases’i hiçbir katalog dizini okumuyorsa boştur; bu durumda geçiş hiçbir şeyi denetlememiş ve diğerlerinin hiçbirini başarısız kılmamıştır. |
checked | integer | evet | Geçişin kaç belge denetlediği. |
findings | integer | evet | Geçişin kaç bulgu bulduğu. |
errors | integer | evet | Bunlardan kaçının hata olduğu. |
warnings | integer | evet | Bunlardan kaçının uyarı olduğu. |
infos | integer | evet | Bunlardan kaçının bilgi amaçlı olduğu. |
files | LintFileFindings[] veya null | evet | Geçişin belge başına bulguları. |
Ek özelliklere izin verilmez.
PluginAddResult
Bir eklentiyi bağlamanın neyi, nereye yazdığı ve hangi sürümü sabitlediği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | Eklentinin bağlandığı soket. |
identity | string | hayır | Bağlantının çözümlendiği kimlik. |
uri | string | hayır | Ekin çözümlendiği başvuru. |
capability | string | hayır | Ekin ilgili olduğu yetenek. |
reference | string | hayır | Sürüm dahil sabitlenmiş başvuru. |
scope | PluginWriteScope | evet | Bir plugin değişikliğinin hangi yapılandırma belgesine yazıldığı ve ne kadar geniş bir alana eriştiği. Komut uzantısı soketinin kendi varsayılanı makine genelindeki belgedir; bu nedenle her yanıt hangisine yazdığını belirtir. |
written | boolean | evet | Yapılandırma belgesinin yazılıp yazılmadığı ya da çağıranın yerleştirmesi için geri verilip verilmediği. |
content | string | hayır | Yazılması yerine gösterilmesini isteyen bir istek için yapılandırma belgesinin metni. |
retraction | PluginRetraction | hayır | Bir kullanımdan kaldırma işaretçisinin hangi eklenti sürümünün sabitlendiğini nasıl belirlediği. |
withdrawn | boolean | hayır | Sorgu sabitlenen sürümü adlandırdığında ve bu çalışma alanının güvendiği bir geri çekme bildirimi o sürümü geri çektiğinde true olur. Adlandırılmış bir sürüm yine de sabitlenir, çünkü onu adlandırmak geçersiz kılmanın kendisidir. Aksi hâlde yoktur ve yokluğu sürümün geri çekilmediği anlamına gelmez: adlandırılmış bir sürümün geri çekme işaretleri okunamadığında retraction.unscreened nedenini belirtir; hiçbir sürüm adlandırılmadığında ise yayımlanmış en son sürüm seçilir ve retraction, geri çekme denetiminin bu seçim hakkında vardığı sonucu bildirir. |
Ek özelliklere izin verilmez.
PluginRemoveResult
Bir eklentiyi ayırmanın neyi ve nereye yazdığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | Eklentinin bağlandığı soket. |
query | string | evet | Hangi bağlantının kaldırıldığı. |
scope | PluginWriteScope | evet | Bir plugin değişikliğinin hangi yapılandırma belgesine yazıldığı ve ne kadar geniş bir alana eriştiği. Komut uzantısı soketinin kendi varsayılanı makine genelindeki belgedir; bu nedenle her yanıt hangisine yazdığını belirtir. |
Ek özelliklere izin verilmez.
PluginSyncResult
Bir Plugin varlığının makineye ait kayıtlarını modülüyle hizalamanın neyi değiştirdiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
entity | string | evet | Hizalanan Plugin varlık belgesi. |
hostFunctions | string[] veya null | evet | Modülün ihtiyaç duyduğunu bildirdiği ana bilgisayar işlevleri. |
commands | PluginCLICommand[] veya null | evet | Modülün katkıda bulunduğu komutlar. |
changed | boolean | evet | Belgede gerçekten bir şeyin değişip değişmediği. |
Ek özelliklere izin verilmez.
PluginGenCatalogResult
Bir üretimin oluşturduğu katalog belgeleri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
documents | PluginGeneratedDocument[] | hayır | Üretilen her belge ve metni. |
notices | string | hayır | Üretimin çağıranın bilmesini istediği her şey. |
dryRun | boolean | evet | Belgelerin yazılmak yerine geri verilip verilmediği. |
Ek özelliklere izin verilmez.
ExplainErrorResult
Derleyicinin bir koşul hakkında bildirdikleri ve yazım düzeltmesini öğreten yayımlanmış bölümler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
shortCode | string | evet | Koşulun kısa kodu. |
code | string | evet | Koşulun açıklayıcı adı. |
message | string | evet | Koşul ortaya çıktığında ne dediği. |
entries | ExplainErrorEntry[] | hayır | Düzeltmeyi öğreten yayımlanmış bölümler. |
reference | string | evet | Durumun açıklandığı yayımlanmış adres. |
note | string | hayır | Edinilemedikleri durumda yayımlanmış bölümlerin neden eksik olduğu. İkili dosyanın kendisinin bildirdikleri yine de yanıtlanır. |
Ek özelliklere izin verilmez.
GetSchemaResult
Bir türün şeması ya da — istek hiçbirini belirtmediğinde — hangi türlerin belirtilebileceği. İki genişlik iki yöntem yerine tek bir yanıtta taşınır, çünkü ‘neyi belirtebilirim’ ve ‘bunlardan hangilerinin belgesini bir yazar yazar’ iki genişlikte aynı sorudur ve iki yanıtın uyumlu tutulması gerekirdi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kind | string | hayır | Şemanın ait olduğu tür. |
schema | herhangi | hayır | İkili dosyanın tuttuğu biçimde aktarılan şemanın kendisi. |
kinds | string[] | hayır | Bu ikili dosyanın yanıt verdiği her belirteç. |
entityKinds | EntityKindDescriptor[] | hayır | Bir yazarın belgesini yazdığı daha dar küme; her biri bir isteğin belirttiği belirteci belgenin kendi başlığının bildirdiği türle eşleştirir. |
Ek özelliklere izin verilmez.
SkillsInstallResult
Asistan becerisinin kurulumunun neyi ve nereye yazdığı.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
skill | string | evet | Yazılan beceri. |
installed | SkillsInstalledFolder[] | evet | Yazılan her beceri klasörü, isteğin asistanları adlandırdığı sırayla. Ortak bir klasörü okuyan asistanlar tek bir girdiyi paylaşır, çünkü beceri oraya bir kez yazılır. |
scope | SkillFolderScope | evet | Bir beceri kurulumunun ne kadar uzağa eriştiği. Bir istek tek bir çalışma alanını adlandırır; bu nedenle hiçbir şey söylemeyen bir yanıt o çalışma alanıyla ilgili olarak okunur — ve bir asistanın her projede okuduğu kullanıcıya özgü klasörler için bu okuma yanlıştır. |
Ek özelliklere izin verilmez.
SkillsInstalledFolder
Bir kurulumun yazdığı tek bir beceri klasörü.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
agents | string[] | evet | Bu klasörü okuyan adlandırılmış asistanların tanımlayıcıları, isteğin onları adlandırdığı sırayla. |
folder | string | evet | Becerinin klasörü, mutlak bir yol olarak. |
replaced | boolean | evet | Becerinin yazılan her kopyasının taşıdığı yorum satırını taşıyan bir kopyanın — önceki bir kurulumun yazdığı ya da yayımlanmış beceri deposundan alınan — orada bulunup bulunmadığı ve değiştirilip değiştirilmediği. Orada bu satırı taşımayan bir dosya değiştirilmez, reddedilir. |
Ek özelliklere izin verilmez.
SkillsListResult
İkili dosyanın birlikte getirdiği beceriler ve bir kurulumun onları yazabileceği her asistan. Hiçbir şey yazılmaz ve hiçbir yere erişilmez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
skills | SkillsListedSkill[] | evet | İkili dosyanın birlikte getirdiği her beceri, sabit bir sırayla. |
agents | SkillsListedAgent[] | evet | Bir kurulumun beceri klasörünü bildiği her asistan, tanımlayıcıya göre sıralanmış. |
Ek özelliklere izin verilmez.
SkillsListedSkill
İkili dosyanın birlikte getirdiği tek bir beceri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Becerinin adı; bu aynı zamanda bir kurulumun yazdığı klasörün adıdır. |
description | string | evet | Bir asistanın beceriyi ne zaman kullandığı, becerinin kendisinin bildirdiği şekliyle. |
Ek özelliklere izin verilmez.
SkillsListedAgent
Bir kurulumun beceri yazabileceği tek bir asistan ve becerileri okuduğu iki klasör.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | evet | Bir isteğin asistanı adlandırdığı tanımlayıcı. |
name | string | evet | Asistanın kendi adı. |
projectFolder | string | evet | Asistanın bir projenin becerilerini okuduğu, proje köküne göreli ve eğik çizgilerle ayrılmış klasör. Proje kurulumu, isteğin adlandırdığı çalışma alanında becerinin klasörünü bunun içine yazar. |
userFolder | string | evet | Asistanın her projede kullanıcının kendi becerilerini okuduğu, ev dizinine göreli ve eğik çizgilerle ayrılmış klasör. global ile yapılan bir kurulum becerinin klasörünü bunun içine yazar. |
Ek özelliklere izin verilmez.