natureco-cli 5.41.0 → 5.42.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.41.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/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 };