İçeriğe geç
zeev1.0.0-rc.1

ADR-013 — Checker semantik katmanları ve tek sahiplik

Depodaki adr/013-checker-katmanlari.md belgesinden Zee ile üretildi.

  • Durum: kabul
  • Tarih: 1 Eylül 2026
  • İlgili kayıt: K-100, K-121, B-006, B-007, V1-P0-01/11
  • Revizyon: 2 Eylül 2026 — K-121 sıra-bağımsız çağrı kısıtı katmanı

Bağlam

ADR-012 checker'ın cümle, ifade ve çağrı handler'larını fiziksel olarak ayırdı; ancak cozumleyici.rs hâlâ tür modelini, bağlam durumunu, sembol çözümünü, akış daraltmasını, açık sözleşmeleri, etki geçişini ve dönüş birleştirmeyi aynı kök modülde sahipleniyordu. Bu durum bir tanının hangi semantik faza ait olduğunu belirsizleştiriyor ve B-007/B-010 gibi sıra bağımsız çıkarım ile semantic ID işlerini gereksizce birbirine bağlıyordu.

Karar

Checker aşağıdaki tek-sahipli katmanlara ayrılır:

KatmanSorumluluk
turlerTur/kapsayıcı türler, tür yazımı çözümü ve temel uzlaşma
baglamişlem imzaları ve bir denetim geçişinin açık durumu
sembolad/alan çözümü ve sözcüksel kapsam yaşamı
akisSeçenek/Sonuç daraltması, gezme ve görev akış değişmezleri
cagriişlem çağrısı, çıkarımlı imza ve özyineleme uzlaştırması
cikarimyerel çağrı kısıtı keşfi ve sıra-bağımsız tür birleşimi
sozlesmepublic parametre/dönüş sözleşmesi doğrulaması
etkiuygulama/web etkisi ve intrinsic yetkinlik metadatası geçişi
donuskesin sonlanma, dönüş dalları ve Seçenek/Sonuç birleşimi
cumle / ifadeAST handler'ları; yukarıdaki hizmetleri orkestre eder

Kök cozumleyici.rs yalnız geçiş sırasını ve public API yeniden dışa aktarımını taşır. Denetim sırası:

text
etki/yetkinlik
  → tür yazımları
  → kopya AST'de yerel çağrı kısıtı keşfi
  → açık işlem sözleşmeleri
  → nihai imzayla cümle/ifade + sembol/akış/çağrı + HIR
  → dönüş/control-flow kanıtı

İç katmanlar pub(super) görünürdür. Var olan dil::cozumleyici::{Tur, VeriTuru, SozlukDegerTuru, ad_cozumle} yüzeyi yeniden dışa aktarılır ve kırılmaz.

Değişmezler

  1. Aynı kaynak aynı tanı kodu, mesaj, konum ve öneriyi üretir.
  2. Etki/yetkinlik denetimi tür geçişinden önce fail-closed kalır.
  3. Public sözleşme çağrı beklemeden; çıkarımlı yerel işlem bütün erişilebilir çağrı kısıtları birleştirildikten sonra denetlenir.
  4. Akış daraltması cümle katmanının açık bağlamıdır; tür enum'una gizlenmez.
  5. Dönüş birleşimi çağrı katmanından bağımsız tek control-flow sahibidir.
  6. Katman dosya bütçesini aşarsa köke geri taşınmaz; yeni sorumluluk sınırı ADR-012/013 ve faz rehberiyle birlikte açılır.

Sonuçlar

  • Checker kökü 963 satırdan 143 satıra indi.
  • Eski bağımsız eylem.rs, checker'ın etki katmanına taşındı; davranışı ve tanıları değişmedi.
  • Beş kaynak-mimari test katman sahipliğini, bütçeleri ve public API'yi korur.
  • K-149/ADR-046 genel production graph'ında cozumleyici katmanını runtime ve adaptörlere doğrudan bağımlılıktan ayrıca korur.
  • B-010 semantic ID, K-101/ADR-014 ile bu katmanlar üstünde tamamlandı. B-007, K-121'de ayrı cikarim katmanı ve mimari bütçesiyle kapandı.
  • K-121'in sıra-bağımsız yerel çıkarım semantiği RFC-0006 ile spec/04 ve spec/10'da normatifleşti; diğer katman ayrımları kaynak yüzeyini değiştirmez.

K-207 ad çözümleme maliyeti

Sembol sahibi ve bağlama sorumluluğu değişmez. Başarılı exact ad çözümlemesi ve morfoloji adayları mevcut hash tablosunda üyelik sorgusuyla yürütülür. Tam ad listesi yalnız A001 önerisinde üretilir; A002 eşleşmeleri sıralanır/ tekilleştirilir. Exact-ad önceliği, tanı mesaj/span/öneri ve SymbolId bağları eski algoritma oracle'ıyla 26.624 karar karşılaştırmasında aynı kalır. Yeni modül/kenar, ters katman geçişi, cache veya uzun ömürlü durum yoktur.

K-207 ikinci dilim — kapsam checkpoint

Kapsam girişi bütün adların HashSet kopyası yerine monotonic tanım sıra sınırını alır. Sembol tablosunun geçici yeni-ad journal'ı scope çıkışında yalnız o sınırdan sonra doğan adları kaldırır. Dış ada atama ve SymbolId kimliği kalıcıdır; silinen kimlik sayacı geri sarılmaz. Nested scope, atama, yerel silme ve kimlik yeniden kullanmama testi mevcut kapsam/ semantic/golden testlerini tamamlar. Eski HashSet algoritmasıyla 4.096 deterministik iç içe kapsam/atama işlemi aynı ad, tür ve kimliği verir. Testler satır bütçisini koruyan cfg(test) alt modülündedir; production modül/kenar ve ters katman geçişi yoktur. Sorumluluk cozumleyici sahibindedir.

Journal derleme başına düşer, LSP belge/cache alanına taşınmaz. Yeni geçici tampon için temiz exact 9e80b69 üzerinde 1800 sn/264.343 döngü soak geçti; compiler RSS medyanı 8.144→8.160 KiB, LSP 19.088→17.568 KiB. Aynı kaynakta release/25+2 ölçek ölçümünde 20k p95 165,137 ms oldu. Ham kanıt ve sınırlar. Kapsam dilimi kapalıdır; incremental/cache kapasitesi açık kalır. Dil/tanı/API/profil ve blokta doğan adın görünürlüğü değişmez.

Kaynak: adr/013-checker-katmanlari.md · Bütün belgeler