Aggrega Wasm Linter Socket şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/wasm-linter-v1beta1.schema.json
Linter soketinin tükettiği (LinterInput) ve ürettiği (LinterOutput) aktarım biçimleri. Linter, yayımlama sırasında önceki sürüm + önerilen sürüm varlık çifti üzerinde (şema evrimi kuralı), çalışma alanı lint işlemi sırasında ise tek tek varlıklar üzerinde (kural başına yapısal kurallar) çalışır. Yayımlanan tek bir Wasm eklentisi birçok kuralı barındırır; eklenti, hangi kuralın çalıştırılacağını LinterInput.rule_id ile seçer. Bu şema, her iki aktarım biçiminin tek kaynağıdır: Go, Rust ve TypeScript yük türleri bu şemadan ortak eklenti ABI paketine üretilir ve her eklenti kiti kendi kopyasını tanımlamak yerine bu üretilmiş türleri yeniden dışa aktarır.
Aşağıdaki biçimlerden biri
LinterInputLinterOutput
Tanımlar
LinterInput
Ana makinenin her çağrıda publishing-linter eklentisine verdiği yük. rule_id, eklentinin hangi kurala yönlendireceğini seçer. entity_kind, denetlenen varlık türünü belirtir (Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate). proposed, sınıflandırılan varlığın ayrıştırılmış yapısını taşır (ana makine göndermeden önce YAML’ı JSON’a ayrıştırır; eklenti ham baytları hiçbir zaman görmez). previous, schema-evolution kuralı için varlığın ayrıştırılmış önceki sürümünü taşır; uygulanabilir olmadığında atlanır. implemented_component, farklı türden ilişkili bir varlığı (denetlenen bir Recipe’nin gerçekleştirdiği Component’i) bir varlığı başka bir varlığın bildirdiği sözleşmeyle karşılaştıran kurallar için taşır; uygulanabilir olmadığında atlanır. release ve components, bir Release’i bütün olarak okuyan bir kural için Release’in geri kalanını taşır: bu durumda proposed, Release’in dağıttığı Aggregate’tir; release o Release’tir; components ise Aggregate’in her bileşen örneğinin örneği olduğu Component’tir; diğer tüm girdilerde ikisi de atlanır. policies, kuralın başvurduğu çalışma alanı başına yayımlama disiplini yapılandırmasını taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
rule_id | string | evet | Eklentinin yönlendirmesi gereken kural, kural kimliğiyle adlandırılır: ortaya çıkan bulgunun rule_id içinde taşıdığı aynı kebab-case tanımlayıcıdır; böylece bastırılan veya bildirilen bir kural her yüzeyde aynı şekilde adlandırılır. Tanınan küme, yayımlanan eklentinin yönlendirdiği kurallardan oluşur; eklentinin tanımadığı bir kural kimliği sessizce geçmek yerine bir ‘unknown_rule’ bulgusu üretir. |
entity_kind | string (enum) | evet | proposed/previous değerlerinin kodladığı varlık türü. schema-evolution kuralının sınıflandırması türe göre değişir; yapısal kurallar belirli türlerle sınırlıdır. İzin verilen değerler: "Component", "Feature", "Recipe", "FeatureRecipe", "SchemaLibrary", "MappingLibrary", "Aggregate" |
proposed | object | evet | Sınıflandırılan varlığın ayrıştırılmış yapısı. Ana makine göndermeden önce YAML’ı JSON’a dönüştürür; böylece eklenti zaten yapılandırılmış bir değer alır ve ham baytları hiçbir zaman görmez. Bir Release’i bütün olarak okuyan bir kuralın girdisinde bu, o Release’in dağıttığı Aggregate’tir. Her girdide, varlık teslim edilmeden önce her parametre değeri kaldırılır, çünkü bir parametrenin değeri kimlik bilgisinin kendisi olabilir; bu nedenle hiçbir parametre değeri bu alan aracılığıyla bir linter eklentisine ulaşmaz. Bir Aggregate, spec.parameters bildirimlerini korur; her biri yalnızca Aggregate şemasının bir parametre bildiriminde kabul ettiği, default dışındaki anahtarları tutar ve properties, items ve valuesType altında iç içe geçmiş her bildirim de aynı kurala tabidir: bir default değiştirilmek yerine kaldırılır, böylece eklenti bir bildirimin default verip vermediğini anlayamaz; şemanın orada kabul etmediği bir anahtar da tuttuğu her şeyle birlikte kaldırılır. spec.aggregates altındaki her modülün, o modüle geçirilen değerleri taşıyan parameters bloğu bütünüyle kaldırılır; başka herhangi bir türden varlıktaki spec.parameters de öyle. Bir parametreyi okuyan şablon metni yazıldığı gibi korunur. |
previous | object | hayır | Varlığın önceki sürümünün ayrıştırılmış yapısı; ikili karşılaştırma yapan kurallar (schema-evolution) içindir ve parametre değerleri proposed’dan kaldırıldıkları biçimde aynen kaldırılır. Kural bir önceki sürüm başvurusuna ihtiyaç duymadığında (ör. ilk yayın, yalnızca yapısal kurallar) atlanır. |
implemented_component | object | hayır | Denetlenen bir Recipe’nin spec.implements içinde adlandırdığı, ana makine tarafından çözümlenen Component’in ayrıştırılmış yapısı. Denetlenen varlıktan FARKLI türde ilişkili bir varlıktır ve onu previous’tan ayıran budur: previous aynı varlığın başka bir sürümünü taşırken bu alan, Recipe’nin bildirilen çıktı sözleşmesini gerçekleştirdiği Component’i taşır. Ana makine onu, bir derlemenin kullandığı aynı katalog aramasıyla, Component’in adını anahtar alarak çözümler; böylece spec.implements’in kabul ettiği üç sabitleme biçiminin tümü (sürümsüz, tam, ana sürümle uyumlu aralık) aynı girdiye ulaşır. Denetlenen varlık bir Recipe değilse, hiçbir Component adlandırmıyorsa veya çalışma alanının katalog dizinlerinde o adda bir Component’e ulaşılamıyorsa atlanır. Değerin bulunmaması, sözleşmenin boş olduğu anlamına gelmez, karşılaştırmanın kullanılamadığı anlamına gelir: bu alanı okuyan bir kural, alan yoksa hiçbir bulgu üretmez. |
release | object | hayır | Release kapsamlı bir denetimin adlandırdığı Release’in, extends zinciri katlanmış ayrıştırılmış yapısı; böylece bir alt Release, tabanından devraldıklarını taşır. Ana makine onu proposed’da olduğu gibi YAML’dan JSON’a dönüştürür. spec.parameters bloğu Aggregate’in parametrelerini karşılayan değerleri tutar; bu nedenle Release teslim edilmeden önce bütünüyle kaldırılır: bir parametrenin değeri kimlik bilgisinin kendisi olabilir, hiçbir kural bu bloğu okumaz ve böylece hiçbir parametre değeri bu alan aracılığıyla bir linter eklentisine ulaşmaz. Yalnızca bir Release’i bütün olarak okuyan bir kuralın girdisinde bulunur; orada proposed, bu Release’in dağıttığı Aggregate’tir ve parametre değerleri proposed’ın açıkladığı gibi kaldırılmıştır; diğer tüm girdilerde atlanır. |
components | object eşlemi | hayır | Aggregate’in her bileşen örneğinin örneği olduğu Component; Aggregate’in örneğe verdiği örnek adıyla anahtarlanır; bu, Aggregate’in ve Release’in kendi components eşlemlerinin kullandığı anahtarın aynısıdır. Her değer, örneğin type alanının çözümlendiği Component’tir; varsa extends zinciri katlanmış ve implemented_component gibi JSON’a dönüştürülmüştür. Component’ine çalışma alanının katalog dizinlerinde ulaşılamayan bir örnek bulunmaz ve bir kural bu yokluğu hiçbir şey bildirmeyen bir Component olarak değil, kullanılamaz olarak okur. Yalnızca release ile birlikte, bir Release’i bütün olarak okuyan bir kuralın girdisinde bulunur; diğer tüm girdilerde atlanır. |
source_path | string | hayır | Varlığın yüklendiği dosya sistemi yolu. Katalog dosya sisteminde gezinen ana makine çağırıcıları tarafından doldurulur; yola duyarlı kurallar (ör. category-matches-directory) tarafından kullanılır. Çağırıcının yol bağlamı olmadığında atlanır. |
policies | Policies | hayır | Kuralın başvurduğu çalışma alanı başına yayımlama disiplini yapılandırması; ana makinenin çalışma alanı yapılandırmasından ve komut satırı geçersiz kılmalarından oluşturduğu bir Policies nesnesi olarak taşınır. |
Ek özelliklere izin verilmez.
LinterOutput
publishing-linter eklentisinin ürettiği yanıt biçimi. findings, sonuç üreten her kural çağrısı için bir girdi taşır. schema-evolution kuralı tam olarak bir bulgu (sınıflandırma kararı) üretir; yapısal kurallar sıfır (ihlal yok) veya çok sayıda (her ihlal için bir) bulgu üretebilir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
findings | Diagnostic[] | evet | Eklenti çağrısının ürettiği kural başına bulgular, eklentinin üretim sırasıyla. |
error | string | hayır | Konuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır. |
Ek özelliklere izin verilmez.
Policies
Kural kümesinin başvurduğu, çalışma alanı başına yayımlama disiplini yapılandırması; ana makine tarafından çalışma alanı yapılandırmasının yayımlama disiplini ayarlarından ve varsa komut satırı geçersiz kılmalarından derlenir. Bu şema, biçimin sözleşmesidir. Bir alanın atlanması her bayrağı varsayılan olarak false yapar ve ana makine yalnızca değeri varsayılan olmayan alanları yazar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
allow_dynamic_refs | boolean | hayır | true olduğunda, SchemaLibrary girdilerinde $dynamicAnchor / $dynamicRef kullanımına izin verilir (dynamic-refs kuralını bastırır). Varsayılan false. |
allow_id_overrides | boolean | hayır | true olduğunda, SchemaLibrary girdilerinde $id geçersiz kılmalarına izin verilir (id-overrides kuralını bastırır). Varsayılan false. |
allow_direct_x_aggrega_extensions | boolean | hayır | true olduğunda, doğrudan x-aggrega-selector / x-aggrega-inject yazımına izin verilir (x-aggrega-discouragement kuralını bastırır). Varsayılan false. |
allow_aggrega_ai_prefix | boolean | hayır | true olduğunda, annotation-prefix kuralı tamamen bastırılır (hem yalın aggrega.ai/ denetimi hem de türe bağlı feature.aggrega.ai/ denetimi). Varsayılan false. |
allow_nonstandard_names | boolean | hayır | true olduğunda, ad biçimi ihlallerine izin verilir (name-shape kuralını bastırır). Varsayılan false. |
allow_category_mismatches | boolean | hayır | true olduğunda, category-matches-directory kuralının bulgularını bastırır. Standart katalog uzlaşımı, core/ |
allow_undeclared_recipe_provides | boolean | hayır | true olduğunda, provides-declared-by-component kuralının bulgularını bastırır. Bu kural, bir Recipe’nin spec.provides içinde yayımladığı ve spec.implements ile adlandırdığı Component’in spec.schema’sının provides ayağında bildirmediği her anahtarı bildirir. Bildirilen sözleşmenin ötesinde yayımlama derleme zamanında kabul edilir, bu nedenle bulgu tavsiye niteliğindedir; Recipes’i Component’lerinin bildirmediği anahtarları bilerek yayımlayan bir çalışma alanı burada devre dışı bırakır. Varsayılan false. |
allow_connection_credential_mismatches | boolean | hayır | true olduğunda, connection-credential-matches-target-key kuralının bulgularını bastırır. Bu kural bütün bir Release’i okur ve hedefi çağıranlarından istediği anahtarı bildiren her bağlantı için, bağlantının sunduğu kimlik bilgisini hedefin tuttuğu anahtarla karşılaştırır: farklı gizli bilgileri adlandıran iki ucu ve yalnızca bir uçta bildirilen bir anahtarı bildirir. İki uç arasındaki uyum, bir derlemenin denetlediği bir şey değil, bir katalog uzlaşımıdır, bu nedenle bulgu tavsiye niteliğindedir; iki ucu bilerek farklı olan bir çalışma alanı burada devre dışı bırakır. Varsayılan false. |
Ek özelliklere izin verilmez.