@aigencydev/cli 0.2.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/agent/checkpoints.js

@@ -0,0 +1,147 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { getCheckpointDir } from "../config/paths.js";
+import { log } from "../utils/logger.js";
+const MAX_CHECKPOINT_BYTES = 2 * 1024 * 1024;
+export async function captureCheckpoint(sessionId, absPath, operation, projectRoot) {
+    try {
+        let beforeContent = "";
+        let existed = false;
+        let size = 0;
+        try {
+            const stat = await fs.stat(absPath);
+            if (stat.isFile()) {
+                size = stat.size;
+                if (size > MAX_CHECKPOINT_BYTES) {
+                    log.debug(`checkpoint: ${absPath} çok büyük (${size}b), snapshot atlandı`);
+                    return null;
+                }
+                beforeContent = await fs.readFile(absPath, "utf8");
+                existed = true;
+            }
+        }
+        catch {
+        }
+        const relPath = path.relative(projectRoot, absPath) || path.basename(absPath);
+        const checkpoint = {
+            relPath,
+            absPath,
+            ts: new Date().toISOString(),
+            operation,
+            beforeContent,
+            existed,
+        };
+        const pathHash = crypto
+            .createHash("sha256")
+            .update(absPath)
+            .digest("hex")
+            .slice(0, 12);
+        const ts = Date.now();
+        const snapshotFile = path.join(getCheckpointDir(sessionId, projectRoot), `${pathHash}-${ts}.snapshot`);
+        await fs.mkdir(path.dirname(snapshotFile), { recursive: true });
+        await fs.writeFile(snapshotFile, JSON.stringify(checkpoint), "utf8");
+        return {
+            relPath,
+            ts: checkpoint.ts,
+            operation,
+            existed,
+            snapshotFile,
+        };
+    }
+    catch (err) {
+        log.debug(`checkpoint hatası: ${err.message}`);
+        return null;
+    }
+}
+export async function findLatestCheckpoint(sessionId, projectRoot) {
+    const dir = getCheckpointDir(sessionId, projectRoot);
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return null;
+    }
+    const files = entries.filter((f) => f.endsWith(".snapshot"));
+    if (files.length === 0)
+        return null;
+    let latest = null;
+    for (const file of files) {
+        const match = /-(\d+)\.snapshot$/.exec(file);
+        if (!match)
+            continue;
+        const ts = parseInt(match[1], 10);
+        if (!latest || ts > latest.ts) {
+            latest = { file, ts };
+        }
+    }
+    if (!latest)
+        return null;
+    try {
+        const raw = await fs.readFile(path.join(dir, latest.file), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function restoreCheckpoint(checkpoint) {
+    try {
+        if (checkpoint.existed) {
+            await fs.mkdir(path.dirname(checkpoint.absPath), { recursive: true });
+            await fs.writeFile(checkpoint.absPath, checkpoint.beforeContent, "utf8");
+            return {
+                ok: true,
+                message: `${checkpoint.relPath} önceki haline geri döndürüldü`,
+            };
+        }
+        else {
+            try {
+                await fs.unlink(checkpoint.absPath);
+            }
+            catch {
+            }
+            return {
+                ok: true,
+                message: `${checkpoint.relPath} silindi (yeni oluşturulmuştu)`,
+            };
+        }
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `Geri alma hatası: ${err.message}`,
+        };
+    }
+}
+export async function listCheckpoints(sessionId, projectRoot) {
+    const dir = getCheckpointDir(sessionId, projectRoot);
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const metadata = [];
+    for (const file of entries) {
+        if (!file.endsWith(".snapshot"))
+            continue;
+        try {
+            const raw = await fs.readFile(path.join(dir, file), "utf8");
+            const cp = JSON.parse(raw);
+            metadata.push({
+                relPath: cp.relPath,
+                ts: cp.ts,
+                operation: cp.operation,
+                existed: cp.existed,
+                snapshotFile: path.join(dir, file),
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return metadata.sort((a, b) => (a.ts > b.ts ? -1 : 1));
+}

package/dist/agent/chunker.js

@@ -1,25 +1,9 @@
-/**
- * AIGENCY CLI — kullanıcı prompt'u ve history için basit chunker.
- *
- * Faz 4 scope'u: basit token budget kontrolü + history trim.
- * Faz 5'te gelişmiş chunked streaming (proje dosyalarını parçalara bölüp
- * ardışık stream istekleriyle göndermek) eklenecek.
- *
- * Şu an:
- *   - Toplam token (history + prompt) tahmin et
- *   - Budget üstü ise en eski mesajları kırp
- *   - Kalan budget prompt + 20% response için yeterli değilse uyar
- */
-/** Basit token tahmini — 1 token ≈ 4 karakter */
 export function approxTokens(text) {
     return Math.ceil(text.length / 4);
 }
-const DEFAULT_MAX_CONTEXT = 120_000; // Güvenli sınır — çoğu model destekler
+const DEFAULT_MAX_CONTEXT = 120_000;
 const DEFAULT_RESERVE_RESPONSE = 8_000;
 const DEFAULT_RESERVE_SYSTEM = 4_000;
-/**
- * History'yi budget'a sığdırır — eskiden başlayarak kırpar.
- */
 export function prepareChunk(prompt, history, options = {}) {
     const maxContext = options.maxContextTokens || DEFAULT_MAX_CONTEXT;
     const reserveResponse = options.reserveForResponse || DEFAULT_RESERVE_RESPONSE;
@@ -34,7 +18,6 @@ export function prepareChunk(prompt, history, options = {}) {
             warning: `Prompt tek başına ${promptTokens} token — context limiti (${available}) aşılıyor. Komutunuzu kısaltın.`,
         };
     }
-    // Sondan başa doğru ekle (son mesajlar daha önemli)
     const reversed = [...history].reverse();
     const selected = [];
     let total = promptTokens;
@@ -56,4 +39,3 @@ export function prepareChunk(prompt, history, options = {}) {
         warning,
     };
 }
-//# sourceMappingURL=chunker.js.map

package/dist/agent/history.js

@@ -1,16 +1,9 @@
-/**
- * AIGENCY CLI — sohbet geçmişi ring buffer.
- *
- * Kullanıcı + asistan mesajlarını tutar. /clear komutu sıfırlar.
- * Chunked streaming sırasında bu history stream endpoint'ine gönderilir.
- */
 const MAX_HISTORY = 40;
 export class ChatHistory {
     messages = [];
     push(msg) {
         const approxTokens = msg.approxTokens ?? Math.ceil((msg.content || "").length / 4);
         this.messages.push({ ...msg, approxTokens });
-        // Ring buffer — en eski mesajları kırp
         while (this.messages.length > MAX_HISTORY) {
             this.messages.shift();
         }
@@ -24,7 +17,6 @@ export class ChatHistory {
     length() {
         return this.messages.length;
     }
-    /** Son N mesajı döner — stream endpoint'ine bunu gönderiyoruz */
     tail(n) {
         return this.messages.slice(-n);
     }
@@ -32,4 +24,3 @@ export class ChatHistory {
         return this.messages.reduce((acc, m) => acc + (m.approxTokens || 0), 0);
     }
 }
-//# sourceMappingURL=history.js.map

package/dist/agent/instructions.js

@@ -0,0 +1,94 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getUserInstructionsFile, getProjectInstructionsFile, getProjectAigencyDir, } from "../config/paths.js";
+import { log } from "../utils/logger.js";
+const MAX_PER_FILE = 32 * 1024;
+const MAX_TOTAL = 96 * 1024;
+const MAX_WALK_DEPTH = 10;
+export async function loadInstructions(projectRoot, cwd = process.cwd()) {
+    const sources = [];
+    let totalBytes = 0;
+    const tryAdd = async (label, filePath) => {
+        if (totalBytes >= MAX_TOTAL)
+            return;
+        const content = await readFileIfExists(filePath);
+        if (!content)
+            return;
+        const trimmed = content.slice(0, MAX_PER_FILE);
+        const remaining = MAX_TOTAL - totalBytes;
+        const finalContent = trimmed.slice(0, remaining);
+        sources.push({
+            label,
+            path: filePath,
+            content: finalContent,
+            sizeBytes: finalContent.length,
+        });
+        totalBytes += finalContent.length;
+    };
+    await tryAdd("global", getUserInstructionsFile());
+    await tryAdd("project", getProjectInstructionsFile(projectRoot));
+    await tryAdd("local", path.join(getProjectAigencyDir(projectRoot), "AIGENCY.local.md"));
+    const rootInstructions = path.join(projectRoot, "AIGENCY.md");
+    if (rootInstructions !== getProjectInstructionsFile(projectRoot)) {
+        await tryAdd("project-root", rootInstructions);
+    }
+    if (isInside(cwd, projectRoot) && cwd !== projectRoot) {
+        let current = path.resolve(cwd);
+        const root = path.resolve(projectRoot);
+        let depth = 0;
+        while (current !== root && depth < MAX_WALK_DEPTH) {
+            const local = path.join(current, ".aigency", "AIGENCY.md");
+            const bare = path.join(current, "AIGENCY.md");
+            await tryAdd(`cwd:${path.relative(root, current)}`, local);
+            await tryAdd(`cwd-root:${path.relative(root, current)}`, bare);
+            const parent = path.dirname(current);
+            if (parent === current)
+                break;
+            current = parent;
+            depth++;
+        }
+    }
+    return {
+        sources,
+        totalBytes,
+        combinedText: buildCombinedText(sources),
+    };
+}
+async function readFileIfExists(p) {
+    try {
+        const stat = await fs.stat(p);
+        if (!stat.isFile())
+            return null;
+        const raw = await fs.readFile(p, "utf8");
+        return raw.includes("\u0000") ? null : raw;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code && code !== "ENOENT") {
+            log.debug(`AIGENCY.md okuma hatası: ${err.message}`);
+        }
+        return null;
+    }
+}
+function isInside(child, parent) {
+    const rel = path.relative(path.resolve(parent), path.resolve(child));
+    return !rel.startsWith("..") && !path.isAbsolute(rel);
+}
+function buildCombinedText(sources) {
+    if (sources.length === 0)
+        return "";
+    const parts = [
+        "## Kullanıcı Talimatları (AIGENCY.md)",
+        "Projede geçerli olan ve her oturumda zorunlu uygulanan talimatlar aşağıdadır.",
+        "",
+    ];
+    for (const src of sources) {
+        parts.push(`### Kaynak: ${src.label}`);
+        parts.push("```markdown");
+        parts.push(src.content.trim());
+        parts.push("```");
+        parts.push("");
+    }
+    parts.push("Yukarıdaki talimatlar SİSTEM KURALLARINDAN sonra, kullanıcı mesajından ÖNCE geçerlidir.", "Birden fazla kaynak çelişirse: lokal (kişisel) > proje > global sırasıyla öncelik ver.");
+    return parts.join("\n");
+}