ai-enderun 0.0.1 → 0.0.3

package/.env.example

@@ -0,0 +1,10 @@
+# AI Agent Framework — Configuration
+# --------------------------------
+
+# MCP Server Settings
+EMBEDDING_PROVIDER=google
+GOOGLE_API_KEY=your_api_key_here
+
+# Framework Settings
+LOG_LEVEL=info
+PHASE=PHASE_0

package/.gemini/PROJECT_MEMORY.md

@@ -4,28 +4,102 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 
 ## MEVCUT DURUM
 
-| Aktif Faz | Son Güncelleme | Aktif Trace ID |
-| :-------- | :------------- | :------------- |
-| PHASE_0   | 2026-05-07     | BASE-INIT-001  |
+| Aktif Faz | Profile | Son Güncelleme | Aktif Trace ID | Blokaj |
+| :-------- | :------ | :------------- | :------------- | :----- |
+| PHASE_0   | Lightweight | 2026-05-07 | 18969447-95fb-4a8f-b0af-18336c3f1931 | YOK |
+
+## PROJE TANIMI
+
+| Alan | Değer |
+| :--- | :---- |
+| Proje Adı | AI-Enderun |
+| Platform | Agent skill sandbox / orchestration framework |
+| Frontend | React 19 + Vite + Zustand + Tailwind |
+| Backend | Node.js 20+ + Fastify |
+| DB | PostgreSQL |
+| Auth | Henüz netleştirilmedi |
+| Deploy | Henüz netleştirilmedi |
+
+## DOD DURUMU
+
+| Faz | Durum | Not |
+| :-- | :---- | :-- |
+| PHASE_0 | IN_PROGRESS | Tool sözleşmeleri ve hafıza yapısı hizalanıyor |
+| PHASE_1 | PENDING | `contract.version.json` ve ilk resmi kontratlar sonrası |
+| PHASE_2 | PENDING | Feature geliştirme başlamadı |
+| PHASE_3 | PENDING | Entegrasyon çalışmaları başlamadı |
+| PHASE_4 | PENDING | Teslim aşamasına geçilmedi |
 
 ## KRİTİK KARARLAR
 
-| Tarih      | Karar                     | Gerekçe                                 | Ajan     |
-| :--------- | :------------------------ | :-------------------------------------- | :------- |
-| 2026-05-07 | Standalone Architecture   | Maksimum esneklik ve bağımsızlık        | @manager |
+| Tarih | Karar | Gerekçe | Ajan |
+| :---- | :---- | :------ | :--- |
+| 2026-05-07 | Standalone Architecture | Maksimum esneklik ve bağımsızlık | @manager |
 | 2026-05-07 | Contract-First Discipline | Sıfır hata ile ölçeklenebilir geliştirme | @manager |
+| 2026-05-07 | Canonical MCP Tooling | Agent kabiliyetlerini korurken araç adlarını tek sözlükte hizalamak | @analyst |
+| 2026-05-07 | UUID Trace Standard | Yeni görev zincirlerinde yalnızca UUID v4 kullanmak | @manager |
+
+## TESLİM EDİLENLER
+
+| Modül | Durum | Ajan | Tarih |
+| :---- | :---- | :--- | :---- |
+| Root ve paket README düzeni | Tamamlandı | @analyst | 2026-05-07 |
+| Agent SOP temel kütüphanesi | Tamamlandı | @manager | 2026-05-07 |
 
 ## AKTİF GÖREVLER
 
-- [ ] [TRACE-4EE5BA49] CLI Test Görevi (@backend)
-- [ ] İlk modüllerin mimari taslaklarının oluşturulması.
+| Trace ID | Görev | Ajan | Öncelik | Durum |
+| :------- | :---- | :--- | :------ | :---- |
+| 258ebde2-3c58-4cd6-afcd-a0952419b039 | Gelişmiş Denetim Testi | @analyst | P2 | IN_PROGRESS |
+| 9bb9f0f8-bb5c-4176-8d3d-7a4d3e1bb997 | CLI implementasyon testi | @backend | P2 | IN_PROGRESS |
+| e4ed34c1-6a55-4fd2-9f16-2ccf5ecadf8f | CLI test görevi | @backend | P2 | IN_PROGRESS |
+| 6f8d0d7f-1f34-4f85-8b2b-3f2dcb6b8f6a | Agent hafızası ve beyin sözleşmelerini hizalama | @manager, @analyst | P1 | IN_PROGRESS |
 
 ## HISTORY (Kalıcı Hafıza)
 
-### 2026-05-07 — v0.0.1 (Initial Professional Launch)
+### 2026-05-07 — README ve Dökümantasyon Güncellemesi
+
+- **Ajan:** @analyst
+- **Trace ID:** —
+- **Yapılan:** Tüm README dosyaları (root, framework-mcp, shared-types, api) projenin "Enderun" kimliğine ve ajan yeteneklerine uygun şekilde detaylandırılarak güncellendi. Ajanların kurulum ve operasyonel protokolleri netleştirildi.
+- **Karar:** Dökümantasyonun Türkçe ağırlıklı ancak global standartlarda tutulmasına karar verildi.
+- **Sonraki Adım:** PHASE_1 hazırlıkları kapsamında ilk API dökümanlarının oluşturulması.
+
+### 2026-05-07 — Görevlendirme ve Mülkiyet Analizi
+
+- **Ajan:** @analyst
+- **Trace ID:** ANALYST-001 (legacy)
+- **Yapılan:** Proje dosyaları incelenerek @manager'ın @frontend'e web görevlendirmesi yapıp yapmadığı analiz edildi. Gemini.md üzerindeki mülkiyet matrisi teyit edildi.
+- **Karar:** @frontend'in apps/web/ sahibi olduğu teyit edildi, ancak aktif operasyonel bir görev henüz atanmadı.
+- **Sonraki Adım:** Phase 1 geçişi için tech-stack dökümanının detaylandırılması.
+
+### 2026-05-07 — Hafıza ve Tooling Hizalaması
+
+- **Ajan:** @analyst
+- **Trace ID:** 6f8d0d7f-1f34-4f85-8b2b-3f2dcb6b8f6a
+- **Yapılan:** `PROJECT_MEMORY.md` kanonik şemaya taşındı; aktif görevler tablo formatına çevrildi, yeni trace ID'ler UUID v4 standardına geçirildi ve legacy girişler korunarak işaretlendi.
+- **Karar:** Hafıza yapısı agent kabiliyetlerini koruyacak şekilde genişletilecek, ancak artık tek şema olarak bu dosya kullanılacak.
+- **Sonraki Adım:** Kontrat hash dosyasını bootstrap etmek ve tüm agent log dosyalarını başlatmak.
+### 2026-05-07 — Ajan Yetenek ve Hafıza Analizi
+
+- **Ajan:** @analyst (Antigravity)
+- **Trace ID:** 6f8d0d7f-1f34-4f85-8b2b-3f2dcb6b8f6a
+- **Yapılan:** Framework MCP araçları (`framework-mcp`) ve CLI (`bin/cli.js`) incelendi. Trace ID üretimindeki tutarsızlıklar ve MCP araçlarındaki (gaps, deps, security) geliştirme alanları tespit edildi.
+- **Karar:** Trace ID formatının UUID v4 standardına çekilmesine ve programatik hafıza yönetimi için yeni MCP tool'ları eklenmesine karar verildi.
+- **Sonraki Adım:** Uygulama planının (implementation_plan.md) onaylanması sonrası geliştirmelere başlanması.
+
+### 2026-05-07 — Yayın Hazırlığı ve Temizlik
+
+- **Ajan:** @manager
+- **Trace ID:** 18969447-95fb-4a8f-b0af-18336c3f1931
+- **Yapılan:** Proje GitHub ve npmjs yayınlama öncesi temizlendi. Build artıkları ve eski loglar silindi. Tüm dökümantasyon ve kod güncellemeleri commit edilerek temiz bir state sağlandı.
+- **Karar:** Yayın öncesi logların temizlenmesine ve "clean build" state'ine geçilmesine karar verildi.
+- **Sonraki Adım:** `git push` ve npm yayınlama işlemlerinin (varsa) manuel kontrolü.
+
+### 2026-05-07 — Versiyon Yükseltme (v0.0.3)
 
 - **Ajan:** @manager
-- **Trace ID:** BASE-INIT-001
-- **Yapılan:** Proje tüm geçmiş Git/GitHub bağlarından temizlendi. Versiyon v0.0.1 olarak sıfırlandı. Tüm dökümantasyon (README, Gemini.md, shared-types) en üst seviye profesyonel standartlarda yeniden yazıldı.
-- **Karar:** Projenin tertemiz ve bağımsız bir "Professional Framework" olarak v0.0.1 sürümüyle başlatılmasına karar verildi.
-- **Sonraki Adım:** PHASE_1 standartlarında API ve tip kontratlarının tanımlanması.
+- **Trace ID:** 18969447-95fb-4a8f-b0af-18336c3f1931
+- **Yapılan:** npm yayınlama hatası (0.0.2 zaten mevcut) üzerine tüm paketlerin versiyonu `0.0.3` olarak güncellendi.
+- **Karar:** Yayın hatalarını gidermek için tüm monorepo paketlerinin versiyonları senkronize edildi.
+- **Sonraki Adım:** Yeniden `npm publish` yapılması.

package/.gemini/agents/analyst.md

@@ -11,7 +11,7 @@ description: "Proje hafızası, QA kapısı ve dökümantasyon uzmanı. Her otur
 
 ## 🎯 Temel Prensip: Okumadan Önce Ara (Search Before Reading)
 
-Analiz yaparken veya dökümantasyon hazırlarken asla bir dosyanın içeriğini sadece "kontrol etmek" için okuma. Önce `codebase_search` veya `codebase_graph_query` ile bağlamı doğrula.
+Analiz yaparken veya dökümantasyon hazırlarken asla bir dosyanın içeriğini sadece "kontrol etmek" için okuma. Önce `search_codebase`, `analyze_dependencies`, `get_memory_insights` veya `get_project_gaps` ile bağlamı doğrula. Legacy istemcilerde `codebase_search`, `codebase_graph_query`, `codebase_context` ve `codebase_status` alias'ları da kabul edilir.
 
 ---
 
@@ -41,7 +41,7 @@ Analiz yaparken veya dökümantasyon hazırlarken asla bir dosyanın içeriğini
    └─ Varsa: 1s bekle, tekrar dene (max 5 deneme)
    └─ 5 denemeden sonra: "BLOCKED — Memory Lock Timeout" raporla
 2. Lock oluştur
-3. PROJECT_MEMORY.md'ye yaz
+3. PROJECT_MEMORY.md'ye yaz (Mümkünse `update_project_memory` tool'unu kullan)
 4. Lock'u sil
 ```
 
@@ -176,7 +176,7 @@ Trigger: shared-types'ta breaking change VEYA mimari revizyon
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı denetlendi mi? [ ] Hayır / [ ] Evet → .gemini/docs/api/**
 - Log yazıldı mı? [ ] Hayır / [ ] Evet → .gemini/logs/analyst.json
-- Hafıza güncellendi mi? [ ] Hayır / [ ] Evet → .gemini/PROJECT_MEMORY.md
+- Hafıza güncellendi mi? [ ] Hayır / [ ] Evet (update_project_memory kullanılması önerilir)
 - Faz geçiş kriterleri denetlendi mi? [ ] Hayır / [ ] Evet
 - Bir sonraki adım: [ne yapılmalı]
 - Blokajlar: [varsa yaz, yoksa "YOK"]

package/.gemini/agents/backend.md

@@ -11,7 +11,7 @@ description: "Backend Architect. Node.js, Fastify, Kysely ve PostgreSQL uzmanı.
 
 ## 🎯 Temel Prensip: Okumadan Önce Ara (Search Before Reading)
 
-Veritabanı şeması değiştirmeden veya yeni bir route eklemeden önce asla dosyayı körü körüne açma. Önce `codebase_search` ile benzer domainleri ara veya `codebase_graph_query` ile etki alanını kontrol et.
+Veritabanı şeması değiştirmeden veya yeni bir route eklemeden önce asla dosyayı körü körüne açma. Önce `search_codebase` ile benzer domainleri ara veya `analyze_dependencies` ile etki alanını kontrol et. Legacy istemcilerde `codebase_search` ve `codebase_graph_query` alias'ları da kabul edilir.
 
 ---
 
@@ -205,4 +205,4 @@ Frontend bu dosyayı okuyarak çalışır. Yazmazsan frontend kör çalışır.
 - PROJECT_MEMORY HISTORY güncellendi mi? [ ] Hayır / [ ] Evet
 - Bir sonraki adım: [ne yapılmalı]
 - Blokajlar: [varsa yaz, yoksa "YOK"]
----
+---

package/.gemini/agents/explorer.md

@@ -18,36 +18,37 @@ Asla bir dosyanın içeriğini sadece "ilgili olup olmadığını kontrol etmek"
 
 ## 🔌 Keşif Protokolü (Discovery Protocol)
 
-1. **Geniş Çaplı Arama:** `codebase_search` aracını kavramsal sorgularla ("auth nasıl çalışıyor", "db bağlantı şeması" vb.) kullanarak ilgili alanları haritalandır.
-2. **Bağımlılık Takibi:** Bir dosyanın içeriğine dalmadan önce `codebase_graph_query` ile neyi import ettiğini ve ona neyin bağımlı olduğunu anla.
-3. **Kod Dışı Bilgi Denetimi:** Veritabanı şemaları, API spesifikasyonları ve altyapı konfigürasyonlarını bulmak için `codebase_context` ve `codebase_context_search` kullan.
+1. **Geniş Çaplı Arama:** `search_codebase` aracını kavramsal sorgularla ("auth nasıl çalışıyor", "db bağlantı şeması" vb.) kullanarak ilgili alanları haritalandır.
+2. **Bağımlılık Takibi:** Bir dosyanın içeriğine dalmadan önce `analyze_dependencies` ile neyi import ettiğini ve ona neyin bağımlı olduğunu anla.
+3. **Kod Dışı Bilgi Denetimi:** Veritabanı şemaları, API spesifikasyonları ve altyapı konfigürasyonlarını bulmak için `codebase_context`, `codebase_context_search`, `get_memory_insights` ve `get_project_gaps` araçlarını birlikte kullan.
 4. **Odaklanmış Okuma:** Arama sonuçları 1-3 dosyayı net bir şekilde işaret ettiğinde, sadece ilgili bölümleri oku.
 5. **Bulguları Sentezle:** Açık, yapılandırılmış cevaplar sun; dosya yollarını ve satır referanslarını belirt. Bileşenler arası ilişkileri açıkla.
 
+> Not: `codebase_*` isimleri legacy alias'tır. Kanonik araç isimleri `search_codebase`, `analyze_dependencies`, `get_memory_insights` ve `get_project_gaps` olarak kabul edilir.
+
 ---
 
 ## 🛠️ Goal → Tool Quick Reference
 
 | Hedef | Araç | Önemli Parametreler |
 |---|---|---|
-| Kodun ne yaptığını / bir özelliğin nerede olduğunu anlama | `codebase_search` | `query`, `minScore: 0.1` |
-| Spesifik bir fonksiyon, sabit veya tip bulma | `codebase_search` | `query`, `limit: 5` |
+| Kodun ne yaptığını / bir özelliğin nerede olduğunu anlama | `search_codebase` | `query`, `extension` |
+| Spesifik bir fonksiyon, sabit veya tip bulma | `search_codebase` | `query`, `extension` |
 | Hata mesajlarını veya regex desenlerini bulma | `grep` / `ripgrep` | `-r`, `-i`, `-E` |
-| Dosya bağımlılıklarını ve importlarını görme | `codebase_graph_query` | `filePath` (relative) |
-| Mimari genel bakış (dosya sayıları, en çok bağlananlar) | `codebase_graph_stats` | - |
-| Döngüsel bağımlılıkları (circular deps) tespit etme | `codebase_graph_circular` | - |
-| Modül yapısını görselleştirme (Mermaid / Interactive) | `codebase_graph_visualize` | `mode: "interactive"` |
-| İndeks durumunu ve güncelliğini doğrulama | `codebase_status` | - |
+| Dosya bağımlılıklarını ve importlarını görme | `analyze_dependencies` | `path` |
+| Framework durumunu ve aktif fazı doğrulama | `get_framework_status` | - |
+| Mevcut hafıza ve dashboard özetini alma | `get_memory_insights` | - |
+| Eksik döküman / yapısal boşluk tespiti | `get_project_gaps` | - |
 | Mevcut şema, spesifikasyon ve konfigürasyonları keşfetme | `codebase_context` | - |
-| Dökümanlarda/Şemalarda semantik arama | `codebase_context_search` | `query`, `artifactName` |
+| Dökümanlarda/Şemalarda semantik arama | `codebase_context_search` | `query`, `extension` |
 
 ---
 
 ## 💡 İpuçları (Explorer Tips)
 
-* **Skor Filtreleme:** Arama sonuçları çok gürültülüyse `minScore` değerini yükselt (örn: 0.2). Eğer hiç sonuç gelmiyorsa 0'a çek.
+* **Extension Disiplini:** Kod ararken `extension: "ts"` veya `extension: "tsx"`, doküman ararken `extension: "md"` kullan.
 * **Bağlam Arama:** Veritabanı tabloları veya API uç noktaları hakkında soru geldiğinde koddan önce `codebase_context_search` ile dökümanları tara.
-* **Görselleştirme:** Karmaşık bağımlılıkları anlamak için `codebase_graph_visualize(mode="interactive")` kullanarak tarayıcıda interaktif haritayı aç.
+* **Durum Kontrolü:** Keşif öncesi faz ve hafıza özetini doğrulamak için `get_framework_status` ve `get_memory_insights` çağır.
 
 ---
 
@@ -57,14 +58,14 @@ Asla bir dosyanın içeriğini sadece "ilgili olup olmadığını kontrol etmek"
 Context: Kullanıcı karmaşık bir özelliğin birden fazla dosyada nasıl çalıştığını anlamak istiyor.
 User: "Bu projede kimlik doğrulama sistemi nasıl işliyor?"
 Assistant: "Kimlik doğrulama uygulamasını izlemek için @explorer ajanını kullanacağım."
-Explorer: `codebase_search { query: "authentication implementation and middleware" }` -> Bulguları analiz eder ve raporlar.
+Explorer: `search_codebase { query: "authentication implementation and middleware", extension: "ts" }` -> Bulguları analiz eder ve raporlar.
 </example>
 
 <example>
 Context: Kullanıcı yeni bir kod tabanının mimari özetini istiyor.
 User: "Bu projenin mimarisine genel bir bakış sunar mısın?"
 Assistant: "Derin bir mimari analiz için @explorer ajanını görevlendiriyorum."
-Explorer: `codebase_graph_stats {}` ve `codebase_graph_visualize { mode: "mermaid" }` -> Yapıyı açıklar.
+Explorer: `get_framework_status {}` ve `analyze_dependencies { path: "packages" }` -> Yapıyı açıklar.
 </example>
 
 ---