prpm-dbp 0.10.1 → 0.11.0

package/README.md

@@ -134,6 +134,8 @@ Pengguna kemudian menarik versi baharu dengan `npx skills update`.
 
 Pilihan: `--refresh`, `--had <n>`, `--delay <ms>`, `--json`, `--cepat`, `--pedoman`.
 
+`--luar-talian` tidak pernah menyentuh rangkaian. Wajib untuk laluan permintaan aplikasi: dokumen penuh dari cache mengambil 0.19 saat, manakala satu perkataan baharu daripada PRPM mengambil beberapa saat.
+
 `--pedoman` membenarkan penjanaan imbuhan menurut peraturan DBP apabila kamus tiada jawapan. Ketepatannya diukur 88-98% terhadap 66,000 perkataan sebenar, jadi ia mati secara lalai dan hasilnya sentiasa ditanda.
 
 ## Guna sebagai library

package/SKILL.md

@@ -237,6 +237,26 @@ Dua puluh dua kes kabur yang tinggal itu sah: `قلقله` boleh dibaca `qalqala
 | §12 serapan Inggeris | Kamus sudah meliputinya; tiada penjanaan diperlukan. |
 | §16.2, §18 | Tidak memerlukan kod: perbezaannya sudah dikodkan dalam jarak teks Rumi. Ada ujian yang mengunci tingkah laku ini. |
 
+## Menyambung ke aplikasi
+
+Kelajuan diukur pada 406 perkataan:
+
+| Keadaan | Masa |
+|---|---|
+| Semua dari cache | **0.19 saat** |
+| Dua perkataan baharu (perlu rangkaian) | **30.7 saat** |
+
+Perbezaan itu menentukan cara ia disambung. **Dalam laluan permintaan aplikasi, gunakan `--luar-talian` sentiasa.** Mod itu tidak pernah menyentuh rangkaian: perkataan yang tiada dalam cache dilaporkan belum disahkan, bukan diambil secara segerak sambil pengguna menunggu.
+
+Urutan yang disyorkan:
+
+1. **Panaskan cache di luar talian** daripada kosa kata projek anda: `npx prpm-dbp warm senarai.txt`
+2. **Hantar cache itu bersama aplikasi** (salin `~/.cache/prpm-dbp/cache.json`, atau tetapkan `PRPM_CACHE`)
+3. **Jalankan dengan `--luar-talian`** dalam laluan permintaan
+4. **Kumpul medan `belumDisahkan`** dan panaskan cache secara berkala di luar talian
+
+Dengan cara ini pengguna tidak pernah menunggu PRPM, dan PRPM tidak pernah menerima trafik daripada aplikasi anda.
+
 ## Rantai kepercayaan
 
 Setiap ejaan Jawi yang dikeluarkan membawa asal-usulnya. Jangan runtuhkan lapisan ini.

package/bin/cli.js

@@ -34,7 +34,8 @@ const BANTUAN = `prpm-dbp — semak Bahasa Melayu dan Jawi terhadap PRPM DBP
   npx prpm-dbp install [--link]          pasang sebagai Claude Code skill
 
 Pilihan: --refresh  --had <n>  --delay <ms>  --json  --cepat
-         --pedoman  jana imbuhan ikut peraturan DBP (88-98% tepat, hasil ditanda)
+         --pedoman       jana imbuhan ikut peraturan DBP (88-98% tepat, hasil ditanda)
+         --luar-talian   jangan sentuh rangkaian langsung (wajib untuk laluan permintaan app)
 
 Cache: ${CACHE_PATH}
 `
@@ -49,6 +50,7 @@ function huraiArgs(argv) {
     else if (a === '--link') pilihan.link = true
     else if (a === '--cepat') pilihan.cepat = true
     else if (a === '--pedoman') pilihan.pedoman = true
+    else if (a === '--luar-talian') pilihan.luarTalian = true
     else if (a === '--jenis') pilihan.jenis = argv[++i]
     else if (a === '--had') pilihan.had = Number(argv[++i])
     else if (a === '--delay') pilihan.delay = Number(argv[++i])
@@ -79,7 +81,12 @@ async function main() {
   }
 
   const cache = await loadCache()
-  const opts = { refresh: pilihan.refresh, delay: pilihan.delay, onProgress: progres }
+  const opts = {
+    refresh: pilihan.refresh,
+    delay: pilihan.delay,
+    onProgress: progres,
+    luarTalian: pilihan.luarTalian,
+  }
 
   switch (perintah) {
     case 'lookup': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm-dbp",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Semak ejaan Bahasa Melayu dan Jawi terhadap PRPM Dewan Bahasa dan Pustaka. CLI dan skill untuk AI agent.",
   "keywords": [
     "bahasa-melayu",

package/src/prpm.js

@@ -130,11 +130,25 @@ export async function fetchPage(kata, { timeout = 20000 } = {}) {
 
 const tidur = (ms) => new Promise((r) => setTimeout(r, ms))
 
-export async function lookup(kata, cache, { refresh = false, delay = 400, perluPenuh = false } = {}) {
+export async function lookup(
+  kata,
+  cache,
+  { refresh = false, delay = 400, perluPenuh = false, luarTalian = false } = {},
+) {
   const key = String(kata).trim().toLowerCase()
   if (!key) return null
 
   const simpanan = cache[key]
+
+  // Mod luar talian TIDAK PERNAH menyentuh rangkaian. Ini wajib untuk
+  // laluan permintaan aplikasi: satu perkataan yang belum dicache mengambil
+  // beberapa saat, manakala keseluruhan dokumen dari cache mengambil 0.2
+  // saat. Perkataan yang tiada dalam cache dilaporkan belum disahkan,
+  // bukan diambil secara segerak sambil pengguna menunggu.
+  if (luarTalian) {
+    if (simpanan) return { ...simpanan, dariCache: true }
+    return { kata: key, dijumpai: false, jawi: null, jawiVarian: [], entri: [], nota: 'tiada dalam cache (mod luar talian)', url: `${BASE_URL}?keyword=${encodeURIComponent(key)}` }
+  }
   // Rekod benih membawa ejaan sahaja, tanpa definisi, supaya pakej kekal
   // kecil. Bila pemanggil betul-betul perlukan definisi, ambil semula.
   const cukup = simpanan && !(perluPenuh && simpanan.ringkas)