aggrega explain
Bir kodun adlandırdığı durdurma koşulunu açıklar
Kullanım
aggrega explain <code>Açıklama
Explain the halting condition a code names.
A halting diagnostic opens with the category the failure is attributable to and the condition's short code — the letter E and four digits, as in [CATALOG_ERROR E0209]. That short code is the one to pass here; it is fixed once a condition is published, so a code quoted out of an old report still names the same condition.
aggrega explain E0209
The descriptive code is accepted too — the hyphenated one naming the condition in words, which a structured diagnostic carries as a field of its own. A condition's two codes name the same condition and reach different readers, so either is a code you may be holding, and the condition above is registered under recipe-values-mapping-requires-source:
aggrega explain recipe-values-mapping-requires-source
Every condition is declared inside this binary, so the identifiers and the sentence are reported without a network or a cache. The published reference supplies the walk-through of the authoring fix for every condition, and nothing else is resolved against it. It is read from the documentation bundle published for this version of aggrega on the default registry — or, where none is published for it, the newest one published for an earlier version — kept in the cache every project on this machine shares, acquired on first use when that cache holds no copy this workspace's signature check admits. Where it cannot be acquired, the condition is still reported and the reason the walk-through is missing is stated.
A number that named a condition and no longer does is reported as retired, with what it named, so a code quoted from an old report is never answered with a different condition.Ne yapar
Duran bir derleme, hatanın atfedilebildiği kategoriyi ve koşulun kısa kodunu (E harfi ve dört rakam) adlandıran köşeli parantezli bir başlık yazdırır:
[CATALOG_ERROR E0209] Recipe: valuesMapping requires source ...aggrega explain E0209, bu kodu adlandırdığı koşula ve yazım düzeltmesinin adım adım açıklamasına dönüştürür:
aggrega explain E0209Yanıt, koşulun her iki tanımlayıcısıyla ve tanılamalarının başladığı sabit cümleyle açılır, ardından koşula neyin yol açtığını ve neyin değiştirilmesi gerektiğini açıklayan girdiyi yeniden verir. Bu, fatal-halts.md sayfasında yayımlanan girdinin aynısıdır.
Verilecek kod
Koşulun iki kodundan herhangi biri kabul edilir, çünkü her biri size farklı bir yüzeyde ulaşır.
Kısa kod, terminalin size gösterdiği koddur ve elinizde yalnızca yazdırılmış çıktı olduğunda başvurulacak olan odur. Bir numara bir kez verilir ve sonra sabit kalır; bu nedenle bir yıl önce bir rapora yapıştırdığınız kısa kod, o zaman adlandırdığı koşulu hâlâ adlandırır.
Açıklayıcı kod, yapılandırılmış bir tanılamanın kendine ait bir alan olarak taşıdığı ve bir programın üzerinde dallandığı tireli koddur. Koşulu sözcüklerle adlandırır ve önek taşımaz; bu nedenle derleyici onun etrafında yeniden düzenlendiğinde bile sabit kalır. Elinizde bu varsa, onun yerine bunu verin; yukarıdaki koşul recipe-values-mapping-requires-source adıyla kayıtlıdır:
aggrega explain recipe-values-mapping-requires-sourceBir koşulun iki kodu aynı koşulu adlandırır; bu nedenle her iki yazım da aynı yanıtı verir. Kısa kod, ekrandan okuyup yeniden yazdığınız bir değer olduğundan büyük/küçük harf ayrımı yapılmadan eşleştirilir.
sentinels.md, bir koşulun taşıdığı üç tanımlayıcıyı ve her birine ne zaman başvurulacağını anlatır.
Yanıtın kaynağı
Bu ikili dosyanın bildirdiği her koşul ikili dosyadan yanıtlanır. Koşulun iki kodu ve tanılamalarının açıldığı cümle derleyicinin içinde bildirilir; bu nedenle bu kısım için ağ, önbellek ya da yapılandırma gerekmez.
Bu ikili dosyanın bildirmediği bir kod, yayımlanmış başvuru kaynağında aranır. Bir eklenti, derleyicinin bildirdiği bir koşulu seçerek bir durmayı bildirir; bu nedenle hiçbir koşul başka bir yerde bildirilmez. Yayımlanmış başvuru kaynağı sentinels.md, ürünün bildirdiği her koşulu listeler ve çalıştırdığınız ikili dosyadan farklı bir sürüm için yayımlanmış olabilir; bu nedenle daha yeni ya da daha eski bir sürümle hazırlanmış bir rapordan alıntılanan bir kod yine de orada çözümlenebilir.
Adım adım açıklama da yayımlanmış belgelerdir ve fatal-halts.md sayfasından okunur. Her iki sayfa da belge paketinden gelir; bu paket, her Aggrega projesinin paylaştığı önbellekte makine başına bir kez, her kayıt defteri ve sürüm için bir kopya olarak tutulur; bkz. aggrega cache. Okunan paket, çalıştırdığınız aggrega sürümü için yayımlanmış olandır; o sürüm için hiçbiri yayımlanmamışsa, daha önceki bir sürüm için yayımlanmış en yeni pakettir — aggrega scaffold --example komutunun yaptığı seçimin aynısı; böylece ikisi hiçbir zaman farklı belgeler okumaz. Daha önceki bir sürümün başvuru kaynağında bulunmayan bir kod, o zamandan beri bildirilmiş bir koşulu adlandırıyor olabilir; bu nedenle hiçbir şeyi adlandırmayan bir kod olarak değil, belirlenemeyen bir kod olarak reddedilir ve ret, hangi sürümün başvuru kaynağının okunduğunu belirtir. Paketin hangi kayıt defterinden, yani varsayılan kayıt defterinden geleceğine çalışma alanınız karar verir; makinede zaten bulunan bir kopyanın okunup okunamayacağına da o karar verir: bir sayfa sunulmadan önce, kopyanın yanında tutulan imzalar, çalışma alanınızın o kayıt defteri için kendi imza denetimiyle, yani paketin getirilmesinin de tabi olduğu denetimle yeniden doğrulanır. Bu denetim çevrimdışı da çalışır. Denetim bir anahtar veya güven kökü sabitliyorsa yalnızca bunları okur; resmî hub’ın yerleşik denetiminde olduğu gibi ikisini de sabitlemiyorsa, çevrimdışı bir çalışma alanının getiremeyeceği genel Sigstore güven köküne karşı doğrular. Bu nedenle çevrimdışıyken, bu makinede daha önce yapılmış çevrimiçi bir getirmenin ana dizininizdeki .sigstore altına bıraktığı güven köküne karşı doğrular ve hiçbir şey getirmez. Makinede kopya yoksa ya da denetiminizin kabul ettiği bir kopya yoksa, komut bu denetim altında bir kez bir kopya edinir ve sonrasında önbellekten okur. Aynı kopya, bir asistanın aggrega mcp üzerinden okuduğu belgeleri ve bir düzenleyicinin aggrega serve üzerinden gösterdiği açıklamaları da sunar.
Üç yanıtı tanımak yararlıdır, çünkü her biri sizden farklı bir şey ister.
Henüz girdisi olmayan bir koşul. Kodlar ve cümle bildirilir; bir not, durdurma koşulları sayfasında o koşul için adım adım açıklama bulunmadığını belirtir. Her koşul yine de sentinels.md sayfasında listelenir.
Kullanılabilir belge yok. Derleyicinin bildirdiği bir koşul için kodlar ve cümle yine bildirilir; bir not da okunamayan paketi ve sürümü adlandırır. Bu ikili dosyanın bildirmediği bir kod için yanıt verecek bir şey kalmaz, bu nedenle kod reddedilir; ret, başvuru kaynağının okunamadığını belirtir, çünkü o olmadan farklı bir sürümden gelen bir kod bir yazım hatasından ayırt edilemez, ve her iki onarımı da açık bırakır: kodu düzeltmek ya da belgeleri edinmek. Bunun olağan nedeni, çevrimdışına sabitlenmiş ya da kayıt defterine hiç ulaşmamış bir çalışma alanıdır. Makinede çalışma alanınızın imza denetiminin kabul etmediği bir kopya varsa (başka bir projenin daha gevşek bir ayarla getirdiği bir kopya ya da bu makine denetimin doğruladığı genel güven kökünü hiç getirmediği için çevrimdışı bir çalışma alanının denetleyemediği bir kopya), not kopyanın eksik olmadığını, reddedildiğini ve nedenini belirtir. Sürümünüz için hiçbir paket yayımlanmamışsa ve daha önceki en yeni paket, aggrega’nın bu sürümünün artık okumadığı bir biçimdeyse — örneğin kendi belgeleri yayımlanmadan önce çalıştırılan bir sürüm adayı — not bu ikisini tek bir cümlede belirtir:
hub.aggrega.ai/docs/aggrega-docs publishes no documentation bundle for 0.9.1-rc.1, and the newest earlier one, 0.8.11, is in a format this version of aggrega no longer reads, so the walk-through is not shown here; every condition, including the ones a provider declares, is published at aggrega-docs/language-reference/errors/sentinels.md, and the walk-through of each authoring fix at aggrega-docs/language-reference/errors/fatal-halts.mdEmekliye ayrılmış bir numara. Bir koşulu adlandırmış ancak artık adlandırmayan bir numara, hiç var olmamış bir kod olarak değil, neyi adlandırdığıyla birlikte emekliye ayrılmış olarak yanıtlanır; ve hiçbir zaman farklı bir koşulla yanıtlanmaz, çünkü emekliye ayrılmış bir numara yeniden verilmez.
Örnekler
Başarısız bir derlemeden doğrudan alınan bir kodu açıklayın:
aggrega build --release release.yaml || aggrega explain E0209Bir programın eşleştirdiği bir kodu açıklayın:
aggrega explain plugin-value-not-representableBir asistandan aynı yanıt
aggrega mcp üzerinden bağlanan bir yapay zekâ asistanı, bu aynı açılıma explain-error aracıyla ulaşır. Ona yalın bir kod yerine tanılama metnini verin (bir asistanın elinde derlemenin yazdırdığı şey vardır); bu metin kısa bir kodla açılıyorsa yanıt, koşulu, tanılamalarının açıldığı cümleyi ve yazım düzeltmesinin yayımlanmış adım adım açıklamasını, yukarıdaki yanıtla aynı biçimde oluşturulmuş olarak taşır. Ayrıca açıklayıcı kodu da taşır; böylece asistan bir mesajın ifadesi yerine onun üzerinde dallanabilir. Koşulun yayımlandığı adres de yanıtta yer alır.
Yukarıdaki bölümlerin eksik bir adım adım açıklama hakkında söylediği her şey orada da geçerlidir: sayfanın girdi belgelemediği bir koşul ve belgeleri okuyamayan bir çalışma alanı, her biri koşulu hangisi olduğunu belirten bir notla yanıtlanmış olarak bırakır. Emekliye ayrılmış bir numara da orada neyi adlandırdığıyla birlikte emekliye ayrılmış olarak yanıtlanır; böylece eski bir tanılama verilen bir asistan, başka bir şey hakkındaki bir sayfaya yönlendirilmek yerine numaranın artık kullanılmadığını öğrenir. Asistan yüzeyi belgeleri oturum açıldığında bir kez edinir; bu nedenle bir açılım zaten önbellekte olanı okur.
Arka plan hizmeti aynı soruyu bir düzenleyici için, bir tanılamadan değil bir koddan yanıtlar. Üçü de, tesadüfen örtüşen üç ayrı yanıt değil, üç biçimde sunulan tek bir açılımdır.