cc-viewer 1.6.182 → 1.6.183

package/concepts/tr/Tool-EnterPlanMode.md

@@ -1,128 +1,35 @@
 # EnterPlanMode
 
-## Tanım
+Oturumu plan moduna geçirir; bu, asistanın kod tabanını incelediği ve herhangi bir dosya değiştirilmeden önce kullanıcının onayı için somut bir uygulama planı hazırladığı yalnızca-okuma keşif aşamasıdır.
 
-Claude Code'u planlama moduna geçirir; uygulamadan önce kod tabanını keşfetmek ve plan tasarlamak için kullanılır.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-Parametre yok.
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Yeni özellik uygulaması — mimari kararlar gerektirir
-- Birden fazla uygulanabilir yaklaşım var — kullanıcı seçimi gerektirir
-- Kod değişikliği mevcut davranışı veya yapıyı etkiler
-- Çoklu dosya değişikliği — 2-3'ten fazla dosya etkilenebilir
-- Gereksinimler belirsiz — önce keşfedip kapsamı anlamak gerekir
-- Kullanıcı tercihi önemli — uygulama birden fazla makul yönde olabilir
-
-**Kullanıma uygun değil:**
-- Tek satır veya az satırlık düzeltmeler (yazım hatası, belirgin bug)
-- Kullanıcı çok spesifik talimatlar vermiş
-- Salt araştırma/keşif görevi — Task (Explore türü) kullanılmalıdır
-
-## Planlama Modundaki Davranış
-
-Planlama moduna girdikten sonra Claude Code:
-1. Glob, Grep, Read araçlarını kullanarak kod tabanını derinlemesine keşfeder
-2. Mevcut kalıpları ve mimariyi anlar
-3. Uygulama planı tasarlar
-4. Planı kullanıcı onayına sunar
-5. Gerekirse AskUserQuestion ile açıklama isteyebilir
-6. Plan hazır olduğunda ExitPlanMode ile çıkar
-
-## Dikkat Edilecekler
-
-- Bu araç, planlama moduna girmek için kullanıcı onayı gerektirir
-- Planlama gerekip gerekmediğinden emin değilseniz, planlamayı tercih edin — önceden uyum sağlamak yeniden çalışmaktan iyidir
-
-## Orijinal Metin
-
-<textarea readonly>Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
-
-## When to Use This Tool
-
-**Prefer using EnterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
-
-1. **New Feature Implementation**: Adding meaningful new functionality
-   - Example: "Add a logout button" - where should it go? What should happen on click?
-   - Example: "Add form validation" - what rules? What error messages?
+- Kullanıcı birden fazla dosya veya alt sistemi kapsayan önemsiz olmayan bir değişiklik ister.
+- Gereksinimler belirsizdir ve asistanın bir yaklaşıma bağlanmadan önce kodu okuması gerekir.
+- Bir refactoring, geçiş veya bağımlılık yükseltmesi önerilir ve etki yarıçapı belirsizdir.
+- Kullanıcı açıkça "bunu planla", "önce planlayalım" diyor veya tasarım incelemesi talep ediyor.
+- Risk, doğrudan düzenlemelere geçmek çalışmayı boşa çıkarabilecek veya durumu bozabilecek kadar yüksektir.
 
-2. **Multiple Valid Approaches**: The task can be solved in several different ways
-   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
-   - Example: "Improve performance" - many optimization strategies possible
-
-3. **Code Modifications**: Changes that affect existing behavior or structure
-   - Example: "Update the login flow" - what exactly should change?
-   - Example: "Refactor this component" - what's the target architecture?
-
-4. **Architectural Decisions**: The task requires choosing between patterns or technologies
-   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
-   - Example: "Implement state management" - Redux vs Context vs custom solution
-
-5. **Multi-File Changes**: The task will likely touch more than 2-3 files
-   - Example: "Refactor the authentication system"
-   - Example: "Add a new API endpoint with tests"
-
-6. **Unclear Requirements**: You need to explore before understanding the full scope
-   - Example: "Make the app faster" - need to profile and identify bottlenecks
-   - Example: "Fix the bug in checkout" - need to investigate root cause
-
-7. **User Preferences Matter**: The implementation could reasonably go multiple ways
-   - If you would use AskUserQuestion to clarify the approach, use EnterPlanMode instead
-   - Plan mode lets you explore first, then present options with context
-
-## When NOT to Use This Tool
-
-Only skip EnterPlanMode for simple tasks:
-- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
-- Adding a single function with clear requirements
-- Tasks where the user has given very specific, detailed instructions
-- Pure research/exploration tasks (use the Agent tool with explore agent instead)
-
-## What Happens in Plan Mode
-
-In plan mode, you'll:
-1. Thoroughly explore the codebase using Glob, Grep, and Read tools
-2. Understand existing patterns and architecture
-3. Design an implementation approach
-4. Present your plan to the user for approval
-5. Use AskUserQuestion if you need to clarify approaches
-6. Exit plan mode with ExitPlanMode when ready to implement
-
-## Examples
-
-### GOOD - Use EnterPlanMode:
-User: "Add user authentication to the app"
-- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
-
-User: "Optimize the database queries"
-- Multiple approaches possible, need to profile first, significant impact
+## Parametreler
 
-User: "Implement dark mode"
-- Architectural decision on theme system, affects many components
+Yok. `EnterPlanMode` hiçbir argüman almaz — boş bir parametre nesnesiyle çağırın.
 
-User: "Add a delete button to the user profile"
-- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
+## Örnekler
 
-User: "Update the error handling in the API"
-- Affects multiple files, user should approve the approach
+### Örnek 1: Büyük özellik isteği
 
-### BAD - Don't use EnterPlanMode:
-User: "Fix the typo in the README"
-- Straightforward, no planning needed
+Kullanıcı sorar: "Yönetici paneline Okta üzerinden SSO ekle." Asistan `EnterPlanMode`'u çağırır, sonra birkaç tur kimlik doğrulama middleware'ini, oturum depolamasını, yönlendirme korumalarını ve mevcut giriş arayüzünü okumakla geçirir. Gerekli değişiklikleri, geçiş adımlarını ve test kapsamını açıklayan bir plan yazar, sonra onay için `ExitPlanMode` aracılığıyla gönderir.
 
-User: "Add a console.log to debug this function"
-- Simple, obvious implementation
+### Örnek 2: Riskli refactoring
 
-User: "What files handle routing?"
-- Research task, not implementation planning
+Kullanıcı der ki: "REST denetleyicilerini tRPC'ye dönüştür." Asistan plan moduna girer, her denetleyiciyi inceler, genel sözleşmeyi kataloglar, yayın aşamalarını (shim, çift okuma, geçiş) listeler ve herhangi bir dosyaya dokunmadan önce bir sıralama planı önerir.
 
-## Important Notes
+## Notlar
 
-- This tool REQUIRES user approval - they must consent to entering plan mode
-- If unsure whether to use it, err on the side of planning - it's better to get alignment upfront than to redo work
-- Users appreciate being consulted before significant changes are made to their codebase
-</textarea>
+- Plan modu sözleşme gereği yalnızca-okumadır. İçindeyken asistan `Edit`, `Write`, `NotebookEdit` veya herhangi bir değiştirici kabuk komutu çalıştırmamalıdır. Yalnızca `Read`, `Grep`, `Glob` ve yıkıcı olmayan `Bash` komutları kullanın.
+- Önemsiz tek satırlık düzenlemeler, saf araştırma soruları veya kullanıcının değişikliği tam ayrıntısıyla zaten belirttiği görevler için plan moduna girmeyin. Ek yük, yararından daha çok zarar verir.
+- Otomatik modda, kullanıcı açıkça talep etmedikçe plan modu önerilmez — Otomatik mod, önceden planlamaktan ziyade eylemi tercih eder.
+- Pahalı işlerde kurs düzeltmelerini azaltmak için plan modunu kullanın. Beş dakikalık bir plan genellikle yanlış yönlendirilmiş düzenlemelerde bir saat tasarruf sağlar.
+- Plan modunda bir kez girdikten sonra, araştırmayı gerçekten değişecek sistem parçalarına odaklayın. Eldeki görevle ilgisi olmayan deponun kapsamlı turlarından kaçının.
+- Planın kendisi, `ExitPlanMode`'un onu gönderebilmesi için harness'in beklediği yolda diske yazılmalıdır. Plan, belirsiz niyet değil, somut dosya yolları, fonksiyon adları ve doğrulama adımları içermelidir.
+- Kullanıcı planı reddedip revizyon isteyebilir. Plan kabul edilene kadar plan modunda iterasyon yapın; ancak o zaman çıkın.

package/concepts/tr/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## Tanım
+Yeni bir dal üzerinde izole bir Git worktree oluşturur veya oturumu mevcut deponun var olan bir worktree'sine geçirir; böylece paralel veya deneysel çalışma, birincil checkout'a dokunmadan ilerleyebilir.
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## Kullanım Senaryoları
+- Kullanıcı açıkça "worktree" diyor — örneğin "bir worktree başlat", "bir worktree oluştur" veya "bir worktree'de çalış".
+- `CLAUDE.md` veya kalıcı bellekteki proje talimatları, mevcut görev için worktree kullanmanızı yönlendirir.
+- Daha önce worktree olarak kurulmuş bir göreve devam etmek istersiniz (yeniden girmek için `path` geçirin).
+- Birden fazla deneysel dalın, sürekli checkout karışıklığı olmadan diskte bir arada bulunması gerekir.
+- Uzun süren bir görevin, ana çalışma ağacındaki ilgisiz düzenlemelerden yalıtılması gerekir.
 
-**Uygun:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**Uygun değil:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## Notlar
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## Orijinal Metin
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## Parametreler
 
-## When to Use
+- `name` (string, opsiyonel): Yeni bir worktree dizini için ad. Her `/`-ayrılmış segment yalnızca harfler, rakamlar, noktalar, alt çizgiler ve tireler içerebilir; tüm string 64 karakterle sınırlıdır. Atlanır ve `path` de atlanırsa, rastgele bir ad oluşturulur. `path` ile karşılıklı olarak birbirini dışlar.
+- `path` (string, opsiyonel): Mevcut deponun geçiş yapılacak var olan bir worktree'sinin dosya sistemi yolu. Bu depo için `git worktree list`'te görünmelidir; mevcut deponun kayıtlı worktree'leri olmayan yollar reddedilir. `name` ile karşılıklı olarak birbirini dışlar.
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## Örnekler
 
-## When NOT to Use
+### Örnek 1: Açıklayıcı bir adla yeni bir worktree oluşturmak
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+`HEAD`'e dayanan yeni bir dal üzerinde `.claude/worktrees/feat/okta-sso`'yu oluşturur, sonra oturumun çalışma dizinini ona geçirir. Sonraki tüm dosya düzenlemeleri ve kabuk komutları, çıkana kadar o worktree'nin içinde çalışır.
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### Örnek 2: Var olan bir worktree'ye yeniden girmek
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+Daha önce oluşturulmuş bir worktree'de çalışmaya devam eder. `path` aracılığıyla girdiğiniz için `ExitWorktree` onu otomatik olarak silmez — `action: "keep"` ile ayrılmak sadece orijinal dizine döner.
 
-## Parameters
+## Notlar
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- Kullanıcı açıkça istemedikçe veya proje talimatları gerektirmedikçe `EnterWorktree`'yi çağırmayın. Sıradan dal değiştirme veya hata düzeltme istekleri, worktrees değil, normal Git komutları kullanmalıdır.
+- Bir Git deposunun içinde çağrıldığında, araç `.claude/worktrees/` altında bir worktree oluşturur ve `HEAD`'e dayalı yeni bir dal kaydeder. Bir Git deposunun dışında, VCS'ten bağımsız yalıtım için `settings.json`'daki yapılandırılmış `WorktreeCreate` / `WorktreeRemove` kancalarına devreder.
+- Aynı anda yalnızca bir worktree oturumu aktiftir. Halihazırda bir worktree oturumunun içindeyseniz araç çalışmayı reddeder; önce `ExitWorktree` ile çıkın.
+- Oturum ortasında ayrılmak için `ExitWorktree` kullanın. Oturum, yeni oluşturulan bir worktree'nin içindeyken sona ererse, kullanıcıdan onu tutması veya kaldırması istenir.
+- `path` ile girilen worktrees dışsal olarak kabul edilir — `action: "remove"` ile `ExitWorktree` onları silmez. Bu, kullanıcının manuel olarak yönettiği worktrees'i korumak için bir güvenlik önlemidir.
+- Yeni bir worktree, mevcut dalın içeriğini miras alır ancak bağımsız bir çalışma dizinine ve indeksine sahiptir. Ana checkout'taki staged ve unstaged değişiklikler worktree içinde görünmez.
+- Adlandırma ipucu: Birden fazla eş zamanlı worktree'yi `git worktree list`'te ayırt etmek kolay olsun diye çalışma türüyle (`feat/`, `fix/`, `spike/`) ön ekleyin.

package/concepts/tr/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## Tanım
+Plan modu sırasında hazırlanan uygulama planını kullanıcı onayına gönderir ve — onaylanırsa — düzenlemelere başlanabilmesi için oturumu plan modundan çıkarır.
 
-Planlama modundan çıkar ve planı kullanıcı onayına sunar. Plan içeriği daha önce yazılmış plan dosyasından okunur.
+## Ne Zaman Kullanılır
 
-## Parametreler
-
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `allowedPrompts` | array | Hayır | Uygulama planının gerektirdiği izin açıklamaları listesi |
-
-`allowedPrompts` dizisindeki her öğe:
-
-| Alan | Tür | Zorunlu | Açıklama |
-|------|-----|---------|----------|
-| `tool` | enum | Evet | Uygulanacak araç, şu anda yalnızca `Bash` desteklenir |
-| `prompt` | string | Evet | İşlemin anlamsal açıklaması (örn. "run tests", "install dependencies") |
+- `EnterPlanMode` sırasında yazılan bir plan tamamlandı ve incelemeye hazır.
+- Görev saf araştırma değil, uygulama odaklıdır (kod veya yapılandırma değişiklikleri), bu nedenle açık bir plan uygundur.
+- Tüm ön okuma ve analiz yapıldı; kullanıcı karar vermeden önce daha fazla inceleme gerekmez.
+- Asistan sadece hedefleri değil, somut dosya yollarını, fonksiyonları ve adımları numaralandırdı.
+- Kullanıcı planı görmek istedi veya plan modu iş akışı düzenleme araçlarına devrediliyor.
 
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Planlama modunda plan tamamlandı, kullanıcı onayına sunulmaya hazır
-- Yalnızca kod yazılması gereken uygulama görevleri için
-
-**Kullanıma uygun değil:**
-- Salt araştırma/keşif görevi — planlama modundan çıkmaya gerek yok
-- Kullanıcıya "Plan uygun mu?" diye sormak — bu tam olarak bu aracın işlevidir, AskUserQuestion kullanmayın
-
-## Dikkat Edilecekler
+## Parametreler
 
-- Bu araç plan içeriğini parametre olarak kabul etmez — daha önce yazılmış plan dosyasından okur
-- Kullanıcı onay için plan dosyasının içeriğini görecektir
-- Bu aracı çağırmadan önce AskUserQuestion ile "plan uygun mu?" diye sormayın, bu tekrardır
-- Sorularda "plan"dan bahsetmeyin, çünkü kullanıcı ExitPlanMode'dan önce plan içeriğini göremez
+- `allowedPrompts` (dizi, opsiyonel): Kullanıcının onay ekranında planı otomatik olarak onaylamak veya değiştirmek için yazabileceği istemler. Her öğe kapsamlı bir izin belirtir (örneğin bir işlem adı ve uygulandığı araç). Varsayılan onay akışını kullanmak için ayarsız bırakın.
 
-## Orijinal Metin
+## Örnekler
 
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+### Örnek 1: Standart gönderme
 
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
+Plan modunda bir kimlik doğrulama refactoring'ini inceledikten ve plan dosyasını diske yazdıktan sonra, asistan argümansız olarak `ExitPlanMode`'u çağırır. Harness, planı standart konumundan okur, kullanıcıya gösterir ve onay veya reddetme bekler.
 
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+### Örnek 2: Önceden onaylanmış hızlı eylemler
 
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+Kullanıcının rutin takip komutları için önceden izin vermesine izin verir, böylece asistanın uygulama sırasında her izin istemi için duraklamasına gerek kalmaz.
 
-## Examples
+## Notlar
 
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>
+- `ExitPlanMode` yalnızca uygulama tarzı iş için anlam taşır. Kullanıcının isteği dosya değişikliği olmayan bir araştırma veya açıklama görevi ise, doğrudan yanıt verin — sadece çıkmak için plan modundan geçmeyin.
+- Bu aracı çağırmadan önce plan zaten diske yazılmış olmalıdır. `ExitPlanMode` plan gövdesini bir parametre olarak kabul etmez; harness'in beklediği yoldan okur.
+- Kullanıcı planı reddederse, plan moduna dönersiniz. Geri bildirime dayalı olarak revize edin ve tekrar gönderin; plan onaylanmamışken dosyaları düzenlemeye başlamayın.
+- Onay, plan modundan çıkma ve planda açıklanan kapsam için değiştirici araçları (`Edit`, `Write`, `Bash` vb.) kullanma iznini verir. Kapsamı sonradan genişletmek yeni bir plan veya açık kullanıcı onayı gerektirir.
+- Bu aracı çağırmadan önce "bu plan iyi görünüyor mu?" diye sormak için `AskUserQuestion` kullanmayın — plan onayı istemek tam olarak `ExitPlanMode`'un yaptığı şeydir ve kullanıcı gönderilene kadar planı göremez.
+- Planı minimal ve eyleme dönüştürülebilir tutun. Bir inceleyici bir dakikadan az sürede tarayabilmeli ve tam olarak neyin değişeceğini anlayabilmelidir.
+- Uygulama ortasında planın yanlış olduğunu fark ederseniz, sessizce sapmak yerine durun ve kullanıcıya rapor verin. Plan moduna yeniden girmek geçerli bir sonraki adımdır.

package/concepts/tr/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+`EnterWorktree` tarafından daha önce oluşturulmuş bir worktree oturumunu sonlandırır ve oturumu özgün çalışma dizinine geri döndürür. Bu araç yalnızca mevcut oturumda `EnterWorktree` tarafından oluşturulan worktree'ler üzerinde çalışır; böyle bir oturum aktif değilse çağrı hiçbir etki üretmez.
+
+## Ne Zaman Kullanılır
+
+- İzole bir worktree'deki çalışma tamamlandı ve ana çalışma dizinine dönmek istiyorsunuz.
+- Bir özellik dalı worktree'sindeki görev tamamlandı ve birleştirme (merge) işleminin ardından dal ve dizini temizlemek istiyorsunuz.
+- Worktree'yi daha sonra kullanmak üzere saklamak ve hiçbir şeyi silmeden yalnızca özgün dizine geri dönmek istiyorsunuz.
+- Disk üzerinde herhangi bir artifact bırakmadan deneysel ya da geçici bir dalı terk etmek istiyorsunuz.
+- Yeni bir `EnterWorktree` oturumu başlatmanız gerekiyor; bu da önce mevcut oturumu sonlandırmayı gerektiriyor.
+
+## Parametreler
+
+- `action` (dize, zorunlu): `"keep"` worktree dizinini ve dalını disk üzerinde olduğu gibi bırakarak daha sonra geri dönülmesine olanak tanır; `"remove"` dizini ve dalı silerek temiz bir çıkış yapar.
+- `discard_changes` (mantıksal, isteğe bağlı, varsayılan `false`): Yalnızca `action` değeri `"remove"` olduğunda anlamlıdır. Worktree'de kaydedilmemiş dosyalar ya da özgün dalda bulunmayan commit'ler varsa, `discard_changes` değeri `true` olarak ayarlanmadıkça araç kaldırma işlemini reddeder. Hata yanıtı, yeniden çağrılmadan önce kullanıcıyla doğrulama yapılabilmesi için ilgili değişiklikleri listeler.
+
+## Örnekler
+
+### Örnek 1: değişiklikleri birleştirdikten sonra temiz çıkış
+
+Bir worktree'deki çalışmayı tamamlayıp dalı main'e birleştirdikten sonra, worktree dizinini ve dalını silmek ve özgün çalışma dizinine dönmek için `action: "remove"` ile `ExitWorktree` çağrısı yapın.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### Örnek 2: kaydedilmemiş deneysel kod içeren geçici bir worktree'yi atmak
+
+Bir worktree tamamen atılması gereken deneysel, kaydedilmemiş değişiklikler içeriyorsa önce `action: "remove"` deneyin. Araç reddedecek ve kaydedilmemiş değişiklikleri listeleyecektir. Kullanıcının değişikliklerin atılabileceğini onaylamasının ardından `discard_changes: true` ile yeniden çağırın.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## Notlar
+
+- Bu araç yalnızca mevcut oturumda `EnterWorktree` tarafından oluşturulan worktree'ler üzerinde çalışır. `git worktree add` ile oluşturulan worktree'leri, önceki oturumlardaki worktree'leri ya da `EnterWorktree` hiç çağrılmamışsa sıradan çalışma dizinini etkilemez; bu durumlarda çağrı hiçbir etki üretmez.
+- `action: "remove"`, worktree'de kaydedilmemiş değişiklikler veya özgün dalda bulunmayan commit'ler varsa, `discard_changes: true` açıkça belirtilmediği sürece reddedilir. Veriler kurtarılamayacağından `discard_changes: true` ayarlanmadan önce her zaman kullanıcıyla doğrulayın.
+- Worktree'ye bağlı bir tmux oturumu varsa: `remove` işleminde sonlandırılır; `keep` işleminde çalışmaya devam eder ve kullanıcının daha sonra yeniden bağlanabilmesi için oturum adı döndürülür.
+- `ExitWorktree` tamamlandıktan sonra yeni bir worktree oturumu başlatmak için `EnterWorktree` yeniden çağrılabilir.

package/concepts/tr/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## Tanım
+Dosya adlarını bir glob desenine karşı eşleştirir ve yolları önce en son değiştirilme zamanına göre sıralanmış olarak döndürür. `find`'e kabuk çağrısı yapmadan herhangi bir boyuttaki kod tabanlarında dosyaları hızlıca bulmak için optimize edilmiştir.
 
-Herhangi bir boyuttaki kod tabanını destekleyen hızlı dosya adı kalıp eşleştirme aracı. Değişiklik zamanına göre sıralanmış eşleşen dosya yollarını döndürür.
+## Ne Zaman Kullanılır
 
-## Parametreler
+- Belirli bir uzantının her dosyasını numaralandırmak (örneğin `src` altındaki tüm `*.ts` dosyaları)
+- Adlandırma kuralına göre yapılandırma veya fikstür dosyalarını keşfetmek (`**/jest.config.*`, `**/*.test.tsx`)
+- Hedefli bir `Grep` çalıştırmadan önce arama yüzeyini daraltmak
+- `Write` çağırmadan önce bilinen bir desende bir dosyanın zaten var olup olmadığını kontrol etmek
+- Değiştirme-zamanı sıralamasına dayanarak yakın zamanda dokunulan dosyaları bulmak
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `pattern` | string | Evet | glob kalıbı (örn. `**/*.js`, `src/**/*.ts`) |
-| `path` | string | Hayır | Arama dizini, varsayılan olarak mevcut çalışma dizini. "undefined" veya "null" geçmeyin |
+## Parametreler
 
-## Kullanım Senaryoları
+- `pattern` (string, zorunlu): Eşleşecek glob ifadesi. Tek-segmentli joker karakterler için `*`, özyinelemeli eşleşmeler için `**` ve alternatifler için `{a,b}` destekler, örneğin `src/**/*.{ts,tsx}`.
+- `path` (string, opsiyonel): Aramanın çalıştırılacağı dizin. Sağlandığında geçerli bir dizin yolu olmalıdır. Mevcut çalışma dizinini aramak için alanı tamamen atlayın. `"undefined"` veya `"null"` stringlerini geçirmeyin.
 
-**Kullanıma uygun:**
-- Dosya adı kalıbına göre dosya bulma
-- Belirli türdeki tüm dosyaları bulma (örn. tüm `.tsx` dosyaları)
-- Belirli sınıf tanımını (örn. `class Foo`) ararken önce dosyayı konumlandırma
-- Tek mesajda paralel olarak birden fazla Glob çağrısı yapılabilir
+## Örnekler
 
-**Kullanıma uygun değil:**
-- Dosya içeriği arama — Grep kullanılmalıdır
-- Birden fazla tur gerektiren açık uçlu keşif — Task (Explore türü) kullanılmalıdır
+### Örnek 1: Her TypeScript kaynak dosyası
+`pattern: "src/**/*.ts"` ile `Glob` çağırın. Sonuç mtime-sıralı bir listedir, bu nedenle en son düzenlenen dosyalar önce görünür, bu da sıcak noktalara odaklanmak için kullanışlıdır.
 
-## Dikkat Edilecekler
+### Örnek 2: Sınıf tanımı adayı bulmak
+Bir sınıfın, adını bilmediğiniz bir dosyada yaşadığından şüpheleniyorsanız, adayları daraltmak için `pattern: "**/*UserService*"` ile arayın, sonra `Read` veya `Grep` ile takip edin.
 
-- Standart glob sözdizimini destekler: `*` tek seviye, `**` çok seviye, `{}` çoklu seçim eşleştirir
-- Sonuçlar değişiklik zamanına göre sıralanır
-- Bash'in `find` komutundan daha çok önerilir
+### Örnek 3: Büyük bir görevden önce paralel keşif
+Tek bir mesajda, birden fazla `Glob` çağrısı (örneğin biri `**/*.test.ts` için ve biri `**/fixtures/**` için) yayınlayın; böylece her ikisi paralel çalışır ve sonuçları ilişkilendirilebilir.
 
-## Orijinal Metin
+## Notlar
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- Sonuçlar alfabetik olarak değil, dosya değiştirilme zamanına göre (en yeni önce) sıralanır. Kararlı sıralamaya ihtiyacınız varsa aşağı yönde sıralayın.
+- Desenler kabuk tarafından değil, araç tarafından değerlendirilir; komut satırında olduğu gibi tırnak içine almanıza veya kaçış karakteri eklemenize gerek yoktur.
+- Birçok arama ve akıl yürütme turu gerektiren açık uçlu keşifler için, birçok `Glob` çağrısını zincirlemek yerine Explore ajan türüyle bir `Agent`'a devredin.
+- Dosya adı keşfi için `find` veya `ls`'nin `Bash` çağrılarına göre `Glob`'u tercih edin; izinleri tutarlı şekilde yönetir ve yapılandırılmış çıktı döndürür.
+- Dosya adları yerine dosyaların içindeki içeriği arıyorsanız, bunun yerine `Grep` kullanın.

package/concepts/tr/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Tanım
+ripgrep motorunu kullanarak dosya içeriklerini arar. Tam düzenli ifade desteği, dosya türü filtreleme ve kesinliği kompaktlık için takas edebileceğiniz üç çıktı modu sunar.
 
-ripgrep tabanlı güçlü içerik arama aracı. Düzenli ifadeler, dosya türü filtreleme ve çoklu çıktı modlarını destekler.
+## Ne Zaman Kullanılır
+
+- Bir fonksiyonun her çağrı yerini veya bir tanımlayıcının her referansını bulmak
+- Bir string veya hata mesajının kod tabanında herhangi bir yerde görünüp görünmediğini kontrol etmek
+- Refactoring'den önce etkiyi ölçmek için bir desenin geçişlerini saymak
+- Bir aramayı bir dosya türüne (`type: "ts"`) veya glob'a (`glob: "**/*.tsx"`) daraltmak
+- `multiline: true` ile çok satırlı struct tanımları veya JSX blokları gibi çapraz-satır eşleşmelerini çekmek
 
 ## Parametreler
 
-| Parametre | Tür | Zorunlu | Açıklama |
-|-----------|-----|---------|----------|
-| `pattern` | string | Evet | Düzenli ifade arama kalıbı |
-| `path` | string | Hayır | Arama yolu (dosya veya dizin), varsayılan mevcut çalışma dizini |
-| `glob` | string | Hayır | Dosya adı filtresi (örn. `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Hayır | Dosya türü filtresi (örn. `js`, `py`, `rust`), glob'dan daha verimli |
-| `output_mode` | enum | Hayır | Çıktı modu: `files_with_matches` (varsayılan), `content`, `count` |
-| `-i` | boolean | Hayır | Büyük/küçük harf duyarsız arama |
-| `-n` | boolean | Hayır | Satır numaralarını göster (yalnızca content modu), varsayılan true |
-| `-A` | number | Hayır | Eşleşmeden sonra gösterilecek satır sayısı |
-| `-B` | number | Hayır | Eşleşmeden önce gösterilecek satır sayısı |
-| `-C` / `context` | number | Hayır | Eşleşme öncesi ve sonrası gösterilecek satır sayısı |
-| `head_limit` | number | Hayır | Çıktı girdi sayısını sınırla, varsayılan 0 (sınırsız) |
-| `offset` | number | Hayır | İlk N sonucu atla |
-| `multiline` | boolean | Hayır | Çok satırlı eşleştirme modunu etkinleştir, varsayılan false |
-
-## Kullanım Senaryoları
-
-**Kullanıma uygun:**
-- Kod tabanında belirli dize veya kalıp arama
-- Fonksiyon/değişken kullanım yerlerini bulma
-- Dosya türüne göre arama sonuçlarını filtreleme
-- Eşleşme sayısını sayma
-
-**Kullanıma uygun değil:**
-- Dosya adına göre dosya bulma — Glob kullanılmalıdır
-- Birden fazla tur gerektiren açık uçlu keşif — Task (Explore türü) kullanılmalıdır
-
-## Dikkat Edilecekler
-
-- ripgrep sözdizimi kullanır (grep değil), süslü parantez gibi özel karakterler kaçış gerektirir
-- `files_with_matches` modu yalnızca dosya yollarını döndürür, en verimli moddur
-- `content` modu eşleşen satır içeriklerini döndürür, bağlam satırlarını destekler
-- Çok satırlı eşleştirme için `multiline: true` ayarlanmalıdır
-- Bash'teki `grep` veya `rg` komutu yerine her zaman Grep aracını tercih edin
-
-## Orijinal Metin
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- `pattern` (string, zorunlu): Aranacak düzenli ifade. ripgrep sözdizimi kullanır, bu yüzden literal süslü parantezlerin kaçış karakteri gerektirir (örneğin `interface{}` bulmak için `interface\{\}`).
+- `path` (string, opsiyonel): Aranacak dosya veya dizin. Varsayılan olarak mevcut çalışma dizini.
+- `glob` (string, opsiyonel): `*.js` veya `*.{ts,tsx}` gibi dosya adı filtresi.
+- `type` (string, opsiyonel): `js`, `py`, `rust`, `go` gibi dosya türü kısayolu. Standart diller için `glob`'dan daha verimli.
+- `output_mode` (enum, opsiyonel): `files_with_matches` (varsayılan, yalnızca yolları döndürür), `content` (eşleşen satırları döndürür) veya `count` (eşleşme sayılarını döndürür).
+- `-i` (boolean, opsiyonel): Büyük/küçük harf duyarsız eşleştirme.
+- `-n` (boolean, opsiyonel): `content` modunda satır numaralarını dahil et. Varsayılan `true`.
+- `-A` (number, opsiyonel): Her eşleşmeden sonra gösterilecek bağlam satırı sayısı (`content` modu gerektirir).
+- `-B` (number, opsiyonel): Her eşleşmeden önceki bağlam satırları (`content` modu gerektirir).
+- `-C` / `context` (number, opsiyonel): Her eşleşmenin iki tarafındaki bağlam satırları.
+- `multiline` (boolean, opsiyonel): Desenlerin yeni satırları kapsamasına izin ver (`.` `\n` ile eşleşir). Varsayılan `false`.
+- `head_limit` (number, opsiyonel): Döndürülen satırları, dosya yollarını veya sayım girişlerini sınırlar. Varsayılan 250; sınırsız için `0` geçirin (cimri kullanın).
+- `offset` (number, opsiyonel): `head_limit` uygulamadan önce ilk N sonucu atla. Varsayılan `0`.
+
+## Örnekler
+
+### Örnek 1: Bir fonksiyonun tüm çağrı yerlerini bulmak
+Her çağrının çevreleyen satırlarını görmek için `pattern: "registerHandler\\("`, `output_mode: "content"` ve `-C: 2` olarak ayarlayın.
+
+### Örnek 2: Bir tür genelinde eşleşme saymak
+Python kaynakları arasında dosya başına TODO toplamlarını görmek için `pattern: "TODO"`, `type: "py"` ve `output_mode: "count"` olarak ayarlayın.
+
+### Örnek 3: Çok satırlı struct eşleşmesi
+Bir Go struct'ı içinde birkaç satır derinlikte bildirilmiş bir alanı yakalamak için `multiline: true` ile `pattern: "struct Config \\{[\\s\\S]*?version"` kullanın.
+
+## Notlar
+
+- Her zaman `Bash` aracılığıyla `grep` veya `rg` çalıştırmak yerine `Grep`'i tercih edin; araç doğru izinler ve yapılandırılmış çıktı için optimize edilmiştir.
+- Varsayılan çıktı modu en ucuz olan `files_with_matches`'tır. Yalnızca satırların kendisini görmeniz gerektiğinde `content`'e geçin.
+- Bağlam bayrakları (`-A`, `-B`, `-C`) `output_mode` `content` olmadıkça yok sayılır.
+- Büyük sonuç kümeleri bağlam tokenlarını yakar. Odaklı kalmak için `head_limit`, `offset` veya daha sıkı `glob`/`type` filtreleri kullanın.
+- Dosya adı keşfi için `Glob` kullanın; birçok turda açık uçlu araştırmalar için Explore ajanıyla bir `Agent` gönderin.

package/concepts/tr/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Uzun süre çalışan bir betikten olayları akışla ileten bir arka plan monitörü başlatır. Her stdout satırı bir bildirim olur — siz çalışmaya devam ederken olaylar sohbete gelir.
+
+## Ne Zaman Kullanılır
+
+- Bir deployment çalışırken günlük dosyasındaki hataları, uyarıları veya çökme imzalarını takip etmek için
+- Yeni durum olaylarını tespit etmek amacıyla uzak bir API, PR veya CI ardışık düzenini her 30 saniyede sorgulamak için
+- Dosya sistemi dizinindeki veya derleme çıktısındaki değişiklikleri gerçek zamanlı izlemek için
+- Birçok yineleme boyunca belirli bir koşulu beklemek için (örneğin bir eğitim adımı kilometre taşı veya bir kuyruğun boşaltılması)
+- Basit "tamamlanana kadar bekle" için **kullanmayın** — bunun için `run_in_background` ile `Bash` kullanın; süreç sona erdiğinde tek bir tamamlama bildirimi gönderir
+
+## Parametreler
+
+- `command` (dize, zorunlu): Çalıştırılacak shell komutu veya betiği. Stdout'a yazılan her satır ayrı bir bildirim olayı olur. Süreç sona erdiğinde monitör biter.
+- `description` (dize, zorunlu): Her bildirimde gösterilen kısa, okunabilir etiket. Spesifik olun — "deploy.log'daki hatalar" ifadesi "günlükleri izliyor" ifadesinden daha iyidir. Bu etiket hangi monitörün tetiklendiğini tanımlar.
+- `timeout_ms` (sayı, varsayılan `300000`, maks `3600000`): Zorla sonlandırma süresi (milisaniye). Bu süreden sonra süreç sonlandırılır. `persistent: true` olduğunda görmezden gelinir.
+- `persistent` (mantıksal, varsayılan `false`): `true` olduğunda monitör zaman aşımı olmaksızın oturumun tüm ömrü boyunca çalışır. `TaskStop` ile açıkça durdurun.
+
+## Örnekler
+
+### Örnek 1: Günlük dosyasını hatalar ve çökmeler için izlemek
+
+Bu örnek tüm terminal durumlarını kapsar: başarı işaretçisi, geri izleme, yaygın hata anahtar kelimeleri, OOM sonlandırması ve beklenmedik süreç çıkışı.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Her pipe'ta `grep --line-buffered` kullanın. Kullanılmazsa işletim sistemi çıktıyı 4 KB'lık bloklar halinde tamponlar ve olaylar dakikalarca gecikebilir. Alternasyon deseni hem başarı yolunu (`deployed`) hem de hata yollarını (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`) kapsar. Yalnızca başarı işaretçisini izleyen bir monitör çökme sırasında sessiz kalır — sessizlik "hâlâ çalışıyor" ile aynı görünür.
+
+### Örnek 2: Uzak API'yi her 30 saniyede sorgulamak
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` geçici bir ağ hatasının döngüyü sonlandırmasını engeller. Hız sınırlarından kaçınmak için uzak API'ler için 30 saniye veya daha fazla sorgulama aralıkları uygundur. API tarafındaki hatalar sessizlikle maskelenmemesi için grep desenini hem başarı hem de hata yanıtlarını yakalayacak şekilde ayarlayın.
+
+## Notlar
+
+- **Pipe'larda her zaman `grep --line-buffered` kullanın.** Kullanılmazsa, işletim sistemi bir 4 KB blok dolana kadar çıktıyı biriktirdiğinden pipe tamponlaması olayları dakikalarca geciktirir. `--line-buffered` her satırdan sonra zorla boşaltma yapar.
+- **Filtre hem başarı hem de hata imzalarını kapsamalıdır.** Yalnızca başarı işaretçisini izleyen bir monitör çökme, takılma veya beklenmedik çıkış durumunda sessiz kalır. Alternasyonu genişletin: başarı anahtar kelimesinin yanına `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` ve benzeri terminal durum işaretçilerini ekleyin.
+- **Sorgulama aralıkları: Uzak API'ler için 30 saniye veya daha fazla.** Harici hizmetlerin sık sorgulanması hız sınırı hatalarına veya engellemelere yol açabilir. Yerel dosya sistemi veya süreç kontrolleri için 0,5–1 saniye uygundur.
+- **Oturum ömrü boyunca çalışan monitörler için `persistent: true` kullanın.** Varsayılan `timeout_ms` değeri 300.000 ms (5 dakika) süreyi sonlandırır. Açıkça durdurulana kadar çalışması gereken monitörler için `persistent: true` ayarlayın ve bittiğinde `TaskStop` çağırın.
+- **Olay seli durumunda otomatik durdurma.** Her stdout satırı bir sohbet mesajıdır. Filtre çok geniş olup çok fazla olay üretirse monitör otomatik olarak durdurulur. Daha dar bir `grep` deseniyle yeniden başlatın. 200 ms içinde gelen satırlar tek bir bildirimde toplanır.