K-118, iki bakım borcunu tek yapısal kapıda kapatır: normatif belgelerin hangi test dosyalarıyla kanıtlandığını görünür tutmak ve README'deki hareketli sayıları elle saymamak.
Spec ↔ code kanıt haritası
Makine-okunur harita her numaralı RFC, ADR ve spec dosyasını tam bir kez listeler. Dört sekmeli alan şunlardır:
- depo köküne göre belge yolu;
kanitli,kismiveyataslakdurumu;- virgülle ayrılmış Rust test dosyaları; yalnız
taslakiçin-olabilir; - kapsamı ya da açık kalan sınırı anlatan kısa not.
Tazelik testi; yeni belgenin haritasız kalmasını, yinelenen/bilinmeyen kaydı, var olmayan test yolunu, test taşımayan .rs kanıtını ve testsiz kanitli ya da kismi satırını reddeder. Harita “test dosyası var” kanıtıdır; testin iddiasıyla normatif metnin doğruluğunu kod incelemesi yine değerlendirmelidir.
kismi, belgenin çalışan dilimi testli olduğu halde açık kapsamı bulunduğunu; taslak, gerçekleme sözü verilmediğini gösterir. Bu ayrım özellikle uzak paket taşıması, telemetri için gelecek ikili audit'i ve self-hosting aşamalarında yanlış tamamlanmışlık izlenimini engeller.
README sayı üreticisi
cd compiler
cargo run --bin depo_sayilari
cargo run --bin depo_sayilari -- --denetle
cargo run --bin depo_sayilari -- --yazAraç depo ağacından şunları hesaplar:
- iki rakamla numaralı golden programlar;
compiler/srcvecompiler/testsiçindeki#[test]vakaları ilecompile_faildoctest'leri;- tanı kimliği fixture'ındaki etkin/ayrılmış kayıtlar;
- RFC dosyaları ve kendi
Durumsatırlarından kabul/geçici/taslak dağılımı; - ADR dosyaları ve kabul sayısı;
- normatif spec bölüm sayısı.
--yaz, README'deki işaretli bloğu ortak atomik dosya çekirdeğiyle değiştirir. --denetle tek byte farkında başarısız olur ve normal test paketi bu kipi çalıştırır. Böylece yeni test, tanı veya karar belgesi sayıları elle arayıp değiştirilmez; geliştiren kişi yalnız üreticiyi çalıştırır. Bu yazma K-128/ADR-032 metadata sözleşmesini de tüketir; README'nin var olan owner/group/ACL/xattr bilgisi sayı tazelenirken sessizce düşürülemez.
Tarihsel K-kayıtlarındaki “o gün toplam N test” cümleleri bilinçli snapshot'tır ve yeniden yazılmaz. README'nin bugünkü canlı sayıları için tek otorite işaretli otomatik bloktur.
Kritik işlev eğilim raporu
K-144/ADR-041'in işlev eğilim raporu, sabit Clippy ölçümünü incelenmiş TSV tabanıyla karşılaştırır. Rapor elle düzenlenmez:
cd compiler
cargo run --locked --bin islev_egilimi -- --denetle
cargo run --locked --bin islev_egilimi -- --rapor-yaz--denetle; yeni, kayıp veya büyüme payını aşan kritik işlev kadar raporun tek byte bayatlamasını da reddeder. Taban yenilemek rapor yenilemekten ayrı ve bilinçli bir mimari incelemedir; düşen değerler kendiliğinden yeni borç alanı açmaz.
Faza özgü test envanteri
K-146/ADR-043'ün faz matrisi, kaynakta görünen test özniteliklerini yaklaşık saymaz. Cargo JSON çıktısındaki gerçek lib/bin/test çalıştırılabilirlerini ve libtest'in vaka listesini her Tier-1 platformunda yeniden çıkarır:
cd compiler
cargo run --locked --bin faz_test_matrisi -- --denetle \
--rapor target/faz-test-matrisi.mdHer vaka tam bir birincil faza aittir. Yeni/sahipsiz/yinelenen test, boşalan seçici, kayıp regression/fuzz/conformance kaynağı veya bayat kanonik belge kapıyı kapatır. Dinamik rapor faz başına count, pass/fail/ignored ve duvar süresini verir. cfg nedeniyle aktif toplam platforma göre değişebilir; README'deki kaynak vakası toplamı ile karıştırılmaz. Süre performans eşiği değildir; K-148'in kullanıcı iş yükü gözlemleri aşağıdaki ayrı kanaldadır.
Performans gözlemi ve tarihçe
K-148/ADR-045, K-152/ADR-049 ve K-153/ADR-050'nin ölçüm rehberi, sabit iş yüklerinde parse, checker, typed-HIR, runtime, yürütme, in-process LSP engine initialize, gerçek dillsp process cold-start, open/change ve Unix tepe RSS yüzeylerini ayırır. Varsayılan release koşusu iki ısınma ve 25 örnekten ham dağılım, p50/p95 ile min/max üretir. İzlenen performans-gecmisi-v2.tsv yalnız incelenmiş tabanları taşır; her satır exact Git SHA, ayrı milestone, temiz çalışma ağacı, OS/CPU/RAM/Rust/release ve gerçek örnekleme sayılarıyla provenance sahibidir. RSS 25 tur değil, koşu sonundaki tek süreç-tepe görüntüsüdür. Araç yeni sonucu ayrı TSV'ye yazar.
cd compiler
cargo build --locked --release --bin dillsp
cargo run --locked --release --bin olcum -- \
--tur 25 --gecmis ../docs/performans-gecmisi-v2.tsv \
--json target/performans.json --rapor target/performans.md \
--gecmis-cikti target/performans-gecmisi.tsv \
--kayit K-NNN-makine --git-sha GIT_SHA --milestone K-NNN \
--dillsp target/release/dillsp--gecmis-cikti kirli çalışma ağacını ve HEAD'den farklı SHA'yı reddeder. Shared CI bu üç dosyayı job summary ve indirilebilir artefakt yapar; runner gürültüsü nedeniyle hard gate uygulamaz. --esik-yuzde yalnız sabitlenmiş adanmış benchmark makinesinde açıkça verilebilir. Geçmiş şema, metadata ve p50/p95 tutarlılığı olcum birim testleriyle; CI kablolaması ve eşiksizlik politikası mimari sınır testiyle korunur.
Production katman graph'ı
K-149/ADR-046'nın katman rehberi ve katman-mimarisi-v1.tsv bütün production Rust dosyalarını 37 üst sahibe bağlar. Exact doğrudan bağımlılık tabanı eklenen kadar artık kullanılmayan kenarı da görünür inceleme ister; katman yönü ters kenarı tabana yazmakla geçilebilir olmaz.
cd compiler
cargo test --locked --test katman_mimarisi_testi
cargo test --locked --test bagimlilik_cevrimi_testiTarayıcı test-only kodu, yorum ve metinleri graph'a katmaz; hedefe özgü production yollarını birleşik korur. Yeni kök modül/ikili sahiplenilmezse, mevcut modüle yeni kenar eklenirse veya sozdizimi/semantik/runtime/adaptör yönü tersine çevrilirse Engineering gates fazı kapanır.
K-150/ADR-047 bunun üstünde SCC hesabı yapar. Açıklamasız yeni SCC, graph'tan kaybolduğu halde duran izin ve son tarihi geçen geçici izin bagimlilik_cevrimi_testi ile reddedilir. İzin fixture'ı exact üyeler, gerekçe, son tarih ve kaldırma işi taşır.
Semantic regresyon korpusu
K-147/ADR-044'ün semantic regresyon korpusu, geçmiş compiler bug'larını K-155/ADR-052 ile regression/v2.tsv içindeki exact fixed_by, mümkünse introduced_by ve guaranteed_since provenance'ı üzerinden küçük .dil kaynaklarına bağlar. Vaka kimliği, K-kaydı, faz, kip, kesin tanı spanı, exit ve çıktı aynı satırdır. Ağaç ile manifest birebir değilse ya da fixture minimality sınırını aşarsa test başarısız olur. Faz matrisi bu testi ayrı Semantic regression fazında sayar; böylece genel yeşil toplam geçmiş arıza kimliğini gizlemez. semantic-regresyon-korugu.sh ayrıca CI tabanındaki vaka+bug+yol+provenance zincirinin silinmesini veya yeniden kullanılmasını reddeder. K-155A/ADR-053 sabit başlangıçtan sonraki her compiler/src commit'ini mesajdan bağımsız docs/compiler-degisiklik-beyanlari-v1.tsv kaydına zorlar; bugfix sınıfı exact fixed_by sahibi yeni satır ve fixture olmadan geçemez. K-160A/ADR-059 bunun üstüne docs/core-freeze-beyanlari-v1.tsv kapısını koyar: semantic feature yalnız dogfood/security/correctness sınıfıyla, dogfood ise ürün+iş+reproducer+etkilenen proje+minimalite+karar zinciriyle geçer. CI tabanı eski freeze beyanının yeniden yazılmasını da reddeder.
Immutable conformance verisi
scripts/conformance-korugu.sh, CI taban Git revizyonunda bulunan bütün conformance/**/*.json veri/şemalarıyla yayımlanmış morfoloji semantic kayıtlarını korur. Var olan artefaktın değiştirilmesi, silinmesi veya yeniden adlandırılması reddedilir; yeni anlam yeni profil/şema kimliğiyle ayrı dosya olarak eklenir. Morfoloji ve zee-esz-1 scheduler korpusları aynı genel kapıyı paylaşır.
Uyumluluk ve deprecation kapısı
K-167/ADR-064'ün uyumluluk rehberi, dil-yuzeyi-v1.tsv envanteri ve deprecation-kayitlari-v1.tsv kaydı; kalıp kelimesi, koşul yüklemi, CLI komutu, biçim, profil, ABI, API ve tanı yüzeyini kaynakla birebir tutar. Kayıtsız kaldırma, süresiz deprecation ve etiket sonrası yayımlanmış sürüm kimliği fail-closed reddedilir.
cd compiler
cargo test --locked --test uyumluluk_testiSpec maddesi drift kapısı
K-171/ADR-065'in drift rehberi, spec-madde-kaniti-v1.tsv ve spec-drift-raporu.md; her normatif spec maddesini exact test işlevine bağlar. Metni değişen madde yeni kimlik alır, kayıp test işlevi ve bayat rapor CI'ı durdurur; kısmi/açık maddeler gerekçesiyle görünür.
cd compiler
cargo run --locked --bin spec_drift -- --denetle
cargo run --locked --bin spec_drift -- --rapor-yazBirleşik güvenlik sürüm kapısı
K-170/ADR-066'nın rehberi, kök SECURITY.md ve guvenlik-bulgulari-v1.tsv; inceleme/fuzz/ dogfood/advisory/drift/saha bulgularını önem ve durumla kaydeder. Açık kritik/yüksek bulgu, kapanış işi olmayan kapalı bulgu ve karar yolu olmayan kabul edilmiş sınır fail-closed'dur.
bash scripts/guvenlik-kapisi.sh --surekli
bash scripts/guvenlik-kapisi.sh --surum-adayiDogfood korpusu
K-172/ADR-067'nin rehberi ve dogfood/korpus-v1.tsv; gerçek ürün sürtünmesinden doğan başarı+başarısızlık vakalarını ürün yetkinlik politikasıyla derler ve hermetik IO ile çalıştırır. Manifest dışı dogfood kaynağı, kanonik olmayan biçim ve günlükte olmayan dilim fail-closed'dur.
cd compiler
cargo test --locked --test dogfood_korpusu_testiTekrar üretilebilir sürüm artefaktı
K-168/ADR-068'in rehberi ve scripts/surum-artefakti.sh; iki bağımsız temiz klonda sabit toolchain, --remap-path-prefix ve commit zamanı SOURCE_DATE_EPOCH ile dil/dillsp derler, özetler eşit değilse artefakt üretmez. surum_artefakti SPDX SBOM, SLSA provenance ve zee-surum-imza-v1 imzasını deterministik üretir/doğrular.
bash scripts/surum-artefakti.sh --cikti /tmp/surum [--anahtar surum.zee-anahtar]Uzun soak kapısı
K-173/ADR-069'un rehberi ve soak-gecmisi-v1.tsv; derleyici döngüsü ile gerçek dillsp sürecini süre bütçesi boyunca koşturur, RSS'i pencere pencere örnekler ve ısınma sonrası büyüme hem %10 hem 32 MiB'ı aşarsa kalır.
cd compiler
cargo build --locked --release --bin dillsp --bin soak
target/release/soak --sure-sn 1800 --pencere-sn 60 --dillsp target/release/dillsp --rapor target/soak.mdTanı kalitesi kapısı
K-166/ADR-070'in raporu ve tani-kalitesi-istisnalari-v1.tsv; golden korpusuna 11 deterministik acemi hatası uygular, her (operatör, kod) sınıfı için öneri, işaret ve gürültü ölçer. Sık sınıflarda ihlal ve bayat rapor CI'ı durdurur.
cd compiler
cargo run --locked --bin tani_kalitesi -- --denetle
cargo run --locked --bin tani_kalitesi -- --rapor-yazKurulum-kaldırma tatbikatı
K-169/ADR-071'in runbook'u, scripts/kur.sh/kur.ps1 ve kaldir.sh/kaldir.ps1; SHA256SUMS doğrulanmadan kurulum, manifest dışı dosya silme ve üzerine yazma yoktur. kurulum_testi gerçek ikililerle akışı ve oynanmış artefakt reddini sınar; kurulum-tatbikati workflow'u üç Tier-1 platformda etikette koşar.
İkinci ürün: kanıt özeti aracı
K-164/ADR-072'nin aracı dogfood/kanit-ozeti altında Zee ile yazılmıştır; dokuz kayıt defterinden docs/kanit-ozeti.md üretir. kanit_ozeti_testi ürünü gerçek kayıt defteri içerikleriyle hermetik koşar ve sayfanın bayt bayt tazeliğini, determinizmini ve bağımsız sayımla doğruluğunu ister; dogfood_korpusu_testi proje kipiyle bütün birim testlerini koşar; CI gerçek CLI ile sayfayı yeniden üretip farkı reddeder.
Üçüncü ürün: kelime avı oyunu
K-179/ADR-074'ün oyunu dogfood/kelime-avi altında etkileşimli komut satırı yüküdür. kelime_avi_testi gerçek sözlükle hermetik kazanma/kaybetme/kısa tahmin/skor özeti/boş sözlük senaryolarını koşar; korpus proje vakası birim testlerini, f001/f003 çiftleri yeni sürtünmeleri taşır. Tekrar eden sınıflar ADR-074'te K-164 kimliğiyle sayılır.
Zee–Rust–Go karşılaştırması
K-165/ADR-073'ün veri sayfası ve exact SHA tarihçesi docs/dogfood-karsilastirma-v1.tsv. dogfood_karsilastirma_testi Rust (ve varsa Go) eşdeğerinin aynı sayfayı bayt bayt ürettiğini ve tarihçenin son kaydındaki kaynak satırı/test sayılarının yeniden hesapla tuttuğunu doğrular; süre ve RSS makineye bağlıdır, kapı değildir.
Kaynak: docs/depo-butunlugu.md · Bütün belgeler