natureco-cli 5.49.1 → 5.50.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to NatureCo CLI will be documented in this file.
 
+## [5.50.0] - 2026-07-10 — "ÖZ-BİLGİ: ajan kendi evini tanıyor ve kendini onarabiliyor"
+
+### Added
+- **`SELF.md` — ajanın öz-bilgi haritası** (paket köküne eklenir, pakete dahil): mimari harita (chat→repl→workflow→agentic-runner akışı, gateway/tek-beyin, hafıza sistemi, skill sistemi, güvenlik katmanları, ~/.natureco veri haritası), dosya-görev tablosu ve **kendini onarma protokolü** (belirtiyi netleştir → haritadan dosyayı bul → read_file → edit_file → node --check ile doğrula → dürüstçe raporla → "kurulu paketteki düzeltme güncellemede ezilir" uyarısı).
+- Sistem mesajındaki öz-bilgi bloğu SELF.md'ye işaret eder: kullanıcı "kendini incele / şu özelliğin bozuk / kendini onar / nasıl çalışıyorsun" dediğinde ajan önce haritayı okur, sonra ilgili kaynak dosyada çalışır. Token maliyeti düşük tutuldu (harita sysMsg'e GÖMÜLMEZ, istek üzerine okunur — progressive disclosure).
+- E2E doğrulandı: "hafıza sistemin hangi dosyalarda, Türkçe arama sorununu hangi dosya çözüyor, kendini nasıl onarırsın?" → doğru dosyalar (`memory_tree.js`, `tr-text.js`...) + SELF.md protokol adımları.
+
 ## [5.49.1] - 2026-07-10 — "FIX: ajan kendi skill/araç envanterini yanlış anlatıyordu"
 
 ### Fixed

package/SELF.md

@@ -0,0 +1,116 @@
+# SELF.md — NatureCo CLI Öz-Bilgi Haritası
+
+> Bu dosya AJANIN KENDİSİ içindir: kendi evinin haritası. Kullanıcı "şu özelliğin
+> bozuldu / kendini incele / şunu onar" dediğinde ÖNCE burayı oku, ilgili dosyayı
+> bul, `read_file` ile incele, `edit_file` ile onar, sonra doğrula.
+> Şüphede kalırsan harita değil KAYNAK KOD doğrudur — dosyayı aç ve oku.
+
+## Kimlik ve konum
+
+- Ben `natureco-cli` npm paketiyim. Kurulum kökümü bu dosyanın bulunduğu klasörden bilirsin.
+- Giriş noktası: `bin/natureco.js` (commander tabanlı komut yönlendirici; açılışta
+  güncelleme bildirimi `src/utils/update-check.js` ve `~/.natureco` bağlantıları
+  `src/utils/builtin-links.js` çalışır).
+- Kullanıcı verileri KODDAN AYRIDIR: `~/.natureco/` (config.json, memory/, sessions,
+  crons.json, channel-history/, gateway.log...). Kod güncellenince veri korunur.
+
+## Ana akışlar (bir özellik bozulduğunda önce akışı bul)
+
+### 1. Sohbet: `natureco chat` → repl → workflow → agentic-runner
+- `src/commands/chat.js` → `src/commands/repl.js`'i çağırır (Phase 9 TUI).
+- `repl.js`: girdi okuma, oturum yönetimi, hafıza yükleme (`loadMemory`), her mesajı
+  `workflow` aracına gönderir, yanıtı model-adı temizliğinden geçirir
+  (MiniMax/Claude → bot adı), oturum sonunda `extractPreferenceFacts` ile korumalı
+  otomatik hafıza kaydı yapar (ajan zaten yazdıysa atlanır).
+- `src/tools/workflow.js`: ORKESTRATÖR. `execute({action:'run', task, conversationHistory})`.
+  - Tool-calling desteklemeyen sağlayıcılar (MiniMax/Gemini/Groq/Ollama) →
+    `src/tools/agentic-runner.js` (XML `<invoke>` protokolünü parse edip araçları
+    çalıştıran sınırlı döngü, maxIterations 15, DEFAULT_ALLOWED allowlist).
+  - Sistem mesajı burada kurulur: kullanıcı hafızası + ağaç-hafıza digest +
+    skill index (`src/utils/skill-index.js`) + araç tanıtımları + öz-bilgi.
+  - YENİ ARAÇ EKLERKEN 3 YER: `src/tools/<ad>.js` dosyası + agentic-runner
+    DEFAULT_ALLOWED + workflow.js sysMsg tanıtımı. Biri eksikse araç "phantom"
+    olur (var ama ajan çağıramaz) — geçmişte cron/web_search/todo bu yüzden bozuktu.
+- `src/utils/api.js`: OpenAI/Anthropic tool_calls yolu (`sendMessage`,
+  `sendMessageToProvider`) + konuşma kalıcılığı + MCP istemcileri.
+
+### 2. Mesajlaşma kanalları: `natureco gateway start`
+- `src/commands/gateway.js` (başlat/durdur) → `src/commands/gateway-server.js`
+  (worker; Telegram/WhatsApp/Signal/IRC/Mattermost/iMessage/SMS sağlayıcıları).
+- TEK BEYİN: güvenilir (allow-list'teki) gönderen `src/utils/channel-brain.js`
+  üzerinden terminaldekiyle AYNI workflow ajanına gider (aynı kişilik + hafıza).
+  Kanal-içi kısa geçmiş: `~/.natureco/channel-history/<kanal>_<sohbet>.json`.
+- Güvenlik: `channelGate(config, kanal, gönderen)` — allow-list doluysa dışındakiler
+  engellenir; boşsa yanıt verilir ama hafızasız + araçsız (`noTools`).
+
+### 3. Hafıza (en kritik özellik — "yanlış hatırlamak hiç hatırlamamaktan kötü")
+- Düz hafıza: `~/.natureco/memory/<kullanıcı>.json` (+ eski `default.json` birleşir).
+  Araç: `src/tools/memory_write.js`. Okuyucu: workflow `loadUserMemory`.
+- Ağaç hafıza: `~/.natureco/memory/tree/<kullanıcı>/` (1-kisisel/2-teknik/3-kararlar
+  → ## dal → yaprak). Araç: `src/tools/memory_tree.js` (index|read|search|append|remove;
+  yazma-anı dedup/çelişki uyarısı içerir). Digest her istekte sysMsg'e gömülür.
+- Türkçe arama: `src/utils/tr-text.js` `foldTr` (İ/I/ı/i tek form — JS toLowerCase
+  Türkçe'de GÜVENİLMEZ). Hafıza hijyeni: `src/utils/memory-lint.js` (`natureco memory lint`).
+- Bekleyen işler: 3-kararlar/"Bekleyen İşler" dalı; repl açılışta hatırlatır.
+
+### 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`
+  + `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`).
+
+### 5. Güvenlik katmanları (GEVŞETME — bilinçli tasarım)
+- `src/utils/exec-policy.js` + `src/commands/exec-policy.js`: bash komutları için
+  deny-by-default allowlist; yıkıcı komutlar (`rm -rf /` vb.) agentic yolda HER
+  modda bloklu (`isDangerousCommand`, agentic-runner içinde).
+- Tam mod: `config set agentExec full` → tüm ~90 araç açılır; yıkıcılar yine bloklu.
+- Her araç KENDİ güvenliğini uygular (allowlist'e güvenme) — tool_calls yolu
+  (api.js) tüm src/tools/*.js'i yükleyebilir. Shell çağrısı `execFileSync`
+  (shell:false) tercih edilir; string + execSync = komut enjeksiyonu riski.
+- Kanal/webhook: gönderen doğrulama + imza kontrolü. Admin RPC: 127.0.0.1 + bearer token.
+
+### 6. Diğer önemli parçalar
+- `src/commands/cron.js` + cron_create aracı: zamanlanmış görevler `~/.natureco/crons.json`;
+  fiilen çalışması için daemon gerekir (`natureco daemon start|install`).
+- `src/commands/status.js`: sürüm/gateway/provider/skill/araç özeti (teşhis için ilk bakılacak yer).
+- `src/commands/memory-cmd.js`: `natureco memory lint|search`.
+- `src/utils/config.js`: `~/.natureco/config.json` okuma/yazma (0600 izin).
+- `src/utils/tui.js` + `src/utils/branding.js`: TUI bileşenleri + ASCII logo.
+- `src/commands/tools.js`: araç kataloğunu listeler. Araç kaynakları: `src/tools/*.js`
+  (~90 dosya; her modül `{name, description, inputSchema, execute}` dışa verir).
+
+## Kendini onarma protokolü
+
+1. Belirtiyi netleştir: hangi komut/özellik, hata mesajı ne, `natureco status` çıktısı.
+2. Bu haritadan ilgili akışı ve dosyayı bul; `read_file` ile oku (önce oku, sonra düzelt).
+3. `grep_search` ile ilgili fonksiyon/hata metnini kaynakta ara (kurulum kökünde).
+4. Düzeltmeyi `edit_file` ile hedefli yap (dosyayı komple yeniden yazma).
+5. Doğrula: `node --check <dosya>` (sözdizimi) ve mümkünse ilgili komutu çalıştır.
+   Test paketi kurulum kökünde: `npm test` (vitest; dev bağımlılıkları global
+   kurulumda olmayabilir — yoksa node --check + elle deneme yeterlidir).
+6. Kullanıcıya NE bozuktu, NEYİ değiştirdin, NASIL doğruladın — dürüstçe söyle.
+7. ÖNEMLİ: kurulu paketteki düzeltmeler bir sonraki `npm install -g natureco-cli`
+   güncellemesinde ezilir. Kalıcı çözüm için kullanıcıya "bu düzeltme geçici;
+   kalıcısı yeni sürümde yayınlanmalı" de.
+
+## Veri haritası (~/.natureco)
+
+| Yol | İçerik |
+|---|---|
+| `config.json` | sağlayıcı, bot adı, kullanıcı adı, kanal tokenları (0600) |
+| `memory/<kullanıcı>.json` | düz hafıza fact'leri |
+| `memory/tree/<kullanıcı>/` | ağaç hafıza (kalıcı bilgi) |
+| `sessions/`, `sessions.json` | REPL oturumları |
+| `channel-history/` | kanal başına kısa konuşma geçmişi |
+| `crons.json` | zamanlanmış görevler |
+| `skills/` | kullanıcının kendi skill'leri |
+| `skills-builtin` → paket | yerleşik skill bağlantısı |
+| `tools` → paket | araç kaynakları bağlantısı |
+| `gateway.log`, `gateway.pid` | kanal sunucusu |
+| `update-check.json` | sürüm bildirimi önbelleği |
+| `exec-approvals.json`, `perm-approvals.json` | izin kayıtları |
+| `audit/` | denetim logları |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.49.1",
+  "version": "5.50.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"
@@ -11,6 +11,7 @@
     "scripts/",
     "skills/",
     "README.md",
+    "SELF.md",
     "CHANGELOG.md",
     "AUDIT.md",
     "SECURITY_AUDIT_SUMMARY.md",

package/src/tools/workflow.js

@@ -261,7 +261,10 @@ async function workflow(params) {
         selfInfo = '\n\nKendi kurulumun (kullanici sorarsa BU bilgiyi kullan, dosya sayarak tahmin etme):'
           + '\n- Toplam skill: ' + skillCount + ' (yerlesikler paketle gelir: ' + path.join(pkgRoot, 'skills') + ' — ~/.natureco/skills-builtin baglantisi da ayni yere acilir)'
           + '\n- Toplam arac: ' + tools.length + ' (kaynaklari: ' + path.join(pkgRoot, 'src', 'tools') + ' — ~/.natureco/tools baglantisi)'
-          + '\n- ~/.natureco/skills SADECE kullanicinin kendi ekledigi skill\'lerdir; yerlesikleri ICERMEZ.';
+          + '\n- ~/.natureco/skills SADECE kullanicinin kendi ekledigi skill\'lerdir; yerlesikleri ICERMEZ.'
+          + '\n- OZ-BILGI HARITAN: ' + path.join(pkgRoot, 'SELF.md') + ' — kendi mimarin, dosya haritasi ve KENDINI ONARMA protokolun.'
+          + ' Kullanici "kendini incele / su ozelligin bozuk / kendini onar / nasil calisiyorsun" derse ONCE bu dosyayi read_file ile oku,'
+          + ' ilgili kaynak dosyayi bul-oku, gerekirse edit_file ile onar, node --check ile dogrula ve yaptigini durustce anlat.';
       } catch { /* sayilamazsa satiri atla */ }
 
       const sysMsg = [