Normatif kaynak: RFC-0028, ADR-064, ADR-025, ADR-058. Durum: TANIMLI — K-167.
Sürüm kimliği
- Derleyici sürümü SemVer
X.Y.Zdir; etiket sonrası çalışma ağacıX.(Y+1).0-devserisi taşımak ZORUNDADIR ve-devaynı sayılı yayından önce sıralanır. dil sürüm, LSPserverInfo.versionve yayın SBOM'u aynı kimliği basmak ZORUNDADIR; yayımlanmış kimlik yeniden kullanılamaz (YASAK).
Dondurulmuş yüzeyler
dil sürüm --json, LSP serverInfo.zeeBuild ve uygulama sağlık rotası dahil tamamlanmış worker yanıtının X-Zee-Build başlığı aynı zee-build-v1 version/source_sha/source_date/channel/dirty kaydını taşımak ZORUNDADIR. Source tarihi commit UTC günüdür; duvar saati gömmek YASAKTIR. Kirli veya unknown kaynak kimliği exact temiz release kabulü değildir. Bu kayıt yalnız build kimliğini içerir; genel health/readiness rotası bu maddeyle eklenmez.
CLI seçenek bölgesindeki bilinmeyen -- argümanı kaynak yolu olarak okunmadan seçenek adı, etkin sürüm ve exit 2 ile reddedilmek ZORUNDADIR. çalıştır kaynak yolundan sonraki ve iz kaydet program argümanları kullanıcı programına aittir; bu seçenek reddinin kapsamına girmez.
Kalıp kelimeleri, koşul yüklemleri, CLI komutları, tanı kodları, proje.kilit v3, ZEEZEP v1, zee-yayin-v1 zarfı, zee-tr-1/zee-io-1/zee-esz-1 profilleri, WASM ABI v3 ve dil::api::v1 uyumluluk yüzeyidir.
- Her yüzey öğesi
dil-yuzeyi-v1.tsv(kelime ve biçimler) ya da kendi sürümlü kaydında (tanı, profil, ABI, API) durum ve giriş sürümüyle listelenmek ZORUNDADIR. - Kayıtsız öğe eklemek veya kayıtlı öğeyi kayıtsız kaldırmak YASAKTIR.
Deprecation
- Kaldırma ve yeniden adlandırma
docs/deprecation-kayitlari-v1.tsviçinde ardışıkDEP-NNNkimliği, duyuru sürümü, kaldırma sürümü, göç yolu ve karar belgesiyle ZORUNLU olarak kayıtlıdır. - Desteklenen yüzeyde kaldırma sürümü duyurudan en az bir alt sürüm serisi sonradır (ZORUNLU). Tanı mezar taşı ve
icyüzey süre şartı taşımaz;icyüzey uyumluluk sözü değildir. - Kaldırılan kelime fixture'da
kaldirildimezar taşı olarak kalır ve başka anlamda yeniden kullanılamaz (YASAK). Ayrılmış her tanı kodu kayıt taşır. - Kaldırılan biçim sessizce kabul edilmez: derleyici tanı üretir ve önerisi göç yolunu adlandırır; regresyon korpusu bunu kalıcı kanıtlar (TANIMLI).
Ana sürüm ve edition
1.0 sonrasında dondurulmuş yüzeylerde kırıcı değişiklik yalnız yeni ana sürüm ya da proje.dil içinde açık edition seçimiyle olur; edition alanının sözdizimi AÇIKtır. Morfoloji profili değişimi spec/13 gereği yeni profil kimliği ister.
Kanıt
compiler/tests/uyumluluk_testi.rs: fixture↔kaynak birebirliği, exact biçim/profil/ABI/API kayıtları, deprecation şeması ve süre kuralı, tanı mezar taşı çaprazı, kaldırılan iç modülün yokluğu, sürüm kimliği ve sentetik bozuk girdilerin reddi.compiler/tests/tani_kimligi_testi.rs,morfoloji_testi.rs,public_api_testi.rsveplayground_testi.rskendi yüzeylerini korur.
TANIMLI: dil çalıştır <proje-klasörü> kökte varsa bounded zee.ayar zee-ayar-1/sürüm 1 zarfını okur. Bilinmeyen olağan alan tek sabit uyarıyla varsayılanı korur; bilinmeyen güvenlik/üst zarf alanı, duplicate JSON, geçersiz tip/sınır ve config kök symlink'i exit 2 ile reddedilir. Kaynak öncesi açık CLI ayarı geçerli config alanını ezer. dil sürüm --ayar-semasi ayrı capability sorgusudur; config reader olmayan 0.7/önceki küçük sürüm rollback kabulü AÇIK kalır (K-234, ADR-097).