compiler/src altındaki her commit, başlığından bağımsız olarak semantic etkisini açıkça bildirir. Kapının makine-okunur kaynağı compiler-degisiklik-beyanlari-v1.tsv, mimari kararı ADR-053'tür. K-160A sonrasında bu beyan tek başına feature izni değildir; ikinci kapı core freeze beyanıdır.
Satır sözleşmesi
Her veri satırı dört sekmeli alan taşır:
- kaynak değişikliğinin tam 40 haneli Git SHA'sı;
semantic-bugfix,semantic-changeveyamaintenancesınıfı;- kanıt;
- en az 40 karakterlik, incelemede anlamlı gerekçe.
| Sınıf | Kanıt | Anlam |
|---|---|---|
semantic-bugfix | regression/v2.tsv vaka kimliği | Vakanın fixed_by alanı commit SHA'sıyla exact eşleşir. |
semantic-change | spec/, rfcs/ veya adr/ Markdown yolu | Kullanıcıya görünen semantic değişiklik normatif karara bağlıdır. |
maintenance | - | Semantic davranış değişmemiştir; gerekçe bunun nedenini açıklar. |
İki commitlik akış
- Kaynak düzeltmesini testleri ve ilgili davranış belgeleriyle commit et.
- Tam SHA'yı al.
- Bug fix ise minimal regression fixture'ını ve
fixed_bysatırını ekle. - Beyan TSV'sine SHA+sınıf+kanıt+gerekçe satırını ekle ve ikinci commit'i al.
- Koruk ile tam faz matrisini çalıştır.
bash scripts/semantic-regresyon-korugu.sh HEAD~2
cd compiler
cargo run --locked --bin faz_test_matrisi -- --denetle \
--rapor target/faz-test-matrisi.mdmaintenance kolay kaçış değildir: her commit yine exact ve tekil kayıttır; gerekçe review edilir. Yanlış sınıflandırma, kod incelemesinde semantic bug sayılır. Koruk; eksik/yinelenen satırı, bozuk kanıtı ve kaynak commit'i olmayan sahipsiz beyanı otomatik reddeder.
Core freeze kapısı semantic sınıfı freeze sınıfıyla çapraz denetler: semantic-change, dogfood/security/correctness kanıtı olmadan geçemez.
Kaynak: docs/compiler-semantic-degisiklik-beyani.md · Bütün belgeler