natureco-cli 5.40.0 → 5.42.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to NatureCo CLI will be documented in this file.
 
+## [5.42.0] - 2026-07-08 — "TOKEN OPTIMİZASYONU: her istekte ~18K token israfı → ~4.5K (%76 azalma)"
+
+Kullanıcı token maliyetini sordu; ölçüm yapıldı ve ciddi bir israf bulundu: basit bir "merhaba" bile **18,763 token** prompt gönderiyordu. Kök neden: `skill-index.js` her sysMsg'e YÜZLERCE skill'in TAM `description`'ını gömüyordu (satır 75 `- name: description`), her istekte tekrar.
+
+### ⚡ Token verimliliği (doğrudan maliyet + kullanıcı tercihi)
+- **skill index kompaktlaştırıldı**: eskiden ~200 skill × ~350 char (tam açıklama) = ~75K char = ~18K token HER istekte. Bu progressive-disclosure'a da aykırıydı (skill_view zaten tam açıklama+içerik veriyor). Artık: çok skill (>60) → **kompakt isim-listesi** (kategorili, virgüllü); az skill → isim + kısa açıklama (88 char, kelime sınırı). Uzun "mandatory scan" yönergesi sadeleştirildi.
+- **Yeni env kontrolü** `NATURECO_SKILL_INDEX`: `off` (index hiç gönderilmez, en düşük token) / `names` (sadece isimler) / `full` (kısa açıklamalı, çok skill'de bile).
+- **Ölçülen etki** (gerçek MiniMax usage, monkeypatch ile): basit selam **18,763 → 4,456 token** (%76↓); tek-araç görevi 38,601 → 9,987 token. Çok-iterasyonlu görevlerde tasarruf katlanır (sysMsg her iterasyonda gider).
+
+538 test yeşil (skill-index token regresyonu +5: `_shorten`, off-mode, skill-başına-char sınırı), ESLint temiz. Provider-bağımsız (tüm sysMsg'ler `buildSkillIndex` kullanır).
+
+## [5.41.0] - 2026-07-08 — "sub-agent orchestration + plan modu PHANTOM idi, açıldı"
+
+Kullanıcının "sub-agent orchestration ve plan modunda açık kalmasın" talebiyle: ikisi de mevcut+çalışır kod (`sub_agent.js`, `plan.js`) AMA agentic-runner `DEFAULT_ALLOWED`'da ve workflow sysMsg'inde YOKTU → agent bunları çağıramıyordu (klasik phantom-tool deseni).
+
+### ✨ Açılan yetenekler (kod vardı, agent erişemiyordu)
+- **sub_agent** (orchestration): agent bir alt-görevi bağımsız bir alt-agent'a devreder (kendi LLM çağrısı, sonucu döner). Birden fazla çağırarak paralel/çok-parçalı orchestration yapar. Güvenli (sadece LLM çağrısı, shell/dosya yok) → safe-mode allowlist'e eklendi.
+- **plan** (plan modu): karmaşık görev için önce plan çıkarır (SADECE metin + `~/.natureco/plans/*.md`, hiçbir işlem yapmaz). safe-mode allowlist'e eklendi.
+- Her ikisi de workflow sysMsg'de tanıtıldı (agent ne zaman/nasıl kullanacağını bilir). Provider-bağımsız (MiniMax/Gemini/OpenAI endpoint routing içeriyor).
+
+### ✓ Doğrulama (agent yolu E2E, MiniMax)
+- plan: agent `plan` aracıyla 10-adımlık detaylı React todo planı çıkardı.
+- sub_agent: agent alt-agent spawn edip "list comprehension nedir" sordurup yanıtı iletti.
+- **çoklu orchestration**: agent İKİ ayrı alt-agent'a iki görev delege etti (5!=120, HTTP 404) ve ikisini özetledi.
+- 533 test yeşil (sub_agent+plan phantom regresyon kilidi), ESLint temiz.
+
 ## [5.40.0] - 2026-07-08 — "CROSS-SESSION HAFIZA bozulması düzeltildi (gerçek macOS SSH testinde bulundu)"
 
 Gerçek MacBook'a SSH ile bağlanıp canlı test yapılırken bulundu: kullanıcı "projemin gizli kod adı ONYX-7'yi hatırla" dediğinde, yeni oturumda HATIRLANMIYORDU. Kök neden zincirleme çözüldü.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.40.0",
+  "version": "5.42.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

@@ -25,6 +25,8 @@ const DEFAULT_ALLOWED = [
   'write_file', 'read_file', 'edit_file', 'skill_view', '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)
+  'sub_agent', 'plan',
   // macOS asistan yetenekleri (Windows'ta zarafetle "sadece macOS" der; kullanıcının Mac'inde çalışır)
   'calendar_add', 'reminder_add', 'notes_add', 'mac_notify',
   // medya (kullanıcının kendi provider/API'siyle)

package/src/tools/workflow.js

@@ -271,6 +271,8 @@ async function workflow(params) {
         '- 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).',

package/src/utils/skill-index.js

@@ -58,25 +58,46 @@ function _discoverSkills() {
   return skills;
 }
 
+/**
+ * v5.42 TOKEN OPTIMIZASYONU: eskiden her skill'in TAM `description`'i (frontmatter,
+ * ~200-500 char) sysMsg'e gomuluyordu → yuzlerce skill'de ~18K token HER istekte
+ * (basit "merhaba" bile). Progressive-disclosure'a da aykiri: skill_view zaten tam
+ * aciklama+icerik veriyor. Artik index'te KISA aciklama (cok skill varsa daha da kisa);
+ * ajan ismi+ozeti gorur, ilgiliyse skill_view(name) ile tam detayi ceker.
+ * NATURECO_SKILL_INDEX=names → sadece isimler (en dusuk token); =off → index yok.
+ */
+function _shorten(d, max) {
+  if (!d) return '';
+  const clean = d.replace(/\s+/g, ' ').trim();
+  if (clean.length <= max) return clean;
+  return clean.slice(0, max).replace(/\s+\S*$/, '') + '…';
+}
+
 function buildSkillIndex() {
+  const mode = String(process.env.NATURECO_SKILL_INDEX || '').toLowerCase();
+  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');
   const byCategory = {};
   for (const s of skills) {
     if (!byCategory[s.category]) byCategory[s.category] = [];
     byCategory[s.category].push(s);
   }
-  const lines = ['## Skills (mandatory)'];
-  lines.push('Before replying, scan the skills below. If a skill matches or is even partially relevant to your task, you MUST load it with skill_view(name) and follow its instructions. Err on the side of loading — it is always better to have context you do not need than to miss critical steps, pitfalls, or established workflows.');
+  const lines = ['## Skills (görevinle ilgiliyse skill_view(name) ile yükle — tam açıklama/içerik oradadır)'];
   lines.push('<available_skills>');
   for (const [cat, catSkills] of Object.entries(byCategory)) {
-    lines.push(`  ${cat}:`);
-    for (const s of catSkills) {
-      lines.push(`    - ${s.name}: ${s.description}`);
+    if (compact) {
+      lines.push(`  ${cat}: ${catSkills.map(s => s.name).join(', ')}`);
+    } else {
+      lines.push(`  ${cat}:`);
+      for (const s of catSkills) lines.push(`    - ${s.name}: ${_shorten(s.description, 88)}`);
     }
   }
   lines.push('</available_skills>');
-  lines.push('Only proceed without loading a skill if genuinely none are relevant.');
   return lines.join('\n');
 }
 
@@ -124,4 +145,4 @@ function skillsList(category) {
   });
 }
 
-module.exports = { buildSkillIndex, skillLookup, skillView, skillsList };
+module.exports = { buildSkillIndex, skillLookup, skillView, skillsList, _shorten, _discoverSkills };