@aigencydev/cli 0.3.0 → 0.3.1

package/README.md

@@ -1,83 +1,280 @@
 # AIGENCY CLI
 
 Terminalden yapay zeka destekli kod üretimi, dosya yönetimi ve proje otomasyonu.
+AIGENCY hesabınla bağlanır, projende çalışır, kodu senin onayınla yazar.
+
+```
+┌──────────────────────────────────────────┐
+│  ✦ AIGENCY CLI v0.3.0                    │
+│  ● default  ·  AIGENCY Pro  ·  my-app    │
+│                                          │
+│  ▸ Sana nasıl yardımcı olabilirim?       │
+└──────────────────────────────────────────┘
+```
+
+---
 
 ## Kurulum
 
-**macOS / Linux**
+**npm ile (önerilen)**
+```bash
+npm install -g @aigencydev/cli
+```
+
+**macOS / Linux — shell installer**
 ```bash
 curl -fsSL https://aigency.dev/cli/install.sh | bash
 ```
 
-**Windows (PowerShell)**
+**Windows — PowerShell**
 ```powershell
 irm https://aigency.dev/cli/install.ps1 | iex
 ```
 
-**npm (alternatif)**
-```bash
-npm install -g @aigencydev/cli
-```
+> **Not:** Node.js 18.18 veya üzeri gerekir. `node --version` ile kontrol edebilirsin.
+
+---
 
-## Kullanım
+## Hızlı Başlangıç
 
 ```bash
-# Hesabınıza bağlanın
+# 1) Hesabına bağlan (tarayıcı açılır)
 aigency login
 
-# Mevcut dizinde .aigency/ proje klasörü oluşturun
+# 2) Bir proje dizinine gir ve .aigency/ iskeletini oluştur
+cd ~/projects/my-app
 aigency init
 
-# Aylık kullanımınızı görün
-aigency usage
+# 3) Ajanla konuşmaya başla
+aigency "bana bir Next.js CV sitesi oluştur, Apple tarzı"
 
-# Sürüm kontrolü
-aigency update
-
-# Yardım
-aigency help
+# ya da interaktif modda
+aigency
 ```
 
-## Paketler
+---
+
+## Komutlar
+
+| Komut | Açıklama |
+|---|---|
+| `aigency` | İnteraktif sohbet modu (varsayılan) |
+| `aigency "<prompt>"` | Tek seferlik prompt çalıştır |
+| `aigency login` | AIGENCY hesabına OAuth ile bağlan |
+| `aigency logout` | Oturumu kapat, yerel token'ları sil |
+| `aigency init` | Mevcut dizinde `.aigency/` yapısını kur |
+| `aigency usage` | Aylık token kullanımını göster |
+| `aigency update` | En son sürümü kontrol et |
+| `aigency help` | Komut yardımı |
+| `aigency --version` | Sürümü göster |
+
+**Flag'ler:**
+- `--mode <default\|plan\|accept_edits\|auto>` — başlangıç izin modu
+- `--model <pro\|max>` — AIGENCY paket seviyesi
 
-| Paket | Fiyat | Aylık token |
-|---|---|---|
-| AIGENCY CLI Pro | 1.500 ₺/ay | 1.000.000 |
-| AIGENCY CLI Max | 3.000 ₺/ay | 5.000.000 + öncelikli kuyruk + Auto mode |
+---
 
-## İzin Modları (Faz 4'te aktif)
+## İzin Modları
 
 | Mod | Davranış |
 |---|---|
-| `default` | Dosya okuma otomatik, yazma ve komut onay ister |
-| `plan` | Dry-run — hiçbir şey yazılmaz, sadece plan gösterilir |
-| `accept_edits` | Dosya yazma otomatik, komut hâlâ onay ister |
-| `auto` | Sınıflandırıcı destekli tam otomatik (sadece Max tier) |
+| `default` | Dosya okuma otomatik, yazma ve komut için onay sorulur |
+| `plan` | Dry-run — hiçbir şey yazılmaz, sadece yapılacakların planı gösterilir |
+| `accept_edits` | Dosya yazma otomatik, shell komutları hâlâ onay ister |
+| `auto` | Sınıflandırıcı destekli tam otomatik (yalnızca **Max** tier) |
+
+Mod'u çalışırken değiştirmek için **Shift+Tab** bas.
+
+---
+
+## Kısayollar
+
+| Tuş | İşlev |
+|---|---|
+| `Shift+Tab` | İzin modlarını döngüle (default → plan → accept_edits → auto) |
+| `ESC` | Aktif ajan işlemini iptal et |
+| `Ctrl+C` | Çalışıyorsa iptal, boştaysa çıkış |
+| `/` | Slash komut başlat |
+
+---
+
+## Slash Komutları
+
+| Komut | İşlev |
+|---|---|
+| `/help` | Komut listesi |
+| `/clear` | Sohbet geçmişini ve onay cache'ini temizle |
+| `/mode [default\|plan\|accept_edits\|auto]` | Modu değiştir veya göster |
+| `/cost` | Bu oturumda kullanılan token sayısı |
+| `/undo` | Son dosya düzenlemesini geri al (checkpoint'ten) |
+| `/exit` veya `/quit` | Çıkış |
+
+---
+
+## Araçlar (Ajanın Kullanabildiği Tool'lar)
+
+Ajan projenizde aşağıdaki işlemleri yapabilir (izin modunuza göre onay ister):
+
+**Dosya sistemi**
+- `read_file` — Dosya içeriği okur
+- `list_files` — Dizin listeler (gitignore'a saygı duyar)
+- `search_files` — Regex ile içerik arar
+- `write_file` — Yeni dosya yazar veya tamamen değiştirir
+- `edit_file` — Mevcut dosyada cerrahi değişiklik yapar
+
+**Shell**
+- `bash_execute` — İnteraktif olmayan shell komutu çalıştırır (5 dk timeout, canlı çıktı akışı)
+
+**Hafıza (kalıcı, makineye özel)**
+- `save_memory` — Önemli bilgiyi oturumlar arası sakla
+- `read_memory` — Detay hafıza dosyasını oku
+- `delete_memory` — Artık geçerli olmayan bilgiyi sil
+
+**Görev planlama**
+- `write_tasks` — Büyük görevleri adımlara böl, ilerlemeyi canlı göster
+- `read_tasks` — Mevcut görev listesini oku
+
+**Sandbox:** `.git/`, `.env*`, `~/.ssh/`, `node_modules/`, `.next/` gibi hassas yollar
+otomatik reddedilir. `sudo`, `rm -rf /`, `curl | sh` gibi tehlikeli komutlar
+engellenir.
+
+---
+
+## Proje Yapılandırması (`.aigency/`)
+
+`aigency init` çalıştırdığında projenizde aşağıdaki yapı oluşturulur:
+
+```
+<proje>/.aigency/
+├── AIGENCY.md              # Proje talimatları (ajan her oturum başında okur)
+├── PROGRESS.md             # İlerleme takibi (opsiyonel)
+├── settings.json           # İzin modu, allow/deny listeleri
+├── settings.local.json     # Kişisel override (gitignored)
+├── rules/                  # Path-scoped kurallar
+│   └── example.md
+├── hooks/                  # PreToolUse/PostToolUse script'leri
+│   ├── hooks.json
+│   └── README.md
+├── logs/                   # Günlük JSONL logları (gitignored)
+└── .gitignore
+```
+
+**AIGENCY.md** en önemli dosyadır — projenizin teknoloji yığını, kodlama kuralları,
+stil tercihleri ve "dokunulmaması gereken yerler"i buraya yazın. Ajan her oturum
+başında bu dosyayı okur ve yazdığı kod bunlarla hizalanır.
+
+---
+
+## Kalıcı Hafıza ve Oturum Verileri
+
+AIGENCY CLI, **makineye özel** veriler için kullanıcının home dizininde ayrı
+bir alan kullanır:
+
+```
+~/.aigency/
+├── cli.json                # Auth metadata
+├── credentials.enc         # AES-256-GCM şifreli token'lar
+├── settings.json           # Kullanıcı seviyesi ayarlar
+├── AIGENCY.md              # Tüm projelerde geçerli global talimatlar
+├── cli.log                 # Rotating log (5 MB × 3 yedek)
+├── cache/                  # LLM response, hash cache
+├── temp/                   # Oturum scratch alanı
+└── projects/
+    └── <proje-hash>/       # Git remote veya yola göre hash
+        ├── memory/
+        │   ├── MEMORY.md   # Hafıza index'i
+        │   ├── user_*.md   # Kullanıcı hakkında
+        │   ├── feedback_*.md # Davranış kuralları
+        │   ├── project_*.md  # Proje bağlamı
+        │   └── reference_*.md # Harici kaynak pointer'ları
+        ├── sessions/
+        │   └── <id>.jsonl  # Oturum transkriptleri
+        └── checkpoints/    # Dosya edit snapshot'ları (undo için)
+```
+
+Bu alan **git'e commit edilmez** ve senkronize de olmaz — her makinede ayrı.
+`.aigency/` (proje klasörü) ise git'e eklenebilir, takımla paylaşılır.
+
+---
+
+## Paketler
+
+| Paket | Fiyat | Aylık Token | Ek Özellikler |
+|---|---|---|---|
+| **AIGENCY CLI Pro** | 1.500 ₺/ay | 1.000.000 | Standart |
+| **AIGENCY CLI Max** | 3.000 ₺/ay | 5.000.000 | Öncelikli kuyruk, Auto mode |
+
+Paketleri [aigency.dev/developer/cli](https://aigency.dev/developer/cli) üzerinden
+yönetebilir, kullanımınızı canlı izleyebilirsiniz.
+
+---
 
 ## Yapılandırma
 
 ### Ortam değişkenleri
 
-- `AIGENCY_CLI_API_URL` — API sunucu URL'i (varsayılan `https://aigency.dev`)
-- `AIGENCY_CLI_DEBUG=1` — ayrıntılı debug log'ları
+| Değişken | Açıklama |
+|---|---|
+| `AIGENCY_CLI_API_URL` | API sunucu adresi (varsayılan `https://aigency.dev`) |
+| `AIGENCY_CLI_DEBUG` | `1` verilirse ayrıntılı debug log'lar |
 
-### Dosyalar
+### `.aigency/settings.json` Örneği
 
-- `~/.aigency/config.json` — kullanıcı düzeyinde varsayılan ayarlar
-- `~/.aigency/credentials.enc` — şifrelenmiş oturum token'ları (AES-256-GCM)
-- `<proje>/.aigency/settings.json` — proje düzeyinde ayar override
+```json
+{
+  "permissions": {
+    "defaultMode": "default",
+    "allow": [
+      "Read(**/*)",
+      "Bash(npm run *)",
+      "Bash(git status)"
+    ],
+    "ask": [
+      "Write(**/*)",
+      "Edit(**/*)",
+      "Bash(*)"
+    ],
+    "deny": [
+      "Read(.env)",
+      "Write(.git/**)",
+      "Bash(rm -rf *)",
+      "Bash(sudo *)"
+    ]
+  },
+  "memory": {
+    "enabled": true
+  },
+  "hooks": {
+    "enabled": false
+  }
+}
+```
+
+---
 
-## Geliştirme
+## Geliştirme (Contributing)
 
 ```bash
-cd aigency-cli
+git clone https://github.com/aigencydev/cli.git
+cd cli
 npm install
+
 npm run dev -- help      # tsx ile direkt çalıştır
-npm run typecheck        # tip kontrolü
+npm run typecheck        # TypeScript tip kontrolü
+npm run test             # Vitest
 npm run build            # dist/ üret
-node dist/index.js help  # derlenmiş halini çalıştır
 ```
 
+---
+
+## Destek
+
+- **Web**: [aigency.dev/developer/cli](https://aigency.dev/developer/cli)
+- **Tanıtım**: [aigency.dev/forge](https://aigency.dev/forge)
+- **Sorun / öneri**: [aigency.dev/contact](https://aigency.dev/contact)
+
+---
+
 ## Lisans
 
-Özel — AIGENCY.
+Özel — AIGENCY. Tüm hakları saklıdır.

package/dist/version.js

@@ -1,3 +1,3 @@
-export const CLI_VERSION = "0.3.0";
+export const CLI_VERSION = "0.3.1";
 export const CLI_NAME = "aigency";
 export const CLI_DISPLAY_NAME = "AIGENCY CLI";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigencydev/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "AIGENCY CLI — terminalden yapay zeka destekli kod üretimi, dosya yönetimi ve proje otomasyonu.",
   "type": "module",
   "bin": {