Aggrega Yetenekten Bağımsız Graf (IR) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Topoloji Oluşturucu tarafından üretilen, düzleştirilmiş ve tamamen çözümlenmiş tek boyutlu graf.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “IR” | evet | Sabit: "IR" |
metadata | IRMetadata | evet | Grafın kimliği: grafın derlendiği Aggregate. |
spec | IRSpec | evet | Grafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri. |
Ek özelliklere izin verilmez.
Tanımlar
Maintainer
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Bakımcının adı. |
email | string | hayır | Bakımcının e-posta adresi. |
url | string | hayır | Bakımcının web adresi. |
FieldProvenance
Bir eklentinin values veya infra yükündeki tek bir yaprağın kökeni.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
origin | string | evet | Yaprağın açıkça mı yazıldığı, yoksa açıklama (annotation) güdümlü genişletme geçişi tarafından mı katkılandığı. |
side | string | hayır | Açıklamanın bildirildiği yazım yüzeyi; açık yapraklar için bulunmaz. |
annotation_key | string | hayır | Bu yaprağı katkılayan açıklamanın adı; açık yapraklar için bulunmaz. |
annotation_source | string | hayır | Açıklama bildiriminin kaynak konumu, |
overridden_annotation | FieldProvenance | hayır | Bu yaprağı açık bir yaprağa kaptıran açıklama katkısı: açık bir yaprak, açıklamayla katkılanmış bir yaprağın üzerine yazdığında, yerini aldığı bastırılmış köken. Tekildir — her zaman yalnızca bir bastırılmış katkı saklanır. |
Ek özelliklere izin verilmez.
AttachmentConnection
Bir eklentinin ait olduğu bağlantı; bileşenin kendi eklenti bloğuna değil, bir bileşenin çizdiği bir bağlantıya yazılmış eklentiler içindir: bağlantının üzerinden kablolandığı soket ve altında yazıldığı takma ad. Bu çift, grafın kenarlarından birini adlandırır — kaynağı eklentiyi taşıyan düğüm olan ve soketi ile takma adı bunlar olan kenarı — böylece bir tüketici eklentiyi o kenara, onun üzerinden de eklentinin sunulduğu hedefe bağlar.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
socket | string | evet | Bağlantının üzerinden kablolandığı soket: eklentinin ait olduğu kenarın soketi. |
alias | string | evet | Bağlantının altında yazıldığı takma ad: eklentinin ait olduğu kenarın takma adı. |
Ek özelliklere izin verilmez.
IRFeatureEntry
Bir düğüm için çözümlenmiş, feature_values_mapping içinde taşınan tek bir eklenti. Her eklenti ailesi bu biçimi paylaşır — operasyonel bir Feature, kimlik bilgisi Feature’ı, kimlik Feature’ı — böylece hiçbir aile diğerinden daha kayıplı bir izdüşüm almaz. Bir kimlik bilgisi eklentisinin values alanının ne taşıdığı yazarın seçimidir: başvuruyla verilen bir kimlik bilgisi bir gizli bilgi deposuna işaretçi taşır, değerle verilen ise malzemenin kendisini taşır; derleyici hangisi yazıldıysa onu, ikisini de çözümlemeden olduğu gibi taşır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | Bu eklentinin talep ettiği Catalog Feature’ının URI’si. |
resolved_version | string | evet | Derleme sırasında çözümlenen tam anlamsal sürüm. |
labels | string eşlemi | hayır | Eklenen Feature’ın katalog etiketleri; katalog varlığının bildirdiği sırayla olduğu gibi taşınır — hiçbir zaman filtrelenmez, normalleştirilmez veya öneki çıkarılmaz; böylece bir tüketici katalog yazarının yazdığını tam olarak okur. Derleyici bunların hiçbirini okumaz. Feature hiç etiket bildirmediğinde ve türü hiçbir katalog varlığına çözümlenmediğinde bulunmaz. |
catalog_annotations | string eşlemi | hayır | Eklenen Feature’ın katalog açıklamaları — bu eklentinin adlandırdığı Feature varlığının metadata.annotations alanı — o varlığın bildirdiği sırayla olduğu gibi taşınır; hiçbir zaman filtrelenmez, normalleştirilmez veya öneki çıkarılmaz; böylece bir tüketici, yazarın kendi ad alanındaki anahtarlar dahil, katalog yazarının yazdığını tam olarak okur. Derleyici bunların hiçbirini okumaz. Bu eklentinin var olmasına neden olan açıklamayı adlandıran ve konumunu belirten annotation_key ve annotation_source alanlarından farklıdır: o ikisi eklentinin nasıl ortaya çıktığını bildirir, bu ise adlandırdığı varlığın meta verisini bildirir; features: bloğunda yazılmış bir eklenti bu açıklamaları taşır ama o ikisinden hiçbirini taşımaz. Feature hiç açıklama bildirmediğinde ve türü hiçbir katalog varlığına çözümlenmediğinde bulunmaz. |
binding | string | hayır | Bu eklentinin doldurduğu eklenti yuvasını adlandırır; bildirilmiş hiçbir yuvayı doldurmadığında “free” değerini alır. Bir yuva iki yerden birinde bildirilir ve hangisi olduğuna eklentinin nereye yazıldığı karar verir: düğümün kendi eklenti bloğundaki bir eklenti, ana Component’in featuresSchema alanında bildirdiği bir yuvayı doldurur; bir bağlantıya yazılmış eklenti ise bağlantının soketinin, ana Component üzerindeki o soketin featuresSchema alanında bildirdiği bir yuvayı doldurur. Eşleştirme her ikisinde de ada göredir — Feature, bileşenin bloğunda ya da bağlantıda yuvanın adı altında eklendiğinde eklenti o yuvayı doldurur — bu nedenle değer, bildirilmiş yuva kümesinden tam bir anahtardır ve asla eklentinin anahtarından okunan bir şey değildir. Bir soketin yuva kümesi kapalıdır, çünkü bir bağlantıya soketinin bildirmediği bir ad altında yazılmış eklenti derlemeyi durdurur; bu nedenle bağlantı taşıyan bir eklenti asla free bildirmez. Yalın bir boolean yerine yuva adı taşınır, çünkü hangi yuvanın doldurulduğu yanıtın daha yararlı yarısıdır. Ana Component’in bildirilmiş yuva kümesi çözümlenemediğinde boştur; bu “free” durumundan farklıdır: free, bildirilmiş hiçbir yuvanın bu adı taşımadığına dair olumlu bir bulgudur. |
values | object | hayır | Eklentinin operasyonel yapılandırma yükü. Bir kimlik bilgisi için, yazar hangi biçimi bildirdiyse o — bir gizli bilgi deposuna işaretçi ya da malzemenin kendisi. |
infra | object | hayır | Bu eklenti için örnek başına fiziksel boyutlandırma. |
inject | object | hayır | Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler. |
origin | string (enum) | hayır | features: bloğunda yazılmış eklentileri (explicit), açıklama güdümlü genişletme geçişinin ürettiği sentetik eklentilerden (annotation) ayırır; eklentinin value/infra yaprakları ikisinin karışımını taşıdığında ise mixed değerini alır (yaprak başına ayrıntı bu durumda köken eşlemlerinde bulunur). İzin verilen değerler: "explicit", "annotation", "mixed" |
annotation_key | string | hayır | Sentetik bir eklentiyi tetikleyen açıklamanın adı. origin explicit olduğunda bulunmaz. |
annotation_source | string | hayır | Açıklama bildiriminin kaynak konumu, |
values_provenance | FieldProvenance eşlemi | hayır | values yükü için yaprak başına köken; noktalı yaprak yoluna göre anahtarlanır. |
infra_provenance | FieldProvenance eşlemi | hayır | infra yükü için yaprak başına köken; noktalı yaprak yoluna göre anahtarlanır. |
sensitive | boolean | hayır | Bu eklenti bir yazarın hassas olarak bildirdiği malzemeyi işlediğinde true olur — ya eklenen Feature values, infra veya provides sütununda hassas bir yaprak bildirir ya da eklentinin doldurduğu yuva taşıdığı malzemeyi hassas olarak bildirir: ana Component’in aynı adlı eklenti yuvası ya da bir bağlantıya yazılmış eklenti için bağlantının soketinin bildirdiği o adlı yuva. Birleştirilmiş eklenti üzerinden bu bildirimlerden türetilir; asla bir değerin içeriğinden veya bir addan türetilmez. Bu bildirimlerin hiçbiri yoksa ayarlanmaz. |
sensitive_inject | string eşlemlerinin eşlemi | hayır | inject alanının, başvurduğu provides anahtarını eklenti Feature’ının hassas olarak bildirdiği teslim anahtarları; inject’in kendi biçiminde: önce mekanizma, ardından teslim anahtarı, değer olarak da başvurulan provides anahtarı. inject’in bir alt kümesidir. Eklenti hiçbir teslim mekanizması bildirmediğinde veya hassas hiçbir provides anahtarına başvurmadığında bulunmaz. |
sensitive_payload_leaves | string[] | hayır | Bu eklentinin values ve infra yükünün taşıdığı, ekli Feature’ın hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak: values.db konumundaki bir bildirim db.password yolunu kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Eklenti başına yanıt hiçbir zaman tek tek yapraklara yayılmaz; bu, okunabilir bırakılan bir yaprak hakkında yanlış bir şey ileri sürerdi. Anahtarın bulunmaması, bu eklentinin Feature’ının hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir. Yükün hassas olmadığını ileri sürmez ve adlandıracak böyle bir yaprağı olmayan bir eklentiyi bu ekseni hiç bildirmeyen bir üreticiden ayırmaz; bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir konuk onu tersinden okumuştur. Yapraklar yükün onları tuttuğu sırayla gelir, values sütununun yaprakları infra sütununun yapraklarından önce: values ve infra yüklerinin kendilerinin taşıdığı sırayla aynıdır ve yükü aynı girdinin çalıştırmaları arasında bayt bayt özdeş kılan budur. Eklenti, Feature’ının hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz. |
connection | AttachmentConnection | hayır | Bu eklentinin ait olduğu bağlantı: düğümün bağlantılarından birine yazılan her eklentide bulunur, düğümün kendi eklenti bloğundaki her eklentide bulunmaz. Bir bağlantıya yazılan eklenti, diğer her bakımdan düğümün eklentilerinden biridir: nitelikli adıyla, yani bağlantının takma adı ile yuvanın bir noktayla birleştirilmesiyle anahtarlanır ve bağlamasını ve hassasiyetini bağlantının soketinin bildirdiği yuvadan alır; dolayısıyla ikisini birbirinden ayıran bu alandır ve bağlantıyı anahtardan okunmaya bırakmak yerine veri olarak taşır. Bir tüketici onu soket ve takma ada göre grafiğin kenarlarıyla birleştirir: kaynağı bu eklentiyi taşıyan düğüm olan ve soketi ile takma adı bunlar olan kenar, eklentinin sunulduğu bağlantıdır ve o kenarın hedefi, eklentinin sunulduğu şeydir. Bir Feature eklentisinin çizdiği bağlantının eklentisi hiçbir zaman bunu taşımaz, çünkü böyle bir bağlantı hiç eklenti taşımaz. |
realization | string | hayır | Bu eklentiyi gerçekleştiren FeatureRecipe, |
Ek özelliklere izin verilmez.
IRFeatureEntry.inject
Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Ortam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır. |
file | string eşlemi | hayır | Dosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır. |
arg | string eşlemi | hayır | Komut satırı argümanı ile teslim: anahtarlar tüketicinin bayrak önekleridir, değerler hedefin provides anahtarlarıdır. |
IRBoundaryFeature
IR’ye yansıtılan sınır düzeyinde bir Feature eklentisi: Feature tür URI’si ile birlikte, sınır kapsamlı bir FeatureRecipe’nin işlediği ve kaynağını karşısında çözümlediği sınır infra’sı. Sınır düzeyindeki eklentiler values yükü taşımaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
type | string | evet | Bu sınıra eklenen Catalog Feature’ının URI’si. |
infra | object | hayır | Sınır eklentisi için fiziksel boyutlandırma; sınır kapsamlı bir FeatureRecipe’nin şablonlarını ve kaynağını karşısında değerlendirdiği infra. |
sensitive_payload_leaves | string[] | hayır | Bu sınır eklentisinin infra yükünün taşıdığı, ekli Feature’ın hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak. Burada yalnızca infra.db konumundaki bir bildirim db.password yolunu kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Anahtarın bulunmaması, bu eklentinin Feature’ının hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; buna ekli Feature’ın bu okuyucunun okuyabileceği hiçbir şemaya çözümlenmediği durum da dahildir. Infra yükünün hassas olmadığını ileri sürmez ve adlandıracak böyle bir yaprağı olmayan bir eklentiyi bu ekseni hiç bildirmeyen bir üreticiden ayırmaz. Bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar yükün onları tuttuğu sırayla gelir; bu, infra yükünün kendisinin taşıdığı sırayla aynıdır ve grafiği aynı girdinin çalıştırmaları arasında bayt bayt özdeş tutan budur. Eklenti, Feature’ının hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz. |
realization | string | hayır | Bu sınır eklentisini gerçekleştiren FeatureRecipe, |
Ek özelliklere izin verilmez.
CatalogMetadata
Catalog varlığından açıkça çıkarılan, yaşam döngüsü ve sahiplik verilerini Wasm linter’larına sunan Kurumsal Meta Veri Paketi.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
maintainers | Maintainer[] | hayır | Katalog varlığının kendi sahipleri olarak listelediği bakımcılar. |
license | string | hayır | Katalog varlığının tanımladığı yazılım için bildirdiği SPDX lisans tanımlayıcısı. |
repository | string | hayır | Katalog varlığının kaynak dosyalarını barındıran yer olarak adlandırdığı Git deposunun URL’si. |
home | string | hayır | Katalog varlığının ana sayfasının, wiki’sinin veya belgelerinin URL’si. |
keywords | string[] | hayır | Katalog varlığının bildirdiği tanımlayıcı anahtar sözcükler. |
Ek özelliklere izin verilmez.
IRNode
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
description | string | hayır | Bu bileşen örneğinin uygulamadaki rolünü açıklayan, geliştiricinin yazdığı isteğe bağlı belgeler. İşleme ve lint tanılamaları için Aggregate’ten aktarılır. |
labels | string eşlemi | evet | Varlığın ördek tiplemesi (duck typing) ve ontoloji etiketleri. |
component | string | evet | Alttaki Component’in adı. |
resolved_version | string | evet | Derleme sırasında çözümlenen Component’in tam Semantic Version değeri. |
sync_wave | integer | hayır | İçeren sınırın syncWave alanından devralınan dağıtım dalgası (varsayılan 0; negatif değere izin verilir). K8s ve Helm’de dağıtımı sıralayan dalgadır: bir argocd.argoproj.io/sync-wave ek açıklamasına dönüşür ve chart’ın zaten Helm hook olarak işaretlediği bir kaynakta o hook’un helm.sh/hook-weight değerine de dönüşür. Compose’da değer hem bir servis etiketi olarak kaydedilir hem de render edildiği dosyanın servislerini aralarındaki depends_on aracılığıyla sıralar. CloudFormation’da bir dağıtım grubunun birleştiği stack’in sağlanmasını sıralar; bir dalgadaki her kaynağın, önceki dalganın kaynaklarına bağımlı olduğu bildirilir: bu, kaynakların oluşturulma sırası ve tersine silinme sırasıdır, asla hazır olma durumu değildir, çünkü bir stack şablonu bir kaynağın hazır olması kavramını ifade etmez. Terraform’da bir sınırın birleştiği kök yapılandırmanın module bloklarını sıralar; bir dalgadaki her modülün, önceki dalganın modüllerine bağımlı olduğu bildirilir: bu, motorun eylemlerini gerçekleştirme sırasıdır, asla hazır olma durumu değildir, çünkü bir yapılandırma bir kaynağın hazır olması kavramını ifade etmez. Değer, düğümün derleme kökeni bilgisiyle de birlikte taşınır. |
boundary_path | string | hayır | Bu düğümün yerleştirildiği Release sınırının yolu: en dıştaki sınırdan içe doğru sınır adları, / ile birleştirilmiş olarak (ör. bir data sınırının içinde bildirilen bir inner sınırına yerleştirilmiş bir bileşen için ‘data/inner’). Bir sınır adı / içeremez, bu nedenle yol belirsizlik olmadan sınırlarına geri ayrılır. Release’in bir sınıra yönlendirdiği içe aktarılmış bir Aggregate’in düğümü o sınırın yolunu taşır. Render plugin’lerinin sınırdan haberdar benzersiz tanımlayıcılar üretmesini sağlar. |
subsystem_path | string | hayır | Bu düğümün bileşeninin bildirildiği Aggregate alt sisteminin yolu: en dıştaki alt sistemden içe doğru alt sistem adları, . ile birleştirilmiş olarak (ör. bir backend alt sisteminin içine yerleştirilmiş bir storage alt sisteminde bildirilen bir bileşen için ‘backend.storage’). Bir alt sistem adı . içeremez, bu nedenle yol belirsizlik olmadan alt sistemlerine geri ayrılır. Üst düzey components bildiren bir Aggregate’in bileşeni, synthesized_subsystem ile işaretlenen sentezlenmiş default değerini taşır. Yol, bileşeni bildiren Aggregate’e görelidir: içe aktarılmış bir Aggregate’in katkıda bulunduğu düğüm, içe aktarıldığı ad olmadan o Aggregate içindeki yolunu taşır (ör. içe aktarılmış Aggregate’in tier alt sistemindeki bir bileşen için ‘tier’), bu nedenle farklı Aggregates’ten gelen düğümler aynı yolu paylaşabilir. Onları, içe aktarma adıyla başlayan düğüm kimliği ve source_file birbirinden ayırır. |
synthesized_subsystem | boolean | hayır | Bu düğümün alt sistemi derleyici tarafından sentezlendiğinde true: adlandırılmış subsystems yerine üst düzey components bildiren bir Aggregate için oluşturulan default alt sistemi. Türetilmiş köken bilgisidir, asla yazar tarafından yazılmaz: sentezlenmiş default alt sistemini, bir kullanıcının açıkça default olarak adlandırdığı alt sistemden ayırır. synthesized_boundary alanından bağımsızdır (bir düğüm eksenlerden birinde veya her ikisinde sentezlenmiş olabilir). Yazar tarafından yazılmış her alt sistem için yoktur (false). |
synthesized_boundary | boolean | hayır | Bu düğümün sınırı derleyici tarafından sentezlendiğinde true: adlandırılmış boundaries yerine üst düzey components bildiren bir Release için oluşturulan default sınırı. Türetilmiş köken bilgisidir, asla yazar tarafından yazılmaz: sentezlenmiş default sınırını, bir kullanıcının açıkça default olarak adlandırdığı sınırdan ayırır ve düğümün yapıtlarını dist/boundaries/default/ yerine düz olarak dist/ dizinine yönlendirir. Yazar tarafından yazılmış her sınır için yoktur (false). |
catalog_metadata | CatalogMetadata | hayır | Catalog varlığından açıkça çıkarılan, yaşam döngüsü ve sahiplik verilerini Wasm linter’larına sunan Kurumsal Meta Veri Paketi. |
catalog_annotations | string eşlemi | hayır | Domain 2’de Platform Mimarı tarafından yazılan, değişmez ve içsel bileşen özellikleri. |
release_annotations | string eşlemi | hayır | Release’teki sınırlardan aşağı doğru aktarılan fiziksel topoloji dizeleri ve operasyonel gerçeklikler. |
aggregate_annotations | string eşlemi | hayır | Aggregate’teki alt sistemlerden aşağı doğru aktarılan bilişsel meta veriler, geliştirici niyeti ve FinOps bilgileri. |
self_inject | object | hayır | Aggregate’ten taşınan, Component düzeyindeki self-inject bloğu; düğümün kendisi için bildirdiği bağımsız enjeksiyon yönlendirmesi. Bu şema katmanında opaktır; onu okuyan bir politika plugin’i baytları ayrıştırır. |
source_file | string | hayır | Bu düğümün yazıldığı Aggregate dosyasının çalışma alanına göreli yolu. Kök katman düğümleri kök Aggregate’in yolunu taşır; alt aggregate düğümleri içe aktarılmış Aggregate’in dosya yolunu taşır. Yol, çalışma alanı köküne (.aggrega-config.yaml dosyasını içeren dizin) görelidir; bu nedenle grafik, çalışma alanları farklı mutlak yollarda bulunan makinelerde bayt bayt aynıdır. Tanılamaları dosya bazında filtreleyen tüketiciler, karşılaştırmadan önce alanı aynı çalışma alanı köküne göre çözümler. Grafik bir çalışma alanı kökü olmadan oluşturulduğunda bulunmaz. |
uses | object | hayır | Düğümün uses bloğu, tam olarak yazıldığı gibi: her soket adı, yazarın bildirdiği sırayla, ya hedef örnek adlarından oluşan bir listeye ya da bağlantı girdilerinden oluşan, takma adla anahtarlanmış bir eşleme eşlenir. Bu, yazıldığı haliyle bloktur ve edges içindeki çözümlenmiş bağlantılardan farklı bir olgudur: yazarın doldurduğu bir soket, hiçbir bağlantı üretmediği yerde bile burada görünür; böylece okuyucu, yazarın doldurduğu bir soketi bir hedefe ulaşan soketten ayırt edebilir. Düğüm bir uses bloğu yazmadığında yoktur. Bu şema katmanında opaktır; onu okuyan bir politika plugin’i baytları ayrıştırır. |
sensitive_payload_leaves | string[] | hayır | Bu düğümün values ve infra yükünün taşıdığı ve Component’inin hassas olarak bildirdiği yapraklar; her biri, verinin bulunduğu, sütun önekli noktalı yol olarak: values.db üzerindeki bir bildirim db.password yaprağını kapsar ve dbPassword adlı kardeş yaprağa ulaşmaz. Anahtarın yokluğu, bu düğümün Component’inin hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; buna düğümün Component’inin bu okuyucunun okuyabileceği hiçbir şemaya çözümlenmediği durum da dahildir. Düğümün yükünün hassas olmadığını öne sürmez ve adlandırılacak böyle bir yaprağı olmayan bir düğümü, bu ekseni hiç raporlamayan bir üreticiden ayırmaz. Anahtarın yokluğunu bir değeri açık metin olarak görüntüleme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar, yükün onları tuttuğu sırayla gelir; values sütununun yaprakları infra sütunununkilerden önce gelir; bu, o yüklerin kendilerinin taşıdığı sırayla aynıdır ve grafiği aynı girdinin çalıştırmaları arasında bayt bayt aynı tutan da budur. Düğüm, Component’inin hassas olarak bildirdiği hiçbir yaprak taşımadığında yoktur. |
Ek özelliklere izin verilmez.
IREdge
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
source | string | evet | Bağlantının başladığı, tüketen düğümün ID’si. |
target | string | evet | Bağlantının ulaştığı düğümün ID’si. |
socket | string | hayır | Bu kenarın ait olduğu usesSchema kategorisi (ör. ‘databases’, ‘tools’). |
alias | string | hayır | Bu bağlantı için geliştiricinin tanımladığı takma ad (ör. ‘primary_db’). |
socket_declaration | string (enum) | evet | Soketin nereden geldiği: soketin sahibi olan katalog varlığı (tüketen Component ya da Feature tarafından yazılmış bir kenar için kaynak Feature) soketi usesSchema içinde listelediğinde declared, Aggregate yazarı kataloğun bildirmediği bir soketi adlandırdığında ad-hoc. Bu, kenarın yazarlığından bağımsız üçüncü bir eksendir: kenarı kimin çizdiğini değil, soketin nereden geldiğini söyler; bu nedenle bildirilmiş bir sokete giden Release tarafından yazılmış bir kenar ile ad-hoc bir sokete giden Aggregate tarafından yazılmış bir kenar iki eksende birbirinden bağımsız olarak farklılaşır. Bildirilmiş bir soket, kenarın hangi hedeflere ulaşabileceğini kısıtlayan seçici dahil olmak üzere usesSchema girdisini taşır; ad-hoc bir soketin katalog girdisi ve dolayısıyla seçicisi yoktur, bu yüzden kenarın ne taşıyabileceği yalnızca hedefin bildirdiği provides ile sınırlanır. Her zaman bulunur; böylece bir tüketici hiçbir zaman eksik bir değeri declared olarak okumak zorunda kalmaz ve bir politika her kenarın declared olmasını şart koşabilir. Aynı biçimdeki soruyu farklı bir konu için yanıtlayan bir eklentinin bağlama işaretçisinden farklıdır. İzin verilen değerler: "declared", "ad-hoc" |
origin_feature | string | hayır | Bu kenar bir Feature tarafından (feature.aggrega.ai/kind: secret etiketli kimlik bilgisi Features dahil) özerk olarak bildirildiyse, Feature tür URI’sini tanımlar. Wasm eklentilerinin kendi topolojilerini ayırmasını sağlar. |
origin_feature_instance | string | hayır | Bu kenarı bildiren Feature’ın eklenti başına örnek adı. Sınır kapsamlı bir FeatureRecipe’in çözümlenmiş provides değerlerini örneğe göre bulur ve aynı sınırdaki aynı Feature türünün iki eklentisini birbirinden ayırır. |
origin_release | boolean | hayır | Bu kenar, bildirilmiş ancak bağlanmamış bir soketi mevcut bir bileşene bağlayan bir Release tarafından oluşturulduğunda true. Yapılandırmayı değil, kenar YAZARLIĞINI işaretler: bir Release’in yalnızca infra sağladığı, geliştirici tarafından bildirilmiş bir kenar Aggregate kaynaklı kalır (origin_release ayarlanmamış; Release infra’sı kenarın infra eşleminde görünür). origin_feature ayarlı => Feature kaynaklı; origin_release true => Release kaynaklı; hiçbiri => Aggregate kaynaklı. |
values | object | hayır | Bu kenar için çözümlenmiş, bağlantı başına geliştirici değerleri (Aggregate kenarından); çözümleme sırasında kaynak soketin (kenarın kaynağı olan, tüketen bileşendeki soket) bildirdiği valueSchema’ya göre doğrulanır ve tüketen düğümün render bağlamına .context.uses. |
infra | object | hayır | Bu kenar için bir Release kenar girdisinin sağladığı, çözümlenmiş bağlantı başına infra; çözümleme sırasında kaynak soketin (kenarın kaynağı olan, tüketen bileşendeki soket) bildirdiği infraSchema’ya göre doğrulanır ve .context.uses. |
inject | object | hayır | Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler. |
sensitive_payload_leaves | string[] | hayır | Bu kenarın values ve infra yüklerinin taşıdığı ve bu yüklerin yazıldığı soketin hassas olarak bildirdiği yapraklar; her biri verinin bulunduğu, sütun önekli noktalı yol olarak: values.db konumundaki bir bildirim db.password yolunu kapsar ve db_password adlı kardeş yaprağa ulaşmaz. Hassas olarak bildirilmiş değerleri graftan gizleyen bir yüzey, bu yaprakları bu kenarın values ve infra yüklerinde ve tüketen düğümün aynı bağlantıya ait uses girdisinde gizler; bu girdi değerleri yazarın yazdığı biçimde taşır. Anahtarın bulunmaması, bu kenarın, soketinin sözleşmesinin hassas olarak bildirdiği hiçbir yaprağı adlandırmadığını belirtir; soketin burada okunabilecek bir sözleşme bildirmediği durum da buna dahildir. Yapılandırmanın hassas olmadığını ileri sürmez ve bulunmayan bir anahtarı bir değeri açık olarak gösterme veya yayma izni olarak okuyan bir tüketici onu tersinden okumuştur. Yapraklar yüklerin onları tuttuğu sırayla gelir, values sütununun yaprakları infra sütununun yapraklarından önce; grafı aynı girdinin çalıştırmaları arasında bayt bayt özdeş tutan budur. Kenar, soketinin sözleşmesinin hassas olarak bildirdiği hiçbir yaprak taşımadığında bulunmaz. |
Ek özelliklere izin verilmez.
IREdge.inject
Bağımsız enjeksiyon yönlendirmesi. Yerel değişkenleri Target provides anahtarlarına eşler.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
env | string eşlemi | hayır | Ortam değişkeni ile teslim: anahtarlar tüketicinin yerel değişken adlarıdır, değerler hedefin provides anahtarlarıdır. |
file | string eşlemi | hayır | Dosya bağlama ile teslim: anahtarlar tüketicinin yerel dosya yollarıdır, değerler hedefin provides anahtarlarıdır. |
arg | string eşlemi | hayır | Komut satırı argümanı ile teslim: anahtarlar tüketicinin bayrak önekleridir, değerler hedefin provides anahtarlarıdır. |
IRMetadata
Grafın kimliği: grafın derlendiği Aggregate.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
aggregate_name | string | evet | Aggregate’in metadata.name değeri. |
Ek özelliklere izin verilmez.
IRProvenance
Tanılama ve denetim için izlenebilirlik meta verileri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
schema_version | string | evet | Grafiğin uyduğu IR şemasının sürümü: aggrega.ai/v1beta1, grafiğin apiVersion alanının taşıdığı değerle aynı. |
compiler_version | string | evet | Zorunlu uyumluluk damgası. Bu grafiği oluşturan aggrega ikili dosyasını sürümüyle tanımlar. |
aggregate_version | string | evet | Derleme sırasında kullanılan kök Aggregate amacının tam semantik sürümü. |
manifest_version | string | evet | Derleme sırasında kullanılan Manifest kilit dosyasının tam semantik sürümü. |
release_version | string | evet | Derleme sırasında kullanılan Release yönlendirme dosyasının tam semantik sürümü. |
Ek özelliklere izin verilir.
IRSpec
Grafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
nodes | IRNode eşlemi | evet | Grafikteki tüm düğümlerin mutlak kimliklerine göre anahtarlanmış sözlüğü. Tamamen topolojiktir. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta ya da kısa çizgi. Desen: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | evet | Düğümler arasındaki açık mantıksal ağ yolları ve bağımlılıklar. |
values_mapping | object | evet | Düğüm kimliğine göre eşlenmiş, opak olarak aktarılan bilişsel yükler için tek doğruluk kaynağı. |
infra_mapping | object | evet | Release’ten enjekte edilen, düğüm kimliğine göre eşlenmiş fiziksel boyutlandırma yükü. |
feature_values_mapping | IRFeatureEntry eşlemi eşlemi | evet | Düğüm kimliklerinin bağlı Feature yapılandırmalarına normalleştirilmiş eşlemi. Tek bir grup, ne ürettiğinden bağımsız olarak bir düğümdeki her eklentiyi (operasyonel Features, kimlik bilgisi Features, kimlik Features) taşır ve yazarın her eklentiye verdiği örnek adına göre anahtarlanır. Düğümün bağlantılarından birine yazılmış bir eklenti, nitelikli adıyla, yani bağlantının takma adı ile yuvanın noktayla birleştirilmesiyle anahtarlanır ve bağlantısını kendi connection alanında adlandırır. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta ya da kısa çizgi. Desen: ^[a-zA-Z0-9_.-]+$. |
boundary_features | IRBoundaryFeature eşlemi eşlemi | hayır | Her sınırın Feature eklentileri; önce sınır yoluna, sonra örnek adına göre anahtarlanır. Yalnızca grafikte sınır düzeyinde Feature eklentileri olduğunda bulunur. Anahtarlar: bir veya daha fazla harf, rakam, alt çizgi, nokta, eğik çizgi ya da kısa çizgi. Desen: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | evet | Tanılama ve denetim için izlenebilirlik meta verileri. |
Ek özelliklere izin verilmez.
IRGraph
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “IR” | evet | Sabit: "IR" |
metadata | IRMetadata | evet | Grafın kimliği: grafın derlendiği Aggregate. |
spec | IRSpec | evet | Grafın kendisi: düğümleri, kenarları ve düğüme göre anahtarlanmış yükleri. |
Ek özelliklere izin verilmez.