natureco-cli 5.50.1 → 5.51.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to NatureCo CLI will be documented in this file.
 
+## [5.51.0] - 2026-07-10 — "PERF: basit istek 2.698 token — %45 daha ucuz (skill keşfi isteğe bağlı)"
+
+### Changed
+- **Gerçek ölçüm: "merhaba" prompt'u 4.883 → 2.698 token** (v5.42 öncesine göre toplam %86 iniş). Bölüm bazlı ölçüm yapıldı ve üç büyük kalem vuruldu:
+  - **Skill index (1.468 → ~40 token):** 319 skill'in isim listesi artık sysMsg'e GÖMÜLMÜYOR; tek satır ipucu var. Yeni **`skill_find(query)`** aracı (foldTr'li Türkçe-güvenli arama) ile ajan gerektiğinde arar, `skill_view(name)` ile yükler — progressive disclosure 2. seviye. Eski davranış env ile: `NATURECO_SKILL_INDEX=names|full`.
+  - **Araç tanıtımları (~892 → ~540 token)** ve **kurallar (~725 → ~405 token):** her kuralın öğrettiği ders korunarak metinler sıkıştırıldı (cron-daemon dürüstlüğü, kayıt kalitesi, bekleyen işler, "internet erişimim yok deme"...).
+- E2E doğrulama (davranış bozulmadı): skill keşfi (ajan skill_find'ı kendisi çağırıp seo-optimization'ı buldu), dosya yazma (write_file ✓), hafıza recall ("Sen Gencay'sın, ben Hinata" ✓). **630 test yeşil** (+7 yeni: skill_find + yeni indeks varsayılanı).
+
+### Added
+- `src/tools/skill_find.js` — isim+açıklama üzerinde anahtar kelime skorlamalı skill arama (agentic allowlist'e eklendi).
+
 ## [5.50.1] - 2026-07-10 — "PERF: öz-bilgi bloğu sıkıştırıldı (~%55 daha az token)"
 
 ### Changed

package/SELF.md

@@ -56,9 +56,11 @@
 ### 4. Skill sistemi
 - Yerleşikler: paket kökünde `skills/` (her biri `<ad>/SKILL.md`, YAML frontmatter).
   Kullanıcınınkiler: `~/.natureco/skills/`. Proje: `./.natureco/skills/`.
-- İndeks: `src/utils/skill-index.js` (`_discoverSkills`, `buildSkillIndex` — 60+
-  skill'de KOMPAKT isim listesi üretir, token şişmesin diye; `NATURECO_SKILL_INDEX` env).
-- Yükleme: ajan `skill_view` aracıyla (progressive disclosure). CLI: `src/commands/skills.js`
+- İndeks: `src/utils/skill-index.js` (`buildSkillIndex` — 60+ skill'de sysMsg'e yalnız
+  TEK SATIR ipucu gider; isim listesi bile gömülmez. `NATURECO_SKILL_INDEX` env:
+  off|names|full ile eski davranışlar açılır).
+- Keşif: ajan `skill_find(query)` ile arar (`src/tools/skill_find.js`, foldTr'li),
+  `skill_view(name)` ile yükler (progressive disclosure). CLI: `src/commands/skills.js`
   + `src/utils/skills.js` (list/install/remove; indirme allowlist'i `skills-allowlist.json`).
 - Görünürlük bağlantıları: `~/.natureco/skills-builtin` ve `~/.natureco/tools`
   (junction/symlink, `src/utils/builtin-links.js`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.50.1",
+  "version": "5.51.0",
   "description": "OpenClaw'dan daha güvenli, daha hızlı, daha ucuz AI agent CLI. Multi-agent, self-evolving skills, audit log, maliyet optimizasyonu ve NatureCo platform-native.",
   "bin": {
     "natureco": "bin/natureco.js"

package/src/tools/agentic-runner.js

@@ -22,7 +22,7 @@ const os = require('os');
 // digerleri → allowlist/full moda gore). Yani keyfi/yikici komut calismaz.
 // Diger ~85 arac (discord, telegram, cron, browser...) bilerek DISARIDA.
 const DEFAULT_ALLOWED = [
-  'write_file', 'read_file', 'edit_file', 'skill_view', 'bash', 'file_search', 'list_dir', 'grep_search',
+  'write_file', 'read_file', 'edit_file', 'skill_view', 'skill_find', 'bash', 'file_search', 'list_dir', 'grep_search',
   'memory_write', 'memory_tree', 'cron_create', 'duckduckgo', 'web_search', 'todo_write',
   'git', 'http_request', 'notebook_edit', 'clarify', 'code_execution',
   // orchestration + planlama (guvenli: sub_agent = alt-LLM cagrisi, plan = metin+.md; shell/sistem yok)

package/src/tools/skill_find.js

@@ -0,0 +1,53 @@
+/**
+ * skill_find — istek üzerine skill keşfi (v5.51 token optimizasyonu).
+ *
+ * Eskiden 319 skill'in İSİM LİSTESİ her istekte sysMsg'e gömülüyordu (~1.450 token).
+ * Artık sysMsg'de tek satırlık ipucu var; ajan görev bir uzmanlık istediğinde bu
+ * araçla arar (isim+açıklama üzerinde anahtar-kelime skorlaması, foldTr ile
+ * Türkçe-güvenli), sonra skill_view(name) ile yükler. Progressive disclosure 2. seviye.
+ */
+
+const { _discoverSkills, _shorten } = require('../utils/skill-index');
+const { foldTr } = require('../utils/tr-text');
+
+module.exports = {
+  name: 'skill_find',
+  description: 'Görevle ilgili skill ara (isim + açıklama üzerinde anahtar kelime eşleşmesi). Bulduğun skill\'i skill_view(name) ile yükle.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: { type: 'string', description: 'Aranacak konu/anahtar kelimeler (ör. "seo audit", "video üretimi", "api tasarımı")' },
+      maxResults: { type: 'number', description: 'En fazla sonuç (varsayılan 8)' },
+    },
+    required: ['query'],
+  },
+  async execute({ query, maxResults = 8 }) {
+    if (!query || !String(query).trim()) {
+      return { success: false, error: 'query gerekli' };
+    }
+    const words = foldTr(String(query)).split(/\s+/).filter(w => w.length > 1);
+    const skills = _discoverSkills();
+
+    const scored = skills.map(s => {
+      const name = foldTr(s.name || '');
+      const desc = foldTr(s.description || '');
+      let score = 0;
+      for (const w of words) {
+        if (name.includes(w)) score += 3;        // isimde geçmesi en güçlü sinyal
+        else if (desc.includes(w)) score += 1;
+      }
+      return { s, score };
+    }).filter(r => r.score > 0)
+      .sort((a, b) => b.score - a.score)
+      .slice(0, Math.max(1, Math.min(20, maxResults)));
+
+    if (scored.length === 0) {
+      return { success: true, results: [], note: 'Eşleşen skill yok — farklı anahtar kelimelerle dene ya da skill olmadan araçlarla ilerle.' };
+    }
+    return {
+      success: true,
+      results: scored.map(r => ({ name: r.s.name, description: _shorten(r.s.description, 100), category: r.s.category })),
+      note: 'Kullanmak için: skill_view(name)',
+    };
+  },
+};

package/src/tools/workflow.js

@@ -271,46 +271,34 @@ async function workflow(params) {
         memCtx ? '\nKullanici bilgisi:\n' + memCtx : '',
         '\n\nOrtam:\n- Isletim sistemi: ' + process.platform + '\n- Kullanici home: ' + os.homedir() + '\n- Masaustu: ' + desktop + '\n- Calisma dizini: ' + process.cwd() + selfInfo,
         '\n\nArac cagirmak icin TAM olarak su formati kullan:\n<minimax:tool_call>\n<invoke name="ARAC_ADI">\n<parameter name="PARAM">DEGER</parameter>\n</invoke>\n</minimax:tool_call>',
-        '\n\nKullanabilecegin araclar:',
-        '- write_file: dosya olustur/uzerine yaz. parametreler: path (TAM yol), content (dosyanin TAM icerigi). Kod/oyun/site isteniyorsa TUM icerigi content icine yaz, kisaltma.',
-        '- read_file: dosya oku. parametre: path',
-        '- edit_file: MEVCUT dosyada metin degistir. parametreler: path, old_string (birebir mevcut metin), new_string. Bir dosyanin bir kismini degistirirken write_file yerine bunu kullan (tum dosyayi yeniden yazma).',
-        '- file_search: glob ile dosya bul. parametre: pattern (orn. "**/*.js", "src/**/*.json").',
-        '- list_dir: dizin icerigini listele. parametre: path',
-        '- bash: kabuk komutu calistir (npm, git, node, python, test, ls, grep/findstr, mkdir...). parametre: command. Guvenli komutlar dogrudan calisir; yikici/tehlikeli komutlar guvenlik politikasiyla engellenir. Icerik aramasi icin grep/findstr kullan.',
-        '- skill_view: gorevle ilgili bir skill yukle. parametre: name',
-        '- cron_create: zamanlanmis/periyodik gorev (cron) olustur. parametreler: name, schedule (cron ifadesi orn. "0 9 * * *" ya da "every day 9am" gibi preset), command, description.',
-        '- duckduckgo_search: internetten anlik arama yap (API key gerekmez, HER ZAMAN calisir). parametreler: query, maxResults.',
-        '- web_search: internetten arama (Tavily API key ayarliysa daha zengin sonuc; ayarli degilse hata doner — o zaman duckduckgo_search kullan). parametreler: query, maxResults.',
-        '- todo_write: gorev/yapilacaklar listesi yonet. parametre: action (list/add/update/start/done/remove/clear), + action\'a gore diger alanlar.',
-        '- grep_search: dosya ICERIGINDE metin/desen ara (kod tabaninda hizli arama). parametreler: pattern, path, includePattern (opsiyonel glob), maxResults. (bash grep yerine bunu tercih et.)',
-        '- git: git islemi. parametreler: operation (status/diff/log/branches/add/commit), args, message (commit icin). (Basit git icin bunu kullan.)',
-        '- http_request: HTTP istegi at (API cagrisi, webhook, veri cekme). parametreler: url, method, headers, body.',
-        '- code_execution: kod parcasi calistir (sandboxli). parametreler: code, language (python/node/bash).',
-        '- sub_agent: bir ALT-GOREVI bagimsiz bir alt-agent\'a devret (kendi LLM cagrisini yapar, sonucu doner). parametreler: task (zorunlu), context (ops.), maxTokens (ops.). Paralel arastirma, odakli alt-problem, ya da ana gorevi bolup parcalari delege etmek icin. Birden fazla cagirarak orchestrate edebilirsin.',
-        '- plan: karmasik/cok-adimli bir gorev icin ONCE plan cikar (SADECE plan metni uretir, HICBIR islem yapmaz; ~/.natureco/plans/ altina kaydeder). parametreler: action ("create" veya "list"), task (create icin), depth ("minimal"/"detailed"). Kullanici "plan yap / once planla / adimlari cikar / yol haritasi" derse bunu kullan.',
-        '- notebook_edit: Jupyter (.ipynb) hucre duzenle. parametreler: filePath, ...',
-        '- clarify: kullaniciya netlestirme sorusu sor (belirsizlik varsa). parametreler: question, options.',
-        '- calendar_add / reminder_add / notes_add / mac_notify: macOS Takvim/Hatirlatici/Notlar/bildirim (kullanici macOS ise; degilse arac "sadece macOS" der).',
-        '- image_generation: gorsel uret. parametre: prompt, size. | text_to_speech: metni sese cevir (text). | speech_to_text: sesi metne cevir (audioPath).',
-        '- memory_write: HIZLI tek bilgi kaydet (isim, kisa tercih). parametreler: username ("' + memUser + '"), fact, category. YENI oturumda hatirlanir.',
-        '- memory_tree: AGAC-HAFIZA — zengin/kategorize kalici bilgi (proje, karar, teknik not, kisisel detay). action: index|read|search|append; username="' + memUser + '"; append icin: root (1-kisisel|2-teknik|3-kararlar) + branch (dal basligi) + content (yaprak). YENI oturumda hatirlanir.',
+        '\n\nKullanabilecegin araclar (p: = parametreler):',
+        '- write_file: dosya olustur/uzerine yaz. p: path (TAM yol), content (dosyanin TAM icerigi, kisaltma yok).',
+        '- read_file: oku (p: path) | list_dir: dizini listele (p: path) | file_search: glob ile dosya bul (p: pattern orn "**/*.js").',
+        '- edit_file: MEVCUT dosyada metin degistir. p: path, old_string (birebir mevcut), new_string. Kismi degisiklikte write_file yerine bunu kullan.',
+        '- grep_search: dosya ICERIGINDE desen ara (bash grep yerine bunu tercih et). p: pattern, path, includePattern?, maxResults?.',
+        '- bash: kabuk komutu (npm/git/node/python/test/mkdir...). p: command. Yikici/tehlikeli komutlar politikayla engellenir.',
+        '- skill_find: skill ara (p: query) → skill_view: skill yukle (p: name).',
+        '- cron_create: zamanlanmis gorev. p: name, schedule ("0 9 * * *" veya "every day 9am"), command, description.',
+        '- duckduckgo_search: internet aramasi, API key GEREKMEZ, her zaman calisir. p: query, maxResults | web_search: Tavily key ayarliysa; degilse duckduckgo kullan.',
+        '- todo_write: aktif gorev listesi. p: action (list/add/update/start/done/remove/clear) + alanlar.',
+        '- git: git islemi (p: operation/args/message) | http_request: HTTP istegi (p: url, method, headers, body) | code_execution: sandbox kod (p: code, language).',
+        '- sub_agent: alt-gorevi bagimsiz alt-agent\'a devret (p: task, context?, maxTokens?). Paralel/odakli isler; coklu cagriyla orchestrate edebilirsin.',
+        '- plan: cok-adimli gorevde SADECE plan metni uret, islem yapmaz (p: action create/list, task, depth). "once planla / yol haritasi" istenirse.',
+        '- notebook_edit: .ipynb hucre duzenle (p: filePath...) | clarify: netlestirme sorusu sor (p: question, options).',
+        '- calendar_add / reminder_add / notes_add / mac_notify: macOS asistan islevleri (macOS degilse arac soyler).',
+        '- image_generation (p: prompt, size) | text_to_speech (p: text) | speech_to_text (p: audioPath).',
+        '- memory_write: HIZLI tek bilgi kaydet (p: username="' + memUser + '", fact, category) | memory_tree: AGAC-HAFIZA, zengin kalici bilgi (p: action index|read|search|append|remove, username="' + memUser + '", append icin root 1-kisisel|2-teknik|3-kararlar + branch + content). Ikisi de YENI oturumda hatirlanir.',
         '\nKurallar:',
-        '- Kullanici kalici bilgi paylasirsa (isim, tercih, parola, proje, karar, onemli detay) ya da "hatirla / not al / kaydet" derse HEMEN KAYDET (username="' + memUser + '"): kisa tek bilgi → memory_write; zengin/kategorize bilgi → memory_tree(append, dogru root/branch). Trivial/gecici seyleri kaydetme.',
-        '- KAYIT KALITESI (onemli): fact\'i kullanicinin SOYLEDIGI ANLAMI ve SPESIFIK DEGERLERI koruyarak yaz. Kod/isim/sayi/tarih/parola gibi degerleri AYNEN gecir (or. "gizli kod adi ONYX-7" → fact: "Projenin gizli kod adi ONYX-7" — "ONYX-7"yi "onyx" yapma, kisaltma). Neyin ne oldugunu DOGRU etiketle: proje kod adi ≠ kullanici adi, sifre ≠ isim. Yanlis ozetleme yeni oturumda yanlis hatirlamaya yol acar.',
-        '- Kullaniciya ozel bir sey sorulunca (gecmis, proje, tercih, karar) once memory_tree(search/read) ile ilgili kok/dali OKU (hedefli, tum hafizayi degil). Tek primary: bilgi tek yerde yasar; digerine sadece "bkz:". Credential/secret ASLA duz metin.',
-        '- Bir is YARIM kalirsa ya da kullanici "sonra / yarin / daha sonra yapalim" derse memory_tree(action:append, root:"3-kararlar", branch:"Bekleyen İşler", content:"...") ile kaydet — yeni oturum basinda otomatik hatirlatilir. Bir bekleyen is TAMAMLANINCA memory_tree(action:remove, root:"3-kararlar", query:"<anahtar kelime>") ile kaldir.',
-        '- Guncel/internet bilgisi gerektiren bir soru gelirse ONCE duckduckgo_search ile ara ("internet erisimim yok" DEME — bu arac her zaman calisir, API key gerekmez).',
-        '- "Gorev listesi / yapilacaklar / todo" istenirse todo_write kullan (memory_tree DEGIL — o kalici bilgi icin, todo_write ise aktif is takibi icin).',
-        '- Zamanlanmis/periyodik/tekrarlayan gorev (cron, "her gun/hafta X yap", hatirlatici) istenirse SADECE cron_create arac ini kullan; bash ile crontab/schtasks/Register-ScheduledTask DUZENLEME (tutarsiz olur, "natureco cron list" ile gorunmez). cron_create sonrasi kullaniciya ACIKCA soyle: gorevin fiilen tetiklenmesi icin arka plan servisinin calisiyor olmasi gerekir ("natureco daemon start" ya da "natureco daemon install"); bu adim atlanirsa gorev database\'e kaydedilir ama calismaz. Bunu SOYLEMEDEN "olusturuldu, calisacak" gibi kesin basari iddia etme.',
-        '- MEVCUT bir dosyayi degistirmeden ONCE read_file ile oku; sonra edit_file ile hedefli degisiklik yap (tum dosyayi write_file ile ezme).',
-        '- Bir seyi nerede oldugunu bilmiyorsan once file_search/list_dir/bash(grep) ile kesfet.',
-        '- Kod yazdiktan/degistirdikten sonra gerektiginde bash ile calistir/test et (orn. "node dosya.js", "npm test"); hata cikarsa duzelt.',
-        '- Birden fazla dosya gerekiyorsa her biri icin AYRI write_file cagir.',
-        '- Kullanici "masaustu"/"desktop" dediyse ve tam yol vermediyse dosyayi buraya yaz: ' + desktop,
-        '- Goreceli yol yerine TAM yol kullan.',
-        '- Arac sonuclari <tool_results> icinde geri gelir; gorev bitince ARAC CAGIRMADAN tek cumlelik ozet yaz.',
-        '- Basit sohbet/selamlasma ise arac cagirma, dogrudan kisa yanit ver.',
+        '- Kalici bilgi paylasilirsa ya da "hatirla/not al/kaydet" denirse HEMEN kaydet (username="' + memUser + '"): kisa → memory_write; zengin → memory_tree(append, dogru root/branch). Trivial/gecici seyleri kaydetme.',
+        '- KAYIT KALITESI: fact\'i soylenen ANLAM ve SPESIFIK DEGERLERLE yaz — kod/isim/sayi/tarih AYNEN ("kod adi ONYX-7"yi "onyx" yapma); etiketi dogru koy (proje kodu ≠ kullanici adi). Yanlis ozet = yeni oturumda yanlis hatirlama.',
+        '- Kisiye ozel soru (gecmis/proje/tercih) → ONCE memory_tree(search/read) ile ilgili dali oku. Bilgi tek yerde yasar; credential ASLA duz metin.',
+        '- Yarim kalan is / "sonra yapalim" → memory_tree(append, root:"3-kararlar", branch:"Bekleyen İşler") — yeni oturumda otomatik hatirlatilir; tamamlaninca memory_tree(remove) ile kaldir.',
+        '- Guncel/internet bilgisi → ONCE duckduckgo_search ("internet erisimim yok" DEME).',
+        '- Gorev listesi/todo → todo_write (memory_tree DEGIL).',
+        '- Zamanlanmis/tekrarlayan is → SADECE cron_create (bash ile crontab/schtasks DUZENLEME — "natureco cron list"te gorunmez). Sonrasinda kullaniciya MUTLAKA soyle: fiilen calismasi icin "natureco daemon start" (veya install) gerekir; bunu soylemeden kesin basari iddia etme.',
+        '- Dosya degistirmeden ONCE read_file ile oku, edit_file ile hedefli degistir. Yerini bilmiyorsan file_search/grep_search ile kesfet.',
+        '- Kod yazinca/degistirince bash ile calistir/test et, hata varsa duzelt. Coklu dosya = her biri icin AYRI write_file. Hep TAM yol; "masaustu" = ' + desktop + '.',
+        '- Arac sonuclari <tool_results> icinde doner; is bitince arac cagirmadan tek cumlelik ozet yaz. Basit sohbette arac cagirma, dogrudan yanitla.',
         execFull ? '- Kullanici uygulama ac / tarayici kontrol / muzik cal / ekran / GUI istediyse yukaridaki computer-use araclarini KULLAN — "yapamam/engellendi" DEME, dogrudan ilgili araci cagir.' : '',
         fullToolsBlock,
         treeDigest ? ('\n\nBILDIGIN KALICI HAFIZA (bu kullaniciya ait, onceki oturumlardan hatirladiklarin; kullaniciya ozel bir sey sorulursa ONCE BUNU KULLAN — dosya arama, uydurma):\n' + treeDigest) : '',

package/src/utils/skill-index.js

@@ -78,10 +78,17 @@ function buildSkillIndex() {
   if (mode === 'off') return '';
   const skills = _discoverSkills();
   if (skills.length === 0) return '';
-  // Cok skill (>60) → KOMPAKT isim-listesi (kategorili, virgullu): en dusuk token.
-  // Az skill → isim + kisa aciklama. Kullanici 'full'/'names' ile ezebilir.
   const many = skills.length > 60;
-  const compact = mode === 'names' || (many && mode !== 'full');
+  // v5.51: cok skill'de VARSAYILAN artik tek satirlik IPUCU (progressive disclosure
+  // 2. seviye): 319 ismin listesi bile ~1.450 token tutuyordu. Ajan gorev bir
+  // uzmanlik istediginde skill_find(query) ile arar, skill_view(name) ile yukler.
+  // Eski davranislar env ile durur: names (isim listesi), full (isim+aciklama).
+  if (many && mode !== 'full' && mode !== 'names') {
+    return `## Skills: ${skills.length} adet hazir skill var (SEO, tasarim, video, guvenlik, kod...). ` +
+      'Gorev bir uzmanlik/sablon istiyorsa ONCE skill_find(query) ile ara, buldugunu skill_view(name) ile yukle.';
+  }
+  // Az skill → isim + kisa aciklama; 'names' → sadece isimler.
+  const compact = mode === 'names';
   const byCategory = {};
   for (const s of skills) {
     if (!byCategory[s.category]) byCategory[s.category] = [];