@takimcizgisi/ajan 0.2.5

package/README.md

@@ -0,0 +1,366 @@
+<p align="center">
+  <img src="./src/gui/assets/image/AJAN_LOGO.svg" alt="AJAN AI" width="420">
+</p>
+
+<div align="center">
+
+**[AJAN AI](https://github.com/takimcizgisi/ajan)** — Tamamen yerel, açık kaynak yapay zeka kodlama ajanı.
+
+![Version](https://img.shields.io/badge/sürüm-v0.2.5-ff751f)
+![License](https://img.shields.io/badge/lisans-GPL--3.0-1a1a1a)
+![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)
+![Node](https://img.shields.io/badge/Node.js-18%2B-339933?logo=node.js&logoColor=white)
+![Platform](https://img.shields.io/badge/Windows%20%7C%20Linux%20%7C%20macOS-555)
+
+_Gemma 4 E2B + Node-llama-cpp ile tamamen çevrimdışı çalışır — verileriniz cihazınızdan çıkmaz._
+
+<div align="center">
+  <table>
+    <tr>
+      <td align="center" style="background-color:#ffe0e0; border:2px solid #d32f2f; border-radius:8px; padding:12px 18px;">
+        <b style="color:#c62828; font-size:1.1em;">⚠️ DENEYSEL PROJE</b><br>
+        <span style="color:#b71c1c;">Bu proje <b>deneyseldir</b> ve <b>tam stabil değildir.</b> Beklenmeyen hatalar veya davranış değişiklikleri olabilir.</span>
+      </td>
+    </tr>
+  </table>
+</div>
+
+</div>
+
+---
+
+## 🛠️ Nasıl Yapıldı?
+
+> Bu proje, **🧢 Vibecoding** yöntemiyle [<img src="./src/gui/assets/image/opencode.svg" alt="opencode" width="60em" style="vertical-align:middle">](https://opencode.ai) ile geliştirilmiştir.
+
+---
+
+## ✨ Özellikler
+
+- 🤖 **Yerel AI Motoru** — Node-llama-cpp ile tamamen çevrimdışı ve gizlilik odaklı
+- 🖥️ **Çift Arayüz** — Terminal (TUI) ve masaüstü GUI (Electron)
+- 💬 **Sohbet Modu** — Çoklu oturum, geçmiş kaydı ve model seçimi
+- 🔧 **Görev / Ajan Modu** — Dosya, terminal, web ve patch araçlarıyla otonom görevler
+- 📥 **Model Yönetimi** — Modelleri indirme, kurma ve yönetme
+- 📁 **Proje Yönetimi** — Ajanı belirli proje klasörlerine bağlama
+- ⚙️ **Yapılandırılabilir** — Kullanıcı dostu ayarlar ekranı
+- 📦 **Kolay Kurulum** — Kurulumdan sonra ek yapılandırma gerektirmez
+
+---
+
+## 📖 İçindekiler
+
+- [Teknik Bilgiler](#-teknik-bilgiler)
+- [Kurulum](#-kurulum)
+- [Kullanım](#-kullanım)
+- [Araçlar](#-araçlar-tools)
+- [Nasıl Çalışır](#-nasıl-çalışır)
+- [Proje Yapısı](#-proje-yapısı)
+- [Katkı & Lisans](#-katkı--lisans)
+
+---
+
+## 🖥️ Teknik Bilgiler
+
+| Özellik | Bilgi |
+|---------|-------|
+| 🧠 Model | Gemma 4 E2B (GGUF) |
+| 🔌 AI Motoru | node-llama-cpp |
+| 💾 RAM / VRAM | Yaklaşık 4 GB |
+| 🧾 Bağlam | Yüksek token (Gemma 4 E2B) |
+| 🖥️ Platform | Windows, Linux, macOS |
+| 🖱️ Arayüz | CLI (TUI) + Electron GUI |
+| 📝 Dil | TypeScript |
+
+---
+
+## 📥 Kurulum
+
+### 🗂️ Yayın (Release) Politikası
+
+> **Önemli:** Bu projenin **kaynak kodları GitHub deposunda bulunmaz.** Her **release** sürümünde kaynak kodu, ayrı bir paket (zip/tar) olarak **Release dosyalarına** yüklenir ve dağıtılır.
+>
+> - ⚠️ Kaynak kodları repo'da **bulunmaz** — yalnızca release paketleri üzerinden yayımlanır.
+> - 📦 Her yeni sürüm, kaynak kodu paketiyle birlikte release olarak yayımlanır.
+> - 🔗 Kaynak kodu almak için en güncel sürümün **Release** sayfasındaki kaynak arşivini indirin.
+
+### Gereksinimler
+
+- ✅ **Node.js** 18 veya daha yeni
+- ✅ **npm** veya **yarn**
+- ✅ (İsteğe bağlı) GPU hızlandırma için **CUDA**
+
+### ☁️ Global Kurulum (npm)
+
+```bash
+npm install -g @takimcizgisi/ajan
+```
+
+Global kurulumdan sonra `ajan` komutunu doğrudan terminalden kullanabilirsiniz.
+
+### 🧑‍💻 Geliştirici Kurulumu
+
+```bash
+git clone https://github.com/takimcizgisi/ajan.git
+cd ajan
+npm install
+npm run build:all
+```
+
+---
+
+## 🚀 Kullanım
+
+### 💻 CLI (Terminal) Arayüzü
+
+```bash
+npm run dev          # Geliştirme modunda CLI
+npm start            # Derlenmiş CLI
+ajan                 # Global kurulumda sohbet TUI'si
+```
+
+### 🖥️ GUI (Masaüstü) Arayüzü
+
+```bash
+npm run dev:gui      # Geliştirme modunda GUI (build + electron)
+npm run gui          # Paketlenmiş GUI
+ajan gui             # Global kurulumda GUI
+```
+
+> 💡 GUI ilk açılışta model indirilmesini isteyebilir; ilerleme arayüzde gösterilir.
+
+### 📦 npm Betikleri
+
+| Betik | Açıklama |
+|-------|----------|
+| `build` | CLI (TypeScript) derle |
+| `build:gui` | GUI (TypeScript) derle |
+| `build:all` | CLI + GUI birlikte derle |
+| `build:electron` | Electron tip kontrolü (derleme yok) |
+| `doctor` | Sistem / bağımlılık kontrolü |
+| `test:tools` | Araçların smoke testleri |
+| `release` | Sürüm paketleme |
+
+### 🧩 CLI Alt Komutları
+
+```bash
+ajan                 # Sohbet TUI'sini başlat (varsayılan)
+ajan gui             # Masaüstü arayüzünü başlat
+ajan model list      # Modelleri listele
+ajan model install <id>  # Model indir
+ajan model use <id>      # Modeli etkin yap
+ajan model remove <id>   # Modeli sil
+```
+
+---
+
+## ⌨️ CLI Komutları (TUI içinde)
+
+| Komut | Açıklama |
+|-------|----------|
+| `/yeni` | Yeni oturum başlat |
+| `/clear` | Konuşma geçmişini temizle |
+| `/sessions` | Kayıtlı oturumları listele |
+| `/resume <id>` | Kayıtlı oturumu yükle |
+| `/export [dosya]` | Oturumu Markdown'a dışa aktar |
+| `/kopyala` | Son çıktıyı/yanıtı panoya kopyala |
+| `/todo` | Görevler: `ekle <metin> | sil <no> | temizle | list` |
+| `/model` | Model: `list | install <id> | use <id> | remove <id>` |
+| `/cd <dizin>` | Çalışma dizinini değiştir |
+| `/doctor` | Sistem kontrolü (GPU, model, SAC) |
+| `/stats` | Bağlam ve oturum istatistikleri |
+| `/tools` | Ajanın araçlarını listele |
+| `/config [anahtar değer]` | Ayarları göster/değiştir |
+| `/help` | Komutları listele |
+| `/exit` | Çıkış yap |
+
+> **Yapılandırma örnekleri**
+>
+> ```text
+> /config temperature 0.7      # Sıcaklık (0-2)
+> /config maxTokens 2048       # Maks. üretim token'ı (>=256)
+> /config maxSteps 40          # Maks. ajan adımı (1-200)
+> ```
+
+---
+
+## 📚 Kullanım Örnekleri
+
+### 💬 Basit Sohbet
+
+```bash
+ajan
+```
+
+```text
+> Merhaba
+AJAN  Merhaba! Size nasıl yardımcı olabilirim?
+```
+
+### 🔧 Kodlama / Görev Ajanı
+
+```bash
+ajan
+> Bu projenin testlerini çalıştır ve sonuçları özetle
+```
+
+AJAN, terminal aracını kullanarak komutu çalıştırır, çıktıyı analiz eder ve sonucu özetler — görev tamamlanana kadar araçları otonom şekilde sırayla kullanır.
+
+### 🧠 Model Yönetimi
+
+```bash
+ajan model list
+ajan model install gemma-4-e2b-q4-k-m
+ajan model use gemma-4-e2b-q4-k-m
+```
+
+### 📦 Bağımlılıklar
+
+| Paket | Rol |
+|-------|-----|
+| **node-llama-cpp** | Yerel LLM motoru (yükleme + inferans) |
+| **chalk** | Terminal renklendirme (TUI) |
+| **diff** | Satır farkı / yama hesaplama |
+| **js-yaml** | Yapılandırma / YAML ayrıştırma |
+| **adm-zip** | Model arşivlerini açma |
+| **electron** · **tsx** · **typescript** | GUI kabuğu ve dev araçları |
+
+---
+
+## 🛠️ Araçlar (Tools)
+
+AJAN çekirdeği, otonom görevleri yerine getirmek için şu araçlara sahiptir:
+
+| Araç | Görev |
+|------|-------|
+| **file** | Dosya oku / yaz / listele |
+| **edit** | Mevcut dosyaları düzenle |
+| **filesys** | Dosya sistemi operasyonları |
+| **patch** | Yama (diff) uygula / üret |
+| **terminal** | Shell komutları çalıştır |
+| **web** | Web sayfası getir / ara |
+| **memory** | Kısa / uzun dönem bellek yönetimi |
+| **data** | Veri işleme / sorgulama |
+| **taskComplete** | Görev tamamlandı işareti |
+
+> ⚙️ Her araç çağrısı TUI/GUI'de görsel olarak izlenir: `çalıştırılıyor... → ✅ / ❌`
+
+---
+
+## ⚙️ Nasıl Çalışır?
+
+| # | Aşama | Açıklama |
+|---|-------|----------|
+| 1 | **Model** | Gemma 4 E2B (GGUF) `node-llama-cpp` ile yüklenir; GPU varsa CUDA, yoksa CPU kullanılır |
+| 2 | **Ajan döngüsü** | `AjanService` mesajı modele iletir; model düşünür ve ilgili aracı (`tools/`) çağırır. Sonuç tekrar modele verilir; görev bitene kadar döngü sürer (maxSteps ile sınırlı) |
+| 3 | **Bağlam** | Uzun konuşmalarda eski turlar otomatik sıkıştırılır, bağlam penceresi aşılmaz |
+| 4 | **Oturumlar** | Konuşmalar kaydedilir: `/sessions` listeler, `/resume <id>` geri yükler, `/export` Markdown'a döker |
+| 5 | **Güvenlik** | Lock mekanizması aynı anda tek arayüz çalıştırır; SAC durumu `/doctor` ile izlenir |
+
+---
+
+## ⌨️ Kısayollar
+
+| Tuş | İşlev |
+|-----|-------|
+| `Enter` | Mesaj gönder |
+| `ESC` | Üretimi durdur |
+| `TAB` | Komut otomatik tamamlama (TUI) |
+| `↑` / `↓` | Geçmiş / imleç gezinme |
+| `Page Up` / `Down` | Kaydırma |
+| `Ctrl + C` / `/exit` | Çıkış |
+| GUI üst menü | Yeni sohbet · Projeler · İndirmeler · Ayarlar |
+
+---
+
+## 📂 Proje Yapısı
+
+```text
+ajan/
+├── config/                 # Yapılandırma dosyaları
+├── dist/                   # Derlenmiş çıktı
+├── scripts/                # Betikler (release, smoke-test)
+├── src/
+│   ├── index.ts            # Paket girişi
+│   ├── service.ts          # Servis katmanı
+│   ├── cli/                # CLI & TUI arayüzü
+│   │   ├── index.ts
+│   │   └── tui.ts
+│   ├── core/               # Ajan çekirdeği (agent)
+│   ├── engine/             # Llama motoru + model yönetimi
+│   ├── electron/           # GUI kabuk (main + preload)
+│   ├── gui/                # Masaüstü arayüzü (HTML/CSS/JS/TS)
+│   ├── tools/              # Dosya, terminal, web, patch araçları
+│   └── utils/              # Yardımcı işlevler
+└── package.json
+```
+
+> **GUI** — `src/gui/` altında `html/`, `css/`, `ts/` (kaynak) ve `js/` (derlenmiş) klasörlerinden oluşur; `assets/` içinde Bootstrap, font ve görseller bulunur.
+
+---
+
+## 🤝 Katkı & Lisans
+
+### 🤝 Katkıda Bulunma
+
+Katkılar her zaman memnuniyetle karşılanır!
+
+1. Repository'yi **fork** edin
+2. Yeni bir **branch** oluşturun
+3. Değişikliklerinizi yapın
+4. Açıklayıcı **commit** mesajları kullanın
+5. **Pull request** gönderin
+
+### ⚖️ Lisans
+
+Bu proje **[GNU GPL v3.0](./LICENSE)** — _GNU General Public License v3_ — ile yayımlanan **özgür ve copyleft** bir yazılımdır.
+
+GPL-3.0 kapsamında bu projeyi;
+
+- ✅ Kullanabilirsiniz
+- ✅ İnceleyebilirsiniz
+- ✅ Değiştirebilirsiniz
+- ✅ Dağıtabilirsiniz (ücretli/ücretsiz)
+
+Ancak;
+
+- ❌ Değiştirdiğiniz/dağıttığınız sürümleri aynı GPL-3.0 lisansı altında yayımlamadan dağıtamazsınız (copyleft)
+- ❌ Kaynak kodunu erişilebilir kılmadan yalnızca derlenmiş halini dağıtamazsınız
+- ❌ Bu yazılım için **hiçbir garanti** verilmez
+
+> **Not:** Bu proje, özgür yazılım felsefesiyle geliştirilmiştir. GPL-3.0 yazılım özgürlüğü sağlar; telif hakkı sahipliğini devretmez. Tam lisans metni için **[LICENSE](./LICENSE)** dosyasına bakınız.
+
+---
+
+## 💛 Destekleyin
+
+Açık kaynak, topluluğun desteğiyle yaşar. Bu projeye katkıda bulunmanın birkaç yolu vardır:
+
+### ⭐ AJAN'a Destek
+
+- Repoya ⭐ **yıldız** verin — görünürlük her şeydir
+- 🐛 Bug bildirin veya 💡 özellik önerisi açın (Issues)
+- 🔧 Kod, dökümantasyon veya çeviri katkısı sağlayın
+- 📣 Projeyi çevrenizle paylaşın
+
+### 🌐 OpenCode'a Destek
+
+**AJAN AI**, 🧢 Vibecoding yöntemiyle [opencode](https://opencode.ai) kullanılarak geliştirilmiştir. OpenCode — açık kaynak ajanının gelişimine de destek olabilirsiniz:
+
+- ⭐ [GitHub'da opencode](https://github.com/anomalyco/opencode) repolarına yıldız verin
+- 💻 Yapay zeka ajanı geliştiricisiyseniz PR'larınızla katkı sağlayın
+- 🗣️ Topluluğa katılın (Discord) ve geri bildirim verin
+
+> Open source, birlikte geliştirilen yazılımın gücüdür. 💪
+
+---
+
+<div align="center">
+
+**👨‍💻 İbrahim Anadol** · TakımÇizgisi Yazılım Geliştirme Grubu
+
+© 2026 İbrahim Anadol · Tüm hakları saklıdır.
+
+_Bu projeyi 🤖⭐ bir yıldızla destekleyebilirsiniz!_
+
+</div>

package/config/models.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://takimcizgisi.dev/schemas/ajan-models.json",
+  "version": 1,
+  "source": "https://raw.githubusercontent.com/takimcizgisi/ajan/main/config/models.json",
+  "models": [
+    {
+      "id": "gemma-4-e2b-q4-k-m",
+      "name": "Gemma 4 E2B (Q4_K_M)",
+      "description": "Ana model: 4-bit sıkıştırılmış, ~3-4GB RAM, 128K bağlam",
+      "uri": "hf:unsloth/gemma-4-E2B-it-GGUF/gemma-4-E2B-it-Q4_K_M.gguf",
+      "fileName": "gemma-4-E2B-it-Q4_K_M.gguf",
+      "contextSize": 131072,
+      "gpuLayers": "auto",
+      "chatWrapper": "gemma4",
+      "reasoning": true,
+      "multimodal": true
+    },
+    {
+      "id": "gemma-4-e2b-q8",
+      "name": "Gemma 4 E2B (Q8_0)",
+      "description": "Daha yüksek kalite, daha fazla RAM (~5-8GB)",
+      "uri": "hf:unsloth/gemma-4-E2B-it-GGUF/gemma-4-E2B-it-Q8_0.gguf",
+      "fileName": "gemma-4-E2B-it-Q8_0.gguf",
+      "contextSize": 131072,
+      "gpuLayers": "auto",
+      "chatWrapper": "gemma4",
+      "reasoning": true,
+      "multimodal": true
+    },
+    {
+      "id": "gemma-3-4b-it-q4-k-m",
+      "name": "Gemma 3 4B Instruct (Q4_K_M)",
+      "description": "Alternatif: çoklu mod destekli, orta boy",
+      "uri": "hf:unsloth/gemma-3-4b-it-GGUF:Q4_K_M",
+      "fileName": "gemma-3-4b-it-Q4_K_M.gguf",
+      "contextSize": 32768,
+      "gpuLayers": "auto",
+      "chatWrapper": "gemma",
+      "multimodal": true
+    },
+    {
+      "id": "qwen-3-4b-instruct-q4-k-m",
+      "name": "Qwen3 4B Instruct (Q4_K_M)",
+      "description": "Alternatif: güçlü tool calling desteği",
+      "uri": "hf:unsloth/Qwen3-4B-GGUF/Qwen3-4B-Q4_K_M.gguf",
+      "fileName": "Qwen3-4B-Q4_K_M.gguf",
+      "contextSize": 32768,
+      "gpuLayers": "auto",
+      "chatWrapper": "qwen3",
+      "reasoning": false,
+      "multimodal": false
+    }
+  ]
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function generateTitle(text: string): string;