dsh-paper-search 0.1.2 → 0.1.4

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.4 | 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,104 @@ 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.4] - 2026-09-28
+
+Empat perbaikan yang **dipelajari dari Issues & PR repo upstream
+`openags/paper-search-mcp`** — masing-masing menunjuk issue-nya, bukan dikarang.
+
+### Fixed
+
+- **PubMed & PMC diurutkan menurut TANGGAL, bukan relevansi** (upstream issue #29).
+  `esearch` tidak pernah diberi `sort`, dan bawaan PubMed adalah tanggal-terbaru.
+  Untuk kueri luas itu buruk: yang muncul paper baru yang tangensial, bukan paper
+  fondasional. Sekarang memakai `sort=relevance`.
+
+  Terukur pada `"ocular microbiome"`: puncaknya berubah dari paper 2026 yang
+  tangensial menjadi *The Microbiome, Ocular Surface, and Corneal Disorders*
+  (2023) dan *The Ocular Microbiome in Stevens-Johnson Syndrome* (2021) — persis
+  seperti yang diprediksi issue itu.
+
+- **Nama penulis bisa terpecah PER HURUF** (upstream issue #109/#110/#112).
+  Konektor mengoper **string** ke medan bertipe daftar, lalu pemakainya
+  meng-`join` string itu — `"TAN, Kwan Hong"` menjadi
+  `"T; A; N; ,;  ; K; w; a; n; …"`. Ditambahkan `daftarPenulis()` yang menerima
+  string, array string, array objek (`{name}`, `{display_name}`,
+  `{given,family}`), bentuk bersarang OpenAlex (`{author:{display_name}}`), dan
+  medan yang hilang — **tidak pernah melempar**.
+
+  `daftarPenulis()` **sengaja TIDAK memecah pada koma**: `"TAN, Kwan Hong"`
+  adalah SATU penulis. Hanya titik koma yang jadi pemisah. Konektor yang
+  sumbernya memang memakai daftar berpemisah koma (DOAJ `authorString`, IACR)
+  memecahnya lebih dulu, baru menormalkan.
+
+- **arXiv: kueri multi-kata kini presisi dulu, longgar sebagai cadangan**
+  (upstream issue #6/#101/#113). Bentuk `all:kata1 AND all:kata2` dipakai lebih
+  dulu; hanya kalau kosong, bentuk longgar dijalankan.
+
+  **Kenapa TIDAK sekadar meniru perbaikan upstream** yang mengutip frasa:
+  **diukur 28 Sep 2026** — untuk kueri Indonesia `"literasi digital"`, bentuk
+  terkutip dan bentuk AND sama-sama memberi **0 hasil**, sedangkan bentuk longgar
+  memberi **50**. arXiv adalah korpus berbahasa Inggris; mengutip membabi-buta
+  akan menghapus SELURUH hasil untuk topik non-Inggris. Jadi yang dipakai adalah
+  presisi-**dengan**-cadangan.
+
+- **HTTP 406 arXiv kadang masih membawa Atom feed yang SAH** (upstream issue #121).
+  Sebelumnya 406 langsung dianggap gagal. Sekarang isi balasannya dicoba diurai
+  lebih dulu — issue itu melaporkan 406 dengan body 5250 byte berisi 2 entri sah.
+  Untuk itu `getText()` kini menyimpan `err.bodyPenuh` terpisah dari `err.body`
+  (yang tetap pendek untuk pesan galat).
+
+### Added
+
+- **15 asersi regresi baru**: 9 bentuk penulis (termasuk kasus bug #109), 3 bentuk
+  kueri arXiv, penjaga `sort=relevance`, dan penjaga penyelamatan body 406.
+
+### Catatan — yang sudah ada dan TIDAK perlu diubah
+
+Diperiksa terhadap issue upstream, dan ternyata sudah tertangani sejak 0.1.0:
+timeout 25 detik per permintaan (issue #55), pelaporan sumber tidak dikenal
+(issue #105), dedup lintas sumber (issue #33), dan prinsip pelaporan kegagalan
+alih-alih "0 hasil" (issue #100/#111).
+
+**PR upstream #97** (`feat: DeepSeek Harness (dsh) integration`) memakai jalur
+**MCP bridge** yang mengekspos **57 tool** — persis rute yang kami buang karena
+biayanya **12.342 token per permintaan**. Plugin ini mendaftarkan **2 tool**.
+Jadi PR itu mengukuhkan keputusan kami, bukan mengubahnya.
+
+## [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

@@ -34,7 +34,11 @@ async function getText(url, { headers = {}, accept, timeoutMs = TIMEOUT_MS } = {
     if (!res.ok) {
       const err = new Error(`HTTP ${res.status}`);
       err.status = res.status;
+      // `body` untuk PESAN (pendek). `bodyPenuh` disimpan TERPISAH supaya isi
+      // balasan yang masih berguna bisa diselamatkan — terukur di arXiv:
+      // HTTP 406 kadang justru membawa Atom feed yang SAH (issue #121).
       err.body = teks.slice(0, 160).replace(/\s+/g, ' ');
+      err.bodyPenuh = teks.slice(0, 512 * 1024);
       throw err;
     }
     return teks;
@@ -66,6 +70,47 @@ function potong(s, n) {
   return t.length > n ? `${t.slice(0, n - 1)}…` : t;
 }
 
+/**
+ * Normalkan daftar penulis dari bentuk apa pun menjadi ARRAY nama. Tidak pernah
+ * melempar; selalu mengembalikan array (boleh kosong).
+ *
+ * Ini jawaban atas tiga bug upstream yang sudah benar-benar terjadi
+ * (issue #109, #110, #112): konektor mengoper **string** ke medan yang bertipe
+ * daftar, lalu pemakainya meng-`join` string itu sehingga setiap nama terpecah
+ * per huruf — `"TAN, Kwan Hong"` menjadi `"T; A; N; ,;  ; K; w; a; n; …"`.
+ * Bentuk lain yang juga muncul di lapangan: array objek (`{name}`,
+ * `{display_name}`, `{given, family}`), dan medan yang hilang sama sekali.
+ *
+ * SENGAJA TIDAK memecah pada KOMA: `"TAN, Kwan Hong"` adalah SATU penulis, dan
+ * memecahnya justru merusak nama. Hanya titik koma yang dipakai sebagai pemisah.
+ */
+export function daftarPenulis(x) {
+  const keluaran = [];
+  const tambah = (v) => {
+    if (v === null || v === undefined) return;
+    if (Array.isArray(v)) { v.forEach(tambah); return; }
+    if (typeof v === 'object') {
+      // Bentuk bersarang yang nyata di lapangan: OpenAlex membungkus penulis
+      // sebagai `{ author: { display_name } }`.
+      if (v.author) { tambah(v.author); return; }
+      tambah(v.name ?? v.display_name ?? v.raw_author_name ?? v.fullName
+        ?? [v.given, v.family].filter(Boolean).join(' '));
+      return;
+    }
+    if (typeof v === 'string') {
+      for (const bagian of v.split(';')) {
+        const b = bersihTeks(bagian);
+        if (b) keluaran.push(b);
+      }
+      return;
+    }
+    const s = bersihTeks(v);
+    if (s) keluaran.push(s);
+  };
+  tambah(x);
+  return keluaran.slice(0, 50);
+}
+
 /** DOI dinormalkan tanpa awalan URL — supaya dedup bekerja. */
 function normDoi(doi) {
   if (!doi) return null;
@@ -132,7 +177,7 @@ function buatPaper(p) {
   const doi = normDoi(p.doi);
   return {
     title: potong(runtuhkanJudul(bersihTeks(p.title) ?? ''), 300),
-    authors: Array.isArray(p.authors) ? p.authors.map(bersihTeks).filter(Boolean).slice(0, 15) : [],
+    authors: daftarPenulis(p.authors).slice(0, 15),
     year: Number.isFinite(Number(p.year)) && Number(p.year) > 1500 ? Number(p.year) : null,
     source: p.source,
     doi,
@@ -154,7 +199,7 @@ async function crossref(query, { rows, email }) {
   const j = await getJson(u.toString());
   return (j?.message?.items ?? []).map((it) => buatPaper({
     title: it.title?.[0],
-    authors: (it.author ?? []).map((a) => [a.given, a.family].filter(Boolean).join(' ') || a.name),
+    authors: daftarPenulis(it.author),
     year: it.issued?.['date-parts']?.[0]?.[0],
     source: 'crossref',
     doi: it.DOI,
@@ -180,7 +225,7 @@ async function openalex(query, { rows, email }) {
   const j = await getJson(u.toString());
   return (j?.results ?? []).map((w) => buatPaper({
     title: w.title,
-    authors: (w.authorships ?? []).map((a) => a.author?.display_name),
+    authors: daftarPenulis(w.authorships),
     year: w.publication_year,
     source: 'openalex',
     doi: w.doi,
@@ -198,7 +243,7 @@ async function doaj(query, { rows }) {
     const b = r.bibjson ?? {};
     return buatPaper({
       title: b.title,
-      authors: (b.author ?? []).map((a) => a.name),
+      authors: daftarPenulis(b.author),
       year: b.year,
       source: 'doaj',
       doi: (b.identifier ?? []).find((x) => x.type === 'doi')?.id,
@@ -215,7 +260,10 @@ async function europepmc(query, { rows }) {
   const j = await getJson(u);
   return (j?.resultList?.result ?? []).map((r) => buatPaper({
     title: r.title,
-    authors: r.authorString ? r.authorString.split(/,\s*/) : [],
+    // DOAJ memberi `authorString` yang MEMANG dipisah koma ("A, B, C"), jadi
+    // pemecahan dilakukan di sini dulu — `daftarPenulis` sendiri sengaja tidak
+    // memecah koma, supaya "TAN, Kwan Hong" (satu penulis) tidak rusak.
+    authors: daftarPenulis((r.authorString ?? '').split(/,\s*/)),
     year: r.pubYear,
     source: 'europepmc',
     doi: r.doi,
@@ -229,7 +277,7 @@ async function europepmc(query, { rows }) {
 async function pubmed(query, { rows }) {
   // E-utilities butuh DUA panggilan: esearch (id) lalu esummary (metadata).
   const base = 'https://eutils.ncbi.nlm.nih.gov/entrez/eutils';
-  const s = await getJson(`${base}/esearch.fcgi?db=pubmed&retmode=json&retmax=${rows}&term=${encodeURIComponent(query)}`);
+  const s = await getJson(`${base}/esearch.fcgi?db=pubmed&retmode=json&retmax=${rows}&sort=relevance&term=${encodeURIComponent(query)}`);
   const ids = s?.esearchresult?.idlist ?? [];
   if (ids.length === 0) return [];
   const d = await getJson(`${base}/esummary.fcgi?db=pubmed&retmode=json&id=${ids.join(',')}`);
@@ -238,7 +286,7 @@ async function pubmed(query, { rows }) {
     if (!r) return null;
     return buatPaper({
       title: r.title,
-      authors: (r.authors ?? []).map((a) => a.name),
+      authors: daftarPenulis(r.authors),
       year: String(r.pubdate ?? '').slice(0, 4),
       source: 'pubmed',
       doi: (r.articleids ?? []).find((a) => a.idtype === 'doi')?.value,
@@ -251,32 +299,89 @@ async function pubmed(query, { rows }) {
 // arXiv meminta TIDAK LEBIH dari 1 permintaan / 3 detik (TOU mereka). Karena
 // sumber dijalankan paralel, permintaan arXiv diserialkan sendiri di sini.
 let arxivTerakhir = 0;
-async function arxiv(query, { rows }) {
+async function arxivTunggu() {
   const jeda = 3000 - (Date.now() - arxivTerakhir);
   if (jeda > 0) await new Promise((r) => setTimeout(r, jeda));
+  arxivTerakhir = Date.now();
+}
+
+/** Uraikan Atom feed arXiv menjadi daftar paper. */
+function uraikanArxiv(xml, rows) {
+  const out = [];
+  for (const m of xml.matchAll(/<entry>([\s\S]*?)<\/entry>/g)) {
+    const blok = m[1];
+    const ambil = (tag) => {
+      const r = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`).exec(blok);
+      return r ? r[1] : null;
+    };
+    out.push(buatPaper({
+      title: ambil('title'),
+      authors: [...blok.matchAll(/<author>\s*<name>([^<]+)<\/name>/g)].map((x) => x[1]),
+      year: String(ambil('published') ?? '').slice(0, 4),
+      source: 'arxiv',
+      doi: ambil('arxiv:doi'),
+      url: ambil('id'),
+      journal: 'arXiv (preprint)',
+      abstract: ambil('summary'),
+      openAccess: true,
+    }));
+  }
+  return out.filter((p) => p.title).slice(0, rows);
+}
+
+/**
+ * Ambil Atom feed arXiv, dengan DUA perbaikan yang diambil dari issue upstream:
+ *
+ * 1. **HTTP 406 kadang masih membawa feed yang SAH** (issue #121). Dilaporkan
+ *    terukur: 406 dengan body 5250 byte ber-`Content-Type: application/atom+xml`
+ *    berisi 2 entri. Jadi 406 tidak langsung digagalkan — isinya dicoba dibaca
+ *    dulu. Kalau body-nya benar-benar kosong, barulah itu kegagalan sungguhan.
+ * 2. **Kueri multi-kata tanpa kutip bisa MENGGANTUNG** di backend arXiv
+ *    (issue #101). Karena itu bentuk presisi dipakai lebih dulu (lihat `arxiv`).
+ */
+async function ambilArxiv(kueri, rows) {
+  const u = `https://export.arxiv.org/api/query?search_query=${encodeURIComponent(kueri)}&max_results=${rows}&sortBy=relevance`;
   try {
-    const u = `https://export.arxiv.org/api/query?search_query=${encodeURIComponent(`all:${query}`)}&max_results=${rows}&sortBy=relevance`;
-    const xml = await getText(u, { accept: 'application/atom+xml' });
-    const out = [];
-    for (const m of xml.matchAll(/<entry>([\s\S]*?)<\/entry>/g)) {
-      const blok = m[1];
-      const ambil = (tag) => {
-        const r = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`).exec(blok);
-        return r ? r[1] : null;
-      };
-      out.push(buatPaper({
-        title: ambil('title'),
-        authors: [...blok.matchAll(/<author>\s*<name>([^<]+)<\/name>/g)].map((x) => x[1]),
-        year: String(ambil('published') ?? '').slice(0, 4),
-        source: 'arxiv',
-        doi: ambil('arxiv:doi'),
-        url: ambil('id'),
-        journal: 'arXiv (preprint)',
-        abstract: ambil('summary'),
-        openAccess: true,
-      }));
-    }
-    return out.filter((p) => p.title);
+    return uraikanArxiv(await getText(u, { accept: 'application/atom+xml' }), rows);
+  } catch (e) {
+    if (e.status === 406 && /<entry>/.test(e.bodyPenuh ?? '')) return uraikanArxiv(e.bodyPenuh, rows);
+    throw e;
+  }
+}
+
+/**
+ * Bentuk kueri arXiv. Presisi dulu (`all:kata1 AND all:kata2`), longgar
+ * (`all:kata1 kata2`) sebagai cadangan.
+ *
+ * Kenapa TIDAK sekadar meniru perbaikan upstream yang mengutip frasa:
+ * **diukur 28 Sep 2026** — untuk kueri Indonesia `"literasi digital"`, bentuk
+ * terkutip dan bentuk AND sama-sama memberi **0 hasil**, sedangkan bentuk
+ * longgar memberi **50**. arXiv memang korpus berbahasa Inggris. Mengutip buta
+ * akan menghapus SELURUH hasil untuk topik non-Inggris, jadi yang dipakai adalah
+ * presisi-dengan-cadangan, bukan kutip-membabi-buta.
+ */
+export function kueriArxiv(query, presisi) {
+  const kata = String(query).trim().split(/\s+/).filter(Boolean);
+  if (kata.length === 0) return `all:${query}`;
+  if (kata.length === 1) return `all:${kata[0]}`;
+  return presisi ? kata.map((k) => `all:${k}`).join(' AND ') : `all:${kata.join(' ')}`;
+}
+
+async function arxiv(query, { rows }) {
+  await arxivTunggu();
+  let hasil;
+  try {
+    hasil = await ambilArxiv(kueriArxiv(query, true), rows);
+  } finally {
+    arxivTerakhir = Date.now();
+  }
+  if (hasil.length > 0) return hasil;
+
+  // Cadangan longgar. Hanya dijalankan kalau bentuk presisi benar-benar kosong,
+  // supaya permintaan arXiv tetap hemat (TOU mereka: 1 permintaan / 3 detik).
+  await arxivTunggu();
+  try {
+    return await ambilArxiv(kueriArxiv(query, false), rows);
   } finally {
     arxivTerakhir = Date.now();
   }
@@ -287,7 +392,7 @@ async function semantic(query, { rows, apiKey }) {
   const j = await getJson(u, apiKey ? { headers: { 'x-api-key': apiKey } } : {});
   return (j?.data ?? []).map((d) => buatPaper({
     title: d.title,
-    authors: (d.authors ?? []).map((a) => a.name),
+    authors: daftarPenulis(d.authors),
     year: d.year,
     source: 'semantic',
     doi: d.externalIds?.DOI,
@@ -307,7 +412,7 @@ async function pmc(query, { rows }) {
   // PubMed Central memakai E-utilities yang sama dengan PubMed:
   // esearch (id) lalu esummary (metadata).
   const base = 'https://eutils.ncbi.nlm.nih.gov/entrez/eutils';
-  const s = await getJson(`${base}/esearch.fcgi?db=pmc&retmode=json&retmax=${rows}&term=${encodeURIComponent(query)}`);
+  const s = await getJson(`${base}/esearch.fcgi?db=pmc&retmode=json&retmax=${rows}&sort=relevance&term=${encodeURIComponent(query)}`);
   const ids = s?.esearchresult?.idlist ?? [];
   if (ids.length === 0) return [];
   const d = await getJson(`${base}/esummary.fcgi?db=pmc&retmode=json&id=${ids.join(',')}`);
@@ -317,7 +422,7 @@ async function pmc(query, { rows }) {
     const pmcid = (r.articleids ?? []).find((a) => a.idtype === 'pmcid')?.value ?? `PMC${id}`;
     return buatPaper({
       title: r.title,
-      authors: (r.authors ?? []).map((a) => a.name),
+      authors: daftarPenulis(r.authors),
       year: String(r.pubdate ?? '').slice(0, 4),
       source: 'pmc',
       doi: (r.articleids ?? []).find((a) => a.idtype === 'doi')?.value,
@@ -341,7 +446,7 @@ async function core(query, { rows, coreApiKey }) {
   });
   return (j?.results ?? []).map((c) => buatPaper({
     title: c.title,
-    authors: (c.authors ?? []).map((a) => a.name),
+    authors: daftarPenulis(c.authors),
     year: c.yearPublished,
     source: 'core',
     doi: c.doi,
@@ -356,7 +461,7 @@ async function zenodo(query, { rows }) {
   const j = await getJson(`https://zenodo.org/api/records?q=${encodeURIComponent(query)}&size=${rows}`);
   return (j?.hits?.hits ?? []).map((z) => buatPaper({
     title: z.metadata?.title,
-    authors: (z.metadata?.creators ?? []).map((c) => c.name),
+    authors: daftarPenulis(z.metadata?.creators),
     year: String(z.metadata?.publication_date ?? '').slice(0, 4),
     source: 'zenodo',
     doi: z.metadata?.doi ?? z.doi,
@@ -372,7 +477,7 @@ async function hal(query, { rows }) {
   const j = await getJson(`https://api.archives-ouvertes.fr/search/?q=${encodeURIComponent(query)}&wt=json&rows=${rows}&fl=${fl}`);
   return (j?.response?.docs ?? []).map((a) => buatPaper({
     title: pertama(a.title_s),
-    authors: a.authFullName_s ?? [],
+    authors: daftarPenulis(a.authFullName_s),
     year: a.producedDateY_i,
     source: 'hal',
     doi: pertama(a.doiId_s),
@@ -400,7 +505,7 @@ async function iacr(query, { rows }) {
     const id = tautan[i][1];
     out.push(buatPaper({
       title: ambil(/<strong>([\s\S]*?)<\/strong>/),
-      authors: (ambil(/<span class="fst-italic">([\s\S]*?)<\/span>/) ?? '').split(/,\s*/).filter(Boolean),
+      authors: daftarPenulis((ambil(/<span class="fst-italic">([\s\S]*?)<\/span>/) ?? '').split(/,\s*/)),
       year: id.slice(0, 4),
       source: 'iacr',
       url: `https://eprint.iacr.org/${id}`,
@@ -430,7 +535,7 @@ async function unpaywall(query, { rows, email }) {
   const oa = j.best_oa_location ?? null;
   const hasil = buatPaper({
     title: j.title,
-    authors: (j.z_authors ?? []).map((a) => a.raw_author_name ?? [a.given, a.family].filter(Boolean).join(' ')),
+    authors: daftarPenulis(j.z_authors),
     year: j.year,
     source: 'unpaywall',
     doi: j.doi ?? doi,
@@ -459,6 +564,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 +600,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 +620,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 +643,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.4",
   "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",