Aggrega Wasm Mutator Socket şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
label-transform rolüne bağlanan bir yönetişim eklentisinin tükettiği (MutatorInput) ve ürettiği (MutatorOutput) iletim biçimleri. Rol, topoloji oluşturma sırasında, graf oluşturulduktan sonra ve değerlendirilmeden önce çalışır: eklenti JSON Patch belgeleri döndürür ve ana makine bunları düğüm etiketlerine uygular, başka hiçbir şeye uygulamaz; grafın başka herhangi bir kısmına ulaşan bir yamada derlemeyi durdurur. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir iletim biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.
Aşağıdaki biçimlerden biri
MutatorInputMutatorOutput
Tanımlar
MutatorInput
Ana makinenin her çağrıda mutator eklentisine verdiği yük: release düzeyindeki derleme bağlamı ile her düğümün etiketlerini ve örneğinin bildirdiği değerleri taşıyan topoloji grafiğinin bir izdüşümü.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
compilation_context | CompilationContext | evet | Mutator’ın derlemeye hangi uyumluluk, FinOps veya yönetişim kurallarının uygulanacağına karar verirken okuduğu Release düzeyindeki meta veriler. |
graph | MutatorGraph | evet | Topoloji grafiğinin mutator eklentisine sunulan izdüşümü: her düğümün Component’i, çözümlenmiş sürümü, etiketleri ve örneğinin bildirdiği değerler. Bilinçli olarak tam topoloji sonucundan daha dardır: kenarlar ve feature yükleri sunulmaz, çünkü mutator’ın işi topolojiyi yeniden biçimlendirmek değil, etiketlemektir. Değerler okunmak için oradadır; böylece geliştiricinin bildirdiği bir yapılandırma bir etikete karar verebilir; bir yama yalnızca etiketlere ulaşır, başka hiçbir şeye ulaşmaz; bu nedenle eklenti değerleri değiştiremez. |
sources | MutatorSource[] | hayır | Ana makinenin okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış bir liste hâlindeki tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz. |
settings | object | hayır | Ana makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz. |
Ek özelliklere izin verilmez.
MutatorOutput
Mutator eklentisinin ürettiği yanıt biçimi: ana makinenin topoloji grafiğine uyguladığı opak JSON Patch belgelerinin bir listesi. Yamalar şema katmanında opak kalır; böylece ana makinenin, konuğun zaten uyguladığı JSON Patch ayrıştırıcısını yinelemesi gerekmez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
patches | any[] | evet | Topoloji grafiğine sırayla uygulanacak opak JSON Patch belgeleri. |
error | string | hayır | Konuk çalıştığı ancak işlemi tamamlayamadığı zaman ayarlanan hata iletisi; başarıda bulunmaz. Ana makine, mevcut bir hatayı başarısız bir eklenti çağrısı olarak gösterir. |
Ek özelliklere izin verilmez.
CompilationContext
Mutator’ın derlemeye hangi uyumluluk, FinOps veya yönetişim kurallarının uygulanacağına karar verirken okuduğu Release düzeyindeki meta veriler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
release_name | string | evet | Release’in metadata.name değeri. |
environment | string | evet | Release’in altında çalıştığı ortam etiketi (ör. dev, staging, prod). |
Ek özelliklere izin verilmez.
MutatorGraph
Topoloji grafiğinin mutator eklentisine sunulan izdüşümü: her düğümün Component’i, çözümlenmiş sürümü, etiketleri ve örneğinin bildirdiği değerler. Bilinçli olarak tam topoloji sonucundan daha dardır: kenarlar ve feature yükleri sunulmaz, çünkü mutator’ın işi topolojiyi yeniden biçimlendirmek değil, etiketlemektir. Değerler okunmak için oradadır; böylece geliştiricinin bildirdiği bir yapılandırma bir etikete karar verebilir; bir yama yalnızca etiketlere ulaşır, başka hiçbir şeye ulaşmaz; bu nedenle eklenti değerleri değiştiremez.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
nodes | MutatorNode eşlemi | evet | Mutlak düğüm kimliğine göre anahtarlanmış düğümler. |
Ek özelliklere izin verilmez.
MutatorNode
Mutator eklentisinin kurallarını değerlendirdiği düğüm başına izdüşüm: düğümün hangi Component’i uyguladığı, o Component’in hangi sürümünün çözümlendiği, düğümün hangi etiketleri taşıdığı ve örneğinin hangi değerleri bildirdiği.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
component | string | evet | Düğümün örneklediği temel Component’in adı. |
resolved_version | string | evet | Çözümleyicinin bu düğüm için sabitlediği Component’in tam Semantic Version değeri. |
labels | string eşlemi | evet | Düğümün duck-typing ve ontoloji etiketleri. |
values | object | hayır | Düğümün bileşen örneğinin Aggregate içinde bildirdiği değerler; yazarın yazdığı şekliyle anahtarlanmış ve yazarın sırasıyla. Aggregate’teki her şablon parametrelerine göre zaten değerlendirilmiştir; böylece bir parametreye taşınmış bir değer, Release’in sağladığı değer ya da parametrenin varsayılanı olarak gelir. Burada yalnızca örneğin kendi değerleri bulunur: Component’in şemasının bildirdiği bir varsayılan ile bir Recipe’in ya da bir Feature’ın katkıda bulunduğu hiçbir şey burada değildir. Component’in hassas olarak bildirdiği bir değer, tüm graf üzerindeki yönetişim kararının onu aldığı şekilde tam olarak gizlenmiş olarak gelir: yerinde, o kararın taşıdığı aynı tek anahtarlı gizleme işaretçisi nesnesi durur ve bildirilen nedeni adlandırır; hiçbir bildirimin ulaşmadığı kardeş bir değer ise yazıldığı gibi gelir. Bir eklenti hangi etiketleri ekleyeceğine karar vermek için bunları okur; bir yama bunlara ulaşamaz. Örnek hiçbir değer bildirmediğinde bulunmaz. |
Ek özelliklere izin verilmez.
MutatorSource
Eklentiye verilen tek bir tanım dosyası: temel ad yolu ve dosyanın içeriği. İkisi de olduğu gibi taşınır; ana makine içeriği ayrıştırmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | Kaynak dosyanın temel adı. Ana makine hiçbir zaman mutlak bir ana makine yolu değil, yalnızca temel adı sağlar; böylece iletim taşınabilir ve belirlenimci olur. |
content | string | evet | Kaynak dosyanın opak bir string olarak olduğu gibi taşınan içeriği. |
Ek özelliklere izin verilmez.