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

27 — Uyumluluk ve sürümleme

Depodaki spec/27-uyumluluk-ve-surumleme.md belgesinden Zee ile üretildi.

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-dev serisi taşımak ZORUNDADIR ve -dev aynı sayılı yayından önce sıralanır.
  • dil sürüm, LSP serverInfo.version ve 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.tsv içinde ardışık DEP-NNN kimliğ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 ic yüzey süre şartı taşımaz; ic yüzey uyumluluk sözü değildir.
  • Kaldırılan kelime fixture'da kaldirildi mezar 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.rs ve playground_testi.rs kendi 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).

Kaynak: spec/27-uyumluluk-ve-surumleme.md · Bütün belgeler