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

ADR-012 — Parser, checker ve runtime için fiziksel faz modülleri

Depodaki adr/012-derleyici-faz-modulleri.md belgesinden Zee ile üretildi.

  • Durum: kabul
  • Tarih: 1 Eylül 2026
  • İlgili kayıt: K-099, B-005, V1-P0-10

Bağlam

Bootstrap derleyicinin parser, tür denetleyici ve yorumlayıcısı çalışır ve geniş bir regresyon korpusuna sahiptir. Ancak üç kök dosya 2709, 3067 ve 3181 satıra; cümle/ifade handler'ları da tek fiziksel bağlama büyümüştü. Yeni bir özellik çoğu zaman aynı dosyanın birkaç yüz satır daha uzamasına yol açıyor, inceleme sınırını ve ilerideki backend/self-hosting geçişini zorlaştırıyordu.

Yalnız dosya adını değiştirmek yeterli değildir. Faz sahipliği görünür olmalı ve kök dosyaların handler'ları yeniden içine alması otomatik testte durmalıdır.

Karar

Derleyici şu fiziksel sınırlara ayrılır:

KatmanKök sorumluluğuHandler modülleri
parsertoken akışı, blok ve tanım orkestrasyonuayristirici/cumle.rs, ayristirici/ifade.rs, ayristirici/kaynak.rs
checkertür modeli, bağlam ve denetim orkestrasyonucozumleyici/cumle.rs, cozumleyici/ifade.rs, cozumleyici/cagri.rs, cozumleyici/kaynak.rs
runtimeIO, scheduler, değer modeli ve orkestrasyonyorumlayici/cumle.rs, yorumlayici/ifade.rs, yorumlayici/hir_gecisi.rs, yorumlayici/io_izi.rs, yorumlayici/io_profili.rs

Modüller pub(super) ile yalnız kendi üst fazına açılır; crate'in public API'sini büyütmez. Bu taşıma davranış değişikliği değildir.

Kaynak-mimari testi iki kuralı otomatik korur:

  1. büyük handler adları kök dosyalara geri dönemez;
  2. kök ve handler dosyaları ilan edilmiş satır bütçesini aşamaz. Bütçeye sığmayan yeni alan kendi handler/modül sınırını açmak zorundadır.

Hata kataloğu bekçisi de compiler/src altındaki bütün Rust modüllerini özyinelemeli ve sıralı tarar; tanılar alt modüle taşınınca görünmez olamaz.

Değişmezler

  1. Parser'ın RFC-0021 katman ve tam tüketim davranışı değişmez.
  2. Checker'ın tanı kodu, kaynak konumu, çıkarım ve akış sonucu değişmez.
  3. Runtime'ın değerlendirme sırası, kısa devre, IO ve scheduler izi değişmez.
  4. Modül taşıma public Rust API ya da zee kullanıcı yüzeyi eklemez.
  5. Satır bütçesi kalite ölçütünün tamamı değildir; yalnız yeniden birleşmeyi engelleyen mekanik alt sınırdır. Checker'ın semantik fazları B-006/K-100 ve ADR-013 ile ayrıca ayrılmıştır.

Sonuçlar

  • Kök parser 1160, checker 963, runtime 1965 satıra indi.
  • Cümle, ifade ve çağrı değişikliklerinin sahipliği incelemede görünür oldu.
  • Üç mimari sınır testi gelecekteki büyümeyi ayrı modüle zorlar.
  • K-149/ADR-046, dosya bütçesinden bağımsız olarak bütün production üst sahiplerini exact doğrudan kenar tabanı ve izinli katman yönüyle korur; ayrıntı katman rehberindedir.
  • Hata kodu↔katalog birebirlik testi yeni alt dizinleri otomatik kapsar.
  • Mevcut 393 davranış testi değişmeden, toplam 396 testle taşıma doğrulandı.
  • Yeni normatif dil spec'i gerekmez; kullanıcı semantiği değişmemiştir.
  • Checker'ın bu fiziksel sınır üstündeki semantik sahipliği ADR-013'e devredildi; checker kökü 143 satırlık orkestrasyona indi.
  • K-101/ADR-014 semantic ID kayıtları baglam, sembol ve cagri katmanlarına eklendi; gerekçeli bütçe değişikliği faz rehberinde kayıtlıdır.
  • K-104 bağlı typed-HIR geçişini yorumlayici/hir_gecisi.rs, K-115 sürümlü IO trace/replay protokolünü yorumlayici/io_izi.rs sahibine ayırdı; gerekçeli bütçeler faz rehberinde kayıtlıdır.
  • K-116 zee-io-1 tohum ve aralık algoritmasını yorumlayici/io_profili.rs sahibine ayırdı; 80 satırlık bütçe ve kırıcı profil değişikliği kuralı faz rehberinde kayıtlıdır.
  • K-126/ADR-030 parser'ın token bölgesi→AST kaynak zarfı kuralını ayristirici/kaynak.rs, checker'ın eski tanıyı kesin ifadeye bağlama kuralını cozumleyici/kaynak.rs sahibine ayırdı. 80 ve 40 satırlık bütçeler bu çapraz kuralın ifade handler'larına geri dağılmasını engeller.
  • K-144/ADR-041 dosya sınırının içinde büyüyebilen tek işlevi ayrıca izler. Dosya bütçesi fiziksel sahipliği korur; 48 işlevlik incelenmiş Clippy tabanı ve kademeli büyüme payı ise satır/karar yoğunluğu trendini ayrı raporda görünür tutar.
  • K-145/ADR-042 kanonik rustfmt çıktısının satır açılımları için parser kökü 1.200→1.300; parser cümle/ifade 500→540 ve 1.150→1.220; checker cümle/ifade/bağlam 1.000→1.200, 960→1.080 ve 150→180; runtime cümle/ifade 620→860 ve 760→900 olarak bir kez yeniden kalibre edildi. Davranış alanı eklenmedi; sonraki değişiklikler yine gerekçe ister.

Kaynak: adr/012-derleyici-faz-modulleri.md · Bütün belgeler