Jelajahi dokumentasi
Apa itu Review Capsule?
Sebuah Review Capsule adalah rekaman tinjauan keamanan yang terstruktur dan portabel. Alih-alih bergantung pada percakapan sementara atau keluaran model yang tidak terstruktur, Linmas menghasilkan paket bukti eksplisit yang terikat pada byte input yang dievaluasi.
Review Capsule membuktikan apa yang dievaluasi, aturan kebijakan yang dijalankan, dan temuan yang dihasilkan. Capsule tidak menyatakan perangkat lunak kebal terhadap serangan atau menggantikan penilaian peninjau manusia yang bertanggung jawab.
Komponen Utama Capsule
| Kolom | Deskripsi | Tujuan |
|---|---|---|
| Identitas Input | Hash SHA-256 dari payload input persis yang ditinjau | Memastikan bukti tinjauan tidak dapat ditukar dengan artefak yang belum ditinjau |
| Temuan Ternormalisasi | Deskripsi risiko, tingkat keparahan, dan pernyataan dampak yang terstruktur | Mengurangi ambiguitas model dan mengikuti skema defensif yang ketat |
| Keputusan Kebijakan | Hasil deterministik, misalnya PASS atau BLOCKED) | Dievaluasi oleh kode deterministik terhadap aturan ambang batas yang dikonfigurasi |
| Penanda Tinjauan Manusia | Selalu bernilai true (humanReviewRequired) | Menegakkan tanggung jawab manusia atas seluruh keputusan keamanan |
| Metadata Eksekusi | Waktu, versi skill, dan lingkungan eksekusi (pemutaran ulang offline atau mesin langsung) | Menyediakan jejak audit untuk kepatuhan dan tinjauan sejawat |
Mengapa Pengikatan Input SHA-256 Penting
Alat pemrograman AI sering mengubah berkas secara bertahap. Pengikatan capsule pada digest SHA-256 input mencegah penggantian diam-diam: jika kode berubah setelah tinjauan selesai, digest tidak lagi cocok dan patch terbaru harus ditinjau ulang.
Menggunakan Capsule dalam CI/CD
Review Capsule dapat diarsipkan bersama pull request atau artefak build sebagai rekaman pemeriksaan defensif. Karena formatnya JSON deterministik, pipeline otomatis dapat memeriksa keputusan dan memastikan temuan yang memblokir telah ditangani sebelum deployment.