İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Aggrega Core (Plugin) şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/plugin-v1beta1.schema.json

Bir Wasm eklentisi: bir OCI kayıt defterine yayımlanan ve metadata.pluginType değeri (uyguladığı soket) ile yalın metadata.name değeriyle tanımlanan bir WebAssembly modülü; hedeflediği ABI sürümünü, isteğe bağlı bir imza işaretçisini ve isteğe bağlı bir çalışma zamanı bloğunu bildirir. Varlık ve onun .wasm dosyası, metadata.version ile etiketlenmiş tek bir OCI manifest’i olarak yayımlanır: varlık YAML’ı manifest’in yapılandırma blob’u, .wasm ise satır içi bir katman olarak yer alır ve bir kez imzalanır. Kimlik, metadata.pluginType/metadata.name koordinatı ile varlığın metadata.version değeridir; .wasm konumu bu koordinattan ve yapılandırılmış kayıt defterinden türetilir, çözümlenen içerik özeti ise varlıkta değil kilit dosyasında bulunur. Kilit dosyası özeti kaydeder ve kayıt defteri başına güven politikası, çekme sırasında yapıtın imzasını doğrular. Derleyici eklentinin davranışını yorumlamaz: başvuruyu yönlendirir; baytları WebAssembly çalışma zamanı yürütür.

Plugin varlıklarını yazmaya ilişkin açıklayıcı rehberlik için Plugin yazma başvurusuna bakın; bu sayfa, o başvurunun tanımladığı yapısal şemayı belgeler.

Üst düzey tür: object

Özellikler

ÖzellikTürZorunluAçıklama
apiVersionconst “aggrega.ai/v1beta1”evetSabit: "aggrega.ai/v1beta1"
kindconst “Plugin”evetSabit: "Plugin"
metadataobjectevet
specobjectevetPlugin’in hedeflediği ABI sürümü, isteğe bağlı bir imza işaretçisi ve isteğe bağlı bir çalışma zamanı bloğu. Plugin’in .wasm konumu, plugin’in kimliğinden — metadata.pluginType (soket) ile yalın metadata.name değerinden — ve yapılandırılmış kayıt defterinden türetilir; spec içinde taşınmaz.

Ek özelliklere izin verilmez.

plugin.metadata

ÖzellikTürZorunluAçıklama
namestringevetEn az 1 karakter uzunluğunda.
versionstringevetPlugin varlığının katı Semantic Versioning sürümü (ör. 1.0.0). Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
pluginTypestring (enum)evetBu plugin’in uyguladığı soket türü. Bir plugin, çalışma zamanının tanıdığı plugin türü sınıflandırmasından alınan tam olarak bir soket türü uygular: provider (IR düğümlerini provider’a özgü yapıtlara dönüştürür), linter (yazılmış içeriği inceler ve tanılamalar üretir), pipeline-step (bir FeatureRecipe’in veya Recipe’in pipeline: alanında, işlenmiş belge kümesine yama uygulayan bir adım), governance (derleme hattının yönetişim rollerini üstlenir — topoloji oluşturma sırasında düğüm etiketlerini dönüştürür ya da statik analizde IR grafiği veya işleme aşamasında işlenmiş yapıtlar üzerinde kabul/ret kararı verir; neyi üretebileceğini türü değil, bağlandığı rol belirler), cli (bir operatörün komut satırında çağırdığı bir çalışma zamanı aggrega <cmd> alt komutu ekler — derleme zamanı işleme ve işlem hattı soketlerinden ayrı bir çalışma zamanı soketi), parser (yabancı bir kaynak metni kanonik yapılandırılmış bir ağaca dönüştürür, böylece bir tüketici kendi dil ayrıştırıcısını taşımadan ağacı okur; işlediği biçimleri parse:<format> yetenekleri olarak bildirir), importer (yabancı bir altyapı veya ajan tanımı kaynağını taslak Aggrega yazım dosyalarına dönüştürür; işlediği biçimleri import:<format> yetenekleri olarak bildirir). İzin verilen değerler: "provider", "linter", "pipeline-step", "governance", "cli", "parser", "importer"
descriptionstringhayırBu varlığın ne olduğu ve ne işe yaradığı; onu kullanıp kullanmamaya karar veren biri için yazılır. Şeyi adlandıran bir cümleyle başlayın, ardından okuyucunun onu seçmek ve doğru kullanmak için bilmesi gerekenleri ekleyin: onu çalıştıran derlemeden ne beklediğini ve davranışında şaşırtıcı olabilecek her şeyi. Olağan uzunluk kısa bir paragraftır.
maintainersobject[]hayırBu varlığın sahibi olan bakımcıların listesi.
licensestringhayırBu varlığın tanımladığı yazılımın lisansı için MIT veya AGPL-3.0 gibi bir SPDX tanımlayıcısı. Bu dosyanın koşullarını değil, o yazılımın koşullarını kaydeder.
repositorystringhayırKaynak dosyaların bulunduğu Git deposunun URL’si.
homestringhayırBu varlığın ana sayfasının, wiki’sinin veya belgelerinin URL’si.
keywordsstring[]hayırKullanıcı arayüzünde keşfedilebilirlik için tanımlayıcı anahtar sözcüklerin listesi.

Ek özelliklere izin verilmez.

plugin.metadata.maintainers[]
ÖzellikTürZorunluAçıklama
namestringevet
emailstringhayır
urlstringhayır

Ek özelliklere izin verilmez.

plugin.spec

Plugin’in hedeflediği ABI sürümü, isteğe bağlı bir imza işaretçisi ve isteğe bağlı bir çalışma zamanı bloğu. Plugin’in .wasm konumu, plugin’in kimliğinden — metadata.pluginType (soket) ile yalın metadata.name değerinden — ve yapılandırılmış kayıt defterinden türetilir; spec içinde taşınmaz.

ÖzellikTürZorunluAçıklama
abiVersionstring (enum)evetPlugin’in hedeflediği host/guest ABI sürümü. Kabul edilen tek değer v1beta1’dir; bu derleyicinin artık desteklemediği bir ABI sürümünü bildiren bir Plugin, plugin’in yeniden derlenmesi gereken sürüm belirtilerek reddedilir. İzin verilen değerler: "v1beta1"
signatureobjecthayırPlugin’e eklenmiş imzaya yönelik isteğe bağlı, açıklayıcı bir işaretçi. Bu blok yalnızca belgelemedir — katalog okuyucuları için imzanın nerede bulunduğunu ve nasıl üretildiğini kaydeder; plugin’i kendisi engellemez ya da kabul etmez. Zorlayıcı denetim, çekme sırasında uygulanan kayıt defterine özgü güven politikasıdır: imza bir OCI referrer olarak getirilir, kayıt defterinin güvenilir kimliklerine veya sabitlenmiş anahtarına karşı doğrulanır ve lockfile’a doğrulanmış bir olgu olarak kaydedilir. İmza gerektiren bir kayıt defteri, gerekli bir imza eksik, güvenilmez veya geçersiz olduğunda çekme işlemini durdurur.
runtimeobjecthayırAna makinenin plugin’i yüklerken ve çalıştırırken uyguladığı isteğe bağlı yürütme kısıtlamaları. Dışa giden ağ erişimi bir yazım alanı değildir: bir plugin derleme zamanında hiçbir zaman ağa erişmez (ahead-of-time sınırı), bu nedenle burada yazılacak bir ana makine izin listesi alanı yoktur.
exportsobject[]hayırBu plugin’in sunduğu dışa aktarımlar, her biri bildirilmiş yeteneğiyle. Bir dışa aktarım, ana makinenin çağrıyı yönlendirdiği adlandırılmış bir giriş noktasıdır (örneğin render_node, lint_naming, step); dışa aktarım başına yetenek bloğu, o dışa aktarımın ne yaptığına dair yazılmış iddiadır ve ana makine bunu yayımlama ve yükleme sırasında plugin’in kendi bildirimiyle karşılaştırır. Girdiler yazarın sırasını korur. Bulunmaması, yazılmış hiçbir dışa aktarım yüzeyi bildirmez.
commandsobject[]hayırMakineye aittir, elle yazmayın: plugin’in kendi bildiriminden aggrega plugin sync (veya aggrega plugin gen-catalog) tarafından kaydedilir. Bir CLI plugin’inin eklediği üst düzey aggrega <command> fiilleri, plugin’in kendi bildiriminden okunur ve burada kendi bildirimin belirttiği sırayla kaydedilir; böylece bir CLI plugin’inin kurduğu komut yüzeyi, plugin yüklenmeden varlıktan okunabilir. CLI olmayan bir plugin komut eklemez ve boş bir liste kaydeder. Ana makine tam olarak bu kümeyi kurar; plugin’in kendi bildiriminden sapan kayıtlı bir küme yükleme sırasında durur ve yayımlama, ikili dosyayla uyumsuz bir kümeyi reddederek yazarı onu yeniden kaydetmeye yönlendirir.
providerobjecthayırBir pluginType: provider plugin’i için provider soketi bloğu: sunduğu yetenekler, aggrega.ai/v1beta1 Workload türünü nasıl çevirdiği, hangi platforma özgü açıklamaları okuduğu ve işleme davranışı sözleşmesi. Yalnızca provider işleyen plugin’lerde bulunur; diğer tüm plugin türlerinde bulunmaz.
pipelineStepobjecthayırBir pluginType: pipeline-step plugin’i için pipeline-step bloğu: adımının uyumlu olduğu provider yetenekleri. Yalnızca pipeline-step plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.
parserobjecthayırBir pluginType: parser plugin’i için parser bloğu: kanonik yapılandırılmış bir ağaca dönüştürdüğü kaynak biçimleri. Yalnızca parser plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.
importerobjecthayırBir pluginType: importer plugin’i için importer bloğu: taslak Aggrega yazım dosyalarına dönüştürdüğü yabancı kaynak biçimleri ve bu biçimlerdeki bir kaynağın tanındığı imzalar. Yalnızca importer plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.

Ek özelliklere izin verilmez.

plugin.spec.signature

Plugin’e eklenmiş imzaya yönelik isteğe bağlı, açıklayıcı bir işaretçi. Bu blok yalnızca belgelemedir — katalog okuyucuları için imzanın nerede bulunduğunu ve nasıl üretildiğini kaydeder; plugin’i kendisi engellemez ya da kabul etmez. Zorlayıcı denetim, çekme sırasında uygulanan kayıt defterine özgü güven politikasıdır: imza bir OCI referrer olarak getirilir, kayıt defterinin güvenilir kimliklerine veya sabitlenmiş anahtarına karşı doğrulanır ve lockfile’a doğrulanmış bir olgu olarak kaydedilir. İmza gerektiren bir kayıt defteri, gerekli bir imza eksik, güvenilmez veya geçersiz olduğunda çekme işlemini durdurur.

ÖzellikTürZorunluAçıklama
typeconst “sigstore-cosign”evetİmza şeması. Desteklenen şema sigstore-cosign’dır. Sabit: "sigstore-cosign"
signatureRefstringhayırBelgeleme ve keşif için, eklenmiş imza paketinin OCI referrer başvurusu. İmza burada sabitlenmek yerine çekme sırasında referrer listelemesiyle keşfedildiğinde bulunmaz.
publicKeyRefstringhayırAnahtarlı bir imza için, imzanın üretildiği açık anahtara yönelik bir işaretçi. Bulunmaması, kayıt defterinin güvenilir kimliklerine karşı doğrulanan anahtarsız (OIDC kimlikli) bir imzayı belirtir.

Ek özelliklere izin verilmez.

plugin.spec.runtime

Ana makinenin plugin’i yüklerken ve çalıştırırken uyguladığı isteğe bağlı yürütme kısıtlamaları. Dışa giden ağ erişimi bir yazım alanı değildir: bir plugin derleme zamanında hiçbir zaman ağa erişmez (ahead-of-time sınırı), bu nedenle burada yazılacak bir ana makine izin listesi alanı yoktur.

ÖzellikTürZorunluAçıklama
maxMemoryPagesintegerhayırPlugin’in doğrusal belleğini Wasm sayfası cinsinden (sayfa başına 64 KiB) sınırlar. Sıfır veya belirtilmemesi platformun varsayılan sınırını uygular, bu nedenle bir yükleme hiçbir zaman sınırsız olmaz; daha fazlasına ihtiyaç duyan bir ekleme bu değeri yükseltir. En az: 0.
timeoutMsintegerhayırPlugin’in kendi kodunun tek bir çağrı sırasında ne kadar süre çalışabileceğini milisaniye cinsinden sınırlar; çağırdığı host fonksiyonlarının içinde geçen süre sayılmaz. Linux’ta ölçü işlemci zamanıdır, bu nedenle yoğun bir makinede işlemci beklerken geçen süre sayılmaz; diğer sistemlerde geçen gerçek süredir. Yeni yüklenmiş bir plugin’e yapılan ilk çağrı, plugin’in kendi başlatılmasını da sayar. Sıfır veya belirtilmemesi platformun varsayılan sınırını uygular, bu nedenle bir çağrı hiçbir zaman iptal edilemez hale gelmez; daha uzun çalışan bir ekleme bu değeri yükseltir. En az: 0.
hostFunctionsstring[]hayırMakineye aittir, elle yazmayın: plugin’in içe aktardığı host fonksiyonları; aggrega plugin sync (veya aggrega plugin gen-catalog) tarafından .wasm içe aktarma bölümünden okunur ve burada kanonik (sıralanmış, yinelenenleri ayıklanmış) biçimde kaydedilir. Yayımlama bunları ikili dosyadan yeniden türetir ve kaydı farklı olan bir varlığı reddeder; çekme işlemi bunları yeniden türetir ve tekrar doğrular. Host tam olarak bu türetilmiş kümeyi kaydeder ve her girdiyi seçilmiş izin listesine göre doğrular.
configKVstring eşlemihayırÇalışma zamanının başlangıçta eklentiye ilettiği, dizeden dizeye anahtar/değer çiftleri biçimindeki Plugin’e özgü yapılandırma. Girdiler, üretilen kayıt çalıştırmalar arasında bayt bayt aynı olsun diye yazarın verdiği sırayı korur. Belirtilmediğinde çalışma zamanının varsayılan boş yapılandırması geçerli kalır.

Ek özelliklere izin verilmez.

plugin.spec.exports[]
ÖzellikTürZorunluAçıklama
namestringevetExport’un ABI adı — host’un yönlendirdiği ad (örneğin render_node, lint_naming, step). En az 1 karakter uzunluğunda.
operatesstring (enum)hayırBu export’un gerçekleştirdiği pipeline işlemi: patch (var olan, render edilmiş bir belgeyi değiştirir) veya emit (yeni bir belge ekler). Belirtilmemesi hiçbir işlem iddiası taşımaz. İzin verilen değerler: "patch", "emit"
scopestring (enum)hayırBu export’un üzerinde çalıştığı belge kökü: own (düğümün kendi render edilmiş belgeleri) veya host (component kapsamlı bir FeatureRecipe’in bağlı olduğu component’in belgeleri). Belirtilmemesi hiçbir kapsam iddiası taşımaz. İzin verilen değerler: "own", "host"
selectorstringhayırExport’un neye etki ettiğinin serbest biçimli, insan tarafından okunabilir açıklaması (örneğin workloads carrying a pod template). Katalog okuyucuları için belgelemedir; derleyici bunu yorumlamaz.

Ek özelliklere izin verilmez.

plugin.spec.commands[]
ÖzellikTürZorunluAçıklama
namestringevetHost’un kaydettiği komut fiili — bir operatörün çağırdığı aggrega <name> belirteci ve host’un çağrı sırasında plugin’e verdiği ayırt edici; böylece birden çok komutu destekleyen tek bir plugin, hangi komutun çağrıldığına göre yönlendirme yapar. En az 1 karakter uzunluğunda.
descriptionstringhayırKomutun komut listesinde ve yardım çıktısında gösterilen tek satırlık kısa yardım metni. Yalnızca belgelemedir; ana makine buna göre işlem yapmaz.
flagsobject[]hayırKomutun bayrakları, bildirildikleri sırayla. Her girdi, host’un komuta kaydettiği bir bayrak ekler; böylece aggrega help onu bir çekirdek komutun bayrağı gibi gösterir. Bayrağı olmayan bir komut bunu boş bırakır. Bir komut içinde her bayrak adı ve her kısaltma bir kez geçer ve hiçbiri her aggrega komutunda zaten bulunan bir bayrağı — --help, -h ve genel bayrakları — yeniden kullanmaz; host bunu plugin’in komutlarını eklerken denetler ve bildirimleri başarısız olan bir plugin bir uyarıyla birlikte eklenmez.

Ek özelliklere izin verilmez.

plugin.spec.commands[].flags[]
ÖzellikTürZorunluAçıklama
namestringevetBayrağın uzun adı — bir operatörün komut satırında verdiği —name belirteci. Bildirilen her bayrak bunu belirtmelidir. En az 1 karakter uzunluğunda.
shorthandstringhayırBayrağın isteğe bağlı kısa takma adı — bir operatörün uzun ad yerine verebileceği -x biçimi — tek bir ASCII harfi veya rakamı olarak. Belirtilmemesi, bayrağın kısa takma adı olmadığı anlamına gelir. Desen: ^[A-Za-z0-9]$.
descriptionstringhayırBayrağın komutun yardım çıktısında gösterilen tek satırlık yardım metni. İsteğe bağlı belgelemedir; host bunu ne doğrular ne de buna göre işlem yapar.
typestring (enum)hayırBayrağın değer türü — string, bool veya int — ve yardımın onu hangi tür bayrak olarak gösterdiği. Belirtilmemesi onu bir dize bayrağı olarak gösterir. İzin verilen değerler: "string", "bool", "int"
defaultstringhayırOperatör bayrağı vermediğinde bayrağın varsayılan değeri, bir dize olarak ifade edilir. Bir bool veya int bayrağı için bu, o türden bir değerdir. Bulunmaması, bayrağın varsayılan bildirmediği anlamına gelir.

Ek özelliklere izin verilmez.

plugin.spec.provider

Bir pluginType: provider plugin’i için provider soketi bloğu: sunduğu yetenekler, aggrega.ai/v1beta1 Workload türünü nasıl çevirdiği, hangi platforma özgü açıklamaları okuduğu ve işleme davranışı sözleşmesi. Yalnızca provider işleyen plugin’lerde bulunur; diğer tüm plugin türlerinde bulunmaz.

ÖzellikTürZorunluAçıklama
capabilitiesstring[]hayırPlugin’in .wasm öz bildiriminden aggrega plugin gen-catalog tarafından kaydedilir; bu nedenle bu listenin kaynağı plugin’dir. Bir yazar listeyi yayımlamadan önce daraltabilir, bu varlığın sunmaması gereken bir girdiyi kaldırabilir, ancak öz bildirimin belirtmediği hiçbir girdiyi ekleyemez: yayımlama ve plugin’in .wasm dosyası --plugin ile verilen aggrega validate, öz bildirimin belirtmediği bir yeteneği adlandıran listeyi reddeder. Yayımlama varlığı yazıldığı gibi gönderir, bu listeyi asla yeniden yazmaz ve öz bildirimin belirttiği ama listenin dışarıda bıraktığı her yeteneği not eder. Bu provider’ın hizmet verdiği yetenekler — helm veya compose gibi yetenek adları —, yani çıktı biçimini oluşturduğu yetenekler. Bir provider, bir yeteneğin çıktı biçimini paylaşan artifact’lar genelinde geneldir, tüm yetenekler genelinde değil; bu nedenle liste bir hedef değil, açık ve test edilmiş bir uyumluluk iddiasıdır. Girdiler yazarın sırasını korur. Bir Recipe’in istediği provider hedefi, listesi o hedefi içeren provider plugin’ine çözümlenir; birden fazla provider plugin’inin listelediği bir hedef, çalışma alanı yapılandırmasının plugins.providers seçimi hangi plugin’in kullanılacağını belirtmedikçe belirsiz olarak durur. Boş ya da belirtilmemiş bir liste hiçbir yetenek iddiası bildirmez, dolayısıyla plugin hiçbir hedefe hizmet vermez.
workloadSchemastringhayırBu provider’ın aggrega.ai/v1beta1 Workload türünü provider’a özgü manifest’lere nasıl çevirdiğini belgeleyen JSON Schema 2020-12. Mevcut olduğunda provider, workload: bloğu bildiren Recipes’i destekler (sentezlenmiş mod) — provider, Workload’u bu şemayı belgeleme/sözleşme olarak kullanarak provider’a özgü manifest’lere çevirir. Bir workload: Recipe’inin desteklenip desteklenmediği, bu alanın varlığıyla değil, bağlı provider’ın sentez yeteneğiyle belirlenir: sentez yapamayan bir provider’a bağlı sentezlenmiş modlu bir Recipe, render sırasında açıkça durur. Standart kütüphane kataloğu, sentez yapan provider’larda workloadSchema’yı, o yetenekle eşzamanlı tutulan belgelenmiş sözleşme olarak bildirir. Bu alan belgelenmiş sözleşmedir: gövde, iyi biçimlendirildiğini denetlemek için yükleme sırasında JSON Schema 2020-12’ye derlenir ve onu başka hiçbir şey okumaz.
wellKnownAnnotationsobject[]hayırProvider’ın destek iddiası: bu provider’ın okuduğu platforma özgü iyi bilinen annotation anahtarları (aggrega.ai/ ad alanı); her biri okunduğu kapsam ve bulunmadığında uygulanan davranışla birlikte. Bir anahtarı yalnızca provider onu okuyorsa bildirin — yayımlanan destek matrisi bu bildirimlerden oluşturulur, dolayısıyla burada listelenen bir anahtar, bir yazarın belirttiği kapsamda oluşturulan çıktıyı değiştirmesini bekleyebileceği bir anahtardır. Derleyici bildirimi iki şekilde okur: provider’ın kendi contract.inputKinds alanının iddia etmediği bir girdi türünü belirten bir scope, aynı varlıktaki komşu bir iddiayla çelişir ve derleme, anahtarı ve çelişkiyi belirterek durur; ayrıca bu provider aracılığıyla bir işlemeye ulaşan bir aggrega.ai/ annotation’ını, o işlemenin bildirdiği girdi türlerinin hiçbirinde kapsayan bir kayıt yoksa derleme uyarı verir. Bu alan, ayrılmış aggrega.ai/ öneki altında bir değer bağlamayı yöneten kuraldan farklıdır. Belirtilmemesi hiçbir destek iddiası bildirmez ve bu provider için böyle bir uyarı verilmez; bu anahtarların hiçbirini okumayan bir provider, bu liste yerine readsNoWellKnownAnnotations bildirir. Girdiler sıralı bir listedir ve yazarın sırasını korur.
readsNoWellKnownAnnotationssabit truehayırBu provider’ın aggrega.ai/ ad alanındaki platforma özgü annotation anahtarlarının, yani aksi halde wellKnownAnnotations alanının listeleyeceği anahtarların hiçbirini okumadığını bildirir: hiçbir anahtarı kapsamayan bir destek iddiasıdır; hem bu alanı hem de wellKnownAnnotations alanını dışarıda bırakmak sessizlik iken bu açık bir beyandır. Bu durumda derleme, bu provider aracılığıyla bir işlemeye ulaşan her aggrega.ai/ annotation’ı için anahtarı, provider’ı ve o işlemenin bildirdiği girdi türlerini belirterek uyarı verir; değer yine de dokunulmadan geçer ve derleme durmaz. Yalnızca true yazılabilir; bu nedenle alanı dışarıda bırakmak, hiçbir şey söylememenin tek yolu olmaya devam eder. wellKnownAnnotations ile birlikte yazılamaz: anahtarların bazılarını okuyan bir provider bunun yerine onları orada listeler. Sabit: true
contractobjecthayırProvider’ın kendi bildirdiği render davranışı sözleşmesi: oluşturduğu girdi türleri, bir dağıtım grubunun düğüm başına çıktısını nasıl birleştirdiği ve bu çıktının hangi dizinlerin altında yer aldığı, içe aktarılan artifact dosyalarına uyguladığı şablon sınırlayıcı çifti, yüklenmiş tek bir örneğin her geçişe hizmet edip edemeyeceği, sınırlar arası kenarları bağlayıp bağlamadığı, omit girdilerine uyup uymadığı, bir Recipe’in sınırının paylaşılan çıktısına kattığı dosyaları kabul edip etmediği ve ekosisteminin bir kaynağın yanında hiçbir zaman dağıtmadığı dosyalar. Provider plugin’inin öz bildiriminin yayımlama zamanındaki kaydıdır; host bunu yayımlama ve yükleme sırasında o öz bildirimle çapraz denetler. Belirtilmemesi hiçbir render davranışı sözleşmesi bildirmez ve çapraz denetim yalnızca export başına iddiaları karşılaştırır.

Ek özelliklere izin verilmez.

plugin.spec.provider.wellKnownAnnotations[]
ÖzellikTürZorunluAçıklama
keystringevetProvider’ın okuduğu platforma özgü iyi bilinen annotation anahtarı (ör. aggrega.ai/namespace). Platforma ayrılmış aggrega.ai/ annotation ad alanı altında yer alır — provider’ın okuduğu platform yönergeleri. Desen: ^aggrega\.ai/.+.
purposestringevetAnnotation’ın neyi denetlediği — mevcut olduğunda etkilediği render davranışı.
defaultBehaviorstringhayırBu annotation bulunmadığında provider’ın uyguladığı davranış.
scopestring (enum)[]hayırBu provider’ın anahtarı nerede okuduğu. İlk üç değer Recipe girdi türleridir ve anahtarın okunduğu render yolunu belirtir — sourced vendor’a alınmış bir dosya kümesi, synthesized provider’ın somutlaştırdığı bir Workload, artifactsStandalone tüm çıktısı içe aktarılan artifact belgelerinden oluşan bir düğüm. Bunların her biri, bu provider’ın contract.inputKinds alanının iddia ettiği bir girdi türü olmalıdır; iddia etmediği birini belirtmek derlemeyi durdurur. boundary, düğüm başına değil sınır başına bir kez çözümlenen bir anahtar içindir — birleştirilmiş bir artifact’ın adı ya da sınırlar arası bir başvurunun biçimlendirildiği yerleşim bağlamı —; burada girdi türü anlamlı bir eksen değildir, bu nedenle contract.inputKinds ile eşleştirilmez. Birden fazla yolda okunan bir anahtar hepsini listeler. Belirtilmemesi yol başına hiçbir iddiada bulunmaz: hiçbir şey denetlenmez ve anahtar yalnızca provider’ın onu bir yerde okuduğunu belirtir. En az 1 girdi. Hiçbir girdi iki kez yer alamaz. Her girdi için izin verilen değerler: "sourced", "synthesized", "artifactsStandalone", "boundary".

Ek özelliklere izin verilmez.

plugin.spec.provider.contract

Provider’ın kendi bildirdiği render davranışı sözleşmesi: oluşturduğu girdi türleri, bir dağıtım grubunun düğüm başına çıktısını nasıl birleştirdiği ve bu çıktının hangi dizinlerin altında yer aldığı, içe aktarılan artifact dosyalarına uyguladığı şablon sınırlayıcı çifti, yüklenmiş tek bir örneğin her geçişe hizmet edip edemeyeceği, sınırlar arası kenarları bağlayıp bağlamadığı, omit girdilerine uyup uymadığı, bir Recipe’in sınırının paylaşılan çıktısına kattığı dosyaları kabul edip etmediği ve ekosisteminin bir kaynağın yanında hiçbir zaman dağıtmadığı dosyalar. Provider plugin’inin öz bildiriminin yayımlama zamanındaki kaydıdır; host bunu yayımlama ve yükleme sırasında o öz bildirimle çapraz denetler. Belirtilmemesi hiçbir render davranışı sözleşmesi bildirmez ve çapraz denetim yalnızca export başına iddiaları karşılaştırır.

ÖzellikTürZorunluAçıklama
inputKindsobjecthayırBu plugin’in üç Recipe girdi türünden hangilerini işlediği: kaynaklı bir dosya kümesi, sentezlenmiş bir workload ve yalnızca artifact’lerden oluşan bağımsız bir düğüm. Her alan bağımsız bir beyandır.
boundaryAssemblystring (enum)hayırPlugin’in bir dağıtım grubunun düğüm başına render çıktısını nasıl birleştirdiği: none her düğümün çıktısını doğrudan dağıtım yoluna yazar; merge düğüm başına parçaları tek bir belgede birleştirir; nest her düğümün çıktısını bir şemsiye yapı içinde kendi konumuna yerleştirir. Bulunmadığında herhangi bir birleştirme beyanı taşımaz. İzin verilen değerler: "none", "merge", "nest"
artifactDelimitersobjecthayırPlugin’in içe aktarılan artifact dosyalarına uyguladığı Go şablonu sınırlayıcı çifti. Bulunmadığında varsayılan {{/}} çifti kullanılır; hedef sözdizimi bu çiftle çakışan bir plugin burada alternatif bir çift beyan eder.
assemblyNameAnnotationobjecthayırÇözümlenmiş değeri, plugin’in bir dağıtım grubundan birleştirdiği artifact’i adlandıran sınır anotasyonu. Bir grubun katkıda bulunan sınırlarını tek bir adlandırılmış birleşimde toplayan bir plugin, okuduğu anotasyon anahtarını ve katkıda bulunan her sınırın bu anotasyonun çözümlenmiş değeri üzerinde uyuşması gerekip gerekmediğini beyan eder. Bulunmadığında plugin birleşimini yalnızca dağıtım yolundan adlandırır.
reusableInstancebooleanhayırYüklenmiş tek bir plugin örneğinin, her geçiş için yeni bir örnek yerine bir derlemenin tüm render, birleştirme ve doğrulama geçişlerine hizmet edip edemeyeceği. Yalnızca plugin geçişler arasında durum tutmadığında — geçiş başına girdisinin saf bir fonksiyonu olduğunda — true olarak beyan edilir; böylece tek bir örnek, yeniden kullanılsa da yeni yüklense de bayt bayt aynı çıktıyı üretir. Bulunmadığında (false) her geçiş için yeni bir örnek yüklenir ve yapısı gereği durum taşıyan bir plugin yalıtılır.
crossBoundaryLinkingbooleanhayırPlugin’in, eşleştirilmiş bir link_publish/link_resolve dışa aktarım sözleşmesi aracılığıyla sağlayıcıya özgü çapraz başvuru bağlantıları üreterek sınırlar arası bir uses kenarını — tüketen ve tüketilen uçları farklı dağıtım gruplarında birleşen bir uses kenarını — bağlayıp bağlamadığı. Yalnızca plugin her ikisini de dışa aktardığında true olarak beyan edilir; dışa aktarım çiftiyle eşleşmeyen bir beyan yükleme sırasında durur. Bulunmadığında (false) sınırlar arası bağlama beyan edilmez, bu nedenle host plugin’e hiçbir bağlantı geçişi yönlendirmez.
omitsbooleanhayırSağlayıcının omit girdilerini — bir düğümün çıktısından çıkarılacak render edilmiş birimleri adlandıran girdileri — dikkate alıp almadığı: bir girdinin eşleştiği her birimi render ettiği çıktının dışında bırakır ve her girdinin kaç birimle eşleştiğini bildirir. Sağlayıcının öz bildiriminin yaptığı omits beyanının yayımlama zamanındaki kaydıdır ve bu bildirimden farklı bir değer yükleme sırasında durur. Bulunmadığında (false) böyle bir destek beyan edilmez.
boundaryArtifactsbooleanhayırSağlayıcının, bir Recipe’in Recipe’in spec.boundary.artifacts alanı altında, render ettiği sınırın paylaşılan çıktısına katkıda bulunduğu dosyaları kabul edip etmediği: derleyici bu tür her dosyayı, sınırın birleştirilmiş çıktısını tutan dizine bir kez yazar ve sağlayıcının hedefi onu o çıktının parçası olarak ele alır. Sağlayıcının öz bildiriminin yaptığı boundary_artifacts beyanının yayımlama zamanındaki kaydıdır ve bu bildirimden farklı bir değer yükleme sırasında durur. Bulunmadığında (false) böyle bir destek beyan edilmez ve bu sağlayıcı için bloğu beyan eden bir Recipe, herhangi bir şey render edilmeden reddedilir.
nestSegmentstringhayırboundaryAssembly değeri nest olan bir sağlayıcı için, bu sağlayıcının hedefinin her katkıda bulunanın kendi alt dizinini altına yerleştirdiği dizin — bir chart şemsiyesi için charts, bir kök modül için modules. Derleyici bu dizini, katkıda bulunanın adını ve her dosyanın kendi yolunu birleştirir. Yalnızca iç içe yerleştiren bir sağlayıcı için okunur. Bulunmadığında her katkıda bulunanın alt dizini doğrudan sınırın kendi dizinine yerleştirilir. Değer tek bir dizini adlandırır, asla bir yolu değil.
sourceIgnoreobjecthayırBu sağlayıcının ekosisteminin render ettiği bir kaynağın yanında asla göndermediği dosyalar, gitignore sözdiziminde yok sayma kuralları olarak — öz bildiriminin beyan ettiği source_ignore kurallarının yayımlama zamanındaki kaydı. Bir yazar, yeteneğine bu sağlayıcının kendisi için hizmet ettiği bir Recipe veya FeatureRecipe’i sabitlediğinde, bu kurallar yazarın kendi .aggregaignore dosyasıyla birleştirilir ve bu plugin’in adıyla birlikte varlığın yanındaki entity.lock dosyasına kaydedilir; varlığın yerel kaynağının sonraki her yayımlanması, karşılaştırılması ve render edilmesi kaydedilen kuralları uygular. Bulunduğunda öz bildirimin beyan ettiğine eşit olmalıdır ve yükleme, bildirimi farklı olan bir plugin’i reddeder; bulunmadığında herhangi bir beyanda bulunmaz ve karşılaştırılmaz.

Ek özelliklere izin verilmez.

plugin.spec.provider.contract.inputKinds

Bu plugin’in üç Recipe girdi türünden hangilerini işlediği: kaynaklı bir dosya kümesi, sentezlenmiş bir workload ve yalnızca artifact’lerden oluşan bağımsız bir düğüm. Her alan bağımsız bir beyandır.

ÖzellikTürZorunluAçıklama
sourcedbooleanhayırKaynak olarak alınmış bir dosya kümesini (bir chart, bir modül, bir compose dosyası) işler.
synthesizedbooleanhayırSentezlenmiş bir iş yükünü provider’a özgü yapıtlara işler.
artifactsStandalonebooleanhayırYalnızca yapıtlardan oluşan bağımsız bir düğümü — içe aktarılmış yapıt belgeleri taşıyan, kaynağı veya iş yükü olmayan bir düğümü — işler.

Ek özelliklere izin verilmez.

plugin.spec.provider.contract.artifactDelimiters

Plugin’in içe aktarılan artifact dosyalarına uyguladığı Go şablonu sınırlayıcı çifti. Bulunmadığında varsayılan {{/}} çifti kullanılır; hedef sözdizimi bu çiftle çakışan bir plugin burada alternatif bir çift beyan eder.

ÖzellikTürZorunluAçıklama
leftstringevetAçılış ayırıcısı.
rightstringevetKapanış ayırıcısı.

Ek özelliklere izin verilmez.

plugin.spec.provider.contract.assemblyNameAnnotation

Çözümlenmiş değeri, plugin’in bir dağıtım grubundan birleştirdiği artifact’i adlandıran sınır anotasyonu. Bir grubun katkıda bulunan sınırlarını tek bir adlandırılmış birleşimde toplayan bir plugin, okuduğu anotasyon anahtarını ve katkıda bulunan her sınırın bu anotasyonun çözümlenmiş değeri üzerinde uyuşması gerekip gerekmediğini beyan eder. Bulunmadığında plugin birleşimini yalnızca dağıtım yolundan adlandırır.

ÖzellikTürZorunluAçıklama
annotationstringevetPlugin’in birleştirilmiş artifact’ın adını okuduğu sınır ek açıklaması anahtarı.
requireUniquebooleanhayırBir dispatch grubuna katkıda bulunan her sınırın ek açıklamanın çözümlenen değeri üzerinde uzlaşması gerekip gerekmediği. True olduğunda, katkıda bulunan sınırları ek açıklamayı farklı değerlere çözümleyen bir grup derlemeyi durdurur; false olduğunda plugin ilk çözümlenen değeri kabul eder.

Ek özelliklere izin verilmez.

plugin.spec.provider.contract.sourceIgnore

Bu sağlayıcının ekosisteminin render ettiği bir kaynağın yanında asla göndermediği dosyalar, gitignore sözdiziminde yok sayma kuralları olarak — öz bildiriminin beyan ettiği source_ignore kurallarının yayımlama zamanındaki kaydı. Bir yazar, yeteneğine bu sağlayıcının kendisi için hizmet ettiği bir Recipe veya FeatureRecipe’i sabitlediğinde, bu kurallar yazarın kendi .aggregaignore dosyasıyla birleştirilir ve bu plugin’in adıyla birlikte varlığın yanındaki entity.lock dosyasına kaydedilir; varlığın yerel kaynağının sonraki her yayımlanması, karşılaştırılması ve render edilmesi kaydedilen kuralları uygular. Bulunduğunda öz bildirimin beyan ettiğine eşit olmalıdır ve yükleme, bildirimi farklı olan bir plugin’i reddeder; bulunmadığında herhangi bir beyanda bulunmaz ve karşılaştırılmaz.

ÖzellikTürZorunluAçıklama
patternsstring[]hayırEkosistemin kendi yoksayma desenleri; her biri yerel kaynak dizininin köküne göre kapsamlanır ve uygulandıkları sırayla yer alır.
filesstring[]hayırEkosistemin bir kaynağın içinde dikkate aldığı yoksayma dosyalarının adları — bir chart için .helmignore. Bu tür her dosyanın satırları, o dosyayı içeren dizine göre kapsamlanan ek desenlerdir.

Ek özelliklere izin verilmez.

plugin.spec.pipelineStep

Bir pluginType: pipeline-step plugin’i için pipeline-step bloğu: adımının uyumlu olduğu provider yetenekleri. Yalnızca pipeline-step plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.

ÖzellikTürZorunluAçıklama
capabilitiesstring[]hayıraggrega plugin gen-catalog tarafından plugin’in .wasm öz bildiriminden kaydedilir; bu nedenle bu listenin kaynağı plugin’dir. Yazar, yayımlamadan önce listeyi daraltarak bu varlığın sunmaması gereken bir girdiyi kaldırabilir, ancak öz bildirimin adlandırmadığı hiçbir girdiyi ekleyemez: yayımlama ve plugin’in .wasm dosyası --plugin ile verilen aggrega validate, öz bildirimin adlandırmadığı bir yeteneği adlandıran listeyi reddeder. Yayımlama varlığı yazıldığı gibi gönderir, bu listeyi asla yeniden yazmaz ve öz bildirimin adlandırdığı ancak listenin dışarıda bıraktığı her yeteneği not eder. Bu plugin’in pipeline adımının uyumlu olduğu sağlayıcı yetenekleri — adımın render edilmiş çıktısını nasıl dönüştüreceğini bildiği, helm veya compose gibi sağlayıcı yetenek adları. Bir adım her seferinde tek bir sağlayıcının çıktı biçimine göre yazılır, bu nedenle liste bir hedef değil, açık ve test edilmiş bir uyumluluk beyanıdır. Girdiler yazarın sırasını korur. Bu beyanın katalogdan okunabilir kaydıdır; derleme, bir adım bir kapsama dokunduğunda aynı beyanı plugin’den okur ve o kapsamın belgelerini render eden sağlayıcı bunlar arasında değilse durur. Boş veya bulunmayan bir liste herhangi bir uyumluluk beyanında bulunmaz, bu nedenle hiçbir kapsam adımı kabul etmez.

Ek özelliklere izin verilmez.

plugin.spec.parser

Bir pluginType: parser plugin’i için parser bloğu: kanonik yapılandırılmış bir ağaca dönüştürdüğü kaynak biçimleri. Yalnızca parser plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.

ÖzellikTürZorunluAçıklama
capabilitiesstring[]hayıraggrega plugin gen-catalog tarafından plugin’in .wasm öz bildiriminden kaydedilir; bu nedenle bu listenin kaynağı plugin’dir. Yazar, yayımlamadan önce listeyi daraltarak bu varlığın sunmaması gereken bir girdiyi kaldırabilir, ancak öz bildirimin adlandırmadığı hiçbir girdiyi ekleyemez: yayımlama ve plugin’in .wasm dosyası --plugin ile verilen aggrega validate, öz bildirimin adlandırmadığı bir yeteneği adlandıran listeyi reddeder. Yayımlama varlığı yazıldığı gibi gönderir, bu listeyi asla yeniden yazmaz ve öz bildirimin adlandırdığı ancak listenin dışarıda bıraktığı her yeteneği not eder. Bu ayrıştırıcının kanonik yapılandırılmış bir ağaca dönüştürdüğü kaynak biçimleri; her biri parse:<format> olarak yazılır — örneğin parse:yaml. Önek girdinin parçasıdır, bu nedenle birden fazla biçim duyuran bir plugin her biçim için bir girdi listeler. Girdiler yazarın sırasını korur. İstenen bir biçim, listesinde eşleşen girdiyi içeren ayrıştırıcıya çözümlenir; hiçbir ayrıştırıcının duyurmadığı bir biçim derlemeyi durdurur ve birden fazla ayrıştırıcı plugin’inin duyurduğu bir biçim belirsiz olarak durur. Boş veya bulunmayan bir liste herhangi bir biçim beyanında bulunmaz, bu nedenle plugin hiçbir şeyi ayrıştırmaz.

Ek özelliklere izin verilmez.

plugin.spec.importer

Bir pluginType: importer plugin’i için importer bloğu: taslak Aggrega yazım dosyalarına dönüştürdüğü yabancı kaynak biçimleri ve bu biçimlerdeki bir kaynağın tanındığı imzalar. Yalnızca importer plugin’lerinde bulunur; diğer tüm plugin türlerinde bulunmaz.

ÖzellikTürZorunluAçıklama
capabilitiesstring[]hayıraggrega plugin gen-catalog tarafından eklentinin .wasm öz bildiriminden kaydedilir; bu nedenle bu listenin kaynağı eklentidir. Yazar, yayımlamadan önce listeyi daraltarak bu varlığın sunmaması gereken bir girdiyi kaldırabilir, ancak öz bildirimin adlandırmadığı hiçbir girdiyi ekleyemez: yayımlama ve eklentinin .wasm dosyası --plugin ile verilen aggrega validate, öz bildirimin adlandırmadığı bir yeteneği adlandıran listeyi reddeder. Yayımlama varlığı yazıldığı gibi gönderir, bu listeyi asla yeniden yazmaz ve öz bildirimin adlandırdığı ancak listenin dışarıda bıraktığı her yeteneği not eder. Bu içe aktarıcının taslak Aggrega yazım dosyalarına dönüştürdüğü yabancı kaynak biçimleri; her biri import:<format> olarak yazılır — örneğin import:terraform. Önek girdinin parçasıdır; bu nedenle birden çok biçim duyuran bir eklenti her biçim için bir girdi listeler. Girdiler yazarın sırasını korur. İstenen bir içe aktarma biçimi, listesinde eşleşen girdiyi içeren içe aktarıcıya çözümlenir; hiçbir içe aktarıcının duyurmadığı bir biçim içe aktarmayı durdurur ve birden fazla içe aktarıcı eklentisinin duyurduğu bir biçim, çalışma alanı yapılandırmasındaki bir plugins.importer girdisi bunlardan birini bağlamadıkça belirsiz olarak durur; bağlanırsa o çalışır. Boş ya da bulunmayan bir liste hiçbir biçim iddiası bildirmez; bu durumda eklenti hiçbir şeyi içe aktarmaz.
detectobject[]hayırMakineye aittir, elle yazmayın: varlık eklentinin .wasm öz bildiriminden üretildiğinde bu bildirimden türetilir ve buraya öz bildirimin bildirdiği sırayla kaydedilir. Bir içe aktarma hiçbir biçim belirtmediğinde, bu içe aktarıcının biçimlerindeki bir kaynağın tanındığı imzalar. aggrega import, çalışma alanının kataloğundaki her içe aktarıcının, tüm sürümler dahil, ve derleyicinin çekirdek içe aktarıcılarının imzalarını okur, hiçbir biçimin ne olduğunu bilmeden bunları kaynakla eşleştirir ve kaynağı, imzası eşleşen tek içe aktarıcının biçimi olarak okur; hiçbir imzanın eşleşmediği bir kaynak biçim istenerek reddedilir, birden fazla biçimin imzalarının eşleştiği bir kaynak ise bu biçimler adlandırılarak reddedilir. Bir kaynağı tanıyan içe aktarıcı onu duyurduğu her biçim olarak tanır; bu nedenle birden fazla biçim duyuran bir içe aktarıcının her eşleşmesi belirsiz olarak reddedilir. Bulunduğunda liste, eklentinin öz bildiriminin bildirdiğine girdi girdi ve aynı sırayla eşit olmalıdır; yükleme ve yayımlama, bildirimi farklı olan bir eklentiyi bu alanı adlandırarak reddeder. Bulunmaması hiçbir iddiada bulunmaz ve karşılaştırılmaz; bu durumda içe aktarıcının biçimlerine yalnızca adları belirtilerek ulaşılır.

Ek özelliklere izin verilmez.

plugin.spec.importer.detect[]
ÖzellikTürZorunluAçıklama
syntaxstringevetKaynağın ayrıştırıldığı sözdizimsel biçim — örneğin json ya da yaml —; bu, bir ayrıştırıcı eklentisinin parse:<syntax> olarak duyurduğu biçimdir. Kaynak, çalışma alanının kataloğunun o sözdizimi için sunduğu ayrıştırıcıyla ya da kataloğun hiçbir ayrıştırıcı sunmadığı bir sözdizimi için derleyicinin taşıdığı ayrıştırıcıyla, sözdizimini kaç imza adlandırırsa adlandırsın en fazla bir kez ayrıştırılır; bu sözdiziminde ayrıştırılamayan bir kaynak, onu adlandıran hiçbir imzayla eşleşmez. İkisinin de ayrıştırıcı sunmadığı bir sözdizimi, tanımayı o ayrıştırıcının yokluğunu adlandırarak durdurur. En az 1 karakter uzunluğunda.
filesstring[]hayırİmzanın uygulandığı dosya adı kalıpları; ayırıcıları eğik çizgi olarak okunarak kaynağın adının sonuyla eşleştirilir: tek bölümlü bir kalıp dosyanın kendi adıyla, eğik çizgiyle ayrılmış birkaç bölümlü bir kalıp ise yolun sondaki o sayıda bölümüyle eşleştirilir; böylece .vscode/mcp.json, .vscode adlı bir dizindeki mcp.json adlı bir dosyayla eşleşir. Bir bölüm içinde * herhangi bir karakter dizisiyle, ? tek bir karakterle ve [...] bir sınıftan tek bir karakterle eşleşir. İmza, herhangi bir kalıp eşleştiğinde uygulanır. Bulunmaması ya da boş olması, imzayı adı ne olursa olsun tek dosyadan oluşan bir kaynağa uygular, bir dizinin hiçbir dosyasına uygulamaz. Bir içe aktarıcının imzalarındaki kalıplar, aggrega import komutunun bir dizinin hangi dosyalarını ona teslim edeceğine de karar verir.
matchobject[]hayırAyrıştırılan ağacın bildirilen sırayla, tümünü karşılaması gereken yüklemler. Bulunmaması ya da boş olması, ağaçtan sözdiziminde ayrıştırılmanın ötesinde hiçbir şey istemez.

Ek özelliklere izin verilmez.

plugin.spec.importer.detect[].match[]
ÖzellikTürZorunluAçıklama
pathstringevetYüklemin ağaçta nereye baktığı; ağacın tepesinden başlayarak noktalarla birleştirilmiş anahtarlar olarak yazılır: data.nodes, en üst düzeydeki data nesnesinin nodes üyesini adlandırır. 0 veya daha büyük bir tam sayı olarak yazılan bir bölüm, sıfırdan sayarak bir dizinin o konumunu seçer; bu nedenle nodes.0.type ilk düğümün type değerini adlandırır; diğer her bölüm bir nesnenin bir üyesini seçer. En az 1 karakter uzunluğunda.
isstring (enum)evetYolun neye ulaşması gerektiği: present, yol null dahil herhangi türde bir değere ulaştığında sağlanır; absent, yol hiçbir şeye ulaşmadığında sağlanır; object, array, string, number ve boolean, yol o türde bir değere ulaştığında sağlanır. İzin verilen değerler: "present", "absent", "object", "array", "string", "number", "boolean"
equalsstringhayırYolun ulaştığı değerin tam olarak eşit olması gereken bir dize; dize olmayan bir değer ona asla eşit olmaz. Bir yüklemde equals ve prefix öğelerinden en fazla biri bildirilir. En az 1 karakter uzunluğunda.
prefixstringhayırYolun ulaştığı değerin onunla başlaması gereken bir dize; dize olmayan bir değer asla onunla başlamaz. Bir yüklemde equals ve prefix öğelerinden en fazla biri bildirilir. En az 1 karakter uzunluğunda.

Ek özelliklere izin verilmez.