natureco-cli 2.23.31 → 4.4.0

package/src/utils/audit.js

@@ -0,0 +1,199 @@
+/**
+ * NatureCo CLI — Audit Log (Phase 2)
+ *
+ * Tüm kullanıcı işlemlerini (komut, onay, tool call, hata) JSONL olarak kaydeder.
+ * Bu log güvenlik denetimi, hata ayıklama ve compliance için kullanılır.
+ *
+ * Format: Her satır bir JSON objesi. Sıralı append, async-non-blocking.
+ *
+ * Varsayılan: ~/.natureco/audit/audit-YYYY-MM-DD.jsonl
+ * 30 günden eski loglar otomatik temizlenir.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const AUDIT_DIR = path.join(os.homedir(), '.natureco', 'audit');
+const RETENTION_DAYS = 30;
+
+// Action tipleri
+const ACTIONS = {
+  COMMAND_RUN:    'command.run',     // Bir CLI komutu çalıştırıldı
+  COMMAND_FAIL:   'command.fail',    // Komut hata verdi
+  APPROVAL_ASK:   'approval.ask',    // Onay istendi
+  APPROVAL_GRANT: 'approval.grant',  // Kullanıcı onayladı
+  APPROVAL_DENY:  'approval.deny',   // Kullanıcı reddetti
+  TOOL_CALL:      'tool.call',       // Agent bir tool çağırdı
+  TOOL_BLOCK:     'tool.block',      // Tehlikeli tool çağrısı engellendi
+  AUTH_LOGIN:     'auth.login',      // Login
+  AUTH_LOGOUT:    'auth.logout',     // Logout
+  SECRET_READ:    'secret.read',     // Secret çözüldü
+  SECRET_LEAK:    'secret.leak',     // Potansiyel secret sızıntısı tespit
+  CONFIG_CHANGE:  'config.change',   // Config değişti
+  CRON_RUN:       'cron.run',        // Cron job çalıştı
+  SKILL_INSTALL:  'skill.install',   // Skill yüklendi
+  SKILL_AUTO:     'skill.auto',      // Self-evolving skill oluştu
+  ERROR:          'error',           // Genel hata
+  INFO:           'info',            // Bilgi mesajı
+};
+
+let _stream = null;
+let _streamPath = null;
+let _writeQueue = Promise.resolve();
+
+function ensureDir() {
+  if (!fs.existsSync(AUDIT_DIR)) fs.mkdirSync(AUDIT_DIR, { recursive: true });
+}
+
+function todayFile() {
+  const d = new Date().toISOString().slice(0, 10);
+  return path.join(AUDIT_DIR, `audit-${d}.jsonl`);
+}
+
+function getStream() {
+  const target = todayFile();
+  if (_stream && target === _streamPath) return _stream;
+  if (_stream) {
+    try { _stream.end(); } catch {}
+  }
+  ensureDir();
+  _stream = fs.createWriteStream(target, { flags: 'a' });
+  _streamPath = target;
+  return _stream;
+}
+
+/**
+ * Ana audit kayıt fonksiyonu. Non-blocking — queue'ya ekler ve döner.
+ *
+ * @param {string} action - ACTIONS enum'undan
+ * @param {object} data - Ek bağlam
+ * @returns {Promise<void>}
+ */
+function log(action, data = {}) {
+  ensureDir();
+  const entry = {
+    ts: new Date().toISOString(),
+    pid: process.pid,
+    ppid: process.ppid,
+    user: os.userInfo().username,
+    cwd: process.cwd(),
+    argv: process.argv.slice(2).slice(0, 5), // ilk 5 argüman
+    action,
+    ...data,
+  };
+
+  _writeQueue = _writeQueue.then(() => new Promise((resolve) => {
+    try {
+      const stream = getStream();
+      stream.write(JSON.stringify(entry) + '\n', () => resolve());
+    } catch (e) {
+      // Audit log hatası uygulamayı kıramamalı
+      resolve();
+    }
+  })).catch(() => {});
+
+  return _writeQueue;
+}
+
+/**
+ * Senkron versiyon — kritik olaylarda çağrılabilir (örn: approval deny).
+ * Hata durumunda null döner, exception fırlatmaz.
+ */
+function logSync(action, data = {}) {
+  try {
+    ensureDir();
+    const entry = {
+      ts: new Date().toISOString(),
+      pid: process.pid,
+      user: os.userInfo().username,
+      cwd: process.cwd(),
+      action,
+      ...data,
+    };
+    fs.appendFileSync(todayFile(), JSON.stringify(entry) + '\n', 'utf8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Tüm log dosyalarını döner — gün ismine göre sıralı.
+ */
+function listLogFiles() {
+  ensureDir();
+  return fs.readdirSync(AUDIT_DIR)
+    .filter(f => f.startsWith('audit-') && f.endsWith('.jsonl'))
+    .sort()
+    .reverse();
+}
+
+/**
+ * Belirli bir günün loglarını parse eder.
+ */
+function readLog(dateStr) {
+  const file = path.join(AUDIT_DIR, `audit-${dateStr}.jsonl`);
+  if (!fs.existsSync(file)) return [];
+  return fs.readFileSync(file, 'utf8')
+    .split('\n')
+    .filter(Boolean)
+    .map(l => {
+      try { return JSON.parse(l); } catch { return null; }
+    })
+    .filter(Boolean);
+}
+
+/**
+ * Retention temizliği — RETENTION_DAYS günden eski dosyaları siler.
+ */
+function cleanup() {
+  ensureDir();
+  const cutoff = Date.now() - RETENTION_DAYS * 86400 * 1000;
+  let removed = 0;
+  for (const file of fs.readdirSync(AUDIT_DIR)) {
+    if (!file.startsWith('audit-') || !file.endsWith('.jsonl')) continue;
+    const filePath = path.join(AUDIT_DIR, file);
+    const stat = fs.statSync(filePath);
+    if (stat.mtimeMs < cutoff) {
+      try { fs.unlinkSync(filePath); removed++; } catch {}
+    }
+  }
+  return removed;
+}
+
+/**
+ * Basit istatistik — son 24 saatte hangi actionlar kaç kez?
+ */
+function stats24h() {
+  const today = new Date().toISOString().slice(0, 10);
+  const yesterday = new Date(Date.now() - 86400000).toISOString().slice(0, 10);
+  const entries = [...readLog(today), ...readLog(yesterday)];
+  const counts = {};
+  for (const e of entries) {
+    counts[e.action] = (counts[e.action] || 0) + 1;
+  }
+  return { total: entries.length, byAction: counts, period: `${yesterday} → ${today}` };
+}
+
+/**
+ * Flush — bekleyen yazma işlemlerini tamamla. Çıkışta çağrılır.
+ */
+async function flush() {
+  await _writeQueue;
+  if (_stream) {
+    return new Promise((resolve) => _stream.end(resolve));
+  }
+}
+
+module.exports = {
+  ACTIONS,
+  log,
+  logSync,
+  listLogFiles,
+  readLog,
+  cleanup,
+  stats24h,
+  flush,
+  AUDIT_DIR,
+};

package/src/utils/branding.js

@@ -0,0 +1,136 @@
+/**
+ * NatureCo CLI — Branding & Splash
+ *
+ * Tek kaynaktan tüm logo, banner ve renkleri yönetir.
+ * Brand kimliğini koruyalım — her yerde aynı görünüm.
+ */
+
+const chalk = require('chalk');
+const os = require('os');
+
+const COLORS = {
+  primary: chalk.hex('#22c55e'),   // NatureCo yeşili
+  secondary: chalk.hex('#0ea5e9'), // gökyüzü mavisi
+  accent: chalk.hex('#f59e0b'),    // amber
+  muted: chalk.gray,
+  danger: chalk.red,
+  success: chalk.green,
+  bold: chalk.bold,
+};
+
+const SMALL_LOGO = [
+  '  🌿  NatureCo',
+];
+
+const FULL_LOGO = [
+  '███╗   ██╗ █████╗ ████████╗██╗   ██╗██████╗ ███████╗ ██████╗  ██████╗ ',
+  '████╗  ██║██╔══██╗╚══██╔══╝██║   ██║██╔══██╗██╔════╝██╔═══██╗██╔═══██╗',
+  '██╔██╗ ██║███████║   ██║   ██║   ██║██████╔╝█████╗  ██║   ██║██║   ██║',
+  '██║╚██╗██║██╔══██║   ██║   ██║   ██║██╔══██╗██╔══╝  ██║   ██║██║   ██║',
+  '██║ ╚████║██║  ██║   ██║   ╚██████╔╝██║  ██║███████╗╚██████╔╝╚██████╔╝',
+  '╚═╝  ╚═══╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝  ╚═════╝ ',
+];
+
+const MASCOT = `         (\\_/)
+         (•_•)    Hoş geldin!
+         />🌿`;
+
+const MASCOT_COMPACT = '(\\_/) · (•_•) · />🌿';
+
+const TIPS = [
+  '🌱 natureco code  →  Edit & refactor any file in one command',
+  '💬 natureco chat "İchigo"  →  Talk to your default bot',
+  '📦 natureco skills install seo-audit  →  Add new capabilities',
+  '🔁 natureco cron add "0 9 * * *" "seo-check"  →  Schedule recurring jobs',
+  '🛡️  natureco doctor  →  Diagnose setup issues in seconds',
+  '🌍 natureco naturehub post "Hello world"  →  Publish to Nature Hub',
+  '🔍 natureco seo audit https://natureco.me  →  SEO insights, instantly',
+  '💰 natureco cost today  →  See today\'s AI spend',
+];
+
+function pickDailyTip() {
+  const day = Math.floor(Date.now() / 86400000);
+  return TIPS[day % TIPS.length];
+}
+
+/**
+ * Kompakt banner — her komut çıktısının üstünde kullanılabilir.
+ */
+function banner(opts = {}) {
+  const { version, subtitle, userName, botName } = opts;
+  const lines = [];
+  lines.push('');
+  lines.push(COLORS.primary.bold(SMALL_LOGO[0]));
+  if (version) {
+    const v = COLORS.muted(`v${version}`);
+    const subtitleLine = subtitle ? COLORS.secondary(` · ${subtitle}`) : '';
+    lines.push(`  ${v}${subtitleLine}`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * Tam logo — sadece ilk açılışta ve --version gibi özel yerlerde.
+ */
+function fullLogo(opts = {}) {
+  const { version, tagline } = opts;
+  const lines = [];
+  for (const ln of FULL_LOGO) lines.push(COLORS.primary(ln));
+  lines.push('');
+  if (tagline) lines.push('  ' + COLORS.secondary(tagline));
+  if (version) lines.push('  ' + COLORS.muted(`v${version} · Node ${process.version.slice(1)} · ${os.platform()}`));
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * Gateway ekranı — komut yoksa gösterilen ana ekran.
+ */
+function gatewayScreen({ version, userName, botName, loginStatus }) {
+  const lines = [];
+  lines.push(COLORS.primary.bold('  🌿 NatureCo CLI'));
+  lines.push(COLORS.muted(`  v${version}  ·  OpenClaw\'dan daha güvenli, daha hızlı, daha ucuz`));
+  lines.push('');
+  lines.push('  ' + COLORS.muted('─'.repeat(64)));
+  lines.push(`  ${COLORS.muted('👤')}  Kullanıcı: ${userName ? COLORS.bold(userName) : COLORS.accent('(setup gerekli)')}`);
+  lines.push(`  ${COLORS.muted('🤖')}  Bot:      ${botName ? COLORS.bold(botName) : COLORS.accent('(setup gerekli)')}`);
+  lines.push(`  ${COLORS.muted('🔐')}  Giriş:    ${loginStatus === 'ok' ? COLORS.success('✓ aktif') : COLORS.danger('✗ gerekli')}`);
+  lines.push('  ' + COLORS.muted('─'.repeat(64)));
+  lines.push('');
+  lines.push('  ' + COLORS.muted(pickDailyTip()));
+  lines.push('');
+  lines.push(`  ${COLORS.secondary.bold('Hızlı başlangıç:')}`);
+  lines.push(`    ${COLORS.cyan('natureco chat')}              Bot ile sohbet`);
+  lines.push(`    ${COLORS.cyan('natureco code <file>')}        Code agent — dosya oku, düzenle`);
+  lines.push(`    ${COLORS.cyan('natureco ask "<soru>"')}      Tek soru sor`);
+  lines.push(`    ${COLORS.cyan('natureco doctor')}            Sistem teşhisi`);
+  lines.push(`    ${COLORS.cyan('natureco help')}              Tüm komutlar`);
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * İlk kurulum ekranı — setup çalıştırılırken gösterilir.
+ */
+function firstRunScreen() {
+  const lines = [];
+  lines.push(COLORS.primary.bold(SMALL_LOGO[0]));
+  lines.push('');
+  lines.push(COLORS.secondary.bold('  İlk kurulum hoş geldin!'));
+  lines.push(COLORS.muted('  60 saniyede hazır olalım.\n'));
+  return lines.join('\n');
+}
+
+module.exports = {
+  COLORS,
+  SMALL_LOGO,
+  FULL_LOGO,
+  MASCOT,
+  MASCOT_COMPACT,
+  pickDailyTip,
+  banner,
+  fullLogo,
+  gatewayScreen,
+  firstRunScreen,
+};

package/src/utils/cost-tracker.js

@@ -0,0 +1,360 @@
+/**
+ * NatureCo CLI — Cost Tracker & Model Router (Phase 4)
+ *
+ * Token kullanımını USD maliyete çevirir, model router ile
+ * basit soruları ucuz modellere yönlendirir, bütçe aşımında uyarır.
+ *
+ * OpenClaw: $50-200/ay token patlaması.
+ * NatureCo: Hedef $5-15/ay akıllı routing ile.
+ *
+ * Fiyatlar 2026 Haziran itibarıyladır, değişebilir.
+ */
+
+// Fiyatlar (USD / 1M token). Provider+model bazlı.
+const PRICING = {
+  // MiniMax — pay-as-you-go fiyatları (tahmini, güncellenebilir)
+  'minimax:MiniMax-M3':             { input: 0.30, output: 1.20 },
+  'minimax:MiniMax-M2.7':           { input: 0.15, output: 0.60 },
+  'minimax:MiniMax-M2.7-highspeed': { input: 0.20, output: 0.80 },
+  'minimax:MiniMax-M2.5':           { input: 0.15, output: 0.60 },
+  'minimax:MiniMax-M2.5-highspeed': { input: 0.20, output: 0.80 },
+  'minimax:MiniMax-M2.1':           { input: 0.10, output: 0.40 },
+  'minimax:MiniMax-M2.1-highspeed': { input: 0.12, output: 0.50 },
+  'minimax:MiniMax-M2':             { input: 0.10, output: 0.40 },
+
+  // Groq — genelde ücretsiz tier var, indirimli
+  'groq:llama-3.1-8b-instant':   { input: 0.05, output: 0.08 },
+  'groq:llama-3.3-70b-versatile': { input: 0.59, output: 0.79 },
+  'groq:mixtral-8x7b-32768':     { input: 0.27, output: 0.27 },
+  'groq:llama-3.2-90b-vision-preview': { input: 0.90, output: 0.90 },
+
+  // OpenAI
+  'openai:gpt-4o':                { input: 2.50, output: 10.00 },
+  'openai:gpt-4o-mini':           { input: 0.15, output: 0.60 },
+  'openai:gpt-4-turbo':           { input: 10.00, output: 30.00 },
+  'openai:o1-mini':               { input: 3.00, output: 12.00 },
+  'openai:o1':                    { input: 15.00, output: 60.00 },
+
+  // Anthropic
+  'anthropic:claude-sonnet-4-6':  { input: 3.00, output: 15.00 },
+  'anthropic:claude-haiku-4-5':   { input: 0.80, output: 4.00 },
+  'anthropic:claude-opus-4-5':    { input: 15.00, output: 75.00 },
+
+  // DeepSeek (çok ucuz)
+  'deepseek:deepseek-chat':       { input: 0.14, output: 0.28 },
+  'deepseek:deepseek-coder':      { input: 0.14, output: 0.28 },
+
+  // Together AI
+  'together:meta-llama/Llama-3.3-70B-Instruct-Turbo': { input: 0.88, output: 0.88 },
+
+  // Fireworks
+  'fireworks:accounts/fireworks/models/llama-v3p3-70b-instruct': { input: 0.90, output: 0.90 },
+
+  // Local (ücretsiz)
+  'ollama:llama3.3':              { input: 0, output: 0 },
+  'ollama:qwen2.5-coder':         { input: 0, output: 0 },
+  'lmstudio:local':               { input: 0, output: 0 },
+};
+
+const DEFAULT_PRICING = { input: 1.00, output: 3.00 };
+
+function getPricingKey(provider, model) {
+  if (!provider || !model) return null;
+  const p = provider.toLowerCase().replace(/^https?:\/\/[^/]+\//, '');
+  return `${p}:${model}`;
+}
+
+function getPricing(provider, model) {
+  const key = getPricingKey(provider, model);
+  if (key && PRICING[key]) return PRICING[key];
+  // Provider'ı bul, ilk modelini kullan
+  const prefix = `${provider.toLowerCase()}:`;
+  for (const [k, v] of Object.entries(PRICING)) {
+    if (k.startsWith(prefix)) return v;
+  }
+  return DEFAULT_PRICING;
+}
+
+/**
+ * Token kullanımını USD'ye çevir.
+ * @param {object} usage - { input: number, output: number }
+ * @param {string} provider
+ * @param {string} model
+ * @returns {number} USD
+ */
+function calculateCost(usage, provider, model) {
+  const pricing = getPricing(provider, model);
+  const inputCost = (usage.input || 0) / 1_000_000 * pricing.input;
+  const outputCost = (usage.output || 0) / 1_000_000 * pricing.output;
+  return inputCost + outputCost;
+}
+
+/**
+ * Model router — görev tipine göre en uygun modeli öner.
+ *
+ * Karmaşıklık seviyesi:
+ *  - "simple": Basit soru, kısa cevap, sınıflandırma
+ *  - "medium": Genel sohbet, doküman özetleme
+ *  - "complex": Kod yazma, mimari karar, çok adımlı reasoning
+ *  - "creative": Yaratıcı yazı, hikaye, içerik üretimi
+ */
+const ROUTING = {
+  simple: {
+    description: 'Basit sorular — sınıflandırma, kısa cevaplar',
+    models: [
+      { provider: 'groq', model: 'llama-3.1-8b-instant', reason: 'En ucuz, hızlı, çoğu basit görev için yeterli' },
+      { provider: 'groq', model: 'llama-3.3-70b-versatile', reason: 'Yedek: daha kaliteli ama ucuz' },
+      { provider: 'anthropic', model: 'claude-haiku-4-5', reason: 'Yüksek kalite gerekiyorsa' },
+    ],
+  },
+  medium: {
+    description: 'Genel sohbet, özetleme, doküman analizi',
+    models: [
+      { provider: 'groq', model: 'llama-3.3-70b-versatile', reason: 'Dengeli fiyat/kalite' },
+      { provider: 'anthropic', model: 'claude-haiku-4-5', reason: 'Daha kaliteli cevap' },
+      { provider: 'openai', model: 'gpt-4o-mini', reason: 'OpenAI istiyorsan' },
+    ],
+  },
+  complex: {
+    description: 'Kod yazma, mimari, çok adımlı reasoning',
+    models: [
+      { provider: 'groq', model: 'llama-3.3-70b-versatile', reason: 'Hızlı, yeterince akıllı' },
+      { provider: 'anthropic', model: 'claude-sonnet-4-6', reason: 'Kod için en iyi kalite' },
+      { provider: 'openai', model: 'gpt-4o', reason: 'OpenAI istiyorsan' },
+    ],
+  },
+  creative: {
+    description: 'Yaratıcı yazı, hikaye, içerik üretimi',
+    models: [
+      { provider: 'anthropic', model: 'claude-sonnet-4-6', reason: 'Yaratıcı yazıda güçlü' },
+      { provider: 'openai', model: 'gpt-4o', reason: 'OpenAI yaratıcı kalitesi' },
+      { provider: 'groq', model: 'llama-3.3-70b-versatile', reason: 'Ücretsiz denemek için' },
+    ],
+  },
+};
+
+/**
+ * Basit karmaşıklık tahmini — prompt içeriğine bakarak.
+ */
+function estimateComplexity(prompt) {
+  if (!prompt) return 'simple';
+  const text = prompt.toLowerCase();
+  const len = text.length;
+
+  // Code işaretleri
+  const codeIndicators = (text.match(/```|function|class|import|const |let |var |=>|\{|\}/g) || []).length;
+  if (codeIndicators >= 3) return 'complex';
+
+  // Karmaşık soru işaretleri
+  const complexKeywords = ['mimari', 'tasarla', 'analiz', 'karşılaştır', 'açıkla', 'optimize et', 'refactor', 'debug', 'neden', 'nasıl çalışır'];
+  if (complexKeywords.some(k => text.includes(k))) return 'complex';
+
+  // Yaratıcı işaretler
+  const creativeKeywords = ['yaz', 'hikaye', 'şiir', 'blog', 'içerik', 'makale', 'yaratıcı', 'senaryo'];
+  if (creativeKeywords.some(k => text.includes(k)) && len > 100) return 'creative';
+
+  // Uzun metin → medium
+  if (len > 500) return 'medium';
+
+  return 'simple';
+}
+
+/**
+ * Bir prompt için önerilen modeli döner.
+ */
+function suggestModel(prompt, options = {}) {
+  const { forceComplexity, currentProvider, currentModel } = options;
+
+  // Mevcut model zaten pahalıysa ve görev basitse, uyar
+  const complexity = forceComplexity || estimateComplexity(prompt);
+  const route = ROUTING[complexity];
+
+  if (!route) return null;
+
+  // Mevcut model routing listesinde mi?
+  if (currentProvider && currentModel) {
+    const matched = route.models.find(m => m.provider === currentProvider.toLowerCase() && m.model === currentModel);
+    if (matched) {
+      return { complexity, ...matched, optimal: true };
+    }
+  }
+
+  // İlk öneriyi döndür
+  return { complexity, ...route.models[0], optimal: false };
+}
+
+/**
+ * Bir kullanım kaydını cost-tracker'a ekle.
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const COST_FILE = path.join(os.homedir(), '.natureco', 'cost-tracking.json');
+const BUDGET_CONFIG_FILE = path.join(os.homedir(), '.natureco', 'budget-config.json');
+
+const DEFAULT_BUDGET = {
+  dailyLimit: 5.00,       // USD/gün
+  monthlyLimit: 100.00,  // USD/ay
+  warnAt: 0.75,          // %75'inde uyar
+  downgradeAt: 0.90,     // %90'ında otomatik downgrade
+};
+
+function loadBudget() {
+  try {
+    if (fs.existsSync(BUDGET_CONFIG_FILE)) {
+      return { ...DEFAULT_BUDGET, ...JSON.parse(fs.readFileSync(BUDGET_CONFIG_FILE, 'utf8')) };
+    }
+  } catch {}
+  return { ...DEFAULT_BUDGET };
+}
+
+function saveBudget(budget) {
+  const dir = path.dirname(BUDGET_CONFIG_FILE);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(BUDGET_CONFIG_FILE, JSON.stringify(budget, null, 2), 'utf8');
+}
+
+function loadCosts() {
+  try {
+    if (fs.existsSync(COST_FILE)) {
+      return JSON.parse(fs.readFileSync(COST_FILE, 'utf8'));
+    }
+  } catch {}
+  return { entries: [] };
+}
+
+function saveCosts(data) {
+  const dir = path.dirname(COST_FILE);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(COST_FILE, JSON.stringify(data, null, 2), 'utf8');
+}
+
+/**
+ * Yeni bir kullanım kaydı ekle.
+ */
+function recordUsage({ provider, model, input, output, sessionId, command }) {
+  const data = loadCosts();
+  const cost = calculateCost({ input, output }, provider, model);
+  const entry = {
+    ts: new Date().toISOString(),
+    provider,
+    model,
+    input: input || 0,
+    output: output || 0,
+    cost,
+    sessionId: sessionId || null,
+    command: command || null,
+  };
+  data.entries.push(entry);
+  // Maksimum 10.000 entry tut (eski dosyaları rotate et)
+  if (data.entries.length > 10000) {
+    data.entries = data.entries.slice(-10000);
+  }
+  saveCosts(data);
+  return entry;
+}
+
+/**
+ * Belirli bir dönem için toplam maliyet.
+ */
+function totalForPeriod(period = 'today') {
+  const data = loadCosts();
+  const now = new Date();
+  let cutoff;
+
+  switch (period) {
+    case 'today':
+      cutoff = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+      break;
+    case 'week':
+      cutoff = now.getTime() - 7 * 86400000;
+      break;
+    case 'month':
+      cutoff = new Date(now.getFullYear(), now.getMonth(), 1).getTime();
+      break;
+    case 'all':
+      cutoff = 0;
+      break;
+    default:
+      cutoff = new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+  }
+
+  const filtered = data.entries.filter(e => new Date(e.ts).getTime() >= cutoff);
+  let totalCost = 0;
+  let totalInput = 0;
+  let totalOutput = 0;
+  const byProvider = {};
+  const byModel = {};
+
+  for (const e of filtered) {
+    totalCost += e.cost;
+    totalInput += e.input;
+    totalOutput += e.output;
+    byProvider[e.provider] = (byProvider[e.provider] || 0) + e.cost;
+    byModel[`${e.provider}:${e.model}`] = (byModel[`${e.provider}:${e.model}`] || 0) + e.cost;
+  }
+
+  return {
+    period,
+    entries: filtered.length,
+    totalCost,
+    totalInput,
+    totalOutput,
+    byProvider,
+    byModel,
+    topModel: Object.entries(byModel).sort((a, b) => b[1] - a[1])[0]?.[0] || null,
+  };
+}
+
+/**
+ * Bütçe kontrolü — limit aşıldı mı?
+ */
+function checkBudget() {
+  const budget = loadBudget();
+  const today = totalForPeriod('today');
+  const month = totalForPeriod('month');
+
+  const dailyUsage = today.totalCost / budget.dailyLimit;
+  const monthlyUsage = month.totalCost / budget.monthlyLimit;
+
+  return {
+    daily: {
+      spent: today.totalCost,
+      limit: budget.dailyLimit,
+      usage: dailyUsage,
+      exceeded: dailyUsage >= 1.0,
+      warning: dailyUsage >= budget.warnAt,
+    },
+    monthly: {
+      spent: month.totalCost,
+      limit: budget.monthlyLimit,
+      usage: monthlyUsage,
+      exceeded: monthlyUsage >= 1.0,
+      warning: monthlyUsage >= budget.warnAt,
+    },
+    shouldDowngrade: dailyUsage >= budget.downgradeAt || monthlyUsage >= budget.downgradeAt,
+  };
+}
+
+function formatUSD(amount) {
+  if (amount === 0) return '$0.00';
+  if (amount < 0.01) return `$${(amount * 100).toFixed(2)}¢`;
+  return `$${amount.toFixed(4)}`;
+}
+
+module.exports = {
+  PRICING,
+  ROUTING,
+  DEFAULT_BUDGET,
+  getPricing,
+  calculateCost,
+  estimateComplexity,
+  suggestModel,
+  loadBudget,
+  saveBudget,
+  recordUsage,
+  totalForPeriod,
+  checkBudget,
+  formatUSD,
+};