prpm-dbp 0.2.0 → 0.2.2

package/README.md

@@ -20,30 +20,102 @@ abad  [a.bad]  Jawi: ابد
 
 Satu kamus rumi ke Jawi yang dijana automatik dari dokumen KPM diperiksa dengan alat ini. Antara yang dijumpai:
 
-| kata | dalam glosari | PRPM |
+| kata | dalam glosari | sebenarnya |
 |---|---|---|
-| abad | ابعاض | ابد |
-| ahzab | اية | tiada entri |
+| abad | ابعاض | ابد — ejaan itu milik `ab-ad`, perkataan lain |
+| ahzab | اية | bukan kata Melayu langsung, nama surah Arab |
+
+Dua jenis kesilapan berbeza. Yang pertama datang daripada menormalkan sempang semasa import, lalu menggabungkan dua entri. Yang kedua daripada memasukkan nama khas Arab ke dalam kamus Melayu, kemudian mengunci ejaan yang bukan miliknya.
 
 Glosari itu dibina dengan mengikis dokumen kurikulum, bukan disemak seorang demi seorang. Kesilapan seperti ini senyap sehingga ada orang yang baca Jawi menyemaknya.
 
 ## Pasang
 
-Tidak perlu pasang apa-apa untuk guna:
+Ada tiga cara, ikut apa yang anda mahu.
+
+### 1. Cuba tanpa pasang
 
 ```bash
 npx prpm-dbp lookup sekolah
 ```
 
-Untuk pasang sebagai skill Claude Code:
+Tiada apa yang dipasang. Sesuai untuk semakan sekali-sekala.
+
+### 2. Sebagai skill Claude Code (disyorkan)
 
 ```bash
-npx prpm-dbp install          # salin ke ~/.claude/skills/prpm-dbp
-npx prpm-dbp install --link   # symlink, untuk pembangun
+npx skills add afu-it/prpm-dbp -g
+```
+
+Ini memasang ke `~/.agents/skills/prpm-dbp` dan membuat symlink ke direktori skill agen anda, jadi Claude Code menemuinya sendiri. Ia juga direkod dalam fail kunci, yang membuatkan kemas kini kemudian menjadi satu arahan.
+
+Tanggalkan `-g` untuk memasang ke projek semasa sahaja, bukan ke seluruh sistem.
+
+Jika satu agen dalam senarai gagal (contohnya "PromptScript does not support global skill installation"), agen lain tetap dipasang. Untuk menyasarkan satu agen sahaja:
+
+```bash
+npx skills add afu-it/prpm-dbp -g -a claude
+```
+
+### 3. Sebagai dependency projek
+
+```bash
+npm install prpm-dbp
+```
+
+```js
+import { lookup, loadCache, saveCache } from 'prpm-dbp'
 ```
 
 Perlu Node 18 ke atas. Tiada dependency.
 
+## Kemas kini
+
+Jika dipasang melalui `npx skills`:
+
+```bash
+npx skills update prpm-dbp -g -y
+```
+
+Atau kemas kini semua skill sekali gus:
+
+```bash
+npx skills update -g -y
+```
+
+Jika dipasang sebagai dependency: `npm update prpm-dbp`.
+
+Untuk `npx prpm-dbp`, tiada kemas kini diperlukan. npx mengambil versi terkini setiap kali.
+
+Semak versi yang sedang dipasang:
+
+```bash
+npx skills list | grep prpm-dbp
+npm view prpm-dbp version
+```
+
+## Untuk penyelenggara
+
+Sunting basecode, bukan salinan yang dipasang. Salinan itu ditulis ganti pada kemas kini berikutnya.
+
+```bash
+# 1. sunting, uji
+npm test
+
+# 2. hantar
+git add -A && git commit -m "..." && git push
+
+# 3. naikkan versi dan lepaskan
+npm version patch
+git push origin main --follow-tags
+```
+
+Langkah ketiga mencetuskan GitHub Actions, yang menerbitkan ke npm melalui Trusted Publishing. Tiada token disimpan, dan pakej dapat kenyataan provenance bertandatangan.
+
+Gunakan `npm version` dan bukan menyunting `package.json` dengan tangan. Ia menghasilkan tag beranotasi; `git push --follow-tags` melangkau tag ringan secara senyap, dan pelepasan anda tidak akan berlaku.
+
+Pengguna kemudian menarik versi baharu dengan `npx skills update`.
+
 ## Perintah
 
 | Perintah | Fungsi |

package/package.json

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