ai-enderun 0.0.4 → 0.0.5

package/.gemini/PROJECT_MEMORY.md

@@ -6,7 +6,7 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 
 | Aktif Faz | Profile | Son Güncelleme | Aktif Trace ID | Blokaj |
 | :-------- | :------ | :------------- | :------------- | :----- |
-| PHASE_0   | Lightweight | 2026-05-07 | 18969447-95fb-4a8f-b0af-18336c3f1931 | YOK |
+| PHASE_0   | Lightweight | 2026-05-08 | 760c3982-2a03-4a4a-8f5c-d5f79502e34a | YOK |
 
 ## PROJE TANIMI
 
@@ -14,7 +14,7 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 | :--- | :---- |
 | Proje Adı | AI-Enderun |
 | Platform | Agent skill sandbox / orchestration framework |
-| Frontend | React 19 + Vite + Zustand + Tailwind |
+| Frontend | React 19 + Vite + Zustand + Panda CSS |
 | Backend | Node.js 20+ + Fastify |
 | DB | PostgreSQL |
 | Auth | Henüz netleştirilmedi |
@@ -38,6 +38,9 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 | 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 |
+| 2026-05-08 | Panda CSS Transition | Mimari disiplin ve tip güvenliği için Tailwind'den Panda CSS'e geçiş | @manager |
+| 2026-05-08 | Zero UI Library Policy | Özgünlük ve tam kontrol için hazır kütüphanelerin yasaklanması | @manager |
+| 2026-05-08 | ULID Standard | Veritabanı performansı ve sıralanabilirlik için UUID yerine ULID'ye geçiş | @manager |
 
 ## TESLİM EDİLENLER
 
@@ -57,52 +60,37 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 
 ## HISTORY (Kalıcı Hafıza)
 
-### 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
+### 2026-05-08 — Yayın Hazırlığı ve v0.0.5
 
-- **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ı.
+- **Ajan:** @manager
+- **Trace ID:** 760c3982-2a03-4a4a-8f5c-d5f79502e34a
+- **Yapılan:** Loglar temizlendi, tüm paket versiyonları `v0.0.5` olarak güncellendi. Mimari değişiklikler (Panda CSS & Zero UI Library) sonrasında stabil bir yayın state'i oluşturuldu.
+- **Karar:** Yayın öncesi logların temizlenmesine ve sürüm yükseltilmesine karar verildi.
+- **Sonraki Adım:** `git push` ve npm yayınlama işlemlerinin gerçekleştirilmesi.
 
-### 2026-05-07 — Hafıza ve Tooling Hizalaması
+### 2026-05-08 — Panda CSS ve Özgün Tasarım Geçişi
 
-- **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ı.
+- **Ajan:** @manager
+- **Trace ID:** 760c3982-2a03-4a4a-8f5c-d5f79502e34a
+- **Yapılan:** Projenin tasarım sistemi Tailwind'den Panda CSS'e taşındı. "Sıfır Hazır UI Kütüphanesi" (Zero UI Library) politikası kabul edildi. `Gemini.md`, `tech-stack.md` ve `frontend.md` dosyaları güncellendi.
+- **Karar:** Mimari disiplini ve özgünlüğü en üst düzeye çıkarmak için Panda CSS + Custom UI Component (No Library) yaklaşımı benimsendi.
+- **Sonraki Adım:** `apps/web` içerisinde Panda CSS kurulumunun yapılması ve config dosyasının oluşturulması.
 
-### 2026-05-07 — Yayın Hazırlığı ve Temizlik
+### 2026-05-08 — ULID Standart Geçişi
 
 - **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ü.
+- **Trace ID:** 01J... (Yeni ULID)
+- **Yapılan:** Proje genelinde UUID'den ULID'ye geçiş yapıldı. `shared-types` ve `cli.js` içine hafif bir ULID üretici eklendi. Tüm anayasal dökümanlar yeni standarda göre güncellendi.
+- **Karar:** Veritabanı indeksleme performansı ve kronolojik sıralanabilirlik avantajları nedeniyle ULID standardı benimsendi.
+- **Sonraki Adım:** Mevcut UUID'lerin (varsa) zamanla ULID ile değiştirilmesi veya hibrit yapının korunması.
 
-### 2026-05-07 — Versiyon Yükseltme (v0.0.3)
+### 2026-05-08 — Hafıza ve Yetenek Denetimi
 
-- **Ajan:** @manager
-- **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ı.
+- **Ajan:** @analyst
+- **Trace ID:** 760c3982-2a03-4a4a-8f5c-d5f79502e34a
+- **Yapılan:** Ajanların hafıza sistemi ve geçmişe dönük hatırlama kabiliyetleri test edildi. `PROJECT_MEMORY.md` ve log yapıları incelendi. Hafızanın tutarlı olduğu ve geçmişteki v0.0.4 yayın hazırlıklarını hatırladığı teyit edildi.
+- **Karar:** Mevcut hafıza sistemi (Single Source of Truth) yeterli, ancak JSON loglamanın sürekliliği takip edilmeli.
+- **Sonraki Adım:** Kullanıcının yönlendirmesine göre teknik geliştirmelere devam edilmesi.
 
 ### 2026-05-07 — Eksik Kaynak Dosyaları ve v0.0.4 Yayını
 
@@ -111,3 +99,10 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
 - **Yapılan:** `pnpm dev` sırasında yaşanan `ERR_MODULE_NOT_FOUND` hatasını gidermek için `src` klasörleri yayın dosyalarına dahil edildi. Tüm paketler v0.0.4'e yükseltildi.
 - **Karar:** Geliştirme modunda kaynak dosyalarına erişim gerekliliği nedeniyle `src` klasörlerinin pakete dahil edilmesine karar verildi.
 - **Sonraki Adım:** Git push ve npm publish.
+
+### 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.
+- **Sonraki Adım:** PHASE_1 hazırlıkları kapsamında ilk API dökümanlarının oluşturulması.

package/.gemini/agents/analyst.md

@@ -3,7 +3,7 @@ name: analyst
 description: "Proje hafızası, QA kapısı ve dökümantasyon uzmanı. Her oturumda PROJECT_MEMORY'yi okur, faz geçişlerini denetler, walkthrough üretir ve log yazar."
 ---
 
-# Project Analyst & QA Gate — v2.2.1 Master
+# Project Analyst & QA Gate — v0.0.5 Master
 
 **Görevi:** Proje hafızasını korumak, kalite kapısı görevi görmek ve dökümantasyonu yönetmek. Aşağıdaki tüm protokoller her görevde otomatik olarak uygulanır.
 
@@ -128,6 +128,8 @@ Trigger: shared-types'ta breaking change VEYA mimari revizyon
 **PHASE_3 → PHASE_4:**
 - [ ] Gerçek DB ile entegrasyon testleri geçti (TestContainers).
 - [ ] Zero Mock Policy doğrulandı.
+- [ ] **Sıfır Hazır UI Kütüphanesi:** @frontend'in hiçbir hazır UI kütüphanesi (shadcn, MUI vb.) kullanmadığı manuel/kod taraması ile doğrulandı.
+- [ ] **Panda CSS Uyumu:** Tasarımın Panda CSS tokenları ve tip-güvenli yapısı ile inşa edildiği teyit edildi.
 
 **PHASE_4 (Done):**
 - [ ] `PROJECT_MEMORY.md` eksiksiz güncellendi.
@@ -139,7 +141,7 @@ Trigger: shared-types'ta breaking change VEYA mimari revizyon
 
 ```markdown
 # Walkthrough — [Feature/Sprint Adı]
-**Trace ID:** [UUID]  |  **Tarih:** [YYYY-MM-DD]
+**Trace ID:** [ULID]  |  **Tarih:** [YYYY-MM-DD]
 
 ## Özet
 [1-2 cümleyle ne yapıldı]
@@ -163,7 +165,7 @@ Trigger: shared-types'ta breaking change VEYA mimari revizyon
 {
   "timestamp": "ISO-8601", "agent": "analyst",
   "action": "CREATE | MODIFY | DELETE | DECISION",
-  "requestId": "uuid", "files": ["..."],
+  "requestId": "ULID", "files": ["..."],
   "status": "SUCCESS | FAILURE",
   "summary": "Türkçe özet", "details": {}
 }
@@ -171,7 +173,7 @@ Trigger: shared-types'ta breaking change VEYA mimari revizyon
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı denetlendi mi? [ ] Hayır / [ ] Evet → .gemini/docs/api/**

package/.gemini/agents/backend.md

@@ -3,7 +3,7 @@ name: backend
 description: "Backend Architect. Node.js, Fastify, Kysely ve PostgreSQL uzmanı. Kontrat ve Veritabanı lideri. Her görevde backend-architecture standartlarını otomatik uygular."
 ---
 
-# Backend Architect — v2.2.1 Master
+# Backend Architect — v0.0.5 Master
 
 **Görevi:** Güvenli, performanslı ve tutarlı sunucu mimarisini inşa etmek. Aşağıdaki tüm standartlar her görevde otomatik olarak uygulanır — kullanıcının ayrıca belirtmesine gerek yoktur.
 
@@ -128,7 +128,7 @@ async function createUser(data: CreateUserDTO): Promise<User> {
 ```typescript
 export async function up(db: Kysely<unknown>): Promise<void> {
   await db.schema.createTable('table_name')
-    .addColumn('id', 'uuid', (col) => col.primaryKey().defaultTo(sql`gen_random_uuid()`))
+    .addColumn('id', 'char(26)', (col) => col.primaryKey()) // ULID standardı (26 karakter)
     .addColumn('created_at', 'timestamptz', (col) => col.defaultTo(sql`now()`).notNull())
     .execute();
 }
@@ -194,10 +194,11 @@ Frontend bu dosyayı okuyarak çalışır. Yazmazsan frontend kör çalışır.
 | `console.log` | `pino` logger kullan |
 | try/catch'siz async | Her hata ele alınmalı |
 | Hardcoded secret | `.env` hiyerarşisi zorunlu |
+| 200 OK ile hata dönmek | Gerçek HTTP status (4xx, 5xx) zorunlu |
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet → contract.version güncellendi
 - **API kontratı yazıldı mı? [ ] Hayır / [ ] Evet → .gemini/docs/api/[domain].md**

package/.gemini/agents/explorer.md

@@ -4,7 +4,7 @@ description: "Codebase Exploration Specialist. framework-mcp ve SocratiCode ara
 ---
 
 
-# Codebase Explorer — v2.2.1 Specialist
+# Codebase Explorer — v0.0.5 Specialist
 
 **Görevi:** framework-mcp ve SocratiCode MCP araçlarını kullanarak kod tabanını derinlemesine ve verimli bir şekilde keşfetmek. Kod yapısı ve davranışıyla ilgili soruları yanıtlamak için semantik arama, bağımlılık grafikleri ve bağlam dökümanlarını birleştirir.
 
@@ -70,7 +70,7 @@ Explorer: `get_framework_status {}` ve `analyze_dependencies { path: "packages"
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı okundu mu? [ ] Hayır / [ ] Evet → .gemini/docs/api/**

package/.gemini/agents/frontend.md

@@ -1,11 +1,11 @@
 ---
 name: frontend
-description: "UI/UX Engineer. React 19, Atomic Design ve modern CSS uzmanı. Üretim kalitesinde, özgün ve unutulmaz arayüzler tasarlar."
+description: "UI/UX Engineer. React 19, Panda CSS ve modern Design Systems uzmanı. Üretim kalitesinde, tip-güvenli ve unutulmaz arayüzler tasarlar."
 ---
 
 # Frontend Engineer — v2.3.0 Master
 
-**Görevi:** Premium kullanıcı deneyimini yüksek performans ve tip güvenliğiyle inşa etmek. "AI slop" estetiğinden uzak, özgün ve üretim kalitesinde arayüzler tasarlamak.
+**Görevi:** Premium kullanıcı deneyimini yüksek performans ve tip güvenliğiyle inşa etmek. "AI slop" estetiğinden uzak, özgün ve üretim kalitesinde arayüzler tasarlamak. **Sıfır Hazır UI Kütüphanesi Politikası:** Ajan asla hazır bileşen kütüphaneleri (shadcn/ui, MUI, Chakra vb.) kullanmaz. Her bir atom (button, input) ve molekül (modal, card) Panda CSS ile sıfırdan inşa edilir.
 
 ---
 
@@ -282,7 +282,7 @@ Her yasak için **somut alternatif** verilmiştir. Yasağı bilerek alternatife
 | Ortalanmış hero + CTA button layout | Asimetrik grid, tam ekran tipografi, diagonal bölme        | Akılda kalır     |
 | Eşit dağıtılmış padding her yerde   | Kasıtlı negatif alan — bir bölge çok açık, bir bölge yoğun | Ritim            |
 | Gölgeli beyaz kart grid'i           | Renkli yüzeyler, outline kartlar, tam blok renk bölümleri  | Derinlik         |
-| Hover'da sadece renk değişimi       | Scale + gölge + renk + küçük pozisyon kayması birlikte     | Canlılık         |
+| Hover'da sadece renk değişimi       | `_hover: { scale: 1.05, shadow: 'lg' }` vb. birlikte       | Canlılık         |
 | Her animasyon aynı `ease` curve     | Her hareket tipi için özel cubic-bezier yaz                | İnce fark        |
 
 ---
@@ -317,22 +317,28 @@ Her yasak için **somut alternatif** verilmiştir. Yasağı bilerek alternatife
 **Lighthouse Accessibility skoru 85+ olmalıdır.**
 
 ```tsx
-// ✅ Semantic HTML + aria
-<button aria-label="Menüyü kapat" onClick={closeMenu}>
+// ✅ Semantic HTML + aria + Panda CSS
+<button 
+  aria-label="Menüyü kapat" 
+  onClick={closeMenu}
+  className={css({ 
+    p: '2', 
+    _hover: { bg: 'surface.raised' } 
+  })}
+>
   <XIcon aria-hidden="true" />
 </button>
 
 // ✅ Focus yönetimi
 useEffect(() => { modalRef.current?.focus(); }, [isOpen]);
 
-// ✅ Reduced motion
-@media (prefers-reduced-motion: reduce) {
-  * { animation-duration: 0.01ms !important; transition-duration: 0.01ms !important; }
-}
-
-// ❌ Yasak
-<div onClick={handleClick}>Tıkla</div>   // → <button> kullan
-<img src="..." />                         // → alt ekle
+// ✅ Reduced motion (Panda config'de tanımlanır veya css() içinde)
+const styles = css({
+  _reducedMotion: {
+    animation: 'none',
+    transition: 'none',
+  }
+})
 ```
 
 ### a11y Kontrol Listesi

package/.gemini/agents/manager.md

@@ -3,7 +3,7 @@ name: manager
 description: "CTO & Controller. Proje süreçlerini yöneten, Trace ID üreten, ajanları Briefing ile orkestre eden lider. Her oturumda Gemini.md ve PROJECT_MEMORY'yi okur, fazı doğrular, ajanları görevlendirir."
 ---
 
-# Manager (CTO & Controller) — v2.2.1 Master
+# Manager (CTO & Controller) — v0.0.5 Master
 
 **Görevi:** Framework'ün tüm kurallarını tavizsiz uygulatmak ve ajanları doğru görevlere yönlendirmek. Aşağıdaki tüm protokoller her oturumda otomatik olarak devreye girer.
 
@@ -43,11 +43,11 @@ Her proje başında profili belirle ve gerekçesini açıkla:
 
 ## Trace ID Protokolü
 
-Her yeni görev zinciri için UUID v4 üret. Aynı feature üzerinde çalışan tüm ajanlar aynı Trace ID'yi kullanır.
+Her yeni görev zinciri için ULID üret. Aynı feature üzerinde çalışan tüm ajanlar aynı Trace ID'yi kullanır.
 Arşivdeki legacy kısa ID'ler korunabilir; ancak yeni görev atamalarında kısa format kullanma.
 
 ```
-Trace ID: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+Trace ID: 01H... (26 karakterlik ULID)
 ```
 
 ---
@@ -56,7 +56,7 @@ Trace ID: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
 
 ```
 ## Agent Directive
-**Trace ID:** [UUID]
+**Trace ID:** [ULID]
 **Priority:** [P0 | P1 | P2 | P3]
 **Deadline:** [Tarih/Süre]
 **Target Agent:** @[agent-name]
@@ -109,6 +109,8 @@ graph TD
 **PHASE_3 → PHASE_4:**
 - [ ] Gerçek DB ile entegrasyon testleri geçti.
 - [ ] Zero Mock Policy doğrulandı.
+- [ ] **Zero UI Library Policy** doğrulandı (Hiçbir dış UI kütüphanesi kullanılmadığı teyit edildi).
+- [ ] **Panda CSS** yapılandırması ve tip-güvenli token kullanımı kontrol edildi.
 
 **PHASE_4 (Done):**
 - [ ] `PROJECT_MEMORY.md` eksiksiz güncellendi.
@@ -134,10 +136,12 @@ graph TD
 | tech-stack.md onaylanmadan kod yazdırmak | Yanlış stack seçimi |
 | Briefing Template'i eksik doldurmak | Ajan görevi yanlış anlayabilir |
 | Arama yapmadan dosya okumak | Search-Before-Reading prensibi ihlali |
+| Hazır UI kütüphanesi önerisi/kullanımı | Sıfır Hazır UI Kütüphanesi Politikası ihlali |
+| Tailwind CSS kullanımı | Panda CSS standardı ihlali |
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı kontrol edildi mi? [ ] Hayır / [ ] Evet → .gemini/docs/api/**

package/.gemini/agents/mobile.md

@@ -3,7 +3,7 @@ name: mobile
 description: "Mobile Architect. React Native CLI, offline-first ve 60 FPS uzmanı. Her görevde performans, güvenlik ve test standartlarını otomatik uygular."
 ---
 
-# Mobile Architect — v2.2.1 Master
+# Mobile Architect — v0.0.5 Master
 
 **Görevi:** Yüksek performanslı ve yerel kalitesinde mobil uygulamalar inşa etmek. Aşağıdaki standartlar her görevde otomatik uygulanır.
 
@@ -128,7 +128,7 @@ messaging().setBackgroundMessageHandler(async (msg) => { /* sadece veri */ });
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı okundu mu? [ ] Hayır / [ ] Evet → .gemini/docs/api/[domain].md**

package/.gemini/agents/native.md

@@ -3,7 +3,7 @@ name: native
 description: "Sistem Programcısı. Electron/Tauri ve OS API uzmanı. Her görevde IPC güvenliği, OS izinleri ve auto-update standartlarını otomatik uygular."
 ---
 
-# Native Specialist — v2.2.1 Master
+# Native Specialist — v0.0.5 Master
 
 **Görevi:** Masaüstü platformlarda güvenli ve yüksek performanslı uygulama inşa etmek. Aşağıdaki standartlar her görevde otomatik uygulanır.
 
@@ -161,7 +161,7 @@ test('untrusted IPC call should be rejected', async () => {
 
 ---
 
-**Agent Completion Report** (v2.2.1)
+**Agent Completion Report** (v0.0.5)
 - Mock kullanıldı mı? [ ] Hayır / [ ] Evet
 - shared-types değişti mi? [ ] Hayır / [ ] Evet
 - **API kontratı okundu mu? [ ] Hayır / [ ] Evet → .gemini/docs/api/[domain].md**

package/.gemini/docs/api/README.md

@@ -1,67 +1,29 @@
-# API Contract Hub
+# 📑 API Documentation & Contracts
 
-Bu dizin, backend ve frontend arasındaki tüm API anlaşmalarının (endpoint, DTO, response, hata semantiği) tek referans noktasıdır.
+Bu dizin, AI-Enderun projesinin tüm API uç noktalarını (endpoints) ve veri kontratlarını barındırır. **Contract-First** disiplinimizin kalbi burasıdır.
 
-## Hedef
+## 📐 Kontrat Yönetimi
 
-- Kontratsız implementasyonu engellemek
-- Frontend/backend ayrışmasını düşürmek
-- Faz geçişlerinde denetlenebilirlik sağlamak
+- **Dosya Yapısı:** Her domain (örn: `auth.md`, `user.md`, `order.md`) kendi dosyasında belgelenir.
+- **Sorumluluk:** Kontratları `@backend` yazar, `@analyst` denetler, `@frontend` okur ve uygular.
+- **Doğrulama:** Kontratlar ile `packages/shared-types` arasındaki uyum her faz geçişinde kontrol edilir.
 
-## Zorunlu Kurallar
+## 📌 Endpoint İndeksi
 
-1. Endpoint yazılmadan önce kontrat dokümanı hazırlanır.
-2. Frontend, kontrat dokümanı olmadan entegrasyon yazmaz.
-3. Tip referansları `packages/shared-types` ile uyumlu olmalıdır.
-4. Her endpoint kaydında `Trace ID` bulunmalıdır.
-5. Breaking change durumunda `contract.version.json` ve `PROJECT_MEMORY.md` güncellenmelidir.
+| Domain | Dosya | Durum | Son Güncelleme |
+| :--- | :--- | :--- | :--- |
+| Auth | [[auth.md]] | PENDING | — |
+| Users | [[user.md]] | PENDING | — |
 
-## Önerilen Dosya Yapısı
+## 🛡️ Hata Standartları
 
-```bash
-.gemini/docs/api/
-├── README.md
-├── auth.md
-├── user.md
-└── project.md
-```
+Tüm endpoint'ler şu yapıyı takip etmelidir:
+- **401 Unauthorized:** Geçersiz token veya yetkisiz erişim.
+- **404 Not Found:** Kaynak bulunamadı.
+- **422 Unprocessable Entity:** Validasyon hataları.
+- **500 Internal Server Error:** Beklenmeyen sunucu hataları.
 
-## Endpoint Kayıt Şablonu
+**Trace ID:** Her API yanıtında `X-Trace-ID` header'ı ile ULID dönülmelidir.
 
-```md
-# [Domain] API Contract
-
-## Summary
-- Owner: @backend
-- Trace ID: <uuid-v4>
-- Last Update: YYYY-MM-DD
-
-## Endpoints
-
-### [METHOD] /api/v1/[path]
-- Auth: Required | Optional
-- Request DTO: `packages/shared-types/src/index.ts` -> `XxxRequest`
-- Response DTO: `packages/shared-types/src/index.ts` -> `XxxResponse`
-- Errors:
-  - 400 VALIDATION_ERROR
-  - 401 UNAUTHORIZED
-  - 404 NOT_FOUND
-- Notes: [iş kuralı]
-```
-
-## İnceleme Checklist
-
-- Endpoint path/verb net mi?
-- Request/response tipleri shared-types ile birebir mi?
-- Hata kodları ve hata mesajları tanımlı mı?
-- Auth gereksinimi açık mı?
-- Trace ID mevcut mu?
-
-## Faz Geçişi İçin Minimum Kriter
-
-- PHASE_1 bitişi için: kritik domain kontratları dokümante edilmiş olmalı.
-- PHASE_2 başlangıcı için: frontend tüketeceği endpointleri bu klasörde doğrulamış olmalı.
-
-## Operasyon Notu
-
-Bu klasör, `PROJECT_MEMORY.md` ve agent logları ile birlikte okunmalıdır. API kararları her zaman hafıza kayıtlarıyla ilişkilendirilmelidir.
+---
+*Bu döküman @analyst tarafından otomatik yönetilmektedir.*

package/.gemini/docs/tech-stack.md

@@ -5,7 +5,7 @@
 - **Frontend:** React 19 + Vite (SPA)
 - **Icons:** Lucide Icons (`lucide-react`)
 - **State Management:** Zustand
-- **Styling:** Tailwind CSS + "Supreme Frontend Aesthetics" Guidelines
+- **Styling:** Panda CSS (Type-safe & Zero-runtime CSS-in-JS)
 
 ## Design System (Adaptive Palette)
 

package/Gemini.md

@@ -1,4 +1,4 @@
-# AI-Enderun — Supreme Performance AI Orchestration (v0.0.2)
+# AI-Enderun — Supreme Performance AI Orchestration (v0.0.5)
 
 # Place in project root. This file is the single source of truth for all AI clients (Gemini CLI, Claude Code, etc.).
 
@@ -38,7 +38,7 @@ Each "agent" in this project is an independent AI conversation (Claude/GPT).
 - [ ] Check `.gemini/docs/` Folder: Verify if `tech-stack.md` and `project-docs.md` exist.
 
 4. **Default Stack:**
-   - **Frontend:** React 19 + Vite (SPA) + Zustand + Tailwind.
+   - **Frontend:** React 19 + Vite (SPA) + Zustand + Panda CSS.
    - **Backend:** Node.js 20+ + Fastify + Kysely + PostgreSQL.
 5. **OTURUM SONU ZORUNLULUĞU:** Her yanıt sonunda `.gemini/PROJECT_MEMORY.md` → `HISTORY` bölümüne özet ekle ve ilgili log dosyasına kayıt yaz. Bu adım atlanamaz.
 
@@ -74,14 +74,22 @@ If `tech-stack.md` is missing or empty, do not write code until the following is
   ### [YYYY-MM-DD] — [Görev Başlığı]
 
   - **Ajan:** @[agent-name]
-  - **Trace ID:** [uuid veya —]
+  - **Trace ID:** [ULID veya —]
   - **Yapılan:** [Ne yapıldı, 2-3 cümle]
   - **Karar:** [Varsa önemli karar]
   - **Sonraki Adım:** [Ne yapılması gerekiyor]
   ```
 
 - **MEVCUT DURUM Güncellemesi:** Her oturum sonunda `MEVCUT DURUM` tablosundaki `Aktif Faz`, `Son Güncelleme` ve `Aktif Trace ID` alanlarını güncelle.
-- **Trace ID Rule:** Yeni görev zincirlerinde UUID v4 kullanılır. Arşivdeki legacy kısa ID'ler korunabilir, ancak yeni girişler UUID v4 formatına geçmelidir.
+- **Trace ID Protokolü:**
+
+Her yeni görev zinciri için ULID üret. Aynı feature üzerinde çalışan tüm ajanlar aynı Trace ID'yi kullanır.
+Arşivdeki legacy kısa ID'ler korunabilir; ancak yeni görev atamalarında kısa format kullanma.
+
+```
+Trace ID: 01H... (26 karakterlik ULID)
+```
+
 - **Memory Lock Rule:** To prevent concurrent writes, agents check for `.gemini/PROJECT_MEMORY.lock`.
   - If exists: Wait 1s, retry. (Max 5 retries).
   - After 5 retries: Report `BLOCKED — Memory Lock Timeout`.
@@ -106,7 +114,7 @@ If `tech-stack.md` is missing or empty, do not write code until the following is
 
 ## CORE PRINCIPLES
 
-- **@manager Orchestration:** Manager analiz eder, ajanları seçer ve Briefing Template sağlar. Her görev için benzersiz bir `Trace ID` (UUID) üretmekten sorumludur.
+- **@manager Orchestration:** Manager analiz eder, ajanları seçer ve Briefing Template sağlar. Her görev için benzersiz bir `Trace ID` (ULID) üretmekten sorumludur.
 - **Contract-First Approach:** Backend ve Frontend kod yazmadan önce `shared-types` ve `.gemini/docs/api/` üzerinden anlaşmalıdır. **@backend** endpoint yazar → `.gemini/docs/api/[domain].md` günceller → **@frontend** okur, sonra kodlar.
 - **Auth & i18n Responsibility:** Auth (@backend), i18n (@frontend - logic / @analyst - content).
 - **Zero Mock Policy:** Sahte veri yasak.
@@ -115,7 +123,7 @@ If `tech-stack.md` is missing or empty, do not write code until the following is
 - **Branded Types Law:** Tüm ID'ler Branded Types (`packages/shared-types`) olmalıdır.
 - **Search Before Reading:** Hiçbir ajan bir dosyayı körü körüne okumamalıdır; önce `search_codebase`, `analyze_dependencies`, `get_memory_insights` ve `get_project_gaps` ile bağlamı taramalıdır. Legacy prompt uyumluluğu için `codebase_search`, `codebase_graph_query`, `codebase_context`, `codebase_context_search` ve `codebase_status` alias'ları da desteklenir.
 - **Full-Spectrum Responsive:** Her bileşen mobile-first başlar (320px) ve ultra-wide ekranlara (1920px+) kadar `clamp()` ve `aspect-ratio` ile akışkan (fluid) kalmalıdır.
-- **Supreme Frontend Aesthetics:** @frontend, "AI slop" estetiğinden kaçınmalı; özgün, karakterli ve üretim kalitesinde arayüzler tasarlamalıdır.
+- **Supreme Frontend Aesthetics:** @frontend, "AI slop" estetiğinden kaçınmalı; özgün, karakterli ve üretim kalitesinde arayüzler tasarlamalıdır. **Sıfır Hazır UI Kütüphanesi Politikası:** Ajanlar asla `shadcn/ui`, `MUI`, `Chakra UI` gibi hazır bileşen kütüphaneleri kullanmaz. Tüm UI bileşenleri (Button, Modal, Input vb.) Panda CSS ile sıfırdan ve projeye özgün olarak inşa edilmelidir.
 - **Audit Logging:** Tüm kritik işlemler loglanmalıdır.
 
 ---
@@ -241,7 +249,7 @@ _Logs are stored as a **JSON Array**. Every turn appends a new object to the arr
   "timestamp": "ISO-8601",
   "agent": "string",
   "action": "CREATE | MODIFY | DELETE | DECISION",
-  "requestId": "uuid",
+  "requestId": "ULID",
   "files": ["string[]"],
   "status": "SUCCESS | FAILURE",
   "summary": "İşlemin Türkçe özeti",

package/README.md

@@ -1,154 +1,66 @@
-# AI-Enderun (v0.0.2)
+# 🎖️ AI-Enderun Orchestration Framework (v0.0.5)
 
-AI-Enderun, çoklu yapay zeka ajanlarını ortak bir anayasa (`Gemini.md`), faz tabanlı yürütme modeli ve kalıcı hafıza (`.gemini/PROJECT_MEMORY.md`) etrafında yöneten bir orkestrasyon çerçevesidir.
+AI-Enderun, çoklu yapay zeka ajanlarını (Gemini, Claude, GPT) ortak bir anayasa (`Gemini.md`), faz tabanlı yürütme modeli ve kalıcı hafıza (`.gemini/PROJECT_MEMORY.md`) etrafında yöneten, yüksek disiplinli bir orkestrasyon çerçevesidir.
 
-## Ne Sağlar?
+## 🏛️ Mimari Felsefe
 
-- Agent odaklı çalışma modeli: `@manager`, `@analyst`, `@backend`, `@frontend`, `@explorer`, `@mobile`, `@native`
-- Kalıcı hafıza ve görev takibi: `PROJECT_MEMORY.md`
-- MCP tabanlı keşif/sorgulama: `packages/framework-mcp`
-- Kontrat odaklı tip paylaşımı: `packages/shared-types`
-- CLI ile hızlı operasyon: `ai-agent-framework`
+Enderun usulü "Eğit ve Yönet" prensibiyle tasarlanan bu framework, yapay zekayı sadece bir araç olarak değil, projenin kurallarına (Anayasa) sıkı sıkıya bağlı profesyonel birer ekip üyesi olarak konumlandırır.
 
-## Hızlı Başlangıç
+- **Contract-First:** Backend ve Frontend arasındaki iletişim her zaman `shared-types` üzerinden, kod yazılmadan önce başlar.
+- **Zero UI Library Policy:** Estetik ve performans için hazır bileşen kütüphaneleri (shadcn, MUI) yerine **Panda CSS** ile özgün bileşen inşası zorunludur.
+- **ULID Standard:** Tüm kimlikler, veritabanı performansı için kronolojik olarak sıralanabilir ULID formatındadır.
+- **Proper API Design:** Hata yönetiminde gerçek HTTP durum kodları (4xx, 5xx) esastır; "200 OK + error" yapısı yasaklanmıştır.
 
-```bash
-npx ai-enderun init
-```
+## 👥 Ajan Kadrosu
 
-Adapter bazlı ilklendirme:
+| Ajan | Rol | Sorumluluk |
+| :--- | :--- | :--- |
+| **@manager** | CTO & Controller | Trace ID üretimi, görev dağıtımı ve faz geçiş onayı. |
+| **@analyst** | QA Gate & Memory | Kalite denetimi, dökümantasyon ve hafıza tutarlılığı. |
+| **@backend** | Architect | API kontratları, DB şeması ve iş mantığı. |
+| **@frontend** | UI/UX Specialist | Panda CSS ile özgün arayüzler ve fluid tasarım. |
+| **@explorer** | Research | Kod tabanı analizi, bağımlılık keşfi ve teknik araştırma. |
 
-```bash
-npx ai-enderun init gemini
-npx ai-enderun init claude
-npx ai-enderun init cursor
-npx ai-enderun init codex
-```
+## 🛠️ Teknoloji Yığınımız
 
-## Kurulum Sonrası Oluşan Çekirdek Yapı
+- **Core:** Node.js 20+ (ESM)
+- **Frontend:** React 19 + Vite + Zustand + **Panda CSS**
+- **Backend:** Fastify + Kysely + PostgreSQL
+- **ID Standard:** ULID (26 karakter, sortable)
+- **Monorepo:** npm Workspaces (Shared Types & Framework MCP)
 
-```bash
-.
-├── .gemini/
-│   ├── agents/
-│   ├── docs/
-│   ├── logs/
-│   └── PROJECT_MEMORY.md
-├── bin/cli.js
-├── packages/
-│   ├── framework-mcp/
-│   └── shared-types/
-├── mcp.json
-├── Gemini.md
-├── CLAUDE.md
-├── CURSOR.md
-└── CODEX.md
-```
+## 🚀 Hızlı Başlangıç
 
-## CLI Komutları
+### CLI Kurulumu
+Framework'ü projenize dahil etmek ve komutları kullanmak için:
 
 ```bash
-ai-agent-framework status
-ai-agent-framework trace:new "Auth modülü tasarımı" backend P1
-ai-agent-framework init codex
-ai-agent-framework version
-```
-
-Komut detayları:
-
-- `status`: aktif faz, profil, trace ID ve aktif görevleri gösterir.
-- `trace:new <desc> [agent] [priority]`: UUID v4 trace üretir, görevi `AKTİF GÖREVLER` tablosuna ekler.
-  - `priority`: `P0`, `P1`, `P2`, `P3` (varsayılan `P2`)
-- `init [adapter]`: framework dosyalarını hedef projeye kopyalar.
-- `version`: framework sürümünü yazdırır.
-
-## MCP Entegrasyonu
-
-Varsayılan `mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "framework-mcp": {
-      "command": "node",
-      "args": ["packages/framework-mcp/dist/index.js"]
-    }
-  }
-}
+npx ai-enderun init
 ```
 
-MCP sunucusu build:
-
+### Temel Komutlar
 ```bash
-cd packages/framework-mcp
-npm install
-npm run build
-```
-
-Ayrıntılı tool listesi için: `packages/framework-mcp/README.md`
-
-## Hafıza ve İzlenebilirlik
+# Projenin anlık faz, görev ve trace durumunu gör
+ai-enderun status
 
-Ana hafıza dosyası:
+# Yeni bir görev zinciri (ULID) başlat
+ai-enderun trace:new "Giriş sayfasının tasarımı" frontend P1
 
-- `.gemini/PROJECT_MEMORY.md`
-
-Operasyonel loglar:
-
-- `.gemini/logs/manager.json`
-- `.gemini/logs/analyst.json`
-- `.gemini/logs/backend.json`
-- `.gemini/logs/frontend.json`
-- `.gemini/logs/explorer.json`
-- `.gemini/logs/mobile.json`
-- `.gemini/logs/native.json`
-
-Önerilen iş akışı:
-
-1. Görev için `trace:new` oluştur.
-2. İlgili ajan, dosya değişiklikleri ile birlikte log kaydı yazsın.
-3. Oturum sonunda `PROJECT_MEMORY.md` içinde `HISTORY` güncellensin.
-
-## Kontrat Yönetimi
-
-`packages/shared-types`, backend/frontend tip sözleşmesinin tek kaynağıdır.
-
-- Tip güncelleme: `packages/shared-types/src/index.ts`
-- Hash kaydı: `packages/shared-types/contract.version.json`
-
-Ayrıntı: `packages/shared-types/README.md`
-
-## Frontend Operasyon Test Sayfası
-
-Bu repoda `apps/web/` altında ekleme + düzenleme akışını doğrulamak için bir sayfa bulunmaktadır.
-
-Dosyalar:
-
-- `apps/web/index.html`
-- `apps/web/app.js`
-- `apps/web/store.js`
-- `apps/web/store.test.mjs`
-
-Store testi çalıştırma:
-
-```bash
-node apps/web/store.test.mjs
+# Framework versiyonunu kontrol et
+ai-enderun version
 ```
 
-## Sürüm ve Paket Notları
+## 📦 Paket Yapısı
 
-- Root paket sürümü: `0.0.2`
-- MCP paket sürümü: `0.0.2`
-- Shared-types paket sürümü: `0.0.2`
+- `packages/shared-types`: Backend ve Frontend arasındaki tip sözleşmeleri.
+- `packages/framework-mcp`: Agent yeteneklerini genişleten Model Context Protocol sunucusu.
+- `.gemini/agents`: Ajanların davranışlarını ve kurallarını belirleyen SOP (Standard Operating Procedure) dosyaları.
+- `.gemini/docs`: API spesifikasyonları ve teknik dökümantasyon.
 
-Yayın öncesi önerilen kontrol:
+## 📜 Anayasa (Gemini.md)
 
-```bash
-npm pack --dry-run
-cd packages/framework-mcp && npm pack --dry-run
-cd ../shared-types && npm pack --dry-run
-```
+Projedeki her ajan, çalışmaya başlamadan önce `Gemini.md` dosyasını okumak ve buradaki kurallara %100 uymak zorundadır. Anayasaya aykırı kod yazımı (@analyst tarafından) reddedilir.
 
-## Lisans
+## 🛡️ Lisans
 
-MIT
+MIT © 2026 Yusuf BEKAR

package/bin/cli.js

@@ -21,8 +21,20 @@ function getMemoryPath() {
   return path.join(targetDir, ".gemini", "PROJECT_MEMORY.md");
 }
 
-function generateUUID() {
-  return crypto.randomUUID();
+function generateULID(seedTime = Date.now()) {
+  const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+  const ENCODING_LEN = ENCODING.length;
+  let time = seedTime;
+  const timeChars = new Array(10);
+  for (let i = 9; i >= 0; i--) {
+    timeChars[i] = ENCODING.charAt(time % ENCODING_LEN);
+    time = Math.floor(time / ENCODING_LEN);
+  }
+  const randomChars = new Array(16);
+  for (let i = 0; i < 16; i++) {
+    randomChars[i] = ENCODING.charAt(Math.floor(Math.random() * ENCODING_LEN));
+  }
+  return timeChars.join("") + randomChars.join("");
 }
 
 function sleep(ms) {
@@ -179,7 +191,7 @@ function traceNewCommand(description, agent = "manager", priority = "P2") {
     return;
   }
 
-  const traceId = generateUUID();
+  const traceId = generateULID();
   const safeDescription = sanitizeTableCell(description);
   const safeAgent = normalizeAgentName(agent);
   const safePriority = normalizePriority(priority);
@@ -221,7 +233,7 @@ async function main() {
       break;
     case "trace:new":
       if (!args[0]) {
-        console.error("❌ Kullanım: ai-agent-framework trace:new <açıklama> [agent] [priority]");
+        console.error("❌ Kullanım: ai-enderun trace:new <açıklama> [agent] [priority]");
       } else {
         traceNewCommand(args[0], args[1], args[2]);
       }
@@ -242,7 +254,7 @@ Kullanılabilir Komutlar:
   version           Versiyon bilgisini gösterir
 
 Örnek:
-  ai-agent-framework trace:new "Auth modülü tasarımı" backend P1
+  ai-enderun trace:new "Auth modülü tasarımı" backend P1
       `);
       break;
   }

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "ai-enderun",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Supreme AI Orchestration Framework — Senior Discipline & Ottoman Wisdom",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ysf-bkr/AI-Enderun.git"
+    "url": "git+https://github.com/ysf-bkr/AI-Enderun.git"
   },
   "homepage": "https://github.com/ysf-bkr/AI-Enderun#readme",
   "type": "module",
   "bin": {
-    "ai-agent-framework": "bin/cli.js"
+    "ai-enderun": "bin/cli.js"
   },
   "files": [
     "bin",
@@ -39,7 +39,12 @@
     "package.json"
   ],
   "scripts": {
+    "build": "npm run build --prefix packages/shared-types && npm run build --prefix packages/framework-mcp",
     "mcp:dev": "npx tsx packages/framework-mcp/src/index.ts",
     "mcp:status": "npx socraticode status"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.4",
+    "typescript": "^5.7.3"
   }
 }

package/packages/framework-mcp/README.md

@@ -1,134 +1,53 @@
-# ai-enderun-mcp (v0.0.2)
+# 🔌 @ai-enderun/framework-mcp (v0.0.5)
 
-`ai-enderun-mcp`, AI-Enderun ajanlarının projeyi güvenli biçimde taraması, sorgulaması ve hafıza görünürlüğü kazanması için kullanılan MCP sunucusudur.
+AI-Enderun Model Context Protocol (MCP) sunucusu. Bu paket, AI ajanlarınızın projeniz üzerinde derinlemesine analiz yapmasını, hafızayı yönetmesini ve mimari boşlukları tespit etmesini sağlayan özel araçlar (tools) sunar.
 
-## Paket Özeti
+## 🛠️ Sağlanan Araçlar (Agent Tools)
 
-- Paket adı: `ai-enderun-mcp`
-- Çalışma şekli: `stdio` transport
-- Giriş noktası: `dist/index.js`
-- Protokol: Model Context Protocol (MCP)
+Ajanlar bu araçları kullanarak projenize "dokunabilirler":
 
-## Kurulum ve Build
+- **`search_codebase`**: Kod tabanında semantik ve metinsel arama yapar.
+- **`analyze_dependencies`**: Dosyalar ve modüller arası bağımlılık grafiğini çıkarır.
+- **`get_memory_insights`**: `.gemini/PROJECT_MEMORY.md` üzerinden projenin o anki state'ini özetler.
+- **`update_project_memory`**: Proje hafızasına güvenli ve kilitli (lock) yazma işlemi yapar.
+- **`get_project_gaps`**: Dökümantasyon, test veya kontratlardaki eksikleri tespit eder.
 
-```bash
-cd packages/framework-mcp
-npm install
-npm run build
-```
-
-Geliştirme modu:
+## ⚙️ Kurulum ve Yapılandırma
 
-```bash
-npm run dev
-```
-
-Üretim modu:
-
-```bash
-npm start
-```
-
-## MCP İstemci Konfigürasyonu
-
-Örnek:
+`mcp.json` dosyanızda sunucuyu şu şekilde tanımlayabilirsiniz:
 
 ```json
 {
   "mcpServers": {
-    "framework-mcp": {
+    "ai-enderun-mcp": {
       "command": "node",
-      "args": ["/abs/path/to/packages/framework-mcp/dist/index.js"]
+      "args": ["packages/framework-mcp/dist/index.js"]
     }
   }
 }
 ```
 
-## Tool Kataloğu
-
-### Ana tool'lar
-
-- `get_framework_status`
-- `search_codebase`
-- `analyze_dependencies`
-- `get_memory_insights`
-- `get_project_gaps`
-- `security_audit_scan`
-- `update_project_memory`
-
-### Uyumluluk alias'ları
-
-- `codebase_status` -> `get_framework_status`
-- `codebase_search` -> `search_codebase`
-- `codebase_graph_query` -> `analyze_dependencies`
-- `codebase_context` -> context artifact listing
-- `codebase_context_search` -> markdown odaklı arama
+## 🔨 Geliştirme ve Build
 
-## Güvenlik ve Yazma Kapsamı
+Sistemi derlemek için:
 
-- Path escape engeli var (`resolveSafePath`): proje kökü dışı erişim reddedilir.
-- Kod dosyaları üzerinde yazma yoktur.
-- Sadece kontrollü hafıza güncellemesi desteklenir:
-  - `update_project_memory` -> `MEVCUT DURUM`, `HISTORY`, `AKTİF GÖREVLER`
-- Hafıza güncellemesinde lock dosyası kullanılır (`PROJECT_MEMORY.md.lock`).
-
-## Pratik Örnekler
-
-### Kod arama
-
-```json
-{
-  "name": "search_codebase",
-  "arguments": {
-    "query": "trace:new",
-    "extension": "js"
-  }
-}
-```
-
-### Bağımlılık analizi
-
-```json
-{
-  "name": "analyze_dependencies",
-  "arguments": {
-    "path": "bin/cli.js"
-  }
-}
-```
-
-### Hafıza içgörüsü
-
-```json
-{
-  "name": "get_memory_insights",
-  "arguments": {}
-}
+```bash
+cd packages/framework-mcp
+npm install
+npm run build
 ```
 
-## Yayın İçeriği
-
-Paket sadece aşağıdakileri yayınlar:
-
-- `dist/`
-- `README.md`
-- `package.json`
-
-Kontrol:
+Geliştirme modunda (build gerektirmeden) çalıştırmak için:
 
 ```bash
-npm pack --dry-run
+npm run mcp:dev
 ```
 
-## Sorun Giderme
+## 📜 Kurallar
 
-- `Tool not found`:
-  - İstemci eski cache tutuyor olabilir; MCP sunucusunu yeniden başlatın.
-- `Memory is locked`:
-  - Aynı anda başka işlem yazıyor olabilir, kısa süre sonra tekrar deneyin.
-- `Path escapes project root`:
-  - `path` argümanını proje köküne göre relatif verin.
+- Hiçbir ajan bir dosyayı körü körüne okumamalıdır; her zaman önce `search_codebase` veya `get_memory_insights` ile bağlamı taramalıdır.
+- Araçlar, AI-Enderun Anayasası'ndaki (`Gemini.md`) güvenlik sınırları içinde çalışır.
 
-## Lisans
+## 📜 Lisans
 
 MIT

package/packages/framework-mcp/package.json

@@ -1,11 +1,11 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ysf-bkr/AI-Enderun.git"
+    "url": "git+https://github.com/ysf-bkr/AI-Enderun.git"
   },
   "homepage": "https://github.com/ysf-bkr/AI-Enderun#readme",
   "type": "module",

package/packages/framework-mcp/src/index.ts

@@ -10,8 +10,8 @@ import fs from "fs";
 
 const server = new Server(
   {
-    name: "ai-agent-framework-mcp",
-    version: "0.0.2",
+    name: "ai-enderun-mcp",
+    version: "0.0.5",
   },
   {
     capabilities: {

package/packages/shared-types/README.md

@@ -1,86 +1,56 @@
-# ai-enderun-shared-types (v0.0.2)
+# 📦 @ai-enderun/shared-types (v0.0.5)
 
-`ai-enderun-shared-types`, AI-Enderun içinde backend/frontend arasında paylaşılan tip sözleşmelerinin merkezi paketidir.
+Bu paket, AI-Enderun ekosistemindeki Backend ve Frontend arasındaki **tek gerçeklik kaynağı (SSOT)** olan tip sözleşmelerini barındırır.
 
-## Amaç
+## 🌟 Öne Çıkan Özellikler
 
-- ID ve DTO tiplerini tek yerde toplamak
-- Contract-first geliştirmeyi desteklemek
-- Faz geçişlerinde sözleşme doğrulaması yapmak
+- **Branded Types:** `UserID` ve `ProductID` gibi kimliklerin yanlışlıkla birbirinin yerine kullanılmasını engelleyen tip güvenliği.
+- **Built-in ULID:** Zamana göre sıralanabilir, 26 karakterlik performanslı kimlik üretimi.
+- **API Wrapper:** Tüm endpoint'ler için standart `ApiSuccess` ve `ApiError` yapıları.
+- **Strict Error Handling:** Proper HTTP Status kodlarıyla senkronize hata tipleri.
 
-## Güncel Dizin Yapısı
+## 🛠️ Temel Kullanım
 
-```bash
-shared-types/
-├── src/
-│   └── index.ts
-├── dist/
-│   ├── index.js
-│   ├── index.d.ts
-│   └── *.map
-├── contract.version.json
-├── package.json
-└── tsconfig.json
-```
-
-## Geliştirme Komutları
+### ULID ve ID Üretimi
+```typescript
+import { createUserID, createULID } from '@ai-enderun/shared-types';
 
-```bash
-cd packages/shared-types
-npm install
-npm run build
-npm run typecheck
+const id = createUserID(); // ULID formatında UserID döner
+const raw = createULID(); // Saf 26 karakterlik ULID string
 ```
 
-Not: Bu pakette `tsc` local devDependency olarak kullanılır.
-
-## Yayın Davranışı
-
-Paket yayınına giren dosyalar:
-
-- `dist/`
-- `README.md`
-- `package.json`
-
-Kontrol:
-
-```bash
-npm pack --dry-run
-```
+### API Yanıt Yapısı
+Framework, hatalarda `200 OK` dönülmesini kesinlikle yasaklar.
 
-## Kontrat Hash Doğrulama
-
-`contract.version.json` içindeki hash ile kaynak hash'i karşılaştırma:
+```typescript
+// Başarılı Yanıt
+const response: ApiResponse<User> = {
+  success: true,
+  data: { id: '...', name: 'Yusuf' }
+};
 
-```bash
-CURRENT_HASH=$(find packages/shared-types/src -name "*.ts" | sort | xargs shasum -a 256 | shasum -a 256 | awk '{print $1}')
-STORED_HASH=$(jq -r '.contract_hash' packages/shared-types/contract.version.json)
-[ "$CURRENT_HASH" = "$STORED_HASH" ] && echo "HASH OK" || echo "HASH MISMATCH"
+// Hata Yanıtı (Gerçek HTTP 401/404 vb. ile birlikte)
+const error: ApiError = {
+  success: false,
+  code: 'UNAUTHORIZED',
+  message: 'Yetkisiz erişim.',
+  statusCode: 401
+};
 ```
 
-## Kullanım Örneği
+## 📐 Mimari Kurallar
 
-```ts
-import type { ApiResponse, UserID } from "ai-enderun-shared-types";
+1. **Owner:** Bu paketin birincil sahibi `@backend` ajanıdır.
+2. **Workflow:** Backend bir tip değiştirir -> `contract_hash` güncellenir -> Frontend dökümantasyonu okur ve tipi import eder.
+3. **No Logic:** Bu paket sadece tip tanımları ve hafif yardımcılar (generator'lar) içermelidir; ağır iş mantığı barındıramaz.
 
-function asUserId(raw: string): UserID {
-  return raw as UserID;
-}
+## 🔨 Geliştirme
 
-const response: ApiResponse<{ id: UserID }> = {
-  success: true,
-  data: { id: asUserId("u-123") },
-};
+```bash
+npm install
+npm run build # npx tsc ile derler
 ```
 
-## Değişiklik Protokolü
-
-1. `src/index.ts` güncelle.
-2. `npm run typecheck` çalıştır.
-3. `npm run build` ile `dist` üret.
-4. `contract.version.json` hash güncelle.
-5. `PROJECT_MEMORY.md` ve ilgili log dosyasında değişikliği kaydet.
-
-## Lisans
+## 📜 Lisans
 
 MIT

package/packages/shared-types/package.json

@@ -1,11 +1,11 @@
 {
   "name": "ai-enderun-shared-types",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Shared TypeScript types for backend ↔ frontend contract. Owned by @backend, consumed by @frontend.",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ysf-bkr/AI-Enderun.git"
+    "url": "git+https://github.com/ysf-bkr/AI-Enderun.git"
   },
   "homepage": "https://github.com/ysf-bkr/AI-Enderun#readme",
   "main": "dist/index.js",
@@ -16,7 +16,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "npx tsc",
     "build:watch": "tsc --watch",
     "typecheck": "tsc --noEmit"
   },

package/packages/shared-types/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * Shared Types — AI Agent Framework v1.0.2
+ * Shared Types — AI-Enderun v0.0.5
  * Bu paketteki tüm tipler backend ve frontend arasındaki kontratı tanımlar.
  * Sadece @backend düzenler, @frontend okur/import eder.
  */
@@ -8,14 +8,30 @@
 // Neden: Ham string ID'lerin birbirine karışmasını engeller (UserID ≠ ProductID)
 export type Brand<T, B> = T & { readonly _brand: B };
 
+// ─── ULID Generator (Lightweight) ──────────────────────────────────────────────
+const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const ENCODING_LEN = ENCODING.length;
+
+export const createULID = (seedTime: number = Date.now()): string => {
+  let time = seedTime;
+  const timeChars = new Array(10);
+  for (let i = 9; i >= 0; i--) {
+    timeChars[i] = ENCODING.charAt(time % ENCODING_LEN);
+    time = Math.floor(time / ENCODING_LEN);
+  }
+  const randomChars = new Array(16);
+  for (let i = 0; i < 16; i++) {
+    randomChars[i] = ENCODING.charAt(Math.floor(Math.random() * ENCODING_LEN));
+  }
+  return timeChars.join("") + randomChars.join("");
+};
+
 export type UserID = Brand<string, 'UserID'>;
 export type SessionID = Brand<string, 'SessionID'>;
-// Yeni ID tipleri buraya ekle: export type XxxID = Brand<string, 'XxxID'>;
 
-// ─── ID Üretici (Runtime) ──────────────────────────────────────────────────────
-// Neden: crypto.randomUUID() tarayıcı + Node.js'te çalışır, uuid paketi gereksiz
-export const createUserID = (): UserID => crypto.randomUUID() as UserID;
-export const createSessionID = (): SessionID => crypto.randomUUID() as SessionID;
+// ─── ID Üreticiler (Runtime) ──────────────────────────────────────────────────
+export const createUserID = (): UserID => createULID() as UserID;
+export const createSessionID = (): SessionID => createULID() as SessionID;
 
 // ─── Pagination ────────────────────────────────────────────────────────────────
 export interface PaginationQuery {
@@ -32,7 +48,9 @@ export interface PaginatedResponse<T> {
 }
 
 // ─── API Response Wrapper ──────────────────────────────────────────────────────
-// Neden: Tüm API yanıtları tutarlı yapıda olmalı
+// Neden: Tüm API yanıtları tutarlı yapıda olmalı. 
+// ÖNEMLİ: Hatalarda 200 OK dönüp içinde "success: false" dönmek YASAKTIR. 
+// Gerçek HTTP status kodları (400, 401, 404 vb.) kullanılmalıdır.
 export interface ApiSuccess<T> {
   success: true;
   data: T;
@@ -42,7 +60,7 @@ export interface ApiError {
   success: false;
   code: string;        // 'NOT_FOUND' | 'VALIDATION_ERROR' | 'UNAUTHORIZED' vb.
   message: string;     // Kullanıcıya gösterilecek mesaj
-  statusCode: number;
+  statusCode: number;  // HTTP status kodu ile eşleşmeli
 }
 
 export type ApiResponse<T> = ApiSuccess<T> | ApiError;