beast-agent 1.9.0 → 2.0.0

package/src/agent/engine.js

@@ -1377,8 +1377,10 @@ class Engine {
 
   /* Beast Code (IDE paneli): VS Code hızında çalışsın diye SECMET prompt.
      OpenCode kodlama disiplini gömülü: bağlam → plan → küçük diff → doğrula.
-     Hafıza embedding araması, skills taraması, kişilik/kural blokları YOK —
-     prompt kısa kalır → ilk token hızlı, tur maliyeti düşük. */
+     GENEL AMAÇLI kodlama ajanı — web/mobil gibi tek stack'e zorlanmaz; stack'i
+     projenin kendi dosyaları belirler. Hafıza embedding araması, skills
+     taraması, kişilik/kural blokları YOK — prompt kısa kalır → ilk token
+     hızlı, tur maliyeti düşük. */
   buildBcSystem(session) {
     const nowD = new Date();
     const localDate = nowD.toLocaleDateString('tr-TR');
@@ -1395,9 +1397,11 @@ class Engine {
     const proj = this._projectInstructions(session);
     return (
       'Sen BEAST CODE\u2019sun — IDE panelinde çalışan, OpenCode disiplinli hızlı bir kodlama ajanı. VS Code gibi çevik ol.\n' +
+      'GENEL AMAÇLI KODLAMA AJANISIN — tek bir proje türüne sınırlı değilsin: web, backend/API, mobil, masaüstü, CLI, kütüphane, script, oyun, veri, DevOps, gömülü… İstenen neyse o. İstenmeyen şeyi (ör. site değilken site) kendiliğinden ÜRETME.\n' +
       `Çalışma klasörü: ${(session && session.workspace) || this.workspace}\n` +
       `Yerel zaman: ${localDate} ${localTime}\n` +
       `${modeBlock}\n` +
+      'STACK TESPİTİ: işe başlarken workspace\u2019i tanı — package.json, go.mod, Cargo.toml, requirements.txt/pyproject.toml, pom.xml/build.gradle, *.csproj, pubspec.yaml, Gemfile, composer.json vb. işaret dosyalarına bak (list_dir + glob). Dili, framework\u2019ü, konvansiyonları ve build/test/run komutlarını PROJE belirler; her işte aynı teknolojiye itme, mevcut stack\u2019e uy.\n' +
       (proj
         ? '# PROJE TALİMATLARI (workspace AGENTS/CLAUDE/CONTEXT dosyalarından — daima uy)\n' + proj + '\n'
         : '') +
@@ -1405,12 +1409,11 @@ class Engine {
       '1) BAĞLAM: değiştirmeden önce ilgili dosyaları OKU — read_file satır numaralı döner (N: içerik); büyük dosyada devamını offset parametresiyle oku, ASLA baştan okuma; bir dosyayı aynı oturumda BİR KEZ okumak yeter — okuduğun içerik oturum SONUNA KADAR bağlamda KALIR, edit yaptıktan sonra dosyayı yeniden okuma YASAK (güncel durum = son okuma + kendi editlerin). İçerik araması için grep (regex), dosya adı için glob kullan; varsayım yapma, mevcut stili/konvansiyonu takip et.\n' +
       '2) PLAN: 2+ adımlı işlerde İLK EYLEM todo_write olsun (2-6 madde); her adım bitince status:"done" ile GÜNCELLE — liste bitene kadar iş bitmiş sayılmaz.\n' +
       '3) EDİT: VAR OLAN dosyada önce edit_file kullan (old_string/new_string ile yalnız ilgili bölümü değiştir; birden çok eşleşme varsa bağlam ekle ya da replace_all); write_file yalnız YENİ dosya ya da tam yeniden yazım için. Dosya işlemleri için ÖZEL ARAÇLARI kullan (edit_file/write_file/read_file/grep/glob); run_command terminal işlerindir (build, git, kurulum, paket) — dosya düzenlemeyi komut/scripte yedirme, edit_file ile yap. İlgisiz yeniden biçimleme/kayıp boşluk değişikliği YAPMA. edit_file/write_file sonucu additions/deletions döner ve değişiklik diske ANINDA uygulanır — doğrulamak için dosyayı TEKRAR OKUMA YASAK; sonraki editi önceki okuduğun içerik + kendi değişikliklerin üzerinden zincirle.\n' +
-      '4) DOĞRULA: edit sonrası mümkünse derle/test et/lint çalıştır (run_command); hata varsa DÜZELT ve TEKRAR dene (en fazla 2 doğrulama turu) — kırmızı bırakma. Doğrulama read_file ile DEĞİL run_command ile yapılır.\n' +
+      '4) DOĞRULA: edit sonrası projenin KENDİ komutlarıyla derle/test/lint çalıştır (run_command: npm test, go test ./..., cargo test, pytest, mvn test vb. — hangisi geçerliyse); hata varsa DÜZELT ve TEKRAR dene (en fazla 2 doğrulama turu) — kırmızı bırakma. Doğrulama read_file ile DEĞİL run_command ile yapılır.\n' +
       '5) RAPOR: 1-3 satır — ne değişti + doğrulama sonucu (ör. "npm test ✓ 154/154"). Uzun açıklama yok.\n' +
-      'CANLI ÖNİZLEME: panel Preview\u2019da DAHİLİ STATİK SUNUCUYU kendisi yönetir — statik site için sunucu başlatma DENEME (python -m http.server vs. GEREKMEZ); index.html\u2019i hazır bırak, kullanıcı Preview\u2019a basınca site sunucudan canlı açılır ve sana observe ile haber verilir. Yalnızca gerçek dev-server/build gerektiren projelerde (React/Vite/Next/Expo) kendi sunucunu BLOKLAMADAN arka planda başlat ve çalışan adresi (http://localhost:PORT) raporda yaz. file:// protokolü ASLA kullanılmaz.\n' +
-      'MOBİL UYGULAMA: React Native/Expo ile yap — `npx create-expo-app <ad>` + `npx expo start` (BLOKLAMADAN arka planda; başlangıç çıktısında http://localhost:8081 görünür, panel Telefon Modunda canlı açar, dosya kaydında hot reload çalışır). APK: `npx expo prebuild` + android\\gradlew assembleDebug; iOS: Windows\u2019ta simülatör YOK — gerçek cihazda Expo Go (QR) veya EAS cloud build kullan.\n' +
+      'ÖNİZLEME: panel Preview\u2019da dahili statik sunucuyu KENDİSİ yönetir — statik HTML işinde sunucu başlatma (python -m http.server vs. GEREKMEZ); index.html\u2019i hazır bırak, kullanıcı Preview\u2019a basınca canlı açılır. Yalnız gerçek dev-server gerektiren projelerde (React/Vite/Next/Expo vb.) kendi sunucunu BLOKLAMADAN arka planda başlat ve çalışan adresi (http://localhost:PORT) raporda yaz. file:// protokolü ASLA kullanılmaz.\n' +
       'HIZ KURALLARI:\n' +
-      '- Kodu ve dosyaları DOĞRUDAN write_file ile yaz; basit dosya oluşturma/düzenleme için Python scripti yazma; python_run yalnız gerçek hesap/veri işleme gerekiyorsa.\n' +
+      '- VAR OLAN dosyayı edit_file ile değiştir, YENİ dosyayı write_file ile yarat; basit dosya oluşturma/düzenleme için Python scripti yazma; python_run yalnız gerçek hesap/veri işleme gerekiyorsa.\n' +
       '- Bağımsız araç çağrılarını AYNI TURDA paralel ver (birden çok read_file tek turda).\n' +
       '- Dosyayı kullanıcı söylememişse list_dir ile yapıyı görüp kendin karar ver.\n' +
       '- Run_command PowerShell ortamında çalışır (Windows): KALICI oturum — cd ve $env değişkenleri çağrılar arasında korunur; büyük çıktıda tam çıktı geçici dosyaya düşer, read_file ile oku. shell:"bash" verirsen git-bash ile bash sözdizimi koşar.\n' +
@@ -1419,6 +1422,66 @@ class Engine {
     );
   }
 
+  /* Beast Studio (video paneli): video YAPMA ve DÜZENLEME ajanı. Workspace'teki
+     her şey video proje malzemesi olarak görülür (ham görüntü, ses, görsel,
+     altyazı, çıktı). Medya işi ffprobe + ffmpeg ile yürütür; ikisi de app ile
+     birlikte gelir (ffmpeg-static). Beast Code disiplini korunur: plan →
+     uygula → doğrula. */
+  buildStudioSystem(session) {
+    const nowD = new Date();
+    const localDate = nowD.toLocaleDateString('tr-TR');
+    const localTime = String(nowD.getHours()).padStart(2, '0') + ':00';
+    const mode = String((session && session.bcMode) || 'auto').toLowerCase();
+    const modeBlock =
+      mode === 'plan'
+        ? 'ÇALIŞMA MODU: PLAN 🔍 — malzemeyi İNCELE (list_dir + ffprobe), KOMUT ÇALIŞTIRMA; adım adım MONTAJ PLANI ver (hangi dosya, hangi işlem, çıktı adı, nasıl doğrulanır). Kullanıcı /build deyince plan uygulanır.'
+        : mode === 'build'
+          ? 'ÇALIŞMA MODU: BUILD 🛠 — son montaj planını SOHBETTEKİ bağlamdan al ve UYGULA: ffmpeg işlerini çalıştır, çıktıları doğrula. Yeni plan açma; en fazla 1 cümlelik yön gösterimi + uygulama.'
+          : 'ÇALIŞMA MODU: OTOMATİK ⚡ — önce 2-4 satırlık mini plan (todo_write), sonra hemen uygula + doğrula.';
+    let ffPath = '';
+    try { ffPath = String(require('ffmpeg-static') || ''); } catch {}
+    let ffprobeHint = '';
+    if (ffPath) {
+      const ffDir = path.dirname(ffPath);
+      ffprobeHint =
+        `Medya araçları KURULU, kurmaya ÇALIŞMA:\n` +
+        `- ffmpeg: "${ffPath}"\n` +
+        `- ffprobe: "${path.join(ffDir, 'ffprobe' + (process.platform === 'win32' ? '.exe' : ''))}" (yoksa ffmpeg -i de meta verir)\n` +
+        `Bunları run_command ile TAM YOLLA çağır (PATH'te değiller). Boşluklu yolları tırnakla.\n`;
+    }
+    const proj = this._projectInstructions(session);
+    return (
+      'Sen BEAST STUDIO\u2019sun — video YAPMA ve DÜZENLEME ajanı. Sol paneldeki klasör senin stüdyondur.\n' +
+      'GÖREV ALANI: video üretme ve düzenleme — kesme/birleştirme (montaj), trim, crop, ölçek, döndürme, hız (slowmo/timelapse), geçiş efektleri, filtre/renk, altyazı basma (srt/ass burn-in), ses ekleme/değiştirme/ses seviyesi/ses temizleme, GIF, thumbnail, format dönüşümü — kısaca kullanıcının istediği HER türlü video/ses işi. Kod yazma projesi DEĞİLDİR — kod istenirse kullanıcı Beast Code\u2019a yönlendirilir.\n' +
+      `Stüdyo klasörü: ${(session && session.workspace) || this.workspace}\n` +
+      `Yerel zaman: ${localDate} ${localTime}\n` +
+      `${modeBlock}\n` +
+      'KLASÖR FARKINDALIĞI: çalışma klasöründeki HER DOSYA video proje MALZEMESİDİR — ham görüntüler, sesler, müzikler, görseller, altyazılar, önceki çıktılar. İşe başlarken list_dir ile malzemeyi gör; isimden tür UYDURMA, ffprobe ile doğrula. Yeni klasör seçilirse (panelde Klasör seç) yeni proje başlar — oradaki malzemeye göre çalış.\n' +
+      ffprobeHint +
+      'MEDYA ANALİZİ: video/ses dosyalarını read_file ile OKUMA (ikili dosya) — ffprobe ile süre, codec, çözünürlük, fps, ses kanalı, bit hızı bilgisini al: ffprobe -v error -show_entries format=duration,size:stream=codec_name,width,height,r_frame_rate,channels -of default=noprint_wrappers=1 "dosya"\n' +
+      'FFMPEG KURALLARI:\n' +
+      '- Çıktıya HER ZAMAN -y ekle (üstüne yaz). Uzun işlerde stderr büyük olur; gerekiyorsa çıktıyı dosyaya düşürüp son 20 satırı oku.\n' +
+      '- Varsayılan kodlama: video libx264 + crf 20, ses aac 192k, mp4 kapsayıcı; kullanıcı kalite belirtirse crf 16-18.\n' +
+      '- Kesme: -ss BAŞ -to BİT (girişten önce hızlı arama için -ss\u2019yi -i\u2019den ÖNCE koy, yeniden kodlamalı kesin işlerde sonra da olur) -i girdi -t SÜRE.\n' +
+      '- Birleştirme: uyumsuz kaynaklarda concat demuxer yerine filtre (concat=n=...:v=1:a=1) kullan veya önce hepsini aynı çözünürlük/fps/codece normalize et.\n' +
+      '- Altyazı: subtitles="dosya.srt":force_style\u2026 (Windows yolunda escaping: C\\:/…); ses: -i ses -map 0:v -map 1:a -c:v copy -shortest.\n' +
+      'ÇIKTI DİSİPLİNİ: üretilen her dosyayı çalışma klasörü içindeki "output" klasörüne yaz (önce mkdir); dosya adları ASCII, boşluksuz ve anlamlı olsun (ör. output\/kesme-01.mp4). Ara dosyaları da output\/tmp altında tut, iş bitince temizle.\n' +
+      'WORKFLOW (her işte bu sıra):\n' +
+      '1) BAĞLAM: list_dir + ffprobe ile malzeme envanteri (paralel çağrılar TEK turda).\n' +
+      '2) PLAN: 2+ adımlı işlerde İLK EYLEM todo_write olsun (2-6 madde); her adım bitince status:"done" ile GÜNCELLE.\n' +
+      '3) UYGULA: her ffmpeg işini run_command ile adım adım çalıştır; büyük işi tek dev komuta gömme — kırıp zincirle.\n' +
+      '4) DOĞRULA: her adımda çıktı gerçekten oluştu mu — ffprobe ile süre/codec kontrolü ETMEDEN "tamam" DEME; hata varsa komutu düzeltip en fazla 2 kez TEKRAR DENE.\n' +
+      '5) RAPOR: 1-3 satır — üretilen dosya(lar) + süre/boyut + ne yapıldı. Dosya yolunu MUTLAKA yaz (kullanıcı panelde oynatır).\n' +
+      'HIZ KURALLARI:\n' +
+      '- Bağımsız ffprobe/ffmpeg çağrılarını AYNI TURDA paralel ver.\n' +
+      '- run_command PowerShell ortamında çalışır (Windows): KALICI oturum — cd korunur.\n' +
+      '- Görüntü üretimi/thumbnail: ffmpeg -ss ortası -i girdi -frames:v 1.\n' +
+      '- Soru sorma; malzemeden emin olamadığında ffprobe\u2019la kendin çöz. Kullanıcı /plan /build /auto ile modu değiştirir.\n' +
+      (proj ? '# PROJE TALİMATLARI (workspace AGENTS/CLAUDE/CONTEXT dosyalarından — daima uy)\n' + proj + '\n' : '') +
+      FORMAT_RULES
+    );
+  }
+
   async buildSystem(queryText, session) {
     /* BOT OTURUMU: non-admin bota bağlıysa global Beast hafızası HIÇ girmez —
        o botun kendi SOUL/USER/MEMORY dosyaları kullanılır (tam izolasyon) */
@@ -2854,9 +2917,11 @@ class Engine {
     const promptText = this._lastUserText(session);
     let system = session.bgJob
       ? this.buildBgSystem(session)
-      : session.bcCode
-        ? this.buildBcSystem(session)
-        : await this.buildSystem(promptText, session);
+      : session.studio
+        ? this.buildStudioSystem(session)
+        : session.bcCode
+          ? this.buildBcSystem(session)
+          : await this.buildSystem(promptText, session);
     // Granül izin: oturumun yetki seviyesine göre araç seti daraltılır.
     // Çoklu izin (ör. web+read) seçiliyse kümeler BİRLEŞİR — hepsinin araçları açık olur.
     const perms = this.sessionPermFor(session.id);
@@ -3456,7 +3521,7 @@ class Engine {
        ajan "eski skillden daha kolay/better yol buldum" diyebilmesin, KARAR VERİP
        skilli GÜNCELLESİN. action: create (yeni) | update (mevcutu iyileştir) | none */
 const skills = require('./skills');
-    const existing = skills
+    const existing = skills
       .scan()
       .map((s) => `- ${s.name}: ${(s.description || '').slice(0, 100)}`)
       .join('\n');

package/src/agent/kb.js

@@ -1,123 +1,123 @@
-'use strict';
-
-/* Beast knowledge store (#3 derin öğrenme katmanı)
-   sqlite-vec yerine sıfır bağımlılık: JSON deposu + TF-IDF benzerlik.
-   Kayıtlar kaynak taşır → kb_search sonucu citation'lı döner.
-
-   Depo: %APPDATA%\beast\knowledge.json
-   { items: [{ id, title, source, tags[], text, createdAt }] }  */
-
-const fs = require('fs');
-const path = require('path');
-const { beastRoot } = require('./memory');
-
-function file() {
-  return path.join(beastRoot(), 'knowledge.json');
-}
-
-let items = null;
-
-function load() {
-  if (items) return;
-  try {
-    const raw = JSON.parse(fs.readFileSync(file(), 'utf8'));
-    items = Array.isArray(raw.items) ? raw.items : [];
-  } catch {
-    items = [];
-  }
-}
-
-function save() {
-  try {
-    fs.mkdirSync(beastRoot(), { recursive: true });
-    const tmp = file() + '.tmp';
-    fs.writeFileSync(tmp, JSON.stringify({ items }, null, 2));
-    fs.renameSync(tmp, file());
-  } catch {}
-}
-
-const KB_CAP = 2000;
-
-function uid() {
-  return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
-}
-
-/* memory.js ile aynı Türkçe duyarsız tokenleştirme */
-const TR_FOLD = { ç: 'c', ğ: 'g', ı: 'i', ö: 'o', ş: 's', ü: 'u', â: 'a', î: 'i', û: 'u' };
-function fold(s) {
-  return String(s || '').toLowerCase().replace(/[çğıöşüâîû]/g, (ch) => TR_FOLD[ch] || ch);
-}
-function tokenize(q) {
-  return (fold(q).match(/[a-z0-9_+#.]+/g) || []).filter((w) => w.length >= 3);
-}
-
-/** add(title, text, {source, tags}) → { ok, id } */
-function add(title, text, meta = {}) {
-  load();
-  const t = String(text || '').trim();
-  if (!t) return { ok: false, error: 'metin boş' };
-  if (items.length >= KB_CAP) items.splice(0, items.length - KB_CAP + 1); // en eskiyi düşür
-  const it = {
-    id: uid(),
-    title: String(title || '').trim().slice(0, 120) || t.slice(0, 60),
-    source: String(meta.source || '').trim().slice(0, 300) || 'agent',
-    tags: Array.isArray(meta.tags) ? meta.tags.map((x) => String(x).slice(0, 40)).slice(0, 8) : [],
-    text: t.slice(0, 20000),
-    createdAt: new Date().toISOString(),
-  };
-  items.push(it);
-  save();
-  return { ok: true, id: it.id };
-}
-
-function get(id) {
-  load();
-  return items.find((x) => x.id === id) ? { ...items.find((x) => x.id === id) } : null;
-}
-
-function count() {
-  load();
-  return items.length;
-}
-
-/** TF-IDF benzerlik araması; sonuçlar citation alanıyla döner */
-function search(query, limit = 5) {
-  load();
-  const qTokens = tokenize(query);
-  if (!qTokens.length || !items.length) return [];
-  const N = items.length;
-  const docs = items.map((it) => tokenize(it.title + ' ' + it.text));
-  /* df */
-  const df = new Map();
-  for (const toks of docs) {
-    for (const t of new Set(toks)) df.set(t, (df.get(t) || 0) + 1);
-  }
-  const scored = [];
-  for (let i = 0; i < N; i++) {
-    const toks = docs[i];
-    if (!toks.length) continue;
-    const tf = new Map();
-    for (const t of toks) tf.set(t, (tf.get(t) || 0) + 1);
-    let score = 0;
-    for (const q of qTokens) {
-      const f = tf.get(q) || 0;
-      if (!f) continue;
-      const idf = Math.log(1 + N / (1 + (df.get(q) || 0)));
-      score += (f / toks.length) * idf;
-    }
-    /* tag/başlık eşleşmesine bonus */
-    const hayT = fold(items[i].title + ' ' + (items[i].tags || []).join(' '));
-    for (const q of qTokens) if (hayT.includes(q)) score += 0.35;
-    if (score > 0) scored.push({ i, score });
-  }
-  scored.sort((a, b) => b.score - a.score);
-  return scored.slice(0, Math.max(1, Math.min(limit, 10))).map(({ i, score }) => ({
-    id: items[i].id,
-    title: items[i].title,
-    snippet: items[i].text.slice(0, 400),
-    score: Number(score.toFixed(3)),
-    citation: `[${items[i].title}] (${items[i].source}, ${String(items[i].createdAt).slice(0, 10)})`,
-  }));
-}
-
-module.exports = { add, get, search, count, tokenize };
+'use strict';
+
+/* Beast knowledge store (#3 derin öğrenme katmanı)
+   sqlite-vec yerine sıfır bağımlılık: JSON deposu + TF-IDF benzerlik.
+   Kayıtlar kaynak taşır → kb_search sonucu citation'lı döner.
+
+   Depo: %APPDATA%\beast\knowledge.json
+   { items: [{ id, title, source, tags[], text, createdAt }] }  */
+
+const fs = require('fs');
+const path = require('path');
+const { beastRoot } = require('./memory');
+
+function file() {
+  return path.join(beastRoot(), 'knowledge.json');
+}
+
+let items = null;
+
+function load() {
+  if (items) return;
+  try {
+    const raw = JSON.parse(fs.readFileSync(file(), 'utf8'));
+    items = Array.isArray(raw.items) ? raw.items : [];
+  } catch {
+    items = [];
+  }
+}
+
+function save() {
+  try {
+    fs.mkdirSync(beastRoot(), { recursive: true });
+    const tmp = file() + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify({ items }, null, 2));
+    fs.renameSync(tmp, file());
+  } catch {}
+}
+
+const KB_CAP = 2000;
+
+function uid() {
+  return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+}
+
+/* memory.js ile aynı Türkçe duyarsız tokenleştirme */
+const TR_FOLD = { ç: 'c', ğ: 'g', ı: 'i', ö: 'o', ş: 's', ü: 'u', â: 'a', î: 'i', û: 'u' };
+function fold(s) {
+  return String(s || '').toLowerCase().replace(/[çğıöşüâîû]/g, (ch) => TR_FOLD[ch] || ch);
+}
+function tokenize(q) {
+  return (fold(q).match(/[a-z0-9_+#.]+/g) || []).filter((w) => w.length >= 3);
+}
+
+/** add(title, text, {source, tags}) → { ok, id } */
+function add(title, text, meta = {}) {
+  load();
+  const t = String(text || '').trim();
+  if (!t) return { ok: false, error: 'metin boş' };
+  if (items.length >= KB_CAP) items.splice(0, items.length - KB_CAP + 1); // en eskiyi düşür
+  const it = {
+    id: uid(),
+    title: String(title || '').trim().slice(0, 120) || t.slice(0, 60),
+    source: String(meta.source || '').trim().slice(0, 300) || 'agent',
+    tags: Array.isArray(meta.tags) ? meta.tags.map((x) => String(x).slice(0, 40)).slice(0, 8) : [],
+    text: t.slice(0, 20000),
+    createdAt: new Date().toISOString(),
+  };
+  items.push(it);
+  save();
+  return { ok: true, id: it.id };
+}
+
+function get(id) {
+  load();
+  return items.find((x) => x.id === id) ? { ...items.find((x) => x.id === id) } : null;
+}
+
+function count() {
+  load();
+  return items.length;
+}
+
+/** TF-IDF benzerlik araması; sonuçlar citation alanıyla döner */
+function search(query, limit = 5) {
+  load();
+  const qTokens = tokenize(query);
+  if (!qTokens.length || !items.length) return [];
+  const N = items.length;
+  const docs = items.map((it) => tokenize(it.title + ' ' + it.text));
+  /* df */
+  const df = new Map();
+  for (const toks of docs) {
+    for (const t of new Set(toks)) df.set(t, (df.get(t) || 0) + 1);
+  }
+  const scored = [];
+  for (let i = 0; i < N; i++) {
+    const toks = docs[i];
+    if (!toks.length) continue;
+    const tf = new Map();
+    for (const t of toks) tf.set(t, (tf.get(t) || 0) + 1);
+    let score = 0;
+    for (const q of qTokens) {
+      const f = tf.get(q) || 0;
+      if (!f) continue;
+      const idf = Math.log(1 + N / (1 + (df.get(q) || 0)));
+      score += (f / toks.length) * idf;
+    }
+    /* tag/başlık eşleşmesine bonus */
+    const hayT = fold(items[i].title + ' ' + (items[i].tags || []).join(' '));
+    for (const q of qTokens) if (hayT.includes(q)) score += 0.35;
+    if (score > 0) scored.push({ i, score });
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.slice(0, Math.max(1, Math.min(limit, 10))).map(({ i, score }) => ({
+    id: items[i].id,
+    title: items[i].title,
+    snippet: items[i].text.slice(0, 400),
+    score: Number(score.toFixed(3)),
+    citation: `[${items[i].title}] (${items[i].source}, ${String(items[i].createdAt).slice(0, 10)})`,
+  }));
+}
+
+module.exports = { add, get, search, count, tokenize };