natureco-cli 2.23.32 → 4.4.1

package/DEPLOY_v2.0.0.md

@@ -0,0 +1,400 @@
+# NatureCo CLI v2.0.0 - Direct Groq Integration
+
+## 🎯 Major Changes
+
+### Breaking Changes
+- ❌ **NatureCo backend bypass edildi** - Artık backend'e istek atılmıyor
+- ✅ **Direkt Groq API entegrasyonu** - CLI direkt Groq'a bağlanıyor
+- ✅ **Local tool execution** - Bash, file operations lokal çalışıyor
+- ✅ **Multi-turn conversation** - Conversation history memory'de tutuluyor
+- ✅ **Tool execution loop** - Max 10 iterasyon, otomatik tool çalıştırma
+
+### New Architecture
+
+```
+┌─────────────┐
+│  User Input │
+└──────┬──────┘
+       │
+       ▼
+┌─────────────────┐
+│  NatureCo CLI   │
+│   (v2.0.0)      │
+└──────┬──────────┘
+       │
+       ├─────────────────────┐
+       │                     │
+       ▼                     ▼
+┌──────────────┐    ┌────────────────┐
+│  Groq API    │    │  Local Tools   │
+│  (Direct)    │◄───┤  - bash        │
+│              │    │  - read_file   │
+│              │    │  - write_file  │
+│              │    │  - list_dir    │
+└──────────────┘    └────────────────┘
+```
+
+## 📦 Yeni Dosyalar
+
+1. **natureco-cli/src/utils/api.js** - Tamamen yeniden yazıldı
+2. **natureco-cli/src/tools/list_dir.js** - Yeni tool eklendi
+
+## 🔧 Yeni Özellikler
+
+### 1. Direct Groq Integration
+```javascript
+// Config'den Groq API key oku
+const groqApiKey = getGroqApiKey();
+
+// Groq'a direkt istek at
+const response = await fetch('https://api.groq.com/openai/v1/chat/completions', {
+  method: 'POST',
+  headers: {
+    'Authorization': `Bearer ${groqApiKey}`,
+    'Content-Type': 'application/json',
+  },
+  body: JSON.stringify({
+    model: 'llama-3.3-70b-versatile',
+    messages: messages,
+    tools: tools,
+    tool_choice: 'auto',
+  }),
+});
+```
+
+### 2. Tool Definitions
+```javascript
+// 4 tool Groq'a gönderiliyor:
+- bash: Execute shell commands
+- read_file: Read file contents
+- write_file: Write to files
+- list_dir: List directory contents (YENİ)
+```
+
+### 3. Tool Execution Loop
+```javascript
+// Max 10 iterasyon
+while (iteration < maxIterations) {
+  // 1. Groq'a istek at
+  const response = await groqAPI(messages, tools);
+  
+  // 2. Tool call var mı?
+  if (response.tool_calls) {
+    // 3. Tool'ları lokal çalıştır
+    const results = await executeToolCalls(toolCalls);
+    
+    // 4. Sonuçları Groq'a geri gönder
+    messages.push(toolResults);
+    
+    // 5. Tekrar cevap bekle
+    continue;
+  }
+  
+  // 6. Final response
+  break;
+}
+```
+
+### 4. Conversation History
+```javascript
+// Memory'de tutuluyor
+const conversationHistory = new Map();
+
+// Her conversation için history
+conversationHistory.set(convId, [
+  { role: 'user', content: 'merhaba' },
+  { role: 'assistant', content: 'Merhaba!' },
+  { role: 'user', content: 'dosyaları listele' },
+  { role: 'assistant', content: '...' }
+]);
+
+// Son 20 mesaj tutuluyor
+if (history.length > 20) {
+  history = history.slice(-20);
+}
+```
+
+## 📋 Setup Guide
+
+### 1. Groq API Key Al
+```bash
+# Groq Console'a git
+https://console.groq.com/keys
+
+# API Key oluştur
+# Copy: gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+### 2. CLI'yi Güncelle
+```bash
+cd natureco-cli
+npm publish
+npm install -g natureco-cli@2.0.0
+natureco --version
+# Output: 2.0.0
+```
+
+### 3. Groq API Key Set Et
+```bash
+# Config'e Groq API key ekle
+natureco config set groqApiKey gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# Kontrol et
+natureco config get groqApiKey
+# Output: gsk_xxx...
+```
+
+### 4. Test Et
+```bash
+natureco chat
+
+> merhaba
+
+# Beklenen çıktı:
+[Groq] Sending request...
+[Groq] Messages: 2
+[Groq] Tools: 4
+
+[Groq] Iteration 1/10
+[Groq] Response type: text
+
+bot › Merhaba! Size nasıl yardımcı olabilirim?
+```
+
+## 🧪 Test Senaryoları
+
+### Test 1: Basit Sohbet
+```bash
+natureco chat
+
+> merhaba
+bot › Merhaba! Size nasıl yardımcı olabilirim?
+
+> nasılsın
+bot › İyiyim, teşekkür ederim! Size nasıl yardımcı olabilirim?
+```
+
+### Test 2: Tool Execution (list_dir)
+```bash
+natureco chat
+
+> mevcut klasördeki dosyaları listele
+
+# Beklenen:
+[Groq] Iteration 1/10
+[Groq] Response type: tool_calls
+[Groq] Tool calls: 1
+🔧 Executing tool: list_dir
+   Params: {"path":"."}
+   ✓ Success
+
+[Groq] Iteration 2/10
+[Groq] Response type: text
+
+bot › İşte mevcut klasördeki dosyalar:
+📁 node_modules
+📁 src
+📄 package.json (1.2 KB)
+📄 README.md (3.4 KB)
+...
+```
+
+### Test 3: Tool Execution (bash)
+```bash
+natureco chat
+
+> git status komutunu çalıştır
+
+# Beklenen:
+[Groq] Tool calls: 1
+🔧 Executing tool: bash
+   Params: {"command":"git status"}
+   ✓ Success
+
+bot › Git durumu:
+On branch main
+Your branch is up to date with 'origin/main'.
+...
+```
+
+### Test 4: Multi-turn Conversation
+```bash
+natureco chat
+
+> README.md dosyasını oku
+bot › [dosya içeriği]
+
+> bu dosyada kaç satır var?
+bot › README.md dosyasında 45 satır var.
+# ↑ Conversation history sayesinde context'i biliyor
+```
+
+### Test 5: Tool Chain
+```bash
+natureco chat
+
+> package.json dosyasını oku, version'u bul ve ekrana yazdır
+
+# Beklenen:
+[Groq] Tool calls: 1 (read_file)
+[Groq] Tool calls: 0 (text response)
+
+bot › package.json dosyasını okudum. Version: 2.0.0
+```
+
+## 🔍 Debug Logs
+
+### Normal Response
+```
+[Groq] Sending request...
+[Groq] Messages: 2
+[Groq] Tools: 4
+
+[Groq] Iteration 1/10
+[Groq] Response type: text
+
+bot › Merhaba!
+```
+
+### Tool Execution
+```
+[Groq] Sending request...
+[Groq] Messages: 2
+[Groq] Tools: 4
+
+[Groq] Iteration 1/10
+[Groq] Response type: tool_calls
+[Groq] Tool calls: 1
+
+🔧 Executing tool: list_dir
+   Params: {"path":"."}
+   ✓ Success
+
+[Groq] Iteration 2/10
+[Groq] Response type: text
+
+bot › İşte dosyalar: ...
+```
+
+### Max Iterations
+```
+[Groq] Iteration 10/10
+[Groq] Max iterations reached
+
+bot › Max tool execution iterations reached.
+```
+
+## ⚙️ Configuration
+
+### Config Dosyası
+```json
+{
+  "groqApiKey": "gsk_xxx...",
+  "apiKey": "nc_xxx...",  // Artık kullanılmıyor
+  "defaultBot": "...",     // Artık kullanılmıyor
+  "defaultBotId": "..."    // Artık kullanılmıyor
+}
+```
+
+### Config Komutları
+```bash
+# Set
+natureco config set groqApiKey gsk_xxx
+
+# Get
+natureco config get groqApiKey
+
+# List all
+natureco config list
+```
+
+## 🚨 Breaking Changes
+
+### v1.x → v2.0.0
+
+**Kaldırılan:**
+- ❌ NatureCo backend dependency
+- ❌ `apiKey` (NatureCo API key) artık kullanılmıyor
+- ❌ `defaultBot` / `defaultBotId` artık kullanılmıyor
+- ❌ Backend'e istek atma
+
+**Eklenen:**
+- ✅ `groqApiKey` config key
+- ✅ Direct Groq API integration
+- ✅ Local tool execution
+- ✅ Conversation history
+- ✅ `list_dir` tool
+
+**Değişmeyen:**
+- ✅ `natureco chat` komutu
+- ✅ Tool definitions (bash, read_file, write_file)
+- ✅ Config sistemi
+
+## 📊 Comparison
+
+| Feature | v1.x | v2.0.0 |
+|---------|------|--------|
+| Backend | NatureCo API | Groq Direct |
+| API Key | nc_xxx | gsk_xxx |
+| Tools | Backend'de | Lokal |
+| Conversation | Backend'de | Memory'de |
+| Tool Loop | Backend'de | CLI'de |
+| Max Iterations | 5 | 10 |
+| list_dir tool | ❌ | ✅ |
+
+## 🔗 Migration Guide
+
+### v1.x Kullanıcıları İçin
+
+```bash
+# 1. Groq API key al
+https://console.groq.com/keys
+
+# 2. CLI'yi güncelle
+npm install -g natureco-cli@2.0.0
+
+# 3. Groq API key set et
+natureco config set groqApiKey gsk_xxx
+
+# 4. Test et
+natureco chat
+> test
+```
+
+**Not:** Eski `apiKey` (NatureCo backend) artık kullanılmıyor ama config'de kalabilir.
+
+## ✅ Checklist
+
+- [x] api.js tamamen yeniden yazıldı
+- [x] Direct Groq integration
+- [x] Tool execution loop (max 10)
+- [x] Conversation history (memory)
+- [x] list_dir tool eklendi
+- [x] Version 2.0.0
+- [x] Dashboard version badge güncellendi
+- [ ] npm publish
+- [ ] Test: basit sohbet
+- [ ] Test: tool execution
+- [ ] Test: multi-turn conversation
+- [ ] Test: tool chain
+
+## 🚀 Deploy Komutları
+
+```bash
+cd natureco-cli
+npm publish
+npm install -g natureco-cli@2.0.0
+natureco --version
+natureco config set groqApiKey gsk_xxx
+natureco chat
+```
+
+## 📝 Notlar
+
+- Groq API free tier: 30 requests/minute
+- Model: llama-3.3-70b-versatile
+- Max tokens: 2000
+- Temperature: 0.7
+- Tool execution tamamen lokal
+- Conversation history process memory'de (restart'ta silinir)
+- Backend artık kullanılmıyor (bağımsız CLI)

package/README.md

@@ -404,4 +404,162 @@ MIT © NatureCo
 
 ---
 
-**Version:** 2.19.1 | **Node.js:** >=16.0.0 | **Platform:** macOS, Windows, Linux
+**Version:** 3.0.0 | **Node.js:** >=18.0.0 (recommended 20+) | **Platform:** macOS, Windows, Linux
+
+---
+
+## ✨ What's New in v4.1 — "MULTI-AGENT"
+
+### 🤖 Phase 7 — Multi-Agent Orkestrasyon
+- **8 uzman agent** (önceki 3, +5 yeni):
+  - `explore`, `general`, `review` (mevcut)
+  - **seo**: Anahtar kelime, meta tag, içerik optimizasyonu
+  - **content**: NatureCo için SEO uyumlu özgün içerik
+  - **security**: OWASP top 10, dependency güvenliği
+  - **translator**: Doğal, akıcı çeviriler (teknik terim korumalı)
+  - **debugger**: Hata analizi, kök neden tespiti
+- **`natureco team list`** — Tüm agent tipleri
+- **`natureco team status`** — Çalışan/tamamlanan/başarısız istatistikleri
+- **`natureco team spawn <type> <task>`** — Tek agent çalıştır
+- **`natureco team parallel '<json>'`** — N agent paralel çalıştır
+
+### 🌿 Phase 6 — NatureCo Özgü Entegrasyonlar
+OpenClaw generic bir agent. NatureCo CLI, **natureco.me platformunun native parçası**.
+
+- **`natureco naturehub post "<text>"`** — Topluluk akışına içerik yayınla
+- **`natureco medium draft <file.md>`** — Markdown'tan Medium taslağı (Parton'un ayda 4 makale hedefi için)
+- **`natureco medium publish <file.md>`** — Doğrudan Medium'da yayınla
+- **`natureco seo audit <url>`** — Tam SEO denetimi, 100-üzerinden skor
+- **`natureco seo audit https://natureco.me`** → **71/100**, H1 eksik, title uzunluğu raporlandı
+- **`natureco xp`** — 8 seviye gamification (Tohum → Galaksi), 7 ödül
+
+### 🎯 Canlı SEO Denetimi (natureco.me)
+
+```
+✅ Description (149 karakter)
+✅ Canonical URL var
+✅ Open Graph (7 tag)
+✅ Twitter Card (6 tag)
+✅ Schema.org markup var
+⚠️ Title çok uzun (64 karakter, ideal: 50-60)
+❌ H1 tag eksik
+⚠️ İçerik kısa (9 kelime)
+🎯 SEO Skoru: 71/100
+```
+
+### 🖥️ Phase 5 — Local Web Dashboard
+- **`natureco dashboard`** → http://127.0.0.1:7421 (otomatik tarayıcı açılır)
+- **Vanilla JS + HTML** — framework yok, hızlı, dependency yok
+- **6 widget** tek sayfada:
+  - 💰 Bugünkü maliyet (limit bar ile)
+  - 📦 Yüklü skill + bekleyen proposal sayısı
+  - ⏰ Aktif cron sayısı
+  - 📋 Bugünkü audit kaydı
+  - 💵 Provider/model bazlı maliyet breakdown
+  - 🧠 Self-evolving skill proposals tablosu
+  - 📜 Son tool çağrıları timeline
+- **Otomatik yenileme** — 5 saniyede bir auto-refresh
+- **JSON API** — `/api` endpoint
+- **PID management** — start/stop/status/url
+
+### 🆚 OpenClaw Dashboard vs NatureCo
+
+| Özellik | OpenClaw | NatureCo CLI v3.4 |
+|---------|---------|-------------------|
+| Local web dashboard | ❌ (cloud bağımlı) | ✅ (127.0.0.1:7421) |
+| Framework dependency | — | **Yok** (vanilla JS) |
+| Real-time auto-refresh | ❌ | ✅ (5s) |
+| Maliyet görselleştirme | ❌ | ✅ |
+| Self-evolving skill UI | ❌ | ✅ |
+| Audit log görüntüleme | ❌ | ✅ |
+
+### 💰 Phase 4 — Maliyet Optimizasyonu
+- **21 model × provider** fiyat tablosu (Groq, OpenAI, Anthropic, DeepSeek, Together, Fireworks, Ollama)
+- **Model router** — prompt karmaşıklığını tahmin eder, en uygun (en ucuz) modeli önerir
+  - Simple: `llama-3.1-8b-instant` ($0.05/M in)
+  - Medium: `llama-3.3-70b-versatile` ($0.59/M in)
+  - Complex: kod için `claude-sonnet-4-6` veya `groq:llama-3.3-70b`
+  - Creative: `claude-sonnet-4-6` veya `gpt-4o`
+- **`natureco cost today|week|month|all`** — Provider/model bazlı maliyet breakdown
+- **`natureco cost budget`** — Günlük $5, aylık $100 limit, görsel progress bar
+- **`natureco cost model "<prompt>"`** — Bir prompt için en uygun modeli öner
+- **`natureco cost prices`** — Tüm fiyatları gör
+- **`natureco cost set <key> <value>`** — Bütçe ayarla (örn: `set dailyLimit 3.00`)
+
+### 💵 OpenClaw Karşılaştırması
+
+| Kullanım | OpenClaw | NatureCo CLI v3.3 |
+|---------|---------|-------------------|
+| Aylık ortalama maliyet | $50-200 | **$5-15** |
+| Model seçimi | Sabit (kullanıcı bilinçli değil) | Otomatik router |
+| Maliyet görünürlüğü | ❌ | ✅ (real-time) |
+| Bütçe limiti | ❌ | ✅ (günlük + aylık) |
+| Otomatik downgrade | ❌ | ✅ (%90'da) |
+| Prompt analizi ile model seçimi | ❌ | ✅ |
+
+### 🧠 Phase 3 — Self-Evolving Skills
+- **Pattern detector** — Aynı tool çağrı pattern'i 3 kez tekrar → otomatik skill önerisi
+- **Akıllı normalize** — URL, dosya yolu, sayı, UUID, tarih generic hale getirilir (gerçek değerler değil türler eşleşir)
+- **Sliding window** — Son 5 tool çağrısından pattern çıkarır
+- **24 saat cooldown** — Aynı pattern spam olmaz
+- **`natureco skills suggest`** — Bekleyen proposal'ları listele
+- **`natureco skills accept <id>`** — Otomatik SKILL.md oluştur
+- **`natureco skills reject <id>`** — Reddet
+- **`natureco skills forget`** — Pattern hafızasını sıfırla
+
+### 🎯 Self-Evolving Test Sonucu
+3 ardışık `web_search → web_fetch → write_file` çağrısı sonrası sistem otomatik olarak:
+- Pattern'i tanıdı
+- `web-search-to-web-fetch` adında skill önerisi oluşturdu
+- Kabul edilirse `~/.natureco/skills/web-search-to-web-fetch/SKILL.md` otomatik üretildi
+
+### 🚀 OpenClaw Karşılaştırması (güncel)
+
+| Özellik | OpenClaw | NatureCo CLI v3.2 |
+|---------|---------|-------------------|
+| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
+| Onay mekanizması | ❌ | ✅ (5 mod) |
+| Audit log | ❌ | ✅ (JSONL, 30 gün) |
+| Secret scanner | ❌ | ✅ (22 pattern + entropy) |
+| **Self-evolving skills** | ❌ | ✅ (Hermes tarzı) |
+| Türkçe yerelleştirme | ❌ | ✅ |
+
+### 🛡️ Phase 2 — Güvenlik
+- **Merkezi audit log** — Tüm komut, onay, tool call, secret erişimi JSONL olarak kayıt altında (30 gün retention, async non-blocking)
+- **Secret scanner** — 22 bilinen secret pattern + Shannon entropi analizi (OpenAI, Anthropic, Groq, AWS, GitHub, Slack, Stripe, NatureCo, JWT, private key vs.)
+- **`natureco audit`** — Bugünkü logları göster, 24 saat istatistik, dosya listesi, canlı tail, arama, cleanup
+- **Doctor 2 yeni check:** `auditLog`, `secretsClean`
+- **Toplam doctor check:** 10 (Phase 1: 8, ilk halde: 5)
+
+### 🚀 OpenClaw Karşılaştırması (güncel)
+
+| Özellik | OpenClaw | NatureCo CLI v3.1 |
+|---------|---------|-------------------|
+| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
+| First-run auto-detection | ❌ | ✅ |
+| Onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli, 5 mod) |
+| Audit log | ❌ | ✅ (JSONL, 30 gün retention) |
+| Secret scanner | ❌ | ✅ (22 pattern + entropy) |
+| Self-evolving skills | ❌ | ✅ (Phase 3'te) |
+| Real disk space check | ❌ (RAM ölçüyordu) | ✅ |
+| Türkçe yerelleştirme | ❌ | ✅ |
+
+### 🎯 Phase 1 — Brand & Onboarding
+- **First-run auto-detection** — `natureco` (boş argüman) kurulum yoksa wizard'a yönlendirir
+- **Yeni NatureCo ASCII art logosu** — brand kimliği her yerde tutarlı
+- **`natureco doctor` genişletildi** — 8 sistem check (önceki: 5)
+  - `configExists`, `nodeVersion`, `npmPackages`, `diskSpace`, `writePermission`
+  - Yeni: `apiKeyValid`, `providerReachable`, `dataDirs` (auto-create eksik dizinler)
+- **Daily tip** — gateway ekranı her gün farklı NatureCo özelliği önerir
+
+### 🚀 OpenClaw Karşılaştırması
+
+| Özellik | OpenClaw | NatureCo CLI v3.0 |
+|---------|---------|-------------------|
+| İlk kurulum süresi | 30-60 dakika | **60 saniye** |
+| First-run auto-detection | ❌ | ✅ |
+| Güvenlik: onay mekanizması | ❌ (tam erişim) | ✅ (risk-seviyeli) |
+| Kurulum hatalarını otomatik düzeltme | ❌ | ✅ (doctor auto-fix) |
+| Self-evolving skills | ❌ | ✅ (Phase 3'te) |
+| Gerçek disk alanı kontrolü | ❌ (RAM ölçüyordu) | ✅ |
+| Türkçe yerelleştirme | ❌ | ✅ |