Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Skema Aggrega Plugin Trust Record

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

Id skema: https://aggrega.ai/schemas/plugins-trust-v1beta1.schema.json

Catatan yang dihasilkan mesin tentang identitas plugin yang dipercaya untuk setiap lampiran yang mengembalikan putusan terima-atau-tolak — lampiran plugins.governance dalam peran ir-verdict atau render-verdict, dan setiap lampiran plugins.linter. Berada di plugins-trust.yaml di samping lockfile dan di-commit bersamanya, karena catatan yang disimpan di luar kontrol versi tidak dapat ditinjau siapa pun dan tidak dapat dibandingkan dengan apa pun. Ditulis oleh aggrega pull, yang membuat berkas tersebut saat pertama kali me-resolve salah satu lampiran tersebut dan menambahkan satu catatan per lampiran saat me-resolve-nya. Berkas yang memuat catatan hanya untuk sebagian lampiran yang dikonfigurasi merupakan keadaan antara yang valid, bukan keadaan rusak. Dibaca oleh aggrega build, oleh aggrega lint --release dan oleh aggrega validate --release, serta oleh operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp; masing-masing mencocokkan konfigurasi workspace dengan catatan tersebut sebelum lampiran mana pun dijalankan. Dua ketidaksesuaian ditolak, dengan alasan berbeda: plugin yang digest artefak hasil resolve-nya bukan digest yang tercatat untuknya ditolak alih-alih dijalankan, karena plugin yang akan dijalankan bukan plugin yang catatannya telah ditinjau; dan entri catatan yang tidak dipertanggungjawabkan oleh lampiran putusan yang dikonfigurasi mana pun menghentikan proses, karena menghapus sebuah gerbang tidak mengubah satu byte pun hasil render, sehingga keluaran yang dihasilkan tanpa gerbang yang telah ditinjau tidak dapat dibedakan dari keluaran yang disetujui gerbang tersebut. Build, lint dengan cakupan rilis, dan validasi dengan cakupan rilis — dari baris perintah, melalui aggrega serve atau melalui aggrega mcp — juga mencocokkan setiap plugin tersebut yang dibacanya dari cache konten dengan signature yang dimuat catatannya, saat memuatnya, sebagaimana build mencocokkan setiap entri lockfile dengan yang dimuat entri tersebut: lihat signature di bawah. Arah sebaliknya — lampiran yang dikonfigurasi yang belum dimuat catatan — adalah keadaan antara yang baru saja dijelaskan dan tidak ditolak oleh kedua perbandingan, dan catatan yang tidak ada tidak memuat entri sama sekali, sehingga tidak mengunci apa pun dan kedua perbandingan tidak menolak apa pun karenanya; persyaratan tanda tangan adalah satu-satunya pengecekan yang tidak dapat dihindari oleh entri yang hilang, sebagaimana dijelaskan signature di bawah. Sebuah entri keluar dari catatan hanya melalui peningkatan eksplisit: aggrega pull --upgrade yang menyebut sebuah plugin menghapus entri plugin tersebut bila tidak ada lagi lampiran putusan yang menyebutnya, dan aggrega pull --upgrade tanpa argumen menghapus setiap entri semacam itu. aggrega pull biasa tidak me-resolve ulang identitas sebuah entri maupun menghapus entri tersebut, sehingga penghentian karena entri yang tidak dipertanggungjawabkan apa pun diselesaikan dengan menyatakannya secara sengaja, bukan oleh proses berikutnya. Catatan yang entri terakhirnya dihapus dikosongkan alih-alih dihapus, dan catatan yang dikosongkan adalah catatan yang valid: tidak memuat apa pun, sehingga tidak mengunci apa pun dan kedua perbandingan tidak menolak apa pun karenanya, persis seperti catatan yang tidak ada. Setiap catatan dialamatkan dengan koordinat identitas plugin itu sendiri dan memuat versi yang dipilih serta digest artefak sebagai field, sehingga perubahan versi merupakan perubahan pada field catatan yang sudah ada, bukan catatan baru di bawah alamat baru — itulah yang membuat plugin yang berganti versi dapat dibedakan, di dalam berkas dan dalam diff-nya, dari plugin yang dicatat untuk pertama kalinya. Selain identitas tersebut, sebuah catatan memuat dua fakta tentang artefak yang disebutnya, masing-masing dicatat hanya bila telah diverifikasi: deprecation yang dilampirkan penerbit padanya, bila ditemukan dan tanda tangannya terverifikasi, dan fakta tanda tangan terverifikasi yang dicatat aggrega pull saat memverifikasi tanda tangan plugin itu sendiri — fakta yang sama, di bawah kunci yang sama, yang dimuat entri lockfile. Masing-masing merupakan fakta tentang artefak yang tercatat, bukan identitas kedua, itulah sebabnya pull biasa mencatatnya tanpa mengusik identitas yang dicocokkan. Di luar itu, berkas tidak mencatat apa pun: tidak ada tanda tangan atas berkas itu sendiri, tidak ada input aturan, tidak ada asal-usul resolusi — tidak ada host registry, tidak ada path pada mesin yang menulisnya — dan tidak ada pembacaan jam, sehingga resolusi yang sama menghasilkan byte yang sama di mana pun dan kapan pun dijalankan. Berkas aturan eksternal lampiran putusan plugins.governance dicatat sebagai digest dalam verdict_inputs milik lockfile; input aturan lampiran plugins.linter tidak dicatat di berkas mana pun. Segala sesuatu yang direproduksi build secara byte demi byte justru dikunci di lockfile; lampiran putusan tidak membentuk keluaran render apa pun, itulah sebabnya identitasnya dicatat di sini, bukan di sana. Disiplin evolusi skema: menambahkan bagian tingkat teratas baru adalah SemVer-MINOR (aditif); menambahkan field baru di dalam bagian yang sudah ada adalah SemVer-MINOR; menghapus kunci atau memperketat batasan adalah SemVer-MAJOR.

Jenis tingkat teratas: object

Properti

PropertiJenisWajibDeskripsi
pluginsobject[]tidakSatu catatan per plugin yang dipercaya untuk attachment yang mengembalikan verdict, dialamatkan oleh koordinat identitas plugin tersebut. Plugin yang terpasang pada dua peran verdict sekaligus — plugin governance yang sama yang diikat ke ir-verdict dan render-verdict — menyumbang satu catatan saja, karena subjek yang dicatat adalah identitas plugin, bukan attachment-nya: kedua attachment membaca artefak yang sama. Catatan dihasilkan dalam urutan koordinat menaik. Default: []
versionconst 1yaVersi skema catatan kepercayaan: 1. Perubahan skema tingkat SemVer-MAJOR menaikkannya. Konstanta: 1

Properti tambahan tidak diizinkan.

plugins-trust.plugins[]

PropertiJenisWajibDeskripsi
deprecationobjecttidakPenanda deprecation retroaktif terverifikasi yang dicatat ketika penanda bertanda tangan dan tepercaya ditemukan pada artefak yang dinamai oleh digest. Penanda adalah OCI referrer bertanda tangan dari artefak yang di-deprecate-nya, dilampirkan setelah publikasi tanpa memublikasikan ulang artefak tersebut, sehingga plugin yang sudah dicatat di sini dapat di-deprecate kemudian — pada tingkat keparahan retracted, yaitu tingkat penarikan, hal itu berarti artefak dikecualikan dari pemilihan, bukan sekadar tidak dianjurkan. Penanda ini adalah fakta tentang artefak yang sudah dialamatkan oleh catatan ini, bukan identitas kedua, dan itulah yang memungkinkan aggrega pull menambahkannya sambil tetap membiarkan resolved_version dan digest tidak berubah: mencatatnya tidak mengadopsi apa pun. Penanda hanya dicatat ketika digest hasil resolusi sama dengan digest yang sudah dicatat — resolusi yang melaporkan byte berbeda merupakan perubahan identitas, yang diatur oleh aturan catatan ini sendiri dan ditolak kecuali run memintanya. Tidak ada yang menghapus penanda yang telah dicatat; penanda hanya hilang bersama catatan yang memuatnya, pada upgrade eksplisit yang mengganti atau menghapus catatan tersebut. aggrega build, aggrega lint --release, dan aggrega validate --release, serta operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp, menyebutkan plugin yang memuat penanda, karena jika tidak, gate yang di-deprecate akan diambil, di-cache, dan dijalankan tanpa pemberitahuan apa pun, dan pengaturan workspace build.halt_on_deprecated_severity menentukan apakah build berhenti karenanya atau hanya diberi peringatan.
pluginstringyaKoordinat identitas plugin: segmen socket dan nama polosnya yang digabungkan dengan garis miring, seperti governance/aggrega-security-baseline. Nama polos hanya unik di dalam socket-nya, sehingga segmen socket-lah yang membedakan dua plugin bernama sama di socket yang berbeda. Koordinat ini sengaja tidak memuat versi — itulah yang membuat perubahan versi terlihat sebagai suntingan pada resolved_version di bawah, bukan sebagai catatan yang tidak berkaitan.
resolved_versionstringyaVersi konkret yang dipilih untuk plugin ini ketika catatan ditulis (misalnya 1.2.3). Dicatat sebagai satu segmen path, sehingga tidak memuat /, \, maupun ... Pola: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringyaDigest konten dari artefak plugin hasil resolusi, dalam bentuk sha256: diikuti 64 karakter heksadesimal huruf kecil — bentuk alamat konten yang digunakan di setiap tempat ia dibandingkan. Pola: ^sha256:[a-f0-9]{64}$.
signatureVerifiedSignaturetidakFakta tanda tangan terverifikasi yang dicatat ketika aggrega pull memverifikasi tanda tangan plugin ini sendiri terhadap kebijakan kepercayaan registry yang melakukan resolusi, untuk artefak yang dinamai oleh digest. Pull memverifikasi tanda tangan setiap plugin yang di-resolve-nya untuk salah satu attachment ini, pada setiap run, dan mencatat hasilnya di sini — menggantikan isi catatan sebelumnya, dan menghapusnya jika pull tidak memverifikasi tanda tangan apa pun — tanpa mengganggu identitas yang menjadi acuan catatan. Sebelum build, lint dengan cakupan release, atau validasi dengan cakupan release menjalankan plugin, bundle tanda tangan ter-cache yang dinamai fakta ini di-hash ulang, dan run berhenti jika blob tersebut hilang atau berbeda; dan untuk plugin yang dibaca dari cache konten, run membaca dari bundle itu untuk artefak mana tanda tangan dibuat, dan berhenti jika tanda tangan dibuat untuk artefak yang berbeda dari plugin yang dibacanya — sehingga signature yang disalin dari entri plugin lain ditolak, apa pun persyaratan penandatanganannya. Tidak ada tanda tangan yang diverifikasi di sana, sehingga bundle yang ditulis ke cache secara manual, yang dibuat untuk artefak plugin ini sendiri, tidak dapat dibedakan dari bundle yang diverifikasi oleh pull. Dan jika konfigurasi kepercayaan workspace mewajibkan tanda tangan untuk plugin yang dibaca dari cache konten — persyaratan yang diterapkan aggrega pull saat memverifikasi plugin, sehingga pengecualian dan registry advisory yang membuat pull tidak mencatat tanda tangan juga membiarkan run berlanjut — catatan yang tidak memuat signature untuk plugin itu, atau sama sekali tidak memuat entri untuknya, menghentikan run, dengan menyebutkan plugin dan pengaturan yang mewajibkan tanda tangan tersebut. Plugin yang dibaca dari direktori katalog atau dari salinan di dalam biner compiler tidak pernah dikenai persyaratan itu.

Properti tambahan tidak diizinkan.

plugins-trust.plugins[].deprecation

Penanda deprecation retroaktif terverifikasi yang dicatat ketika penanda bertanda tangan dan tepercaya ditemukan pada artefak yang dinamai oleh digest. Penanda adalah OCI referrer bertanda tangan dari artefak yang di-deprecate-nya, dilampirkan setelah publikasi tanpa memublikasikan ulang artefak tersebut, sehingga plugin yang sudah dicatat di sini dapat di-deprecate kemudian — pada tingkat keparahan retracted, yaitu tingkat penarikan, hal itu berarti artefak dikecualikan dari pemilihan, bukan sekadar tidak dianjurkan. Penanda ini adalah fakta tentang artefak yang sudah dialamatkan oleh catatan ini, bukan identitas kedua, dan itulah yang memungkinkan aggrega pull menambahkannya sambil tetap membiarkan resolved_version dan digest tidak berubah: mencatatnya tidak mengadopsi apa pun. Penanda hanya dicatat ketika digest hasil resolusi sama dengan digest yang sudah dicatat — resolusi yang melaporkan byte berbeda merupakan perubahan identitas, yang diatur oleh aturan catatan ini sendiri dan ditolak kecuali run memintanya. Tidak ada yang menghapus penanda yang telah dicatat; penanda hanya hilang bersama catatan yang memuatnya, pada upgrade eksplisit yang mengganti atau menghapus catatan tersebut. aggrega build, aggrega lint --release, dan aggrega validate --release, serta operasi yang sama yang dijangkau melalui aggrega serve dan aggrega mcp, menyebutkan plugin yang memuat penanda, karena jika tidak, gate yang di-deprecate akan diambil, di-cache, dan dijalankan tanpa pemberitahuan apa pun, dan pengaturan workspace build.halt_on_deprecated_severity menentukan apakah build berhenti karenanya atau hanya diberi peringatan.

PropertiJenisWajibDeskripsi
messagestringyaPesan deprecation yang dapat dibaca manusia yang dibawa oleh penanda — biasanya petunjuk migrasi. Jika penanda tidak membawa pesan terpisah, alasannya dicatat di sini sebagai gantinya, sehingga kalimat yang dilaporkan tidak pernah kosong.
severitystring (enum)yaTingkat keparahan penanda, berurutan warning < error < retracted. Build berhenti ketika tingkat keparahan ini mencapai atau melampaui ambang henti yang dikonfigurasi, dan hanya diberi peringatan jika tidak — aturan yang sama dan pengaturan yang sama yang dibaca oleh setiap laporan deprecation lainnya. retracted adalah tingkat penarikan: artefak pada tingkat keparahan itu dikecualikan dari pemilihan, sedangkan dua tingkat keparahan peringatan lainnya membiarkannya tetap dapat dipilih. Nilai yang diizinkan: "warning", "error", "retracted"

Properti tambahan tidak diizinkan.

Definisi

VerifiedSignature

Fakta tanda tangan terverifikasi yang dicatat oleh sebuah pull ketika pull tersebut memverifikasi tanda tangan sebuah artefak terhadap kebijakan kepercayaan registry yang melakukan resolusi. Ini adalah satu-satunya bentuk yang digunakan kedua catatan untuk fakta tersebut — lockfile, pada setiap entrinya, dan catatan ini, pada setiap plugin — sehingga tanda tangan terverifikasi terbaca sama di kedua file. Mencatat mode verifikasi, identitas/penerbit keyless yang cocok (jika keyless) atau sidik jari kunci yang disematkan (jika keyed), serta digest beralamat konten dari bundel tanda tangan yang di-cache oleh pull.

PropertiJenisWajibDeskripsi
bundle_digeststringyaDigest SHA-256 dari blob bundel tanda tangan yang di-cache, dalam bentuk sha256: diikuti 64 karakter heksadesimal huruf kecil. Digest ini menamai blob cache, sehingga digunakan untuk membentuk sebuah path dan tidak memuat /, \, maupun .. — yang sudah dikecualikan oleh bentuk sha256: — dan digest inilah yang menjadi acuan saat build, lint dengan cakupan release, dan validasi dengan cakupan release melakukan hash ulang terhadap blob tersebut. Pola: ^sha256:[a-f0-9]{64}$.
identitystringtidakPenanda tangan terverifikasi dari tanda tangan: subjek sertifikat penandatanganan untuk tanda tangan keyless, atau keyed:sha256: diikuti SHA-256 dari teks PEM kunci publik yang di-pin untuk tanda tangan keyed.
issuerstringtidakPenerbit OIDC terverifikasi untuk tanda tangan keyless. Kosong untuk tanda tangan keyed.
modestring (enum)yaMode verifikasi yang menerima tanda tangan. Nilai yang diizinkan: "keyless", "keyed"

Properti tambahan tidak diizinkan.