@aigencydev/cli 0.3.9 → 0.4.0

package/README.md

@@ -3,50 +3,32 @@
 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?       │
-└──────────────────────────────────────────┘
-```
+> **Önemli:** AIGENCY CLI mevcut web ve mobil AIGENCY hizmetlerini etkilemez. Ayrı bir API namespace (`/api/cli/*`) kullanır, mevcut `/api/v1`, `/api/v2` ve `/api/mobile` endpoint'leri değişmez.
 
 ---
 
 ## Kurulum
 
-**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**
-```powershell
-irm https://aigency.dev/cli/install.ps1 | iex
-```
-
-> **Not:** Node.js 18.18 veya üzeri gerekir. `node --version` ile kontrol edebilirsin.
+> Node.js 18.18 veya üzeri gerekir. `node --version` ile kontrol edebilirsiniz.
 
 ---
 
 ## Hızlı Başlangıç
 
 ```bash
-# 1) Hesabına bağlan (tarayıcı açılır)
+# 1) Hesabınıza bağlanın (tarayıcı açılır)
 aigency login
 
-# 2) Bir proje dizinine gir ve .aigency/ iskeletini oluştur
+# 2) Proje dizinine girin ve .aigency/ iskeletini oluşturun
 cd ~/projects/my-app
 aigency init
 
-# 3) Ajanla konuşmaya başla
-aigency "bana bir Next.js CV sitesi oluştur, Apple tarzı"
+# 3) Ajanla konuşmaya başlayın
+aigency "bana bir Next.js CV sitesi oluştur"
 
 # ya da interaktif modda
 aigency
@@ -58,32 +40,31 @@ aigency
 
 | Komut | Açıklama |
 |---|---|
-| `aigency` | İnteraktif sohbet modu (varsayılan) |
+| `aigency` | İnteraktif sohbet modu |
 | `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 login` | AIGENCY hesabına bağlan |
+| `aigency logout` | Oturumu kapat |
+| `aigency init` | Mevcut dizinde `.aigency/` 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 update` | Sürüm kontrolü |
+| `aigency help` | 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
+| `aigency --mode plan` | Plan modunda başlat (dry-run) |
+| `aigency --mode accept_edits` | Düzenlemeleri otomatik kabul |
 
 ---
 
-## İzin Modları
+## Slash Komutları
 
-| Mod | Davranış |
+| Komut | İşlev |
 |---|---|
-| `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.
+| `/help` | Komut listesi |
+| `/clear` | Sohbet geçmişini temizle |
+| `/mode [mod]` | İzin modunu değiştir veya göster |
+| `/cost` | Bu oturumda kullanılan token |
+| `/undo` | Son dosya düzenlemesini geri al |
+| `/continue` | Kaldığın yerden devam et |
+| `/exit` | Çıkış |
 
 ---
 
@@ -91,109 +72,75 @@ Mod'u çalışırken değiştirmek için **Shift+Tab** bas.
 
 | Tuş | İşlev |
 |---|---|
-| `Shift+Tab` | İzin modlarını döngüle (default → plan → accept_edits → auto) |
-| `ESC` | Aktif ajan işlemini iptal et |
+| `Shift+Tab` | İzin modlarını döngüle |
+| `ESC` | Aktif işlemi iptal et |
 | `Ctrl+C` | Çalışıyorsa iptal, boştaysa çıkış |
-| `/` | Slash komut başlat |
 
 ---
 
-## Slash Komutları
+## İzin Modları
 
-| Komut | İşlev |
+| Mod | Davranış |
 |---|---|
-| `/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ış |
+| `default` | Okuma otomatik, yazma ve komut için onay sorulur |
+| `plan` | Dry-run — hiçbir şey yazılmaz, sadece plan gösterilir |
+| `accept_edits` | Dosya yazma otomatik, komutlar onay ister |
+| `auto` | Tam otomatik (yalnızca Max paket) |
 
 ---
 
-## Araçlar (Ajanın Kullanabildiği Tool'lar)
+## Araçlar
 
-Ajan projenizde aşağıdaki işlemleri yapabilir (izin modunuza göre onay ister):
+Ajan projenizde aşağıdaki işlemleri yapabilir:
 
-**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
+**Dosya sistemi:** `read_file` · `list_files` · `search_files` · `write_file` · `edit_file` · `edit_file_multi`
 
-**Shell**
-- `bash_execute` — İnteraktif olmayan shell komutu çalıştırır (5 dk timeout, canlı çıktı akışı)
+**Shell:** `bash_execute` — interaktif olmayan komutlar, 5 dk timeout, canlı çıktı
 
-**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
+**Doğrulama:** `verify_project` — proje sağlık kontrolü (package.json, scripts, node_modules)
 
-**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
+**Hafıza:** `save_memory` · `read_memory` · `delete_memory` — oturumlar arası kalıcı
 
-**Sandbox:** `.git/`, `.env*`, `~/.ssh/`, `node_modules/`, `.next/` gibi hassas yollar
-otomatik reddedilir. `sudo`, `rm -rf /`, `curl | sh` gibi tehlikeli komutlar
-engellenir.
+**Görev planlama:** `write_tasks` · `read_tasks` — canlı ilerleme göstergesi
+
+**Self-check:** `assert_done` — görev tamamlama doğrulaması
+
+**Güvenlik:** `.git/`, `.env*`, `~/.ssh/`, `node_modules/` yazma yasak. `sudo`, `rm -rf /`, `curl | sh` otomatik engellenir.
 
 ---
 
-## Proje Yapılandırması (`.aigency/`)
+## Proje Yapılandırması
 
-`aigency init` çalıştırdığında projenizde aşağıdaki yapı oluşturulur:
+`aigency init` ile projenizde 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)
+.aigency/
+├── AIGENCY.md          # Proje talimatları (her oturumda okunur)
+├── settings.json       # İzin modu, allow/deny listeleri
+├── rules/              # Dosya bazlı kurallar
+├── hooks/              # PreToolUse/PostToolUse script'leri
 └── .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.
+**AIGENCY.md** projenizin kurallarını tanımlar — teknoloji yığını, kodlama standartları, dokunulmaması gereken yerler.
 
 ---
 
-## 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:
+## Kalıcı Veriler
 
 ```
 ~/.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)
+├── cli.json            # Auth metadata
+├── credentials.enc     # Şifreli token'lar (AES-256-GCM)
+├── settings.json       # Global ayarlar
+├── cli.log             # Rotating log
+└── projects/<hash>/
+    ├── memory/         # Kalıcı hafıza (MEMORY.md + topic dosyaları)
+    ├── sessions/       # Oturum transkriptleri (JSONL)
+    └── 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.
+Makineye özel, git'e eklenmez.
 
 ---
 
@@ -201,80 +148,209 @@ Bu alan **git'e commit edilmez** ve senkronize de olmaz — her makinede ayrı.
 
 | Paket | Fiyat | Aylık Token | Ek Özellikler |
 |---|---|---|---|
-| **AIGENCY CLI Pro** | 1.500 ₺/ay | 100.000.000 | Standart |
-| **AIGENCY CLI Max** | 3.000 ₺/ay | 500.000.000 | Öncelikli kuyruk, Auto mode |
+| **CLI Pro** | 1.500 ₺/ay | 100.000.000 | Standart |
+| **CLI Max** | 3.000 ₺/ay | 500.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.
+Paket yönetimi: [aigency.dev/developer/cli](https://aigency.dev/developer/cli)
 
 ---
 
 ## Yapılandırma
 
-### Ortam değişkenleri
-
 | 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 |
-
-### `.aigency/settings.json` Örneği
-
-```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
-  }
-}
+| `AIGENCY_CLI_API_URL` | API adresi (varsayılan: `https://aigency.dev`) |
+| `AIGENCY_CLI_DEBUG` | `1` ile debug loglar |
+
+---
+
+## Destek
+
+- [aigency.dev/developer/cli](https://aigency.dev/developer/cli) — Yönetim paneli
+- [aigency.dev/forge](https://aigency.dev/forge) — Tanıtım ve SSS
+- [aigency.dev/contact](https://aigency.dev/contact) — İletişim
+
+---
+
+## Lisans
+
+Özel lisans — AIGENCY. Tüm hakları saklıdır.
+
+---
+
+# AIGENCY CLI (English)
+
+AI-powered code generation, file management and project automation from your terminal.
+Connect with your AIGENCY account, work in your project, code is written with your approval.
+
+> **Important:** AIGENCY CLI does not affect existing web and mobile AIGENCY services. It uses a separate API namespace (`/api/cli/*`), existing `/api/v1`, `/api/v2` and `/api/mobile` endpoints remain unchanged.
+
+---
+
+## Installation
+
+```bash
+npm install -g @aigencydev/cli
 ```
 
+> Requires Node.js 18.18 or higher.
+
 ---
 
-## Geliştirme (Contributing)
+## Quick Start
 
 ```bash
-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        # TypeScript tip kontrolü
-npm run test             # Vitest
-npm run build            # dist/ üret
+# 1) Sign in (opens browser)
+aigency login
+
+# 2) Navigate to your project and create .aigency/ scaffold
+cd ~/projects/my-app
+aigency init
+
+# 3) Start chatting with the agent
+aigency "create a Next.js CV site for me"
+
+# or interactive mode
+aigency
 ```
 
 ---
 
-## Destek
+## Commands
 
-- **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)
+| Command | Description |
+|---|---|
+| `aigency` | Interactive chat mode |
+| `aigency "<prompt>"` | One-shot prompt |
+| `aigency login` | Sign in to AIGENCY |
+| `aigency logout` | Sign out |
+| `aigency init` | Create `.aigency/` scaffold |
+| `aigency usage` | Show monthly token usage |
+| `aigency update` | Check for updates |
+| `aigency help` | Help |
+| `aigency --version` | Show version |
+| `aigency --mode plan` | Start in plan mode (dry-run) |
 
 ---
 
-## Lisans
+## Slash Commands
+
+| Command | Action |
+|---|---|
+| `/help` | Command list |
+| `/clear` | Clear chat history |
+| `/mode [mode]` | Change or show permission mode |
+| `/cost` | Tokens used this session |
+| `/undo` | Revert last file edit |
+| `/continue` | Resume from where you left off |
+| `/exit` | Exit |
+
+---
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|---|---|
+| `Shift+Tab` | Cycle permission modes |
+| `ESC` | Cancel active operation |
+| `Ctrl+C` | Cancel if busy, exit if idle |
+
+---
+
+## Permission Modes
+
+| Mode | Behavior |
+|---|---|
+| `default` | Reads automatic, writes and commands prompt for approval |
+| `plan` | Dry-run — no writes, only shows the plan |
+| `accept_edits` | Writes automatic, commands still require approval |
+| `auto` | Full automation (Max tier only) |
+
+---
+
+## Tools
+
+The agent can perform the following operations in your project:
+
+**Filesystem:** `read_file` · `list_files` · `search_files` · `write_file` · `edit_file` · `edit_file_multi`
+
+**Shell:** `bash_execute` — non-interactive commands, 5 min timeout, live output streaming
+
+**Verification:** `verify_project` — project health check (package.json, scripts, node_modules)
+
+**Memory:** `save_memory` · `read_memory` · `delete_memory` — persistent across sessions
+
+**Task planning:** `write_tasks` · `read_tasks` — live progress indicator
+
+**Self-check:** `assert_done` — task completion verification
+
+**Security:** `.git/`, `.env*`, `~/.ssh/`, `node_modules/` are write-protected. `sudo`, `rm -rf /`, `curl | sh` are automatically blocked.
+
+---
+
+## Project Configuration
+
+Created by `aigency init`:
+
+```
+.aigency/
+├── AIGENCY.md          # Project instructions (read every session)
+├── settings.json       # Permission mode, allow/deny lists
+├── rules/              # Path-scoped rules
+├── hooks/              # PreToolUse/PostToolUse scripts
+└── .gitignore
+```
+
+**AIGENCY.md** defines your project rules — tech stack, coding standards, protected areas.
+
+---
+
+## Persistent Data
+
+```
+~/.aigency/
+├── cli.json            # Auth metadata
+├── credentials.enc     # Encrypted tokens (AES-256-GCM)
+├── settings.json       # Global settings
+├── cli.log             # Rotating log
+└── projects/<hash>/
+    ├── memory/         # Persistent memory (MEMORY.md + topic files)
+    ├── sessions/       # Session transcripts (JSONL)
+    └── checkpoints/    # File edit snapshots (for /undo)
+```
+
+Machine-local, never committed to git.
+
+---
+
+## Plans
+
+| Plan | Price | Monthly Tokens | Extras |
+|---|---|---|---|
+| **CLI Pro** | 1,500 ₺/mo | 100,000,000 | Standard |
+| **CLI Max** | 3,000 ₺/mo | 500,000,000 | Priority queue, Auto mode |
+
+Manage plans at [aigency.dev/developer/cli](https://aigency.dev/developer/cli)
+
+---
+
+## Configuration
+
+| Variable | Description |
+|---|---|
+| `AIGENCY_CLI_API_URL` | API address (default: `https://aigency.dev`) |
+| `AIGENCY_CLI_DEBUG` | Set `1` for debug logs |
+
+---
+
+## Support
+
+- [aigency.dev/developer/cli](https://aigency.dev/developer/cli) — Dashboard
+- [aigency.dev/forge](https://aigency.dev/forge) — Product page & FAQ
+- [aigency.dev/contact](https://aigency.dev/contact) — Contact
+
+---
+
+## License
 
-Özel — AIGENCY. Tüm hakları saklıdır.
+Proprietary — AIGENCY. All rights reserved.

package/dist/agent/stream-guards.js

@@ -0,0 +1,23 @@
+export function checkTokenBudget(sessionTokens, softWarningSent, assertDonePassed) {
+    const TOKEN_SOFT_LIMIT = 500_000;
+    const TOKEN_HARD_LIMIT = 800_000;
+    if (sessionTokens > TOKEN_HARD_LIMIT) {
+        return {
+            action: "hard_stop",
+            message: "Bu istek için token bütçesi aşıldı (800K). " +
+                "Çalışma durduruluyor — tamamlanmamış adımlar varsa yeni bir istekle devam edebilirsiniz.",
+        };
+    }
+    if (sessionTokens > TOKEN_SOFT_LIMIT && !assertDonePassed && !softWarningSent) {
+        return {
+            action: "soft_warn",
+            message: "DİKKAT: Bu istek için 500K token harcandı. Token bütçesi azalıyor. " +
+                "Kalan işleri öncelendir, gereksiz dosya okuma/yazma yapma. " +
+                "En kritik işleri bitir ve assert_done ile tamamla.",
+        };
+    }
+    return { action: "continue" };
+}
+export function shouldForceNoTools(toolName, success, gatePassed) {
+    return toolName === "assert_done" && success && gatePassed === true;
+}

package/dist/tools/write-file.js

@@ -57,6 +57,22 @@ export const writeFileTool = async (params, ctx) => {
     catch {
         isNew = true;
     }
+    if (!isNew && existingContent === content) {
+        return {
+            success: false,
+            output: "",
+            error: "Dosya zaten güncel — içerik aynı, yazma yapılmadı.",
+            metadata: {
+                path: check.displayPath,
+                is_new: false,
+                noop: true,
+                bytes: content.length,
+                added: 0,
+                removed: 0,
+            },
+            duration: Date.now() - start,
+        };
+    }
     const diff = summarizeDiff(existingContent, content);
     const previewLines = isNew
         ? content.split(/\r?\n/).slice(0, 20).join("\n")

package/package.json

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