LogicScope JS

Analisis statis untuk kualitas logika kode JavaScript — bukan sekadar gaya penulisan.

LogicScope JS membaca kode Anda melalui Abstract Syntax Tree (AST), mendeteksi 31 pola kesalahan logika dan kompleksitas, lalu merangkumnya menjadi satu skor kualitas 0–100 yang bisa Anda pantau saat mengetik.

Setiap temuan tidak hanya memberi tahu apa yang salah, tetapi juga mengapa itu bermasalah dan bagaimana memperbaikinya.

Kenapa LogicScope JS?

Linter umumnya menjawab "aturan mana yang dilanggar?". LogicScope JS menjawab "seberapa sehat logika kode ini?".

Instalasi

1. Buka Visual Studio Code
2. Tekan Ctrl+Shift+X untuk membuka panel Extensions
3. Cari LogicScope JS
4. Klik Install

Tidak ada konfigurasi tambahan yang diperlukan.

Memulai dalam 30 Detik

1. Buka berkas JavaScript
Berkas berekstensi .js atau .jsx.

2. Klik ikon LogicScope JS di Activity Bar
Ikon kaca pembesar di sisi kiri layar.

3. Tekan tombol ANALYSIS CORRECTION
Panel akan menampilkan skor kualitas beserta seluruh temuan.

4. Telusuri temuan
Klik teks Ln 12, Col 5 pada temuan mana pun untuk melompat ke lokasinya di editor.

5. Terapkan perbaikan
Centang perbaikan yang diinginkan, lalu tekan REPAIR CODE. Skor akan langsung diperbarui.

Setelah langkah ketiga, analisis berjalan otomatis setiap kali Anda mengetik. Tidak perlu menekan tombol lagi.

Mengenal Panel Analisis

┌────────────────────────────────┐
│ contoh.js            10:42:31  │  ← nama berkas & waktu analisis
│                                │
│ 49 /100 · Kurang               │  ← skor kualitas logika
│ ▓▓▓▓▓▓▓▓▓░░░░░░░░░░            │
│                                │
│  4       2        3            │
│ Error  Warning  Saran          │  ← rekap tingkat keparahan
│                                │
│ TEMUAN (9)                     │
│ ┌────────────────────────────┐ │
│ │ ☑ Pilih semua (6)          │ │  ← seleksi perbaikan massal
│ │ [✔ Hanya aman] [Bersihkan] │ │
│ └────────────────────────────┘ │
│                                │
│ ☑ ❌ LS001 · constant-condition│
│    Kondisi selalu bernilai...  │  ← MASALAH
│    Ln 8, Col 3   [Logika]      │
│    Ekspresi kondisi berupa...  │  ← PENYEBAB
│    💡 Ganti dengan kondisi...  │  ← SARAN
│    ✔ Aman diterapkan otomatis  │
│    ┌──────────────────────┐    │
│    │ total = total + 1000;│    │  ← PRATINJAU PERBAIKAN
│    └──────────────────────┘    │
│                                │
│ ─────────────────────────────  │
│ 🔍 ANALYSIS CORRECTION         │
│ 🔧 REPAIR CODE (3)             │
│ ● LIVE      3 dipilih · aman   │
└────────────────────────────────┘

Memahami Skor Kualitas

Skor dimulai dari 100 dan dikurangi berdasarkan temuan yang ditemukan:

Penalti = (Error × 10) + (Warning × 4) + (Saran × 1)
Skor    = 100 − Penalti   (minimum 0)

Bobot mencerminkan kepastian, bukan besarnya dampak. Temuan Error hampir pasti merupakan bug, sedangkan Saran adalah praktik yang lebih baik.

Tiga Jenis Perbaikan

Ini pembeda utama LogicScope JS. Tidak semua perbaikan sama amannya, jadi setiap usulan diberi klasifikasi risiko:

Contoh klasifikasi Usulan: mengganti == menjadi === memang benar, tetapi bisa mengubah hasil perbandingan jika kode lama mengandalkan konversi tipe. Karena itu tidak diterapkan tanpa persetujuan Anda.

Contoh klasifikasi Manual: pada if (a.stok === a.stok), LogicScope JS tahu perbandingan ini selalu bernilai true — tetapi tidak tahu operand mana yang seharusnya ditulis. Hanya Anda yang tahu.

Daftar Aturan Deteksi

🔴 Logika (13 aturan)

🟡 Kompleksitas (6 aturan)

🔵 Alur Kendali (4 aturan)

⚪ Gaya Penulisan (5 aturan)

⚫ Sintaks (1 aturan)

Analisis Real-Time

Setelah analisis pertama dijalankan, LogicScope JS memantau perubahan kode secara otomatis.

• Indikator hijau berdenyut pada panel dan status bar menandakan mode ini aktif
• Analisis berjalan 500 ms setelah Anda berhenti mengetik, bukan setiap ketukan tombol
• Klik indikator pada status bar untuk menyalakan atau mematikannya

Kalau sedang bekerja pada berkas sangat besar dan terasa berat, matikan mode ini atau naikkan nilai jeda pada pengaturan.

Perintah

Dapat diakses melalui Command Palette (Ctrl+Shift+P):

Perbaikan juga tersedia lewat Quick Fix — arahkan kursor ke baris bermasalah lalu tekan Ctrl+.

Pengaturan

Pertanyaan Umum

Apakah kode saya dikirim ke server?
Tidak. Seluruh analisis berjalan sepenuhnya di komputer Anda, tanpa koneksi internet dan tanpa mengirim data ke mana pun.

Apakah bisa dipakai bersamaan dengan ESLint?
Bisa. Keduanya menggunakan sistem Diagnostic bawaan VS Code, sehingga temuan tampil berdampingan tanpa saling mengganggu.

Kenapa sebagian temuan tidak punya tombol perbaikan?
Karena perbaikannya memerlukan keputusan yang hanya Anda yang tahu jawabannya. Memaksakan perbaikan otomatis pada kasus seperti itu justru berisiko menyembunyikan bug alih-alih memperbaikinya.

Apakah mendukung TypeScript?
Belum. Saat ini hanya JavaScript (.js) dan JSX (.jsx).

Saat mengetik muncul error sintaks sesaat, apakah normal?
Ya. Kode yang sedang diketik sering belum lengkap, sehingga LS000 muncul sebentar lalu hilang sendiri. Naikkan analysisDelay bila terasa mengganggu.

Keterbatasan

LogicScope JS melakukan analisis berbasis AST tanpa data-flow analysis, type inference, maupun symbol table. Konsekuensinya:

• Konstanta tidak dilacak lintas baris — const AKTIF = true; if (AKTIF) tidak terdeteksi sebagai kondisi tetap
• Analisis keterjangkauan hanya berlaku dalam satu blok, belum lintas blok
• Aturan loose-equality tidak memeriksa tipe operand, sehingga bisa memberi peringatan pada perbandingan yang sebenarnya aman

Keterbatasan ini disampaikan secara terbuka agar Anda tahu persis apa yang bisa dan tidak bisa diandalkan dari alat ini.

Lisensi

MIT — lihat berkas LICENSE.