natureco-cli 4.9.1 → 5.0.1

package/CHANGELOG.md

@@ -1,422 +1,486 @@
-# Changelog
-
-All notable changes to NatureCo CLI will be documented in this file.
-
-## [4.2.0] - 2026-06-22 — "LAUNCH READY"
-
-### 🚀 Headline
-**v4.2.0 ile NatureCo CLI npm'e publish'a hazır.** OpenClaw'ın açık ara üstünü.
-
-### ✨ Added
-- **package.json launch-ready:**
-  - Açıklayıcı description, 18 keywords (SEO optimize)
-  - `repository`, `bugs`, `homepage`, `author` (Gencay Olgun) alanları
-  - `postinstall` script: `natureco doctor` otomatik çalışır
-  - `prepublishOnly`: syntax check + test
-  - Files: README, CHANGELOG, AUDIT, DEPLOY docs dahil
-- **LAUNCH.md** — Pazarlama materyali:
-  - Reddit/HN/Twitter/Medium/Discord mesajları (Parton imzalı)
-  - Hedef kitle segmentleri
-  - 30-gün başarı metrikleri
-  - Launch checklist
-- **npm publish adımları** dokümante edildi
-
-### 📊 Final İstatistikler
-- 152 JS dosyası (8 yeni eklendi)
-- 32K+ satır kod
-- 11 utility modülü (5 yeni)
-- 95+ CLI komutu (8 yeni)
-- 8 phase, 0 blocking bug
-- v2.23.32 → v4.2.0 (8 minor versiyon)
-
-### 🎯 Hedef
-- İlk hafta: 1,000 npm indirme
-- İlk ay: 500 GitHub yıldız, 200 aktif kullanıcı
-
----
-
-## 🏁 TÜM PHASE'LER TAMAMLANDI
-
-- [x] Phase 0: Audit
-- [x] Phase 1: Brand & Onboarding (v3.0.0)
-- [x] Phase 2: Defense-in-Depth (v3.1.0)
-- [x] Phase 3: Self-Evolving Skills (v3.2.0)
-- [x] Phase 4: Cost-Optimized (v3.3.0)
-- [x] Phase 5: Developer Experience (v3.4.0)
-- [x] Phase 6: NatureCo Native (v4.0.0)
-- [x] Phase 7: Multi-Agent (v4.1.0)
-- [x] Phase 8: Launch Ready (v4.2.0)
-
-**OpenClaw'ın yerini almaya hazırız.** 🌿
-
-### 🤖 Headline
-Tek agent değil, **agent ağı**. OpenClaw single-agent — NatureCo multi-agent.
-
-### ✨ Added
-- **`src/utils/sub-agent.js`** genişletildi: 3 → 8 agent tipi
-  - `explore`, `general`, `review` (mevcut)
-  - **Yeni:** `seo`, `content`, `security`, `translator`, `debugger`
-  - Her biri farklı system prompt ile uzmanlaşmış
-- **`natureco team`** — Multi-agent orkestrasyon komutu
-  - `team list`: 8 agent tipi ve açıklamaları
-  - `team status`: Son çalışan agent istatistikleri (toplam/çalışan/tamamlanan/başarısız)
-  - `team spawn <type> <task>`: Tek agent çalıştır (token kullanım raporu ile)
-  - `team parallel '<json>'`: N agent paralel çalıştır, sonuçları birleştir
-- **Mevcut `spawnSubAgent`/`spawnParallel` altyapısı** zaten vardı (Phase 7 bunu sadece genişletti)
-
-### 🔜 Final Phase
-- v4.2.0 — Phase 8: Launch & marketing
-
-### 🌿 Headline
-Generic agent değil, **NatureCo platformunun native parçası**. OpenClaw generic — NatureCo natureco.me'ye özel.
-
-### ✨ Added
-- **`natureco naturehub`** — Nature Hub topluluk akışına içerik yayınla (post|list|trending|config)
-  - Token tabanlı, `natureco config set naturehubToken`
-  - Offline: yerel JSONL'e kaydeder, API hazır olunca gönderir
-- **`natureco medium`** — Parton'un ayda 4 makale hedefi için (draft|publish|list)
-  - Markdown dosyasından taslak/yayın
-  - Medium integration token gerektirir
-  - Yerel taslak kayıt (`~/.natureco/medium-drafts/`)
-- **`natureco seo`** — URL SEO denetimi (audit|meta|speed)
-  - Title, description, canonical, OG, Twitter Card, schema.org
-  - H1-H3 heading analizi, image alt kontrolü
-  - Word count ve 100-üzerinden skor
-  - **Test: natureco.me → 71/100, H1 eksik bildirildi**
-- **`natureco xp`** — Gamification (stats|leaderboard|rewards)
-  - 8 seviye: Tohum → Galaksi (0 → 12,000 XP)
-  - 7 farklı ödül (sticker → Founder statüsü)
-  - XP history (son 100 kayıt)
-
-### 🎯 Phase 6 Canlı Test
-- **SEO audit natureco.me**: 71/100 skor, H1 eksikliği, title uzunluğu tespit edildi
-- **XP sistemi**: 0 XP, Lv.1 Tohum, sonraki Filiz (100 XP)
-
-### 🔜 Coming
-- v4.1.0 — Phase 7: Multi-agent orkestrasyon (sub-agents)
-- v4.2.0 — Phase 8: Launch & marketing
-
-### 🖥️ Headline
-OpenClaw "kara kutu". NatureCo CLI **şeffaf** — tüm veriler tek bir local dashboard'da.
-
-### ✨ Added
-- **`src/utils/dashboard-server.js`** — Local web dashboard
-  - Port 7421, vanilla JS + HTML (framework yok)
-  - 6 widget: bugünkü maliyet, yüklü skill, aktif cron, audit kayıtları, provider bazlı maliyet, self-evolving proposals, son tool çağrıları
-  - Otomatik 5 saniyede bir yenileme (auto-refresh)
-  - JSON API endpoint (`/api`)
-  - PID file ile kolay durdurma
-- **`src/commands/dashboard.js`** — `natureco dashboard [start|status|stop|url]`
-  - Port kontrolü (zaten çalışıyor mu?)
-  - Process kill ile temiz shutdown
-  - macOS/Windows/Linux uyumlu tarayıcı açma
-
-### 📊 Phase 5 Dashboard Test
-- HTTP 200, 8575 byte HTML
-- API JSON: tüm Phase 3 proposal verileri görünüyor
-- Real-time auto-refresh çalışıyor
-
-### 🔜 Coming
-- v4.0.0 — Phase 6: NatureCo özgü entegrasyonlar (naturehub, medium, seo)
-- v4.1.0 — Phase 7: Multi-agent orkestrasyon
-- v4.2.0 — Phase 8: Launch & marketing
-
-### 💰 Headline
-OpenClaw kullanıcıları ayda $50-200 token faturası ödüyor. NatureCo hedef: $5-15/ay akıllı routing ile.
-
-### ✨ Added
-- **`src/utils/cost-tracker.js`** — Maliyet hesaplama ve model router
-  - 21 model × provider için güncel fiyat tablosu (Groq, OpenAI, Anthropic, DeepSeek, Together, Fireworks, Ollama)
-  - Token → USD dönüşümü (input/output ayrı)
-  - **Model router**: 4 karmaşıklık seviyesi (simple/medium/complex/creative)
-    - Basit soru → llama-3.1-8b-instant ($0.05 in)
-    - Kod → llama-3.3-70b-versatile veya claude-sonnet
-    - Yaratıcı yazı → claude-sonnet veya gpt-4o
-  - **Otomatik karmaşıklık tahmini**: prompt içeriğinden (kod işaretleri, anahtar kelimeler, uzunluk)
-  - **Bütçe sistemi**: günlük $5, aylık $100 limit, %75 uyarı, %90 otomatik downgrade
-- **`src/commands/cost.js`** — `natureco cost [today|week|month|all|budget|set|model|prices]`
-  - Renkli bar chart'lar
-  - Provider ve model bazlı breakdown
-  - Bütçe durumu görselleştirmesi
-- **`bin/natureco.js`** — `cost` komutu kayıtlı
-
-### 📊 Phase 4 Test Sonucu
-- 3 farklı provider kullanımı kaydedildi → $0.0252 toplam
-- Basit prompt: `groq:llama-3.1-8b-instant` önerildi (en ucuz)
-- Karmaşık kod prompt: `groq:llama-3.3-70b-versatile` önerildi
-- Bütçe görsel: %1 kullanım (günlük limit $5)
-
-### 🔜 Coming
-- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
-- v4.0.0 — Phase 6-8: NatureCo native + launch
-
-### 🧠 Headline
-Kullanımın tekrar eden pattern'lerinden otomatik skill oluştur. Hermes Agent'tan ilham, NatureCo uyarlaması.
-
-### ✨ Added
-- **`src/utils/pattern-detector.js`** — Tool çağrı pattern detector
-  - Normalize: URL'ler, dosya yolları, sayılar, UUID'ler, ISO tarihler, email'ler, hex string'ler generic hale getirilir
-  - Sliding window (son 1-5 çağrı)
-  - Aynı pattern 3+ kez tekrar → proposal oluştur
-  - 24 saat cooldown (aynı pattern'i tekrar önerme)
-  - Persistent log: `~/.natureco/patterns.json`
-  - Proposal kayıt: `~/.natureco/skill-proposals.json`
-- **`src/commands/skills.js`** — 4 yeni alt komut:
-  - `skills suggest` — Bekleyen proposal'ları göster
-  - `skills accept <id>` — Proposal'ı SKILL.md olarak oluştur
-  - `skills reject <id>` — Proposal'ı reddet
-  - `skills forget` — Pattern hafızasını sıfırla
-- **Otomatik SKILL.md üretimi** — accepted proposal'lardan `~/.natureco/skills/<name>/SKILL.md`
-- **Audit entegrasyonu** — Her skill kabulü `SKILL_AUTO` action'ı olarak loglanır
-
-### 🐛 Fixed
-- Pattern detector'da fingerprint bug'ı: normalize edilmiş string'ler tekrar normalize ediliyordu (boş pattern üretiyordu)
-
-### 🔜 Coming
-- v3.3.0 — Phase 4: Maliyet optimizasyonu (model router, token budget)
-- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
-
-### 🛡️ Headline
-OpenClaw'ın en zayıf olduğu alan: güvenlik. v3.1.0 ile NatureCo CLI artık OpenClaw'tan **açık ara daha güvenli**.
-
-### ✨ Added
-- **`src/utils/audit.js`** — Merkezi audit log sistemi (JSONL, 30 gün retention, async, non-blocking)
-  - 19 action tipi (command, approval, tool, auth, secret, config, cron, skill, error, info)
-  - 24 saat istatistik, dosya bazlı günlük log'lar, auto-cleanup
-- **`src/utils/secret-scanner.js`** — 22 bilinen secret pattern tespiti (OpenAI, Anthropic, Groq, AWS, GitHub, Slack, Stripe, Tavily, HuggingFace, Replicate, Firecrawl, NatureCo, JWT, private key, vs)
-  - Shannon entropi analizi (bilinmeyen format yüksek entropi secret'lar)
-  - Otomatik maskeleme (`sk-a***9012`)
-  - Cross-platform dosya tarama (skip: node_modules, .git, dist, lock files)
-- **`src/commands/audit.js`** — `natureco audit [today|stats|show|search|files|cleanup|tail]`
-  - Renkli action kategorileri
-  - 24 saat bar chart
-  - Canlı tail modu (yeni kayıtları real-time göster)
-- **`bin/natureco.js`** — `audit` komutu kayıtlı
-- **`src/commands/doctor.js`** — 2 yeni check:
-  - `auditLog`: Audit dizini yazılabilir mi?
-  - `secretsClean`: Çalışma dizininde secret var mı?
-
-### 📊 Phase 2 Doctor Sonuçları
-- **10 check** toplam (Phase 1'de 8, ilk halde 5)
-- 6/10 geçti (fresh setup'ta config henüz yok — beklenen)
-
-### 🔜 Coming
-- v3.2.0 — Phase 3: Self-evolving skills
-- v3.3.0 — Phase 4: Maliyet optimizasyonu
-- v3.4.0 — Phase 5: Geliştirici deneyimi
-
-### 🔥 Headline
-OpenClaw'dan daha güvenli, daha hızlı, daha ucuz. İlk kurulum 60 saniye.
-
-### ✨ Added
-- **First-run auto-detection** (`bin/natureco.js`) — `natureco` (boş argüman) kurulum yoksa otomatik setup wizard'a yönlendirir
-- **`src/utils/branding.js`** — merkezi brand kimliği (renkler, ASCII art, daily tip)
-- **Doctor 3 yeni check:** `apiKeyValid`, `providerReachable`, `dataDirs` (auto-fix ile)
-- **Setup wizard** artık tam NatureCo logosuyla açılıyor (eski ASCII cat yerine)
-- **README v3.0 notları + OpenClaw karşılaştırma tablosu**
-
-### 🐛 Fixed
-- **Doctor `diskSpace` bug:** `os.freemem()` (RAM) kullanıyordu, artık gerçek disk alanı (`df -k`, Windows: `Get-PSDrive`)
-- **README/package.json versiyon senkron:** 2.19.1 → 3.0.0
-- **README Node engine:** >=16 → >=18 (package.json ile uyumlu)
-
-### 📁 Audit (Phase 0)
-- 152 JS dosyası, syntax %100 temiz, 0 require hatası
-- 10 TODO/FIXME, 10 boş fonksiyon, 5 deprecated existsSync tespit edildi
-- AUDIT.md oluşturuldu
-
-### 🔜 Coming in next versions
-- v3.1.0 — Phase 2: Defense-in-depth güvenlik (approval v2, audit log, sandbox)
-- v3.2.0 — Phase 3: Self-evolving skills
-- v3.3.0 — Phase 4: Maliyet optimizasyonu (model router)
-- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
-- v4.0.0 — Phase 6-8: NatureCo native + launch
-
-## [1.0.0] - 2026-05-10
-
-### Added
-
-#### Core Features
-- **First-Time Setup Wizard**
-  - Automatic setup on first run
-  - Interactive API key validation with live check
-  - Bot selection from user's bots
-  - Optional Telegram integration
-  - Creates `~/.natureco/` directory structure
-  - Beautiful boxed interface
-  - Can be run manually with `natureco setup`
-
-- **Authentication System**
-  - Login/logout with API key
-  - Secure storage in `~/.natureco/config.json`
-  - Support for both `nco_` and `nc_` key formats
-
-- **Bot Management**
-  - List available bots
-  - Interactive chat with bots
-  - Bot switching within chat
-
-- **Gateway Screen**
-  - Beautiful boxed interface
-  - Login status display
-  - Active bot information
-  - Skill and MCP server counts
-
-#### Project Management
-- **Project Initialization**
-  - `natureco init` command
-  - Creates `.natureco/` folder structure
-  - Interactive bot and skill selection
-  - Generates `config.json` and `AGENTS.md`
-
-- **Configuration System**
-  - Global config: `~/.natureco/config.json`
-  - Project config: `.natureco/config.json`
-  - Get/set/list commands
-  - Hierarchical config management
-
-#### Skills System
-- **Three-Tier Hierarchy**
-  - Built-in skills (code-review, summarize, translate)
-  - User skills (`~/.natureco/skills/`)
-  - Project skills (`.natureco/skills/`)
-
-- **Skill Management**
-  - List installed skills
-  - Install from NatureHub
-  - Remove skills
-  - Update all skills
-  - Create new skill templates
-
-- **Skill Features**
-  - Automatic prompt injection in chat
-  - Requirement gating (bins, env vars, OS)
-  - SKILL.md format with frontmatter
-  - Metadata validation
-
-#### Chat Features
-- **Interactive Chat**
-  - Real-time conversation with bots
-  - Readline interface with arrow key support
-  - Command history (last 100 commands)
-  - Conversation history saved to `~/.natureco/history/`
-
-- **Chat Commands**
-  - `/clear` - Clear screen
-  - `/bot [name]` - Switch bot or list bots
-  - `/skills` - Show active skills
-  - `/help` - Show chat help
-  - `exit`, `quit` - Exit chat
-
-- **Quick Commands**
-  - `natureco ask "<question>"` - Single-shot questions
-  - `natureco run <script.md>` - Run markdown scripts
-  - Pipe support for ask command
-
-#### MCP Server Support
-- **Server Management**
-  - List MCP servers
-  - Add servers (interactive or template-based)
-  - Remove servers
-  - Test connections
-  - Enable/disable servers
-
-- **Ready Templates**
-  - `filesystem` - File system operations
-  - `github` - GitHub operations
-  - `postgres` - PostgreSQL database
-  - `sqlite` - SQLite database
-  - `brave-search` - Web search
-
-- **Configuration**
-  - Stored in `~/.natureco/config.json`
-  - Environment variable support
-  - Auto-approve lists
-  - Disable/enable flags
-
-#### AGENTS.md Support
-- Project-specific bot instructions
-- Automatic prompt injection in chat
-- Markdown format
-- Created during `natureco init`
-
-#### Update System
-- **Auto-Update Notifications**
-  - Checks every 24 hours
-  - Notifies when new version available
-  - Uses update-notifier package
-
-- **Manual Update Check**
-  - `natureco update` command
-  - Shows current and latest versions
-  - Provides update instructions
-
-#### UI/UX
-- Colorful terminal interface with chalk
-- Loading animations with spinners
-- Boxed gateway screen
-- Monospace formatting
-- Error messages in Turkish
-- Cross-platform support (Windows, macOS, Linux)
-
-### Technical Details
-
-#### Dependencies
-- `chalk@4.1.2` - Terminal colors
-- `commander@11.1.0` - CLI framework
-- `inquirer@8.2.7` - Interactive prompts
-- `boxen@5.1.2` - Terminal boxes
-- `ora@5.4.1` - Spinners
-- `conf@10.2.0` - Config management
-- `update-notifier@6.0.2` - Update notifications
-
-#### API Integration
-- Base URL: `https://api.natureco.me`
-- Endpoints:
-  - `GET /api/v1/bots` - List bots
-  - `POST /api/agent/chat` - Chat with bot
-- Headers:
-  - `Authorization: Bearer <apiKey>`
-  - `X-User-ID: cli-user`
-- Platform identifier: `cli`
-
-#### File Structure
-```
-~/.natureco/
-├── config.json          # Global config
-├── skills/              # User skills
-└── history/             # Chat history
-    └── <bot-id>.json
-
-.natureco/               # Project folder
-├── config.json          # Project config
-├── AGENTS.md            # Bot instructions
-└── skills/              # Project skills
-```
-
-### Commands
-
-```bash
-natureco                    # Gateway screen (runs setup if needed)
-natureco setup              # Run setup wizard
-natureco login              # Login
-natureco logout             # Logout
-natureco bots               # List bots
-natureco chat <bot>         # Start chat
-natureco ask "<question>"   # Quick question
-natureco run <script.md>    # Run script
-natureco init               # Initialize project
-natureco skills [action]    # Manage skills
-natureco mcp [action]       # Manage MCP servers
-natureco config <action>    # Manage config
-natureco update             # Check updates
-natureco help               # Show help
-```
-
-### Requirements
-- Node.js >= 18.0.0 (for native fetch)
-- npm or yarn
-- NatureCo API key
-
-### License
-MIT
+# Changelog
+
+All notable changes to NatureCo CLI will be documented in this file.
+
+## [4.2.0] - 2026-06-22 — "LAUNCH READY"
+
+### 🚀 Headline
+**v4.2.0 ile NatureCo CLI npm'e publish'a hazır.** OpenClaw'ın açık ara üstünü.
+
+### ✨ Added
+- **package.json launch-ready:**
+  - Açıklayıcı description, 18 keywords (SEO optimize)
+  - `repository`, `bugs`, `homepage`, `author` (Gencay Olgun) alanları
+  - `postinstall` script: `natureco doctor` otomatik çalışır
+  - `prepublishOnly`: syntax check + test
+  - Files: README, CHANGELOG, AUDIT, DEPLOY docs dahil
+- **LAUNCH.md** — Pazarlama materyali:
+  - Reddit/HN/Twitter/Medium/Discord mesajları (Parton imzalı)
+  - Hedef kitle segmentleri
+  - 30-gün başarı metrikleri
+  - Launch checklist
+- **npm publish adımları** dokümante edildi
+
+### 📊 Final İstatistikler
+- 152 JS dosyası (8 yeni eklendi)
+- 32K+ satır kod
+- 11 utility modülü (5 yeni)
+- 95+ CLI komutu (8 yeni)
+- 8 phase, 0 blocking bug
+- v2.23.32 → v4.2.0 (8 minor versiyon)
+
+### 🎯 Hedef
+- İlk hafta: 1,000 npm indirme
+- İlk ay: 500 GitHub yıldız, 200 aktif kullanıcı
+
+---
+
+## 🏁 TÜM PHASE'LER TAMAMLANDI
+
+- [x] Phase 0: Audit
+- [x] Phase 1: Brand & Onboarding (v3.0.0)
+- [x] Phase 2: Defense-in-Depth (v3.1.0)
+- [x] Phase 3: Self-Evolving Skills (v3.2.0)
+- [x] Phase 4: Cost-Optimized (v3.3.0)
+- [x] Phase 5: Developer Experience (v3.4.0)
+- [x] Phase 6: NatureCo Native (v4.0.0)
+- [x] Phase 7: Multi-Agent (v4.1.0)
+- [x] Phase 8: Launch Ready (v4.2.0)
+
+**OpenClaw'ın yerini almaya hazırız.** 🌿
+
+### 🤖 Headline
+Tek agent değil, **agent ağı**. OpenClaw single-agent — NatureCo multi-agent.
+
+### ✨ Added
+- **`src/utils/sub-agent.js`** genişletildi: 3 → 8 agent tipi
+  - `explore`, `general`, `review` (mevcut)
+  - **Yeni:** `seo`, `content`, `security`, `translator`, `debugger`
+  - Her biri farklı system prompt ile uzmanlaşmış
+- **`natureco team`** — Multi-agent orkestrasyon komutu
+  - `team list`: 8 agent tipi ve açıklamaları
+  - `team status`: Son çalışan agent istatistikleri (toplam/çalışan/tamamlanan/başarısız)
+  - `team spawn <type> <task>`: Tek agent çalıştır (token kullanım raporu ile)
+  - `team parallel '<json>'`: N agent paralel çalıştır, sonuçları birleştir
+- **Mevcut `spawnSubAgent`/`spawnParallel` altyapısı** zaten vardı (Phase 7 bunu sadece genişletti)
+
+### 🔜 Final Phase
+- v4.2.0 — Phase 8: Launch & marketing
+
+### 🌿 Headline
+Generic agent değil, **NatureCo platformunun native parçası**. OpenClaw generic — NatureCo natureco.me'ye özel.
+
+### ✨ Added
+- **`natureco naturehub`** — Nature Hub topluluk akışına içerik yayınla (post|list|trending|config)
+  - Token tabanlı, `natureco config set naturehubToken`
+  - Offline: yerel JSONL'e kaydeder, API hazır olunca gönderir
+- **`natureco medium`** — Parton'un ayda 4 makale hedefi için (draft|publish|list)
+  - Markdown dosyasından taslak/yayın
+  - Medium integration token gerektirir
+  - Yerel taslak kayıt (`~/.natureco/medium-drafts/`)
+- **`natureco seo`** — URL SEO denetimi (audit|meta|speed)
+  - Title, description, canonical, OG, Twitter Card, schema.org
+  - H1-H3 heading analizi, image alt kontrolü
+  - Word count ve 100-üzerinden skor
+  - **Test: natureco.me → 71/100, H1 eksik bildirildi**
+- **`natureco xp`** — Gamification (stats|leaderboard|rewards)
+  - 8 seviye: Tohum → Galaksi (0 → 12,000 XP)
+  - 7 farklı ödül (sticker → Founder statüsü)
+  - XP history (son 100 kayıt)
+
+### 🎯 Phase 6 Canlı Test
+- **SEO audit natureco.me**: 71/100 skor, H1 eksikliği, title uzunluğu tespit edildi
+- **XP sistemi**: 0 XP, Lv.1 Tohum, sonraki Filiz (100 XP)
+
+### 🔜 Coming
+- v4.1.0 — Phase 7: Multi-agent orkestrasyon (sub-agents)
+- v4.2.0 — Phase 8: Launch & marketing
+
+### 🖥️ Headline
+OpenClaw "kara kutu". NatureCo CLI **şeffaf** — tüm veriler tek bir local dashboard'da.
+
+### ✨ Added
+- **`src/utils/dashboard-server.js`** — Local web dashboard
+  - Port 7421, vanilla JS + HTML (framework yok)
+  - 6 widget: bugünkü maliyet, yüklü skill, aktif cron, audit kayıtları, provider bazlı maliyet, self-evolving proposals, son tool çağrıları
+  - Otomatik 5 saniyede bir yenileme (auto-refresh)
+  - JSON API endpoint (`/api`)
+  - PID file ile kolay durdurma
+- **`src/commands/dashboard.js`** — `natureco dashboard [start|status|stop|url]`
+  - Port kontrolü (zaten çalışıyor mu?)
+  - Process kill ile temiz shutdown
+  - macOS/Windows/Linux uyumlu tarayıcı açma
+
+### 📊 Phase 5 Dashboard Test
+- HTTP 200, 8575 byte HTML
+- API JSON: tüm Phase 3 proposal verileri görünüyor
+- Real-time auto-refresh çalışıyor
+
+### 🔜 Coming
+- v4.0.0 — Phase 6: NatureCo özgü entegrasyonlar (naturehub, medium, seo)
+- v4.1.0 — Phase 7: Multi-agent orkestrasyon
+- v4.2.0 — Phase 8: Launch & marketing
+
+### 💰 Headline
+OpenClaw kullanıcıları ayda $50-200 token faturası ödüyor. NatureCo hedef: $5-15/ay akıllı routing ile.
+
+### ✨ Added
+- **`src/utils/cost-tracker.js`** — Maliyet hesaplama ve model router
+  - 21 model × provider için güncel fiyat tablosu (Groq, OpenAI, Anthropic, DeepSeek, Together, Fireworks, Ollama)
+  - Token → USD dönüşümü (input/output ayrı)
+  - **Model router**: 4 karmaşıklık seviyesi (simple/medium/complex/creative)
+    - Basit soru → llama-3.1-8b-instant ($0.05 in)
+    - Kod → llama-3.3-70b-versatile veya claude-sonnet
+    - Yaratıcı yazı → claude-sonnet veya gpt-4o
+  - **Otomatik karmaşıklık tahmini**: prompt içeriğinden (kod işaretleri, anahtar kelimeler, uzunluk)
+  - **Bütçe sistemi**: günlük $5, aylık $100 limit, %75 uyarı, %90 otomatik downgrade
+- **`src/commands/cost.js`** — `natureco cost [today|week|month|all|budget|set|model|prices]`
+  - Renkli bar chart'lar
+  - Provider ve model bazlı breakdown
+  - Bütçe durumu görselleştirmesi
+- **`bin/natureco.js`** — `cost` komutu kayıtlı
+
+### 📊 Phase 4 Test Sonucu
+- 3 farklı provider kullanımı kaydedildi → $0.0252 toplam
+- Basit prompt: `groq:llama-3.1-8b-instant` önerildi (en ucuz)
+- Karmaşık kod prompt: `groq:llama-3.3-70b-versatile` önerildi
+- Bütçe görsel: %1 kullanım (günlük limit $5)
+
+### 🔜 Coming
+- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
+- v4.0.0 — Phase 6-8: NatureCo native + launch
+
+### 🧠 Headline
+Kullanımın tekrar eden pattern'lerinden otomatik skill oluştur. Hermes Agent'tan ilham, NatureCo uyarlaması.
+
+### ✨ Added
+- **`src/utils/pattern-detector.js`** — Tool çağrı pattern detector
+  - Normalize: URL'ler, dosya yolları, sayılar, UUID'ler, ISO tarihler, email'ler, hex string'ler generic hale getirilir
+  - Sliding window (son 1-5 çağrı)
+  - Aynı pattern 3+ kez tekrar → proposal oluştur
+  - 24 saat cooldown (aynı pattern'i tekrar önerme)
+  - Persistent log: `~/.natureco/patterns.json`
+  - Proposal kayıt: `~/.natureco/skill-proposals.json`
+- **`src/commands/skills.js`** — 4 yeni alt komut:
+  - `skills suggest` — Bekleyen proposal'ları göster
+  - `skills accept <id>` — Proposal'ı SKILL.md olarak oluştur
+  - `skills reject <id>` — Proposal'ı reddet
+  - `skills forget` — Pattern hafızasını sıfırla
+- **Otomatik SKILL.md üretimi** — accepted proposal'lardan `~/.natureco/skills/<name>/SKILL.md`
+- **Audit entegrasyonu** — Her skill kabulü `SKILL_AUTO` action'ı olarak loglanır
+
+### 🐛 Fixed
+- Pattern detector'da fingerprint bug'ı: normalize edilmiş string'ler tekrar normalize ediliyordu (boş pattern üretiyordu)
+
+### 🔜 Coming
+- v3.3.0 — Phase 4: Maliyet optimizasyonu (model router, token budget)
+- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
+
+### 🛡️ Headline
+OpenClaw'ın en zayıf olduğu alan: güvenlik. v3.1.0 ile NatureCo CLI artık OpenClaw'tan **açık ara daha güvenli**.
+
+### ✨ Added
+- **`src/utils/audit.js`** — Merkezi audit log sistemi (JSONL, 30 gün retention, async, non-blocking)
+  - 19 action tipi (command, approval, tool, auth, secret, config, cron, skill, error, info)
+  - 24 saat istatistik, dosya bazlı günlük log'lar, auto-cleanup
+- **`src/utils/secret-scanner.js`** — 22 bilinen secret pattern tespiti (OpenAI, Anthropic, Groq, AWS, GitHub, Slack, Stripe, Tavily, HuggingFace, Replicate, Firecrawl, NatureCo, JWT, private key, vs)
+  - Shannon entropi analizi (bilinmeyen format yüksek entropi secret'lar)
+  - Otomatik maskeleme (`sk-a***9012`)
+  - Cross-platform dosya tarama (skip: node_modules, .git, dist, lock files)
+- **`src/commands/audit.js`** — `natureco audit [today|stats|show|search|files|cleanup|tail]`
+  - Renkli action kategorileri
+  - 24 saat bar chart
+  - Canlı tail modu (yeni kayıtları real-time göster)
+- **`bin/natureco.js`** — `audit` komutu kayıtlı
+- **`src/commands/doctor.js`** — 2 yeni check:
+  - `auditLog`: Audit dizini yazılabilir mi?
+  - `secretsClean`: Çalışma dizininde secret var mı?
+
+### 📊 Phase 2 Doctor Sonuçları
+- **10 check** toplam (Phase 1'de 8, ilk halde 5)
+- 6/10 geçti (fresh setup'ta config henüz yok — beklenen)
+
+### 🔜 Coming
+- v3.2.0 — Phase 3: Self-evolving skills
+- v3.3.0 — Phase 4: Maliyet optimizasyonu
+- v3.4.0 — Phase 5: Geliştirici deneyimi
+
+### 🔥 Headline
+OpenClaw'dan daha güvenli, daha hızlı, daha ucuz. İlk kurulum 60 saniye.
+
+### ✨ Added
+- **First-run auto-detection** (`bin/natureco.js`) — `natureco` (boş argüman) kurulum yoksa otomatik setup wizard'a yönlendirir
+- **`src/utils/branding.js`** — merkezi brand kimliği (renkler, ASCII art, daily tip)
+- **Doctor 3 yeni check:** `apiKeyValid`, `providerReachable`, `dataDirs` (auto-fix ile)
+- **Setup wizard** artık tam NatureCo logosuyla açılıyor (eski ASCII cat yerine)
+- **README v3.0 notları + OpenClaw karşılaştırma tablosu**
+
+### 🐛 Fixed
+- **Doctor `diskSpace` bug:** `os.freemem()` (RAM) kullanıyordu, artık gerçek disk alanı (`df -k`, Windows: `Get-PSDrive`)
+- **README/package.json versiyon senkron:** 2.19.1 → 3.0.0
+- **README Node engine:** >=16 → >=18 (package.json ile uyumlu)
+
+### 📁 Audit (Phase 0)
+- 152 JS dosyası, syntax %100 temiz, 0 require hatası
+- 10 TODO/FIXME, 10 boş fonksiyon, 5 deprecated existsSync tespit edildi
+- AUDIT.md oluşturuldu
+
+### 🔜 Coming in next versions
+- v3.1.0 — Phase 2: Defense-in-depth güvenlik (approval v2, audit log, sandbox)
+- v3.2.0 — Phase 3: Self-evolving skills
+- v3.3.0 — Phase 4: Maliyet optimizasyonu (model router)
+- v3.4.0 — Phase 5: Geliştirici deneyimi (dashboard)
+- v4.0.0 — Phase 6-8: NatureCo native + launch
+
+## [1.0.0] - 2026-05-10
+
+### Added
+
+#### Core Features
+- **First-Time Setup Wizard**
+  - Automatic setup on first run
+  - Interactive API key validation with live check
+  - Bot selection from user's bots
+  - Optional Telegram integration
+  - Creates `~/.natureco/` directory structure
+  - Beautiful boxed interface
+  - Can be run manually with `natureco setup`
+
+- **Authentication System**
+  - Login/logout with API key
+  - Secure storage in `~/.natureco/config.json`
+  - Support for both `nco_` and `nc_` key formats
+
+- **Bot Management**
+  - List available bots
+  - Interactive chat with bots
+  - Bot switching within chat
+
+- **Gateway Screen**
+  - Beautiful boxed interface
+  - Login status display
+  - Active bot information
+  - Skill and MCP server counts
+
+#### Project Management
+- **Project Initialization**
+  - `natureco init` command
+  - Creates `.natureco/` folder structure
+  - Interactive bot and skill selection
+  - Generates `config.json` and `AGENTS.md`
+
+- **Configuration System**
+  - Global config: `~/.natureco/config.json`
+  - Project config: `.natureco/config.json`
+  - Get/set/list commands
+  - Hierarchical config management
+
+#### Skills System
+- **Three-Tier Hierarchy**
+  - Built-in skills (code-review, summarize, translate)
+  - User skills (`~/.natureco/skills/`)
+  - Project skills (`.natureco/skills/`)
+
+- **Skill Management**
+  - List installed skills
+  - Install from NatureHub
+  - Remove skills
+  - Update all skills
+  - Create new skill templates
+
+- **Skill Features**
+  - Automatic prompt injection in chat
+  - Requirement gating (bins, env vars, OS)
+  - SKILL.md format with frontmatter
+  - Metadata validation
+
+#### Chat Features
+- **Interactive Chat**
+  - Real-time conversation with bots
+  - Readline interface with arrow key support
+  - Command history (last 100 commands)
+  - Conversation history saved to `~/.natureco/history/`
+
+- **Chat Commands**
+  - `/clear` - Clear screen
+  - `/bot [name]` - Switch bot or list bots
+  - `/skills` - Show active skills
+  - `/help` - Show chat help
+  - `exit`, `quit` - Exit chat
+
+- **Quick Commands**
+  - `natureco ask "<question>"` - Single-shot questions
+  - `natureco run <script.md>` - Run markdown scripts
+  - Pipe support for ask command
+
+#### MCP Server Support
+- **Server Management**
+  - List MCP servers
+  - Add servers (interactive or template-based)
+  - Remove servers
+  - Test connections
+  - Enable/disable servers
+
+- **Ready Templates**
+  - `filesystem` - File system operations
+  - `github` - GitHub operations
+  - `postgres` - PostgreSQL database
+  - `sqlite` - SQLite database
+  - `brave-search` - Web search
+
+- **Configuration**
+  - Stored in `~/.natureco/config.json`
+  - Environment variable support
+  - Auto-approve lists
+  - Disable/enable flags
+
+#### AGENTS.md Support
+- Project-specific bot instructions
+- Automatic prompt injection in chat
+- Markdown format
+- Created during `natureco init`
+
+#### Update System
+- **Auto-Update Notifications**
+  - Checks every 24 hours
+  - Notifies when new version available
+  - Uses update-notifier package
+
+- **Manual Update Check**
+  - `natureco update` command
+  - Shows current and latest versions
+  - Provides update instructions
+
+#### UI/UX
+- Colorful terminal interface with chalk
+- Loading animations with spinners
+- Boxed gateway screen
+- Monospace formatting
+- Error messages in Turkish
+- Cross-platform support (Windows, macOS, Linux)
+
+### Technical Details
+
+#### Dependencies
+- `chalk@4.1.2` - Terminal colors
+- `commander@11.1.0` - CLI framework
+- `inquirer@8.2.7` - Interactive prompts
+- `boxen@5.1.2` - Terminal boxes
+- `ora@5.4.1` - Spinners
+- `conf@10.2.0` - Config management
+- `update-notifier@6.0.2` - Update notifications
+
+#### API Integration
+- Base URL: `https://api.natureco.me`
+- Endpoints:
+  - `GET /api/v1/bots` - List bots
+  - `POST /api/agent/chat` - Chat with bot
+- Headers:
+  - `Authorization: Bearer <apiKey>`
+  - `X-User-ID: cli-user`
+- Platform identifier: `cli`
+
+#### File Structure
+```
+~/.natureco/
+├── config.json          # Global config
+├── skills/              # User skills
+└── history/             # Chat history
+    └── <bot-id>.json
+
+.natureco/               # Project folder
+├── config.json          # Project config
+├── AGENTS.md            # Bot instructions
+└── skills/              # Project skills
+```
+
+### Commands
+
+```bash
+natureco                    # Gateway screen (runs setup if needed)
+natureco setup              # Run setup wizard
+natureco login              # Login
+natureco logout             # Logout
+natureco bots               # List bots
+natureco chat <bot>         # Start chat
+natureco ask "<question>"   # Quick question
+natureco run <script.md>    # Run script
+natureco init               # Initialize project
+natureco skills [action]    # Manage skills
+natureco mcp [action]       # Manage MCP servers
+natureco config <action>    # Manage config
+natureco update             # Check updates
+natureco help               # Show help
+```
+
+### Requirements
+- Node.js >= 18.0.0 (for native fetch)
+- npm or yarn
+- NatureCo API key
+
+### License
+MIT
+
+## [4.9.1] - 2026-06-22 — "SELF-COMPLETE TOOLSET"
+
+### Yeni: 14 Tool Eklendi (Toplam: 45)
+Parton'un vizyonu: "kendi araçlarimi ekle". Hermes'te olan araçlarin aynisi.
+
+#### macOS Native Tools (6 yeni)
+- **calendar_add** - macOS Calendar'a etkinlik ekle (AppleScript)
+- **reminder_add** - macOS Reminders'a hatirlatici
+- **notes_add** - Apple Notes'a not
+- **mac_notify** - Notification Center bildirimi
+- **mac_app_open** / **mac_app_quit** - Uygulama kontrol
+
+#### Sistem & Shell (5 yeni)
+- **code_execution** - Python/Node/Bash sandbox
+- **shell_command** - Tek shell komutu (find, ls, df, vb.)
+- **http_request** - HTTP GET/POST/PUT/DELETE
+- **bash** (zaten vardi, guncellendi)
+
+#### Dosya & Arama (4 yeni)
+- **file_search** - Glob pattern ile dosya arama (**/*.js)
+- **grep_search** - Icerik arama (ripgrep veya grep)
+- **filesystem**, **list_dir** (zaten vardi)
+
+#### Yönetim & Verimlilik (6 yeni)
+- **todo_write** - Yapilacaklar listesi (list/add/done/remove)
+- **kanban** - Kanban board (todo/in_progress/done kolonlar)
+- **memory_search** - Kalici hafizada ve session'larda arama
+- **cron_create** - Zamanlanmis gorev olusturma
+- **notebook_edit** - Jupyter notebook hucre duzenleme
+- **delegate_task** - Alt-agent gorev devretme
+
+#### AI & Medya (zaten vardi + Pollinations fallback)
+- **image_generation** - v4.8.4'te Pollinations.ai (ucretsiz) eklendi
+- **media_understanding** - Gorsel analiz (OpenAI/Anthropic/Groq)
+- **text_to_speech** - macOS say / edge-tts
+
+### İyilestirmeler
+- **Tool calling tam entegre** - v4.8.0'da basladi, v4.9.1'de tamamlandi
+- **OpenAI uyumlu tool calling** - MiniMax, OpenAI, Anthropic, Groq hepsi
+- **Auto-fallback** - Key yoksa ucretsiz alternatife gec (Pollinations)
+- **Tool UI feedback** - Her tool cagrisi 🔧 Tool: ... ile gosteriliyor
+
+### Düzeltmeler
+- **macos.js** (tek dosya, birden fazla tool) → 6 ayri dosyaya bolundu
+- **file_search.js** syntax hatasi (JSDoc icindeki yildiz) duzeltildi
+- **REPL'in tool registry** - Yeni tool'lar REPL acilisinda otomatik yukleniyor
+
+### Toplam Ilerleme
+- v2.23 (baslangic): ~12 tool
+- v3.0-v4.0: +5 tool (brand, audit, cost, dashboard, seo)
+- v4.5-v4.7: +8 tool (xp, team, naturehub, medium, repl, vb.)
+- v4.8: Tool calling tam entegre (28 tool)
+- **v4.9.1: 45 tool** - Parton'un vizyonu: "kendi araçlarim olsun"
+
+### Kullanim
+```bash
+natureco repl
+> "Yarin 14:00 doktor randevum var"      # calendar_add
+> "Spotify ac"                            # mac_app_open
+> "src/ icindeki TODO'lari bul"            # grep_search
+> "Python ile 2+2 hesapla"                # code_execution
+> "Tum TODO'lari goster"                  # todo_write
+```