ai-enderun 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/.gemini/PROJECT_MEMORY.md +10 -9
  2. package/.gemini/docs/api/README.md +38 -58
  3. package/Gemini.md +1 -1
  4. package/README.md +125 -34
  5. package/package.json +1 -1
package/.gemini/PROJECT_MEMORY.md CHANGED
@@ -10,22 +10,23 @@ Bu dosya, projenin tek gerçeklik kaynağı (Single Source of Truth) ve kalıcı
10
10
 
11
11
  ## KRİTİK KARARLAR
12
12
 
13
- | Tarih | Karar | Gerekçe | Ajan |
14
- | :--------- | :------------------------ | :-------------------------------------- | :------- |
15
- | 2026-05-07 | Standalone Architecture | Maksimum esneklik ve bağımsızlık | @manager |
13
+ | Tarih | Karar | Gerekçe | Ajan |
14
+ | :--------- | :------------------------ | :--------------------------------------- | :------- |
15
+ | 2026-05-07 | Standalone Architecture | Maksimum esneklik ve bağımsızlık | @manager |
16
16
  | 2026-05-07 | Contract-First Discipline | Sıfır hata ile ölçeklenebilir geliştirme | @manager |
17
17
 
18
18
  ## AKTİF GÖREVLER
19
19
 
20
+ - [ ] [TRACE-5D1BF70C] CLI implementasyon testi (@backend)
20
21
  - [ ] [TRACE-4EE5BA49] CLI Test Görevi (@backend)
21
22
  - [ ] İlk modüllerin mimari taslaklarının oluşturulması.
22
23
 
23
24
  ## HISTORY (Kalıcı Hafıza)
24
25
 
25
- ### 2026-05-07 — v0.0.1 (Initial Professional Launch)
26
+ ### 2026-05-07 — README ve Dökümantasyon Güncellemesi
26
27
 
27
- - **Ajan:** @manager
28
- - **Trace ID:** BASE-INIT-001
29
- - **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ı.
30
- - **Karar:** Projenin tertemiz ve bağımsız bir "Professional Framework" olarak v0.0.1 sürümüyle başlatılmasına karar verildi.
31
- - **Sonraki Adım:** PHASE_1 standartlarında API ve tip kontratlarının tanımlanması.
28
+ - **Ajan:** @analyst
29
+ - **Trace ID:** —
30
+ - **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.
31
+ - **Karar:** Dökümantasyonun Türkçe ağırlıklı ancak global standartlarda tutulmasına karar verildi.
32
+ - **Sonraki Adım:** PHASE_1 hazırlıkları kapsamında ilk API dökümanlarının oluşturulması.
package/.gemini/docs/api/README.md CHANGED
@@ -1,84 +1,64 @@
1
- # 📡 API Contract Hub
1
+ # 📡 API Kontrat Merkezi (API Contract Hub)
2
2
 
3
- Bu klasör, **@backend** tarafından yazılan tüm endpoint'lerin belgesidir.
4
- **@frontend** bu klasörü okumadan herhangi bir API çağrısı yazamaz.
5
-
6
- > **Kural:** Backend bir endpoint yazar → bu dosyayı günceller → Frontend okur → kodlar.
7
- > Kontrat olmadan çalışmak yasaktır.
3
+ Bu dizin, **AI-Enderun** projesinin tüm ağ iletişim protokollerini ve endpoint dökümantasyonunu içerir. "Sıfır Hata" prensibi gereği, backend ve frontend arasındaki tüm etkileşimler burada önceden tanımlanmalıdır.
8
4
 
9
5
  ---
10
6
 
11
- ## 📋 Endpoint Listesi (İndeks)
7
+ ## 🛡️ Altın Kurallar
12
8
 
13
- | Domain | Dosya | Endpoint Sayısı | Son Güncelleme |
14
- |---|---|---|---|
15
- | *(Henüz endpoint yok)* | — | — | — |
9
+ 1. **Kontratsız Kod Yasaktır:** `@backend` bir endpoint yazmadan önce dökümanını hazırlamalı, `@frontend` dökümanı okumadan kod yazmamalıdır.
10
+ 2. **SSoT Uyumu:** Tüm dökümanlar `packages/shared-types` içindeki tiplerle %100 uyumlu olmalıdır.
11
+ 3. **Traceability:** Her endpoint tanımı, oluşturulduğu görevin `Trace ID`'sini içermelidir.
12
+ 4. **Versioning:** Kontratlardaki breaking change'ler mutlaka `@analyst` denetiminden geçmelidir.
16
13
 
17
14
  ---
18
15
 
19
- ## 📌 Nasıl Kullanılır?
20
-
21
- ### @backend için
22
- 1. Yeni endpoint yazdığında → `[domain].md` dosyası oluştur/güncelle
23
- 2. Yukarıdaki tabloyu güncelle
24
- 3. `shared-types` değiştiyse `contract.version.json` hash'ini güncelle
16
+ ## 📋 Endpoint İndeksi
25
17
 
26
- ### @frontend için
27
- 1. Oturum başında bu dosyayı oku
28
- 2. Kullanacağın endpoint'in `[domain].md` dosyasını aç
29
- 3. Kontrat yoksa → `@backend`'e bildir, tahmin üzerinden çalışma
18
+ | Domain | Durum | Endpoint Sayısı | Sorumlu | Son Güncelleme |
19
+ | :--- | :--- | :--- | :--- | :--- |
20
+ | **Auth** | ⏳ Beklemede | 0 | @backend | — |
21
+ | **User** | ⏳ Beklemede | 0 | @backend | — |
22
+ | **Project** | ⏳ Beklemede | 0 | @backend | — |
30
23
 
31
24
  ---
32
25
 
33
- ## 🗂️ Domain Dosyaları
26
+ ## 📌 Operasyonel Akış
34
27
 
35
- *(Henüz oluşturulmadı. @backend ilk endpoint'ini yazdığında buraya eklenecek.)*
28
+ ### 🟢 Backend Protokolü
29
+ - Yeni bir endpoint tasarlandığında ilgili `[domain].md` dosyasını oluşturun veya güncelleyin.
30
+ - `shared-types` referanslarını (DTO ve Response tipleri) net bir şekilde belirtin.
31
+ - Hata kodlarını (400, 401, 404 vb.) ve fırlatılma koşullarını dökümante edin.
32
+
33
+ ### 🔵 Frontend Protokolü
34
+ - Geliştirmeye başlamadan önce bu dizini tarayın.
35
+ - Kontrat dökümanı eksikse veya güncel değilse `@backend` ajanına `P1` öncelikli direktif gönderin.
36
+ - Tahmin yürüterek veya mock verilerle (anayasa izni dışında) çalışmayın.
36
37
 
37
38
  ---
38
39
 
39
- ## 📝 Endpoint Belgeleme Şablonu
40
+ ## 📝 Standart Belgeleme Formatı
40
41
 
41
- Her `[domain].md` dosyası şu formatı kullanır:
42
+ Her `[domain].md` dosyası aşağıdaki profesyonel şablonu izlemelidir:
42
43
 
43
44
  ```markdown
44
- # [Domain] API — Kontrat
45
+ # [Domain] API Kontratı
45
46
 
46
- ## Endpoint Listesi
47
- - [GET] /api/[path] — Kısa açıklama
48
- - [POST] /api/[path] — Kısa açıklama
47
+ ## Genel Bakış
48
+ [Domain'in amacı ve sorumluluğu]
49
49
 
50
- ---
50
+ ## Endpoint'ler
51
51
 
52
- ### [METHOD] /api/[path]
53
- - **Açıklama:** Bu endpoint ne yapar?
54
- - **Auth:** Gerekli mi? Hangi rol? (örn: Bearer Token, Admin)
55
- - **Request Body:**
56
- ```typescript
57
- interface CreateXxxDTO {
58
- field: string;
59
- }
60
- ```
61
- - **Query Params:** `?page=1&limit=20`
62
- - **Response (200):**
63
- ```typescript
64
- interface XxxResponse {
65
- id: string;
66
- field: string;
67
- createdAt: string;
68
- }
69
- ```
70
- - **Hata Kodları:**
71
- - `400` — Geçersiz istek
72
- - `401` — Auth gerekli
73
- - `404` — Kaynak bulunamadı
74
- - `409` — Çakışma
75
- - `500` — Sunucu hatası
76
- - **shared-types Referansı:** `CreateXxxDTO`, `XxxResponse`
77
- - **Son Güncelleme:** YYYY-MM-DD
78
- - **Trace ID:** [uuid]
52
+ ### [METHOD] /api/v1/[path]
53
+ - **Açıklama:** [İşlev]
54
+ - **Auth:** [Gerekli/Değil] - [Rol]
55
+ - **Request (DTO):** `shared-types` -> `XxxDTO`
56
+ - **Response (200):** `shared-types` -> `XxxResponse`
57
+ - **Hatalar:** 400 (Validation), 401 (Unauthorized), 404 (Not Found)
58
+ - **Trace ID:** [UUID]
59
+ - **Güncelleme:** YYYY-MM-DD
79
60
  ```
80
61
 
81
62
  ---
82
63
 
83
- *Son güncelleme: —*
84
- *Sorumlu: @backend (yazma) / @frontend (okuma)*
64
+ *Bu döküman @analyst tarafından düzenli olarak denetlenmektedir.*
package/Gemini.md CHANGED
@@ -1,4 +1,4 @@
1
- # AI-Enderun — Supreme Performance AI Orchestration (v0.0.1)
1
+ # AI-Enderun — Supreme Performance AI Orchestration (v0.0.2)
2
2
 
3
3
  # Place in project root. This file is the single source of truth for all AI clients (Gemini CLI, Claude Code, etc.).
4
4
 
package/README.md CHANGED
@@ -1,51 +1,96 @@
1
- # 🏛️ AI-Enderun — Supreme Performance AI Orchestration (v0.0.1)
1
+ # 🏛️ AI-Enderun — Supreme Performance AI Orchestration (v0.0.2)
2
2
 
3
- **Developer:** Yusuf BEKAR (Senior Software Architect)
4
- **Status:** 🛠️ Professional Multi-Agent Framework
5
- **Philosophy:** Senior Engineering Discipline & Ottoman Wisdom
6
-
7
- **AI-Enderun**, modern yazılım ekosisteminde yapay zeka ajanlarını seçkin birer "Senior Mühendis" gibi çalıştıran, Osmanlı'nın disiplinli devlet geleneğinden (Enderun) ilham alan profesyonel bir orkestrasyon sistemidir.
8
-
9
- [English](#english) | [Türkçe](#türkçe) | [Deutsch](#deutsch)
3
+ **Geliştirici:** Yusuf BEKAR (Senior Software Architect)
4
+ **Durum:** 🛠️ Üretim Hazırı Çoklu Ajan Çerçevesi
5
+ **Felsefe:** Kıdemli Mühendislik Disiplini ve Enderun Bilgeliği
10
6
 
11
7
  ---
12
8
 
13
- <a name="english"></a>
14
- ## 🇬🇧 English: The Sovereign Intelligence
9
+ ## 🛡️ Neden AI-Enderun?
15
10
 
16
- ### 🛡️ The Philosophy: "Discipline Above All"
17
- Named after the elite Ottoman palace school, **AI-Enderun** ensures that AI agents operate within a strict architectural constitution. It eliminates "AI Slop" by enforcing mandatory phase-based execution and a robust contract-first discipline.
11
+ AI kod asistanlarının genellikle karmaşık, yapılandırılmamış ve teknik borç üreten kodlar (AI Slop) ürettiği bir dönemde, **AI-Enderun** bir disiplin abidesi olarak yükselir. Osmanlı İmparatorluğu'nun seçkin **Enderun** okulundan ilham alan bu framework, AI ajanlarını basit sohbet botları olarak değil, katı bir **Anayasa (Gemini.md)** ve **Faz Tabanlı Yürütme** modelini izlemek zorunda olan yüksek rütbeli **Senior Mühendisler** olarak görür.
12
+
13
+ [Türkçe](#türkçe) | [English](#english) | [Deutsch](#deutsch)
18
14
 
19
15
  ---
20
16
 
21
17
  <a name="türkçe"></a>
22
- ## 🇹🇷 Türkçe: Egemen Zeka
23
18
 
24
- ### 🛡️ Felsefe: "Her Şeyin Başı Disiplin"
25
- Adını Osmanlı'nın en seçkin beyinleri yetiştiren saray okulundan alan **AI-Enderun**, yapay zeka ajanlarının katı bir mimari anayasa çerçevesinde çalışmasını sağlar. Faz-bazlı yürütme ve kontrat-öncelikli disiplin ile kalitesiz kod üretimini (AI Slop) tamamen engeller.
19
+ ## 🇹🇷 Türkçe: Kapsamlı Rehber
26
20
 
27
- ---
21
+ ### 👥 Uzman Ajan Kadrosu (Yetenekler)
28
22
 
29
- <a name="deutsch"></a>
30
- ## 🇩🇪 Deutsch: Die Souveräne Intelligenz
23
+ | Ajan | Rol | Temel Yetenekler & Sorumluluklar |
24
+ | :------------ | :------------------ | :--------------------------------------------------------------------------------------------------------------------------------- |
25
+ | **@manager** | **CTO / Lider** | Orkestrasyon, Trace ID Yönetimi, Faz Kapıları (Phase Gates), Briefing Oluşturma ve Proje Sağlığı. |
26
+ | **@explorer** | **Ar-Ge / Analist** | `framework-mcp` ile derin kod taraması, bağımlılık haritalama, semantik arama ve mimari keşif. |
27
+ | **@backend** | **Mimar** | Node.js (Fastify), Veritabanı (Kysely/PostgreSQL), Katmanlı Mimari (Route->Controller->Service->Repository) ve API Kontrat Yazımı. |
28
+ | **@frontend** | **UX Mühendisi** | React 19, Tailwind CSS, Atomic Design, Fluid Typography (`clamp`), Dinamik Tasarım Tokenları ve Premium Estetik. |
29
+ | **@mobile** | **Mobil Uzmanı** | React Native, Offline-First stratejileri, 60 FPS performans optimizasyonu ve Güvenli Depolama (Keychain). |
30
+ | **@native** | **Sistem Uzmanı** | Electron/Tauri, IPC Güvenliği, İşletim Sistemi API entegrasyonları ve Auto-Update sistemleri. |
31
+ | **@analyst** | **QA / Denetçi** | Kontrat Doğrulama (SHA-256), Proje Hafızası (PROJECT_MEMORY) Yönetimi, QA Kapısı ve Walkthrough üretimi. |
31
32
 
32
- ### 🛡️ Die Philosophie: "Disziplin über Alles"
33
- Benannt nach der elitären osmanischen Palastschule, stellt **AI-Enderun** sicher, dass KI-Agenten innerhalb einer strengen architektonischen Verfassung agieren. Es eliminiert unstrukturierten Code durch die Erzwingung einer phasenbasierten Ausführung und einer robusten "Contract-First" Disziplin.
33
+ ### 🚀 Kurulum ve Yapılandırma
34
34
 
35
- ---
35
+ AI-Enderun framework'ünü herhangi bir projeye (yeni veya mevcut) dahil etmek için `npx` komutunu kullanabilirsiniz. Bu işlem, projenize kıdemli mühendislik standartlarını ve ajan yapılandırmalarını enjekte eder.
36
+
37
+ #### 1. Framework'ü İlklendirme
38
+
39
+ En temel kurulum için aşağıdaki komutu çalıştırın:
40
+
41
+ ```bash
42
+ npx ai-enderun init
43
+ ```
44
+
45
+ #### 2. AI Adaptörü Seçimi (Özel Talimatlar)
46
+
47
+ Kullandığınız AI asistanına göre özel yapılandırma dosyalarını (Anayasa dökümanları) yükleyebilirsiniz:
48
+
49
+ ```bash
50
+ # Google Gemini için (Gemini.md yükler)
51
+ npx ai-enderun init gemini
52
+
53
+ # Anthropic Claude için (CLAUDE.md yükler)
54
+ npx ai-enderun init claude
55
+
56
+ # Cursor IDE için (CURSOR.md yükler)
57
+ npx ai-enderun init cursor
58
+
59
+ # GitHub Copilot / Codex için (CODEX.md yükler)
60
+ npx ai-enderun init codex
61
+ ```
36
62
 
37
- ## 🏗️ Technical Structure / Teknik Yapı
63
+ #### 3. MCP Sunucusunu Bağlama
38
64
 
39
- | Path | Description |
40
- | :--- | :--- |
41
- | **`Gemini.md`** | The Constitution / Anayasa (Supreme Law) |
42
- | **`.gemini/`** | Project Memory & Agent Personas / Hafıza ve Ajanlar |
43
- | **`bin/cli.js`** | Command Center / Komuta Merkezi |
44
- | **`packages/`** | Core Engine & Contracts / Çekirdek Motor ve Kontratlar |
65
+ AI asistanınızın (örn: Claude Desktop) projenizi derinlemesine analiz edebilmesi için MCP sunucusunu yapılandırın:
66
+
67
+ 1. `packages/framework-mcp` dizinine gidin.
68
+ 2. `npm install` ve `npm run build` komutlarını çalıştırın.
69
+ 3. AI istemcinizin konfigürasyonuna MCP yolunu ekleyin (Detaylar: [framework-mcp/README.md](file:///Users/ybekar/Desktop/Projeler/base/packages/framework-mcp/README.md)).
70
+
71
+ ### 🛠️ CLI Komutları (Derinlemesine)
72
+
73
+ - **`ai-agent-framework status`**: `PROJECT_MEMORY.md` dosyasını tarayarak projenin hangi fazda olduğunu, son kararları ve bekleyen görevleri terminale raporlar.
74
+ - **`ai-agent-framework trace:new <desc> [agent]`**: Yeni bir iş akışı başlatır. Benzersiz bir Trace ID üretir ve bu ID'yi hafızadaki `AKTİF GÖREVLER` tablosuna ilgili ajan etiketiyle ekler.
75
+ - **`ai-agent-framework init <adapter>`**: Projeyi sıfırdan kurar veya yeni bir AI adaptörü ekleyerek dökümantasyonu günceller.
45
76
 
46
77
  ---
47
78
 
48
- ## 🚀 Quick Start / Schnellstart
79
+ <a name="english"></a>
80
+
81
+ ## �� English: The Definitive Guide
82
+
83
+ ### 👥 Specialized Agent Squad (Capabilities)
84
+
85
+ - **@manager (CTO):** Orchestration, Trace ID management, and phase gate control.
86
+ - **@explorer (R&D):** Deep codebase scanning and semantic search via `framework-mcp`.
87
+ - **@backend (Architect):** High-performance logic, Kysely/PostgreSQL, and API contract leadership.
88
+ - **@frontend (UX):** React 19, Fluid aesthetics, and advanced design token systems.
89
+ - **@mobile (Mobile):** High-performance React Native with offline-first capabilities.
90
+ - **@native (System):** Secure desktop integration via Electron or Tauri.
91
+ - **@analyst (QA):** Integrity auditing, memory consistency, and QA gatekeeping.
92
+
93
+ ### 🚀 Quick Start
49
94
 
50
95
  ```bash
51
96
  npx ai-enderun init
@@ -53,11 +98,57 @@ npx ai-enderun init
53
98
 
54
99
  ---
55
100
 
56
- ## 📜 Version History
57
- | Version | Status | Description |
58
- | :--- | :--- | :--- |
59
- | **v0.0.1** | 🟢 Active | Rebranded as AI-Enderun. Multilingual support (EN, TR, DE). |
101
+ ## 🏗️ Detaylı Proje Yapısı
102
+
103
+ Proje, hem monorepo standartlarını hem de AI ajanlarının hafıza yönetimini optimize eden hibrit bir yapıya sahiptir:
104
+
105
+ ```bash
106
+ .
107
+ ├── 📜 Gemini.md # Ana Anayasa: Tüm ajanların uyması gereken yüce kurallar.
108
+ ├── 📜 CLAUDE.md / CURSOR.md # Adaptör Dosyaları: Seçilen AI asistanına özel talimatlar.
109
+ ├── 📁 bin/
110
+ │ └── ⚙️ cli.js # AI-Enderun CLI: Proje yönetimi ve Trace ID motoru.
111
+ ├── 📁 .gemini/ # 🧠 Framework Beyni
112
+ │ ├── 📁 agents/ # Ajan Personaları: Her rolün (backend, frontend vb.) SOP'ları.
113
+ │ │ ├── manager.md # CTO orkestrasyon kuralları.
114
+ │ │ ├── backend.md # API ve DB mimari standartları.
115
+ │ │ └── ... # Diğer uzman ajan tanımları.
116
+ │ ├── 📁 docs/ # Teknik Dökümantasyon
117
+ │ │ ├── 📁 api/ # API Kontratları: Endpoint tanımları ve dökümanları.
118
+ │ │ ├── 📜 tech-stack.md # Projenin teknoloji yığını kararları.
119
+ │ │ └── 📜 WIKI.md # Genel proje bilgi bankası.
120
+ │ ├── 📁 logs/ # İşlem Kayıtları: Ajan bazlı aktivite logları.
121
+ │ └── 📜 PROJECT_MEMORY.md # 📍 SSoT: Projenin canlı hafızası ve durum takibi.
122
+ ├── 📁 packages/ # 📦 Modüler Paketler
123
+ │ ├── 📁 framework-mcp/ # Zeka Motoru: Kod analizi yapan MCP sunucusu.
124
+ │ │ ├── 📁 src/ # MCP tool tanımları ve mantığı.
125
+ │ │ └── 📜 package.json
126
+ │ └── 📁 shared-types/ # Tip Kontratı: Backend/Frontend ortak tipleri.
127
+ │ ├── 📁 src/ # TypeScript interface ve DTO tanımları.
128
+ │ └── 📜 contract.version.json # Kontrat bütünlük hash kaydı.
129
+ ├── 📁 apps/ # 🚀 Uygulamalar (PHASE_2'de oluşturulur)
130
+ │ ├── 📁 web/ # React 19 Frontend uygulaması.
131
+ │ └── 📁 api/ # Fastify Backend uygulaması.
132
+ ├── 📜 package.json # Ana proje bağımlılıkları.
133
+ └── 📜 mcp.json # MCP sunucu konfigürasyonu.
134
+ ```
135
+
136
+ ---
137
+
138
+ ## � Yürütme Fazları (Execution Phases)
139
+
140
+ 1. **PHASE_0: Discovery** - Stack onayı ve profil seçimi.
141
+ 2. **PHASE_1: Architecture** - `shared-types` ve API kontratlarının onaylanması.
142
+ 3. **PHASE_2: Development** - Core özelliklerin birim testlerle teslimi.
143
+ 4. **PHASE_3: Integration** - Gerçek DB ve entegrasyon testleri.
144
+ 5. **PHASE_4: Deployment** - Üretim dökümantasyonu ve yayına alım.
145
+
146
+ ---
147
+
148
+ ## 👨‍💻 Geliştirici Hakkında
149
+
150
+ **Yusuf BEKAR**, karmaşık sistemleri ve yüksek performanslı ekipleri yönetme konusundaki deneyimini AI çağına taşıyan bir Senior Software Architect'tir. AI-Enderun, mühendislik disiplininin AI ile birleştiği zirve noktadır.
60
151
 
61
152
  ---
62
153
 
63
- > **Supreme Law:** Senior discipline is not an option, it's the standard.
154
+ > **Yüce Yasa:** Kıdemli disiplini bir seçenek değil, standarttır.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-enderun",
3
- "version": "0.0.1",
3
+ "version": "0.0.2",
4
4
  "description": "Supreme AI Orchestration Framework — Senior Discipline & Ottoman Wisdom",
5
5
  "author": "Yusuf BEKAR <ybekar@msn.com>",
6
6
  "repository": {