aggrega explain
Menjelaskan kondisi penghentian yang dinamai oleh sebuah kode
Sinopsis
aggrega explain <code>Deskripsi
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.Apa yang dilakukannya
Build yang berhenti mencetak kepala dalam kurung siku yang menyebutkan kategori penyebab kegagalan dan kode pendek kondisinya — huruf E dan empat digit:
[CATALOG_ERROR E0209] Recipe: valuesMapping requires source ...aggrega explain E0209 mengubah kode itu menjadi kondisi yang disebutkannya dan panduan langkah demi langkah untuk memperbaikinya:
aggrega explain E0209Balasan dibuka dengan kedua pengenal kondisi dan kalimat tetap yang mengawali diagnostiknya, lalu mereproduksi entri yang menjelaskan penyebab kondisi dan apa yang harus diubah — entri yang sama dengan yang diterbitkan di fatal-halts.md.
Kode yang diberikan
Salah satu dari dua kode kondisi diterima, karena masing-masing sampai kepada Anda melalui antarmuka yang berbeda.
Kode pendek adalah kode yang ditampilkan terminal, dan kode inilah yang digunakan ketika Anda hanya memiliki output tercetak. Sebuah nomor diberikan sekali lalu tetap, sehingga kode pendek yang Anda tempelkan ke laporan setahun lalu masih menyebutkan kondisi yang sama seperti saat itu.
Kode deskriptif adalah kode bertanda hubung yang dibawa diagnostik terstruktur sebagai bidang tersendiri, dan yang menjadi dasar percabangan program. Kode ini menyebutkan kondisi dengan kata-kata dan tidak memiliki prefiks, sehingga tetap sama bahkan ketika kompiler ditata ulang di sekitarnya. Jika kode inilah yang Anda pegang, berikan kode ini sebagai gantinya — kondisi di atas terdaftar sebagai recipe-values-mapping-requires-source:
aggrega explain recipe-values-mapping-requires-sourceDua kode sebuah kondisi menyebutkan kondisi yang sama, sehingga kedua penulisan menghasilkan jawaban yang identik. Kode pendek dicocokkan tanpa memedulikan huruf besar-kecil, karena kode itu adalah nilai yang Anda baca dari layar lalu ketik kembali.
sentinels.md menjelaskan tiga pengenal yang dibawa sebuah kondisi dan kapan masing-masing digunakan.
Dari mana jawabannya berasal
Setiap kondisi yang dideklarasikan biner ini dijawab dari biner. Dua kodenya dan kalimat pembuka diagnostiknya dideklarasikan di dalam kompiler, sehingga bagian itu tidak memerlukan jaringan, cache, maupun konfigurasi.
Kode yang tidak dideklarasikan biner ini dicari di referensi yang diterbitkan. Sebuah plugin melaporkan penghentian dengan memilih kondisi yang dideklarasikan kompiler, sehingga tidak ada kondisi yang dideklarasikan di tempat lain. Referensi yang diterbitkan, sentinels.md, mencantumkan setiap kondisi yang dideklarasikan produk, dan mungkin diterbitkan untuk versi yang berbeda dari biner yang Anda jalankan — sehingga kode yang dikutip dari laporan yang dibuat dengan rilis yang lebih baru atau lebih lama masih dapat diresolusi di sana.
Panduan langkah demi langkah juga merupakan dokumentasi yang diterbitkan, dibaca dari fatal-halts.md. Kedua halaman berasal dari bundel dokumentasi, yang disimpan sekali per mesin di cache yang digunakan bersama oleh setiap proyek Aggrega, satu salinan untuk setiap registry dan versi — lihat aggrega cache. Bundel yang dibaca adalah yang diterbitkan untuk versi aggrega yang Anda jalankan; jika tidak ada yang diterbitkan untuk versi itu, bundel yang dibaca adalah yang terbaru yang diterbitkan untuk rilis sebelumnya — pilihan yang sama dengan yang dibuat aggrega scaffold --example, sehingga keduanya tidak pernah membaca dokumentasi yang berbeda. Kode yang tidak dimuat dalam referensi rilis sebelumnya mungkin menyebutkan kondisi yang dideklarasikan sesudahnya, sehingga kode itu ditolak sebagai tidak dapat ditentukan, bukan sebagai kode yang tidak menyebutkan apa pun, dan penolakan itu menyatakan referensi versi mana yang dibaca. Workspace Anda menentukan dari registry mana bundel berasal, yaitu registry bawaannya, dan apakah salinan yang sudah ada di mesin boleh dibaca: sebelum sebuah halaman disajikan, tanda tangan yang disimpan di samping salinan diverifikasi ulang dengan pemeriksaan tanda tangan workspace Anda untuk registry itu, pemeriksaan yang sama yang berlaku untuk pengambilan bundel. Pemeriksaan itu juga berjalan secara offline. Jika pemeriksaan itu mematok kunci atau trust root, ia hanya membaca keduanya; jika tidak mematok keduanya, seperti pemeriksaan bawaan hub resmi, ia memverifikasi terhadap trust root publik Sigstore, yang tidak dapat diambil oleh workspace offline — sehingga secara offline ia memverifikasi terhadap trust root yang ditinggalkan oleh pengambilan online sebelumnya di mesin ini di bawah .sigstore di direktori home Anda, dan tidak mengambil apa pun. Jika mesin tidak memiliki salinan, atau tidak ada yang diterima pemeriksaan Anda, perintah ini memperoleh satu salinan dengan pemeriksaan itu, sekali saja, dan setelahnya membaca dari cache. Salinan yang sama menyajikan dokumentasi yang dibaca asisten melalui aggrega mcp dan penjelasan yang ditampilkan editor melalui aggrega serve.
Tiga balasan perlu Anda kenali, karena masing-masing meminta hal yang berbeda dari Anda.
Kondisi yang belum memiliki entri. Kode dan kalimatnya dilaporkan, dan sebuah catatan menyatakan bahwa halaman kondisi penghentian tidak memuat panduan langkah demi langkah untuk kondisi itu. Setiap kondisi tetap tercantum di sentinels.md.
Dokumentasi tidak tersedia. Untuk kondisi yang dideklarasikan kompiler, kode dan kalimatnya tetap dilaporkan, dan sebuah catatan menyebutkan bundel dan versi yang tidak dapat dibaca. Untuk kode yang tidak dideklarasikan biner ini, tidak ada lagi yang dapat digunakan untuk menjawab, sehingga kodenya ditolak — dan penolakan itu menyatakan bahwa referensi tidak dapat dibaca, karena tanpanya kode dari versi lain tidak dapat dibedakan dari salah ketik, dan membiarkan kedua perbaikan tetap terbuka: perbaiki kodenya, atau dapatkan dokumentasinya. Penyebab umumnya adalah workspace yang dipatok offline, atau workspace yang belum pernah menjangkau registry-nya. Jika mesin menyimpan salinan yang tidak diterima pemeriksaan tanda tangan workspace Anda — salinan yang diambil proyek lain dengan pengaturan yang lebih longgar, atau salinan yang tidak dapat diperiksa workspace offline karena mesin ini belum pernah mengambil trust root publik yang menjadi acuan verifikasi pemeriksaannya — catatan menyatakan bahwa salinan itu ditolak, bukan hilang, beserta alasannya. Jika tidak ada bundel yang diterbitkan untuk versi Anda dan bundel sebelumnya yang terbaru berada dalam format yang tidak lagi dibaca oleh versi aggrega ini — misalnya kandidat rilis yang dijalankan sebelum dokumentasinya sendiri diterbitkan — catatan menyatakan keduanya dalam satu kalimat:
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.mdNomor yang sudah dipensiunkan. Nomor yang pernah menyebutkan sebuah kondisi dan kini tidak lagi dijawab sebagai nomor yang dipensiunkan, beserta apa yang dulu disebutkannya, alih-alih sebagai kode yang tidak pernah ada — dan tidak pernah dijawab dengan kondisi yang berbeda, karena nomor yang dipensiunkan tidak diberikan lagi.
Contoh
Jelaskan kode langsung dari build yang gagal:
aggrega build --release release.yaml || aggrega explain E0209Jelaskan kode yang dicocokkan oleh sebuah program:
aggrega explain plugin-value-not-representableJawaban yang sama dari asisten
Asisten AI yang terhubung melalui aggrega mcp menjangkau penjelasan yang sama ini melalui alat explain-error. Berikan teks diagnostiknya, bukan kode saja — asisten memegang apa yang dicetak build — dan jika teks itu dibuka dengan kode pendek, jawabannya memuat kondisi, kalimat pembuka diagnostiknya, dan panduan langkah demi langkah perbaikan yang diterbitkan, yang disusun dengan cara yang sama seperti balasan di atas. Jawaban itu juga memuat kode deskriptif, sehingga asisten dapat bercabang berdasarkan kode itu alih-alih berdasarkan susunan kata sebuah pesan, serta alamat tempat kondisi itu diterbitkan.
Semua yang dikatakan bagian-bagian di atas tentang panduan yang tidak ada juga berlaku di sana: kondisi yang entrinya tidak didokumentasikan halaman itu, dan workspace yang tidak dapat membaca dokumentasi, masing-masing membuat kondisi dijawab dengan catatan yang menyebutkan kasus mana yang terjadi. Nomor yang dipensiunkan juga dijawab sebagai dipensiunkan di sana, beserta apa yang dulu disebutkannya, sehingga asisten yang menerima diagnostik lama mengetahui bahwa nomor itu tidak lagi digunakan alih-alih diarahkan ke halaman tentang hal lain. Antarmuka asisten memperoleh dokumentasi sekali saat sesi dibuka, sehingga sebuah penjelasan membaca apa yang sudah ada di cache.
Daemon menjawab pertanyaan yang sama untuk editor, berdasarkan kode alih-alih diagnostik. Ketiganya adalah satu penjelasan dalam tiga penyajian, bukan tiga jawaban yang kebetulan sama.