- Durum: kabul
- Tarih: 3 Eylül 2026
- İlgili kayıt: K-155, B-063
Bağlam
K-147'nin 17 vakalık korpusu bug kimliği, faz, kaynak ve gözlenebilir sonucu kalıcılaştırdı; ancak “hangi commit düzeltti, hangi commit bozdu ve hangi Zee sürümünden itibaren bu güvence var?” sorularını cevaplamıyordu. K-numarası bir karar kaydıdır, exact kaynak revizyonu değildir. Ayrıca yeni bir compiler bug düzeltmesinin fixture ekleme kuralı yalnız yazılı politikaydı.
Karar
- Kanonik manifest
regression/v2.tsvolur. Her satır eski alanlara ek olarak tam 40 hanelifixed_by, biliniyorsa tamintroduced_by(bilinmiyorsa açık-) ve SemVer biçimliguaranteed_sincetaşır. - İlk 17 vaka için
fixed_by, ilgili K-kaydının gerçek düzeltme commit'ine bağlanır. Fixture'lar K-147 ile yayımlanmadan önce minimal reproducer bulunmadığından geriye dönükintroduced_bytahmini yapılmaz; bilinmeyen veri sahte kesinlikle doldurulmaz. Garanti serisi0.8.0-devdir. - Manifest testi SHA biçimini, commit varlığını,
fixed_byrevizyonunun HEAD atası olmasını ve varsaintroduced_by→fixed_bytarih yönünü denetler. Garanti sürümü kanonik geliştirme serisiyle uyuşmalıdır. - Git tabanlı koruk v1→v2 göçünü okuyabilir; v2 yayımlandıktan sonra vaka, bug, dosya, fixed commit veya garanti sürümü yeniden yazılamaz.
introduced_byyalnız-değerinden,fixed_byatası olduğu kanıtlanan tam SHA'ya bir kez zenginleştirilebilir; geri alınamaz veya değiştirilemez. - İlk uygulama,
compiler/srcaltında düzeltme bildiren commit başlıklarını tarayarak exact fixture istiyordu. K-155A/ADR-053 bu zayıf niyet sezgisini yürürlükten kaldırdı: sabit başlangıçtan sonraki her compiler kaynak commit'i mesajından bağımsız, tekil semantic beyan taşır; bugfix sınıfı exact fixture ister. İki atomik commit akışı korunur.
Reddedilen seçenekler
- K-numarasını fixed commit saymak: karar kimliğini kaynak kimliğiyle karıştırır ve checkout edilebilir provenance vermez.
- Introduced commit'i tahmin etmek: eski reproducer olmadan güvenilir bisect yapılamaz; yanlış soy ağacı bilinmeyen değerden daha zararlıdır.
- Serbest metin sürüm notu: makinece tekillik, biçim ve değişmezlik kapısı kurulamaz.
- Bug fix ile aynı commit'in SHA'sını manifestte istemek: commit kendi hash'ini önceden taşıyamaz; döngüsel ve üretilemez bir sözleşmedir.
- Commit başlığını semantic sınır saymak: ilk K-155 uygulamasının regex'i farklı yazımlarla atlanabildiği için ADR-053 tarafından kaldırılmıştır.
Sonuçlar
- “Bug düzeldi” ifadesi exact kaynak commit'i, kalıcı reproducer ve garanti serisi olmadan CI'dan geçemez.
- Gelecekte gerçek bir introduced commit bisect ile kanıtlanırsa
-alanı tek yönlü ve ata denetimli biçimde zenginleştirilebilir; SHA geri alınamaz veya başka bir commit'le değiştirilemez. - Grammar, runtime davranışı, tanı anlamları, RFC ve normatif spec değişmedi.
Kaynak: adr/052-semantic-regresyon-provenance.md · Bütün belgeler