dsh-paper-search 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -4,7 +4,7 @@
 
 | dsh-paper-search | DeepSeek Harness | Diuji pada |
 |---|---|---|
-| 0.1.2 | 0.1.7-rc.2 | 28 Sep 2026, Windows, Node 24 |
+| 0.1.3 | 0.1.7-rc.2 | 28 Sep 2026, Windows, Node 24 |
 | ~~0.1.0~~ | — | **JANGAN DIPAKAI — plugin gagal dimuat, lihat 0.1.1** |
 
 Paket ini tidak memakai API internal DSH selain `ctx.tools.register` dan
@@ -12,6 +12,40 @@ Paket ini tidak memakai API internal DSH selain `ctx.tools.register` dan
 berjalan di profil ini (`dsh-search-cascade`), jadi titik patahnya sama dan sudah
 diketahui.
 
+## [0.1.3] - 2026-09-28
+
+### Fixed
+
+- **Portal Indonesia melaporkan GAGAL padahal hasilnya cuma KOSONG.** Ketiga
+  konektor Indonesia melempar `markup ... berubah` setiap kali penanda hasil tidak
+  ditemukan — termasuk saat portal itu **sah-sah saja menjawab nol hasil**. Itu
+  keliru dengan arah berlawanan dari prinsip paket ini: melaporkan kegagalan di
+  tempat yang seharusnya kosong sama menyesatkannya dengan menyembunyikan
+  kegagalan.
+
+  Ketahuan dari **uji orkestrasi**, bukan dari uji unit: `Sinta` gagal untuk
+  `"literasi digital remaja"` padahal berhasil untuk `"pendidikan karakter"`.
+  Setelah halaman kosong dan halaman ber-hasil dibandingkan, ternyata ketiga
+  portal punya penanda nol-hasilnya sendiri:
+
+  | Portal | Penanda nol hasil | Halaman kosong |
+  |---|---|---|
+  | Garuda | `Found 0 documents` | 11.181 huruf |
+  | Sinta | header `Results for "<q>"` tetap ada, tautan profil nol | 34.063 huruf |
+  | IOS | `No Results!` | 23.041 huruf |
+
+  `portalNolHasil()` sekarang membedakan **tiga** kemungkinan — nol hasil (→ `[]`),
+  markup berubah (→ error), dan diblokir (→ error) — bukan dua.
+
+  Akibatnya untuk Sinta: kueri spesifik yang memang nol hasil tidak lagi tampak
+  seperti kerusakan. Sinta mendaftar **jurnal**, bukan artikel, jadi nol hasil itu
+  wajar dan sekarang dilaporkan sebagai nol.
+
+### Added
+
+- 3 asersi regresi: kueri omong kosong ke ketiga portal Indonesia harus
+  menghasilkan **0 hasil tanpa error**.
+
 ## [0.1.2] - 2026-09-28
 
 ### Fixed

package/lib/sources.js

@@ -459,6 +459,29 @@ function ambilHtml(html, pola, batas) {
   return out;
 }
 
+/**
+ * Saat penanda hasil tidak ditemukan, ada TIGA kemungkinan yang BERBEDA:
+ *   1. portal menjawab "nol hasil"  -> `[]`, itu hasil yang SAH
+ *   2. markup portal berubah        -> error
+ *   3. portal memblokir/mengalihkan -> error
+ *
+ * Sebelum ini (1) dan (2) diperlakukan sama, sehingga portal yang benar-benar
+ * kosong dilaporkan sebagai **GAGAL**. Itu keliru dengan arah berlawanan:
+ * melaporkan kegagalan padahal hasilnya sah-sah saja kosong — sama
+ * menyesatkannya dengan menyembunyikan kegagalan.
+ *
+ * Penanda nol-hasil diukur 28 Sep 2026 memakai kueri omong kosong, lalu
+ * dibandingkan dengan kueri yang ada hasilnya:
+ *
+ *   Garuda : "Found 0 documents"                (halaman 11.181 huruf)
+ *   Sinta  : header `Results for "<q>"` tetap ada, tautan profil nol
+ *            (halaman 34.063 huruf) — Sinta TIDAK menulis pesan kosong
+ *   IOS    : "No Results!"                      (halaman 23.041 huruf)
+ */
+function portalNolHasil(html, ...penanda) {
+  return penanda.some((re) => re.test(html));
+}
+
 const GARUDA_BASE = 'https://garuda.kemdiktisaintek.go.id';
 
 /** Garuda — indeks artikel jurnal Indonesia (Kemdiktisaintek). */
@@ -472,9 +495,10 @@ async function garuda(query, { rows }) {
     journal: 'Garuda (jurnal Indonesia)',
     openAccess: true,
   })).filter((p) => p.title);
-  // Penguraian HTML yang tidak menemukan satu pun pola = kemungkinan markup
-  // berubah. Laporkan sebagai error, JANGAN sebagai "tidak ada hasil".
+  // Penguraian HTML yang tidak menemukan satu pun pola bisa berarti DUA hal yang
+  // berlawanan. Bedakan: Garuda menulis "Found 0 documents" saat memang kosong.
   if (hasil.length === 0 && !/title-article/.test(html)) {
+    if (portalNolHasil(html, /Found\s+0\s+document/i)) return [];
     throw new Error('markup Garuda berubah: penanda "title-article" tidak ditemukan lagi');
   }
   return hasil;
@@ -491,7 +515,12 @@ async function sinta(query, { rows }) {
     journal: 'Sinta (jurnal terakreditasi)',
     openAccess: true,
   })).filter((p) => p.title);
+  // Sinta TIDAK menulis pesan kosong — ia tetap menampilkan header
+  // `Results for "<kueri>"` lalu daftar yang kosong. Jadi header itu yang
+  // dipakai sebagai bukti "halaman dimuat, hasilnya memang nol".
+  // (Sinta mendaftar JURNAL, bukan artikel, jadi kueri spesifik memang sering nol.)
   if (hasil.length === 0 && !/journals\/profile\//.test(html)) {
+    if (portalNolHasil(html, /Results for/i)) return [];
     throw new Error('markup Sinta berubah: tautan "journals/profile" tidak ditemukan lagi');
   }
   return hasil;
@@ -509,6 +538,7 @@ async function ios(query, { rows }) {
     openAccess: true,
   })).filter((p) => p.title);
   if (hasil.length === 0 && !/class="title"/.test(html)) {
+    if (portalNolHasil(html, /No Results!/i)) return [];
     throw new Error('markup IOS berubah: tautan hasil ber-class "title" tidak ditemukan lagi');
   }
   return hasil;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-paper-search",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Literature search for DeepSeek Harness: thirteen international sources (Crossref, OpenAlex, DOAJ, Europe PMC, PubMed, PubMed Central, arXiv, Semantic Scholar, CORE, Zenodo, HAL, IACR ePrint, Unpaywall) and three Indonesian journal portals (Garuda, Sinta, IOS OneSearch), all native HTTP with no external CLI required, plus a status tool that reports which sources answer and which credentials are configured.",
   "license": "MIT",
   "type": "module",