natureco-cli 5.31.0 → 5.32.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to NatureCo CLI will be documented in this file.
 
+## [5.32.0] - 2026-07-04 — "AĞAÇ-HAFIZA + OTURUMLAR ARASI KALICILIK (Theseus mimarisi)"
+
+### ✨ Yeni (Hafıza)
+- **Oturumlar arası hafiza DUZELDI**: eski persist dar regex kaliplariyla (sadece "adim X") fact cikariyordu; keyfi bilgi ("parolam X, hatirla") kayboluyordu. Artik ajan `memory_write` ile ANINDA kaydeder → yeni oturumda hatirlanir (E2E: parola S1→S2 ✓).
+- **Agac-hafiza (`memory_tree`)**: kullanicinin OpenCode/Theseus icin tasarladigi tree-memory mimarisinden uyarlandi. Kok (1-kisisel/2-teknik/3-kararlar) → dal (## baslik) → yaprak. action: index|read|search|append. Duz `facts[]` listesinin "coplুğe donme" sorununu cozer; kategorize + logaritmik erisim.
+- **Proaktif yukleme (Theseus deseni)**: her istekte hafiza agaci sistem prompt'una otomatik enjekte edilir ("BILDIGIN KALICI HAFIZA") → ajan on-demand aramaya guvenmeden baglami ZATEN bilir. (E2E: "NatureCoPixel neyle yapiliyor?"→"Godot" ✓; hafiza ile dosya sistemini ayirt eder.)
+- Tek-primary + "bkz:" capraz referans; credential/secret asla duz metin.
+
+Doğrulama: memory_write + memory_tree E2E (S1 kaydet → S2 yeni oturum hatirla); 6 yeni tree testi; **498 test yeşil**, ESLint temiz.
+
 ## [5.31.0] - 2026-07-04 — "CHAT/CODE ARAYÜZ ZENGİNLEŞTİRME (araç görünürlüğü + düşünme + input alanı)"
 
 ### ✨ Yeni (UX)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.31.0",
+  "version": "5.32.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/tools/agentic-runner.js

@@ -21,7 +21,7 @@ const os = require('os');
 // icinde approvals politikasini uyguluyor (isSafeCommand → direkt; tehlikeli → red;
 // digerleri → allowlist/full moda gore). Yani keyfi/yikici komut calismaz.
 // Diger ~85 arac (discord, telegram, cron, browser...) bilerek DISARIDA.
-const DEFAULT_ALLOWED = ['write_file', 'read_file', 'edit_file', 'skill_view', 'bash', 'file_search', 'list_dir'];
+const DEFAULT_ALLOWED = ['write_file', 'read_file', 'edit_file', 'skill_view', 'bash', 'file_search', 'list_dir', 'memory_write', 'memory_tree'];
 
 const TOOL_ALIASES = {
   write_file: 'write_file', create_file: 'write_file', writefile: 'write_file', write: 'write_file', create: 'write_file', save_file: 'write_file', new_file: 'write_file',
@@ -31,6 +31,8 @@ const TOOL_ALIASES = {
   bash: 'bash', run_command: 'bash', shell: 'bash', shell_command: 'bash', exec: 'bash', run_terminal: 'bash', terminal: 'bash', run: 'bash', command: 'bash',
   file_search: 'file_search', glob: 'file_search', find_files: 'file_search', search_files: 'file_search', find: 'file_search',
   list_dir: 'list_dir', ls: 'list_dir', dir: 'list_dir', list_directory: 'list_dir', filesystem: 'list_dir',
+  memory_write: 'memory_write', remember: 'memory_write', save_memory: 'memory_write', memorize: 'memory_write', memory_save: 'memory_write', save_fact: 'memory_write',
+  memory_tree: 'memory_tree', tree_memory: 'memory_tree', memory: 'memory_tree', hafiza: 'memory_tree',
 };
 
 function expandHome(p) {

package/src/tools/memory_tree.js

@@ -0,0 +1,156 @@
+/**
+ * memory_tree — Ağaç-hafıza (kök → dal → yaprak). Kullanıcının OpenCode için tasarladığı
+ * tree-memory mimarisinden uyarlandı (opencode-hafiza-mimarisi.md).
+ *
+ * Felsefe: "bilgi saklama" değil "hızlı bilgi bulma". Düz liste zamanla çöplüğe döner;
+ * ağaç logaritmik arama sağlar (kök seç → dal seç → yaprak oku, <300 token).
+ *
+ * Yapı: ~/.natureco/memory/tree/<user>/
+ *   0-index.md   — yönlendirme (hangi konu hangi kökte)
+ *   1-kisisel.md — Kişisel & Tercihler (## dallar altında yapraklar)
+ *   2-teknik.md  — Teknik & Projeler
+ *   3-kararlar.md— Kararlar, Kurallar & Dersler
+ *
+ * Kurallar (mimariden): tek primary + "bkz:" çapraz referans; yeni bilgi ilgili dalın
+ * altına (dosya sonuna değil); credential/secret ASLA düz metin ("bkz: secrets vault").
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const ROOTS = [
+  { id: '1-kisisel', title: 'Kişisel & Tercihler', branches: ['Kimlik', 'Tercihler', 'İletişim Kalıpları'] },
+  { id: '2-teknik', title: 'Teknik & Projeler', branches: ['Projeler', 'Kurulum & Sistem', 'Teknik Referans'] },
+  { id: '3-kararlar', title: 'Kararlar, Kurallar & Dersler', branches: ['Kararlar', 'Kurallar & Kısıtlar', 'Öğrenilen Dersler', 'Tarihli Olaylar'] },
+];
+
+function treeDir(username) {
+  return path.join(os.homedir(), '.natureco', 'memory', 'tree', String(username || 'default').toLowerCase());
+}
+function rootPath(username, id) { return path.join(treeDir(username), id + '.md'); }
+function readSafe(username, id) { try { return fs.readFileSync(rootPath(username, id), 'utf8'); } catch { return ''; } }
+function resolveRoot(root) {
+  if (!root) return ROOTS[0];
+  const r = String(root).toLowerCase();
+  return ROOTS.find((x) => x.id === r || x.id.endsWith(r.replace(/^\d+-/, '')) || x.id.includes(r) || x.title.toLowerCase().includes(r)) || ROOTS[0];
+}
+
+function ensureTree(username) {
+  const dir = treeDir(username);
+  fs.mkdirSync(dir, { recursive: true });
+  for (const r of ROOTS) {
+    const p = rootPath(username, r.id);
+    if (!fs.existsSync(p)) fs.writeFileSync(p, `# ${r.title}\n\n` + r.branches.map((b) => `## ${b}\n`).join('\n'), 'utf8');
+  }
+  const idx = path.join(dir, '0-index.md');
+  if (!fs.existsSync(idx)) fs.writeFileSync(idx, '# Hafıza İndeksi (kök → dal)\n\n' + ROOTS.map((r) => `- **${r.id}** — ${r.title}: ${r.branches.join(', ')}`).join('\n') + '\n', 'utf8');
+}
+
+// Modele enjekte edilen kompakt indeks (dal başlıkları + yaprak sayısı).
+function buildIndex(username) {
+  ensureTree(username);
+  const lines = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    const branches = (txt.match(/^##\s+(.+)$/gm) || []).map((s) => s.replace(/^##\s+/, '').trim());
+    const leaves = (txt.match(/^\s*-\s+\S/gm) || []).length;
+    lines.push(`- ${r.id} (${r.title}) — dallar: ${branches.join(' · ') || '(boş)'}${leaves ? ` [${leaves} kayıt]` : ''}`);
+  }
+  return lines.join('\n');
+}
+
+function readRoot(username, id) {
+  ensureTree(username);
+  try { return fs.readFileSync(rootPath(username, resolveRoot(id).id), 'utf8'); } catch { return ''; }
+}
+
+// Theseus deseni: oturum BAŞINDA hafızayı proaktif yükle. Tüm kökler-dallar-yapraklardan
+// (boş dallar hariç) kompakt bir özet çıkar → sistem prompt'una gömülür ki ajan
+// on-demand aramaya güvenmeden bilgiyi ZATEN bilsin. maxChars aşılırsa kırpılır.
+function buildDigest(username, maxChars = 2600) {
+  ensureTree(username);
+  const parts = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    let branch = '';
+    const byBranch = {};
+    for (const line of txt.split('\n')) {
+      if (line.startsWith('## ')) branch = line.slice(3).trim();
+      else if (/^\s*-\s+\S/.test(line)) (byBranch[branch] = byBranch[branch] || []).push(line.trim().replace(/^-\s*/, ''));
+    }
+    const nonEmpty = Object.entries(byBranch).filter(([, l]) => l.length);
+    if (nonEmpty.length) {
+      parts.push(`[${r.title}]`);
+      for (const [b, l] of nonEmpty) parts.push(`  ${b}: ${l.join('; ')}`);
+    }
+  }
+  let out = parts.join('\n');
+  if (out.length > maxChars) out = out.slice(0, maxChars) + '\n…(fazlası için memory_tree ile oku)';
+  return out;
+}
+
+function search(username, query) {
+  ensureTree(username);
+  const q = String(query || '').toLowerCase().trim();
+  if (!q) return [];
+  const hits = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    let branch = '';
+    for (const line of txt.split('\n')) {
+      if (line.startsWith('## ')) branch = line.slice(3).trim();
+      else if (line.trim() && !line.startsWith('#') && line.toLowerCase().includes(q)) hits.push(`${r.id}/${branch}: ${line.trim()}`);
+    }
+  }
+  return hits;
+}
+
+function append(username, root, branch, content) {
+  ensureTree(username);
+  const r = resolveRoot(root);
+  const p = rootPath(username, r.id);
+  const br = String(branch || 'Genel').trim();
+  const leaf = '- ' + String(content).replace(/\s+/g, ' ').trim();
+  let txt = fs.readFileSync(p, 'utf8');
+  const bRe = new RegExp(`^##[ \\t]+${br.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[ \\t]*$`, 'mi');
+  const m = txt.match(bRe);
+  if (m) {
+    const idx = txt.indexOf(m[0]) + m[0].length;
+    txt = txt.slice(0, idx) + '\n' + leaf + txt.slice(idx);
+  } else {
+    txt = txt.trimEnd() + `\n\n## ${br}\n${leaf}\n`;
+  }
+  fs.writeFileSync(p, txt, 'utf8');
+  return { success: true, root: r.id, branch: br, saved: leaf };
+}
+
+module.exports = {
+  name: 'memory_tree',
+  description: 'Ağaç-hafıza (kök→dal→yaprak): kalıcı bilgiyi kategorize SAKLA/OKU/ARA. Yeni oturumda hatırlanır. action: index|read|search|append',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: 'index | read | search | append' },
+      username: { type: 'string', description: 'kullanıcı adı' },
+      root: { type: 'string', description: '1-kisisel | 2-teknik | 3-kararlar' },
+      branch: { type: 'string', description: 'dal başlığı (append için)' },
+      content: { type: 'string', description: 'yaprak metni (append için)' },
+      query: { type: 'string', description: 'arama (search için)' },
+    },
+    required: ['action'],
+  },
+  async execute(p) {
+    const u = p.username || 'default';
+    try {
+      if (p.action === 'index') return { success: true, index: buildIndex(u) };
+      if (p.action === 'read') return { success: true, content: readRoot(u, p.root || '1-kisisel') };
+      if (p.action === 'search') return { success: true, results: search(u, p.query || p.content || '') };
+      if (p.action === 'append') {
+        if (!p.content) return { success: false, error: 'content (yaprak metni) gerekli' };
+        return append(u, p.root || '1-kisisel', p.branch || 'Genel', p.content);
+      }
+      return { success: false, error: 'bilinmeyen action: ' + p.action + ' (index|read|search|append)' };
+    } catch (e) { return { success: false, error: e.message }; }
+  },
+  _internal: { ensureTree, buildIndex, buildDigest, readRoot, search, append, treeDir, rootPath, ROOTS },
+};

package/src/tools/workflow.js

@@ -222,6 +222,11 @@ async function workflow(params) {
       const { runAgentic } = require('./agentic-runner');
       const memCtx = memoryContext();
       const desktop = path.join(os.homedir(), 'Desktop');
+      const memUser = cfg.userName || 'default';
+      // Theseus deseni: oturum basinda hafiza agacini PROAKTIF yukle (on-demand aramaya
+      // guvenme). Digest = kayitli bilgiler (icerik); Index = yapi (kok→dal).
+      let treeIndex = '', treeDigest = '';
+      try { const mt = require('./memory_tree')._internal; treeDigest = mt.buildDigest(memUser); treeIndex = mt.buildIndex(memUser); } catch {}
       // Tam mod (sahibin opt-in'i): tum arac+skill'ler acilir, keyfi shell (yikici haric).
       const execFull = cfg.agentExec === 'full' || cfg.computerUse === true || String(process.env.NATURECO_AGENT_EXEC || '').toLowerCase() === 'full';
       let fullToolsBlock = '';
@@ -252,7 +257,11 @@ async function workflow(params) {
         '- list_dir: dizin icerigini listele. parametre: path',
         '- bash: kabuk komutu calistir (npm, git, node, python, test, ls, grep/findstr, mkdir...). parametre: command. Guvenli komutlar dogrudan calisir; yikici/tehlikeli komutlar guvenlik politikasiyla engellenir. Icerik aramasi icin grep/findstr kullan.',
         '- skill_view: gorevle ilgili bir skill yukle. parametre: name',
+        '- memory_write: HIZLI tek bilgi kaydet (isim, kisa tercih). parametreler: username ("' + memUser + '"), fact, category. YENI oturumda hatirlanir.',
+        '- memory_tree: AGAC-HAFIZA — zengin/kategorize kalici bilgi (proje, karar, teknik not, kisisel detay). action: index|read|search|append; username="' + memUser + '"; append icin: root (1-kisisel|2-teknik|3-kararlar) + branch (dal basligi) + content (yaprak). YENI oturumda hatirlanir.',
         '\nKurallar:',
+        '- Kullanici kalici bilgi paylasirsa (isim, tercih, parola, proje, karar, onemli detay) ya da "hatirla / not al / kaydet" derse HEMEN KAYDET (username="' + memUser + '"): kisa tek bilgi → memory_write; zengin/kategorize bilgi → memory_tree(append, dogru root/branch). Trivial/gecici seyleri kaydetme.',
+        '- Kullaniciya ozel bir sey sorulunca (gecmis, proje, tercih, karar) once memory_tree(search/read) ile ilgili kok/dali OKU (hedefli, tum hafizayi degil). Tek primary: bilgi tek yerde yasar; digerine sadece "bkz:". Credential/secret ASLA duz metin.',
         '- MEVCUT bir dosyayi degistirmeden ONCE read_file ile oku; sonra edit_file ile hedefli degisiklik yap (tum dosyayi write_file ile ezme).',
         '- Bir seyi nerede oldugunu bilmiyorsan once file_search/list_dir/bash(grep) ile kesfet.',
         '- Kod yazdiktan/degistirdikten sonra gerektiginde bash ile calistir/test et (orn. "node dosya.js", "npm test"); hata cikarsa duzelt.',
@@ -263,6 +272,8 @@ async function workflow(params) {
         '- Basit sohbet/selamlasma ise arac cagirma, dogrudan kisa yanit ver.',
         execFull ? '- Kullanici uygulama ac / tarayici kontrol / muzik cal / ekran / GUI istediyse yukaridaki computer-use araclarini KULLAN — "yapamam/engellendi" DEME, dogrudan ilgili araci cagir.' : '',
         fullToolsBlock,
+        treeDigest ? ('\n\nBILDIGIN KALICI HAFIZA (bu kullaniciya ait, onceki oturumlardan hatirladiklarin; kullaniciya ozel bir sey sorulursa ONCE BUNU KULLAN — dosya arama, uydurma):\n' + treeDigest) : '',
+        treeIndex ? ('\n\nHafiza agaci yapisi (yukarida olmayan detay icin memory_tree(action:read/search) ile ilgili kok/dali oku):\n' + treeIndex) : '',
         skillsIndexBlock ? '\n\n' + skillsIndexBlock : '',
       ].filter(Boolean).join('\n');