Numex Codex tanitimi: Konsey, FinishGate, IDE, CLI, Web, komutlar, .numex hafizasi

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: ⬇️ Codex'i indir
+    url: https://codex.numexai.com.tr
+    about: IDE, VS Code eklentisi ve CLI.
+  - name: 🧰 Numex SDK (açık kaynak)
+    url: https://github.com/mobilcep/numex-sdk
+    about: Codex'i kendi kodundan çalıştır.
+  - name: 🔒 Güvenlik bildirimi
+    url: mailto:destek@numexai.com.tr
+    about: Güvenlik açıklarını e-postayla bildir.

.github/ISSUE_TEMPLATE/hata-bildir.yml

@@ -0,0 +1,44 @@
+name: 🐞 Hata bildir
+description: Numex Codex'te (IDE, VS Code, CLI, Web) bir hata bildir
+labels: ["hata"]
+body:
+  - type: dropdown
+    id: kapi
+    attributes:
+      label: Hangi Codex?
+      options: [Codex IDE (masaüstü), VS Code eklentisi, Codex CLI, Codex Web, Uzaktan PC köprüsü]
+    validations:
+      required: true
+  - type: input
+    id: surum
+    attributes:
+      label: Sürüm ve işletim sistemi
+      placeholder: "ör. IDE v2.9.59 · Windows 11  /  CLI v3.3.10 · Node 22 · Ubuntu"
+    validations:
+      required: true
+  - type: dropdown
+    id: mod
+    attributes:
+      label: Hangi mod?
+      options: [Sohbet, Plan, Otonom, Hata Avcısı, Konsey, Misyon, Bilmiyorum]
+  - type: textarea
+    id: ne-oldu
+    attributes:
+      label: Ne oldu?
+    validations:
+      required: true
+  - type: textarea
+    id: adimlar
+    attributes:
+      label: Nasıl tekrarlanır?
+      placeholder: |
+        1. numex "..." yazdım
+        2. ...
+  - type: textarea
+    id: log
+    attributes:
+      label: Log / konsey raporu / ekran görüntüsü
+      description: "`.numex/logs` veya `.numex/audit/audit-trail.jsonl`'den ilgili satırlar işe yarar. Token, e-posta, API anahtarı gibi bilgileri gizle."
+  - type: markdown
+    attributes:
+      value: "🔒 Güvenlik açığı mı? Lütfen issue açma: destek@numexai.com.tr"

.github/ISSUE_TEMPLATE/ozellik-istegi.yml

@@ -0,0 +1,16 @@
+name: 💡 Özellik isteği
+description: Codex için bir fikir öner
+labels: ["öneri"]
+body:
+  - type: textarea
+    id: sorun
+    attributes:
+      label: Hangi sorunu çözüyor?
+    validations:
+      required: true
+  - type: textarea
+    id: oneri
+    attributes:
+      label: Önerin
+    validations:
+      required: true

README.en.md

@@ -0,0 +1,88 @@
+<div align="center">
+
+<img src="gorseller/codex-banner.png" alt="Numex Codex" width="100%">
+
+# Numex Codex
+
+### A coding agent that thinks in Turkish — for your editor, terminal and browser.
+
+**Ask. It writes, runs and verifies — until the job is actually done.**
+
+[🇹🇷 Türkçe](README.md) · 🇬🇧 **English**
+
+</div>
+
+---
+
+Numex Codex is the coding agent of [Numex AI](https://numexai.com.tr), Türkiye's Turkish-first AI.
+Tell it what you want in plain language; it **plans, writes, runs and tests** the code, and only says
+"done" once it can **prove** it works. For complex work it doesn't act alone — it convenes a
+**Council** of four specialists.
+
+> 📌 This is Codex's showcase, documentation and community repo. Downloads:
+> [codex.numexai.com.tr](https://codex.numexai.com.tr). Open-source SDK:
+> [numex-sdk](https://github.com/mobilcep/numex-sdk).
+
+## 🚪 Four doors, one agent
+
+| | Where | Install |
+|---|---|---|
+| 🧩 **Codex IDE** | Windows desktop (VS Code based) | [Download](https://codex.numexai.com.tr) — v2.9.59, ~162 MB |
+| 🧩 **VS Code extension** | Your existing VS Code | Install the extension + sign in via CLI |
+| ⌨️ **Codex CLI** | Terminal | `npm i -g @numexai/cli` (v3.3.10) |
+| 🌐 **Codex Web** | Browser | Nothing to install |
+
+## 🏛️ The Council — four specialists, one task
+
+Most coding agents grade their own homework: one model plans, writes, tests and declares success.
+Codex hands complex tasks to a Council where every member has **one job and limited permissions**:
+
+| Member | Job | Can write? |
+|---|---|---|
+| 📐 **Architect** | Folder structure, data model, per-file function plan | ❌ Plan only |
+| 💻 **Coder** | Writes complete, working code — no stubs, no TODOs | ✅ **The only writer** |
+| 🛡️ **Auditor** | First asks *"did we build the right thing?"*, then tests and verifies | ❌ Read & report only |
+| 🎨 **Designer** | Polishes UI/UX | ⚠️ CSS/HTML only |
+
+- **Single-writer rule** — only the Coder writes code, so agents never collide.
+- **Off-topic plan check** — if the Architect's plan drifts from your request, the Coder follows *your request*, not the plan.
+- **Right-sized team** — a one-line fix gets no council; a full-stack system gets all four. Token budget is checked up front (trivial ≈ 500 tokens … enterprise ≈ 30,000).
+- **Summon it yourself** — *"konseyi topla"* ("gather the council").
+- **Honest report** — a plain-language summary of who did what, including anything left unresolved.
+
+→ [Full Council write-up (Turkish)](docs/konsey.md)
+
+## 🚦 No "done" without proof — FinishGate
+
+A task only closes with **live evidence**: an HTTP 200 from the running server, passing tests, or the
+expected DOM in a headless browser. Otherwise the agent returns to a **self-healing loop**. If it gets
+stuck, a stuck-detector hands control back to you.
+
+## 🔀 Four modes
+
+**Chat** (explain, answer) · **Plan** (no edits, just a roadmap) · **Autonomous** (plan → approve →
+apply → verify) · **Bug Hunter** (root cause from logs and output).
+
+## ⌨️ CLI highlights
+
+```bash
+numex "build a dark-themed todo app"
+numex plan "add a payment module"      # plan only
+numex mission "make the tests pass"    # long-running autonomous mission in sandboxed worktrees
+numex undo                             # roll back the last turn
+numex --offline "…"                    # local Ollama, no internet
+numex uzak install                     # control your PC from your phone
+```
+
+Surgical diff-based patching · background process error interception · BM25 + AST code index · MCP
+client · live tree progress.
+
+## 🧠 Transparent memory
+
+Every project gets a readable `.numex/` folder: RAG index, **audit trail** of every action, undo
+checkpoints, learned errors, mission state and token usage. → [docs/numex-klasoru.md](docs/numex-klasoru.md)
+
+## 🤝 Community
+
+Bugs and ideas → [Issues](../../issues/new/choose) · Show what you built → [Discussions](../../discussions) ·
+Security → **destek@numexai.com.tr**

README.md

@@ -1 +1,264 @@
-# numex-codex
+<div align="center">
+
+<img src="gorseller/codex-banner.png" alt="Numex Codex — Editörüne Türkçe düşünen bir kod ajanı" width="100%">
+
+# Numex Codex
+
+### Editörüne Türkçe düşünen bir kod ajanı.
+
+**İste, yazsın, çalıştırsın — iş bitene kadar.**
+
+[![Site](https://img.shields.io/badge/codex.numexai.com.tr-00C9A7?style=for-the-badge)](https://codex.numexai.com.tr)
+[![IDE](https://img.shields.io/badge/IDE-v2.9.59-0A1628?style=for-the-badge)](https://codex.numexai.com.tr)
+[![CLI](https://img.shields.io/badge/CLI-v3.3.10-0A1628?style=for-the-badge)](https://codex.numexai.com.tr)
+[![SDK](https://img.shields.io/badge/SDK-açık_kaynak-0A1628?style=for-the-badge)](https://github.com/mobilcep/numex-sdk)
+
+🇹🇷 Türkçe · [🇬🇧 English](README.en.md)
+
+</div>
+
+---
+
+Numex Codex, [Numex AI](https://numexai.com.tr)'ın kod ajanıdır. Ona Türkçe ne istediğini söylersin;
+**plan çıkarır, kodu yazar, çalıştırır, test eder** ve ancak çalıştığını **kanıtladığında** "bitti" der.
+Karmaşık işlerde tek başına değil, dört uzmandan oluşan bir **Konsey** ile çalışır.
+
+> 📌 Bu depo Numex Codex'in **tanıtım, dokümantasyon ve topluluk** deposudur. Hata bildirimleri,
+> öneriler ve tartışmalar burada; sürümler [codex.numexai.com.tr](https://codex.numexai.com.tr)'den
+> indirilir. Açık kaynak SDK: [numex-sdk](https://github.com/mobilcep/numex-sdk).
+
+## 📑 İçindekiler
+
+- [Üç kapı, tek ajan](#-üç-kapı-tek-ajan)
+- [Hızlı başlangıç](#-hızlı-başlangıç)
+- [🏛️ Konsey — 4 uzman, tek görev](#️-konsey--4-uzman-tek-görev)
+- [Dört çalışma modu](#-dört-çalışma-modu)
+- [Kanıtsız "bitti" yok: FinishGate](#-kanıtsız-bitti-yok-finishgate)
+- [Codex IDE](#-codex-ide--numex-çözüm)
+- [Codex CLI](#️-codex-cli)
+- [Codex Web](#-codex-web)
+- [Şeffaf hafıza: `.numex/`](#-şeffaf-hafıza-numex)
+- [Güvenlik ve kontrol](#-güvenlik-ve-kontrol)
+- [Fiyat](#-fiyat)
+- [Dokümanlar](#-dokümanlar)
+
+---
+
+## 🚪 Üç kapı, tek ajan
+
+| | Nerede? | Kurulum | Kimin için? |
+|---|---|---|---|
+| 🧩 **Codex IDE** | Windows masaüstü | [İndir](https://codex.numexai.com.tr) — v2.9.59, ~162 MB, tamamen Türkçe | Günlük profesyonel geliştirme |
+| 🧩 **VS Code eklentisi** | Mevcut VS Code'un | Eklentiyi kur + CLI'ye giriş yap | Alışkanlığını bozmadan |
+| ⌨️ **Codex CLI** | Terminal | `npm i -g @numexai/cli` | Terminal, otomasyon, uzak sunucu, CI |
+| 🌐 **Codex Web** | Tarayıcı | Yok | Kurulumsuz, "sohbet eder gibi" hızlı proje |
+
+Hepsi aynı **Numex Çekirdeği**'ni kullanır: terminaldeki komut ile editördeki buton birebir aynı
+davranır. Programatik erişim için: [Numex SDK](https://github.com/mobilcep/numex-sdk).
+
+## ⚡ Hızlı başlangıç
+
+```console
+$ npm i -g @numexai/cli
+$ numex login
+✓ Giriş başarılı — hoş geldin 👋
+$ numex
+◇ Numex Codex — Türkçe kod ajanı hazır
+```
+
+![Numex Codex CLI açılış ekranı](gorseller/cli-codex-acilis.png)
+
+İlk görevini ver:
+
+```bash
+numex "koyu temalı, localStorage kullanan bir yapılacaklar uygulaması yap"
+```
+
+---
+
+## 🏛️ Konsey — 4 uzman, tek görev
+
+Çoğu kod ajanı tek bir modelin her şeyi aynı anda yapmasına dayanır: planlar, yazar, test eder ve
+"bitti" der — **kendi ödevini kendi notlandıran bir öğrenci** gibi. Codex'te karmaşık işler bir
+**Konsey**'e verilir; her üyenin tek bir işi ve sınırlı bir yetkisi vardır.
+
+| Üye | Görevi | Yazabilir mi? |
+|---|---|---|
+| 📐 **Mimar** | Klasör yapısı, veri modeli, dosya dosya fonksiyon planı | ❌ Sadece plan |
+| 💻 **Kodlayıcı** | Plana göre **tam ve çalışan** kodu yazar — iskelet, TODO yok | ✅ **Tek yazıcı** |
+| 🛡️ **Denetçi** | Önce *"doğru şeyi mi yaptık?"*, sonra test ve doğrulama | ❌ Sadece test/rapor |
+| 🎨 **Tasarımcı** | Arayüz ve kullanıcı deneyimi cilası | ⚠️ Sadece CSS/HTML |
+
+```mermaid
+flowchart LR
+    U([İstek]) --> A[📐 Mimar]
+    A --> C[💻 Kodlayıcı]
+    C --> H[🔁 Self-Healing]
+    H --> D[🛡️ Denetçi]
+    H --> T[🎨 Tasarımcı]
+    D -->|sorun| C
+    D --> G{🚦 FinishGate}
+    T --> G
+    G -->|kanıt ✓| OK([✅ Onay])
+    G -->|kanıt yok| H
+```
+
+- **Tek yazıcı kuralı:** Kodu yalnızca Kodlayıcı yazar; çakışma imkânsızdır.
+- **Konu sapması kontrolü:** Mimar'ın planı isteğinden saparsa Kodlayıcı planı değil **senin isteğini** esas alır.
+- **Doğru iş için doğru ekip:** Basit bir düzeltmede konsey toplanmaz; işin büyüklüğüne göre 0, 2, 3 ya da 4 üye çağrılır ve token bütçesi önceden kontrol edilir.
+- **Kendin çağır:** *"konseyi topla"*, *"ajanları çağır"*, *"ekibi topla"*, *"hep birlikte bak"*.
+- **Dürüst rapor:** Sonunda ne olduğunu düz Türkçe anlatan bir konsey raporu; çözülemeyen sorun varsa açıkça söylenir.
+
+👉 **Ayrıntılı anlatım: [Konsey nasıl çalışır?](docs/konsey.md)**
+
+![Codex IDE — Swarm fazında çalışan ajan](gorseller/codex-ide-ayarlar-swarm.png)
+
+---
+
+## 🔀 Dört çalışma modu
+
+| Mod | Ne yapar? | Örnek |
+|---|---|---|
+| 💬 **Sohbet** | Soru-cevap; dosya okur, açıklar, önerir | *"Bu proje ne yapıyor?"* |
+| 🗺️ **Plan** | Kod değiştirmeden mimari plan ve adım listesi | *"Ödeme modülü nasıl eklenir?"* |
+| 🤖 **Otonom** | Plan → onay → uygula → doğrula döngüsünü kendisi yürütür | *"Testleri yeşile çek"* |
+| 🐞 **Hata Avcısı** | Log, terminal çıktısı ve koddan kök nedeni bulur | *"Uygulama açılıyor ama ses yok"* |
+
+Her adım görünür: *"🔍 7 adım · 2 dosya okundu · 2 klasör tarandı · 63 eşleşme"*.
+
+## 🚦 Kanıtsız "bitti" yok: FinishGate
+
+Kod ajanlarının klasik hatası: *"Tamamlandı!"* deyip çalışmayan kod teslim etmek. Codex'te görev
+ancak **canlı kanıtla** kapanır:
+
+- ✅ Sunucu gerçekten **HTTP 200** dönüyor mu?
+- ✅ **Testler** geçiyor mu?
+- ✅ Tarayıcıda **DOM** beklenen öğeleri içeriyor mu? (Omni-Vision: headless tarayıcıyla görsel kontrol)
+
+Kanıt yoksa ajan **Self-Healing** döngüsüne döner: sözdizimi, yapı, veri bütünlüğü ve parantez
+dengesi kontrol edilir, hata düzeltilir, tekrar denenir. Ajan takılırsa **StuckDetector** devreye
+girip sana ya da web aramasına döner.
+
+---
+
+## 🧩 Codex IDE — "Numex Çözüm"
+
+VS Code tabanlı masaüstü editör. Sağ paneldeki asistanın adı **Numex Çözüm**.
+
+| | |
+|---|---|
+| ✍️ **Satır içi düzenleme** | `Ctrl+K` → *"bunu async yap"* |
+| ⏭️ **Sonraki düzenleme** | Bir değişiklik yaparsın, ilgili sonraki yeri tahmin eder → `Tab` |
+| 🔍 **Kod Lens** | Her fonksiyonun üstünde `◆ Numex: … hakkında sor` |
+| 🧠 **Anlamsal arama** | *"Ödeme nerede doğrulanıyor?"* — embedding indeksiyle |
+| 🖼️ **Görselden arayüz** | Ekran görüntüsü → çalışan kod |
+| 🖥️ **Terminal** | Doğal dilden komut üret · terminal çıktısını sohbete gönder |
+| 🔀 **Git** | Commit mesajı üret · değişiklikleri AI ile incele · PR aç |
+| 🤖 **Ajanlar** | Arka plan ajanı · bulut ajanı · gömülü tarayıcı · Design Mode · Composer |
+| 🌍 **Uzak** | SSH ve WSL ile uzak sunucuya bağlan |
+| ⚙️ **Ayarlar** | Model & sağlayıcı · sohbet & onay · **Mizah Modu** · RAG · tema · token kullanımı |
+
+![Agent diff görünümü](gorseller/agent-diff.png)
+
+Tüm komutlar ve kısayollar: **[docs/komutlar.md](docs/komutlar.md)**
+
+## ⌨️ Codex CLI
+
+```bash
+numex                                  # terminal sohbeti
+numex "görev"                          # tek seferlik görev
+numex plan "ödeme modülü ekle"         # sadece plan, kod değişmez
+numex mission "testleri yeşile çek"    # izole çalışma alanında uzun otonom misyon
+numex undo                             # son turu tek tıkla geri al
+numex --offline "…"                    # yerel Ollama ile internetsiz
+/model fast | pro | code               # profili kilitle
+```
+
+- ✂️ **Cerrahi yama** — dosyayı baştan yazmaz, diff parçalarıyla hedefli değişiklik
+- 🛰️ **Subshell yakalama** — arka plandaki npm/vite/node hatalarını ~2 sn'de yakalar, toparlanır
+- 🌳 **Canlı ağaç ilerlemesi** — görev adımları ağaç görünümünde
+- 🔎 **BM25 + AST** kod indeksi · 🔌 **MCP** istemcisi (dosya sistemi, git)
+
+### 📱 Uzaktan PC — telefondan bilgisayarına
+
+```bash
+numex uzak install    # arka plan köprüsü; terminal kapansa da çalışır, sistem tepsisinde ikon
+```
+
+Sonra **numexai.com.tr/developers/remote** sayfasından Google ile giriş yap, yeşil noktalı PC'ni seç,
+yaz: klasör oluştur, dosya yaz, komut çalıştır.
+
+| | |
+|---|---|
+| ![numex menüsü](gorseller/cli-menu.png) | ![Uzaktan CLI bağlandı](gorseller/uzak-cli-baglandi.png) |
+
+![Tarayıcıdan PC'ye komut](gorseller/uzak-cli-web.png)
+
+## 🌐 Codex Web
+
+> *"Chat kutusuna ne istediğini yaz. Agent dosyaları otomatik oluşturur, editöre yazar, önizlemeyi
+> günceller. Tek buton yok, tek tıklama yok — sadece yaz ve izle."*
+
+- Solda dosya gezgini + **Monaco** editörü, sağda ajan sohbeti, altta terminal, ayrı önizleme
+- Şablonlar: Başlangıç · Todo · Hesap · Dashboard · E-ticaret · Blog · Manav
+- Hedef platform (Web / API / Masaüstü) ve proje türü (Muhasebe, POS, Oyun, E-ticaret…) seçimi
+- Ajan değişiklik kartı: **Kabul Et / Fark / Reddet**
+- Kaydet · ZIP indir · URL'den aç · **🚀 Yayınla** — tek tıkla herkese açık adres
+
+![Codex Web rehberi](gorseller/codex-rehber.png)
+
+---
+
+## 🧠 Şeffaf hafıza: `.numex/`
+
+Codex ne bildiğini ve ne yaptığını gizlemez. Her projede **okunabilir** bir `.numex/` klasörü tutar:
+RAG indeksi, **denetim izi** (`audit-trail.jsonl`), geri alma noktaları, öğrenilen hatalar, misyon
+durumu ve token kullanımı. Projeye döndüğünde ajan kaldığı yerden devam eder.
+
+👉 [docs/numex-klasoru.md](docs/numex-klasoru.md)
+
+## 🔐 Güvenlik ve kontrol
+
+- **Önce anlaşalım, sonra yapalım:** Otonom modda bile plan sunar ve onay alır.
+- **Diff önizleme:** Her değişiklik kabul/ret için gösterilir.
+- **Geri alma:** `numex undo`, `.numex/checkpoints`.
+- **Denetim izi:** Ajanın çalıştırdığı her komut ve yaptığı her değişiklik kayıtlı.
+- **Kendi bilgisayarında:** Ajan dosyalarını senin makinende işler; veriler Türkiye'de, KVKK uyumlu altyapı.
+
+## 💳 Fiyat
+
+| Plan | Codex erişimi |
+|---|---|
+| Ücretsiz | Temel CLI |
+| Başlangıç PRO — ₺99/ay | Tam CLI |
+| **Numex PRO — ₺399/ay** | Tam CLI + API, 128K bağlam, öncelikli kuyruk |
+| Advanced — ₺599/ay | Tam CLI + tam API, 3 hesap, canlı destek |
+
+Kota bitince **Numex Kredisi**; abonelik istemeyenlere **zaman bileti** (8 saat ₺29'dan).
+Güncel fiyatlar: [numexai.com.tr](https://numexai.com.tr).
+
+## 📚 Dokümanlar
+
+| | |
+|---|---|
+| 🏛️ [Konsey nasıl çalışır?](docs/konsey.md) | 4 uzman, bütçe seviyeleri, FinishGate, konsey raporu |
+| ⌨️ [Komutlar ve kısayollar](docs/komutlar.md) | CLI komutları, IDE komut paleti |
+| 🧠 [.numex klasörü](docs/numex-klasoru.md) | Ajanın şeffaf hafızası |
+| 🌐 [Numex ekosistemi](https://github.com/mobilcep/numex_nedir) | Numex Ailesi'nin tamamı |
+| 🧰 [Numex SDK](https://github.com/mobilcep/numex-sdk) | Codex'i kendi kodundan çalıştır |
+
+## 🤝 Topluluk
+
+- 🐞 Hata mı buldun? → [Hata bildir](../../issues/new/choose)
+- 💡 Fikrin mi var? → [Özellik isteği](../../issues/new/choose)
+- 💬 Codex ile ne yaptın? → [Discussions](../../discussions)
+- 🔒 Güvenlik açığı → **destek@numexai.com.tr** (lütfen herkese açık issue açma)
+
+<div align="center">
+
+---
+
+**Numex Codex** · [Numex Ailesi](https://www.numexai.com.tr/aile)'nin geliştirici kapısı<br>
+*İnsanı önce koyan Türk yapay zekâsı* 🇹🇷
+
+</div>

docs/komutlar.md

@@ -0,0 +1,83 @@
+# ⌨️ Komutlar ve Kısayollar
+
+## Codex CLI
+
+| Komut | Açıklama |
+|---|---|
+| `numex` | Etkileşimli terminal sohbeti (REPL) |
+| `numex basla` | Giriş + başlangıç menüsü (terminal sohbeti / web'den PC kontrolü) |
+| `numex login` | Tarayıcı onaylı cihaz girişi |
+| `numex "<görev>"` | Tek seferlik görev |
+| `numex plan "<görev>"` | Mimar planlayıcı — kod değiştirmez |
+| `numex mission "<görev>"` | İzole sandbox çalışma alanlarında uzun süreli otonom misyon |
+| `numex undo` | Son turu geri al |
+| `numex --devam` | Son oturumdan devam et |
+| `numex --offline "<görev>"` | Yerel Ollama ile internetsiz çalış |
+| `numex --api-key nx_live_…` | API anahtarı tanımla |
+| `numex --version` | Sürüm |
+| `numex uzak` | Uzaktan PC köprüsünü başlat (terminal açık kalır) |
+| `numex uzak install` | Köprüyü arka plan servisi olarak kur (sistem tepsisi) |
+| `numex uzak pause` | Köprüyü duraklat |
+
+### REPL içi komutlar
+
+| Komut | Açıklama |
+|---|---|
+| `/yardim` | Yardım |
+| `/cikis` | Çıkış |
+| `/model fast \| pro \| code` | Aktif profili kilitle |
+| `/proje "C:\yol\proje"` | Belirli bir projeye geç (proje hafızası yüklenir) |
+
+### Konseyi çağırma ifadeleri
+*"konseyi topla"* · *"ajanları çağır"* · *"ekibi topla"* · *"takımı çağır"* · *"herkesi topla"* ·
+*"hep birlikte bak"* · *"swarm council"*
+
+## Codex IDE / VS Code eklentisi
+
+### Kısayollar
+
+| Kısayol | İşlev |
+|---|---|
+| `Ctrl+Alt+M` | Sohbeti aç/kapat |
+| `Ctrl+Alt+N` | Seçimi sor |
+| `Ctrl+K` | Satır içi düzenle |
+| `Tab` | Sonraki düzenleme önerisini uygula |
+
+### Komut paleti (`Ctrl+Shift+P` → "Numex")
+
+| Grup | Komutlar |
+|---|---|
+| **Başlangıç** | Hoş Geldiniz · Bu klasörde çalış · Çalışma klasörü seç / sıfırla · Giriş / Çıkış |
+| **Sohbet** | Sohbeti Aç/Kapat · Sohbet Paneli · Yeni Sohbet · Sohbet Geçmişi · Transkripti Dışa Aktar · Son Yanıtı Tekrar Üret |
+| **Kod** | Seçimi Sor · Bu Dosya Hakkında Sor · Seçimi Açıkla · Kod Lens Sorgusu · Satır-içi Düzenle · Sonraki Düzenlemeyi Uygula / Kapat · Dosyadaki Hataları AI ile Düzelt · Composer |
+| **Kod tabanı** | Projeyi İndeksle · Yeniden İndeksle (leksikal) · Anlamsal Aramayı Aç · Kod Tabanında Ara |
+| **Görsel** | Ekran Görüntüsü Al ve Sohbete Ekle · Tarayıcıyı Aç · Design Mode |
+| **Terminal** | Terminal Komutu Üret (doğal dil) · Terminal Çıktısını Sohbete Gönder |
+| **Git** | Commit Mesajı Üret · Değişiklikleri İncele (AI) · Pull Request Aç |
+| **Ajanlar** | Otonom Modu Aç/Kapat · Arka Plan Ajanı · Bulut Ajanı |
+| **Uzak** | Uzak Sunucuya Bağlan · SSH ile Bağlan · WSL ile Bağlan |
+| **Diğer** | Ayarlar · Ekran Dilini Seç · Güncellemeleri Denetle · Destek / Hata Bildir |
+
+### Eklenti ayarları
+
+| Ayar | Varsayılan | Açıklama |
+|---|---|---|
+| `numex.command` | `numex` | CLI komutu veya tam yolu |
+| `numex.extraArgs` | — | REPL başlatma argümanları (ör. `--yolo --lint`) |
+
+## Codex Web
+
+| Kısayol | İşlev |
+|---|---|
+| `Ctrl+N` / `Ctrl+Shift+N` | Yeni proje / yeni dosya |
+| `Ctrl+O` | Proje aç |
+| `Ctrl+S` / `Ctrl+Shift+S` | Kaydet / tümünü kaydet |
+| `Ctrl+Shift+P` | Yayınla |
+| `Ctrl+K` | Komut paleti |
+| `Ctrl+B` | Dosya gezgini |
+| `Ctrl+F` / `Ctrl+H` | Bul / değiştir |
+| `F11` | Tam ekran |
+| `Ctrl+Shift+K` | Klavye kısayolları |
+
+---
+← [Ana sayfa](../README.md)

docs/konsey.md

@@ -0,0 +1,156 @@
+# 🏛️ Numex Konseyi — 4 Uzman, Tek Görev
+
+> *"Kullanıcı tek bir istek atar; arka planda 4 uzman ajan toplanır, tartışır ve kanıtlanmış bir sonuç üretir."*
+
+Çoğu kod ajanı tek bir modelin her şeyi aynı anda yapmasına dayanır: planlar, yazar, test eder ve
+"bitti" der. Bu, **kendi ödevini kendi notlandıran bir öğrenciye** benzer. Numex Codex'te karmaşık
+işler bunun yerine bir **Konsey**'e (Swarm Council) verilir. Her üyenin tek bir işi ve **sınırlı bir
+yetkisi** vardır.
+
+---
+
+## 👥 Konsey üyeleri
+
+| Üye | Görevi | Yetkisi | Yazabilir mi? |
+|---|---|---|---|
+| 📐 **Mimar** | Klasör yapısını, veri modelini ve dosya listesini çizer; her dosya için fonksiyonları ve parametreleri tek tek planlar | Sadece okuma + plan | ❌ Sadece öneri |
+| 💻 **Kodlayıcı** | Mimar'ın planına göre **tam ve çalışan** kodu yazar | Okuma + yazma | ✅ **Tek yazıcı** |
+| 🛡️ **Denetçi** | Yazılanı okur, test eder, açıkları bulur, doğrular | Okuma + komut | ❌ Sadece test/rapor |
+| 🎨 **Tasarımcı** | Arayüzü ve kullanıcı deneyimini cilalar | Okuma + yazma (yalnızca CSS/HTML) | ⚠️ Sadece arayüz dosyaları |
+
+### Altın kural: aynı anda tek yazıcı
+Kodu **yalnızca Kodlayıcı** yazar. Diğerleri okur ve eleştirir; Tasarımcı sadece CSS/HTML'e dokunur,
+JavaScript mantığına karışmaz. Böylece iki ajanın aynı dosyayı aynı anda değiştirmesi (race
+condition) baştan imkânsızdır.
+
+### Her üyenin "yapmayacağı" da tanımlı
+- **Mimar kod yazmaz, doğrulama yapmaz.** Plan yapar ve bitirir. Plan belirsizse bu başarısızlık
+  sayılır: *"Vague plan = BAŞARISIZ."*
+- **Kodlayıcı boşluğu uydurmaz.** Görev belirsizse kafasından bir proje icat etmek yerine
+  *"GÖREV BELİRSİZ: [ne eksik]"* diye durur. Asla iskelet, `TODO` ya da yer tutucu kod bırakmaz.
+- **Denetçi dosyalara yazamaz.** Okur ve rapor verir — tarafsız kalması için.
+- **Tasarımcı sunucuyu başlatıp durdurmaz**, iş mantığını değiştirmez.
+
+---
+
+## 🔄 Konsey nasıl çalışır?
+
+```mermaid
+flowchart TD
+    U([👤 Senin isteğin]) --> B{🎚️ Karmaşıklık<br/>ve bütçe değerlendirmesi}
+    B -->|basit| S[Tek ajan<br/>hızlı düzeltme]
+    B -->|orta / karmaşık| A[📐 Mimar<br/>plan + dosya yapısı]
+    A --> K{Plan görevle<br/>örtüşüyor mu?}
+    K -->|hayır| C2[Kodlayıcı planı yok sayar,<br/>orijinal isteği esas alır]
+    K -->|evet| C[💻 Kodlayıcı<br/>kodu yazar]
+    C2 --> H
+    C --> H[🔁 Self-Healing<br/>kendi hatalarını düzeltir]
+    H --> D[🛡️ Denetçi<br/>görev uyumu + test]
+    H --> T[🎨 Tasarımcı<br/>arayüz cilası]
+    D -->|sorun var| C
+    D -->|temiz| G{🚦 FinishGate<br/>canlı kanıt var mı?}
+    T --> G
+    G -->|HTTP 200 · test · DOM ✓| OK([✅ Onaylandı])
+    G -->|kanıt yok| H
+```
+
+1. **Değerlendirme.** İstek bir karmaşıklık seviyesine yerleştirilir; kaç üyenin çağrılacağına ve
+   token bütçesine göre karar verilir (aşağıdaki tablo).
+2. **Plan.** Mimar ayrıntılı bir plan çıkarır.
+3. **Konu sapması kontrolü.** Mimar'ın planı gerçekten istenen şey mi? Tek satırlık hızlı bir yapay
+   zekâ yargısıyla kontrol edilir. Plan konudan saparsa Kodlayıcı planı görmezden gelir ve **senin
+   orijinal isteğini** esas alır.
+4. **Yazım + Self-Healing.** Kodlayıcı yazar; sözdizimi, yapı, veri bütünlüğü, parantez dengesi
+   kontrol edilir ve Kodlayıcı kendi hatalarını düzeltir.
+5. **Denetim ve cila (paralel).** Denetçi test ederken Tasarımcı arayüzü cilalar.
+6. **Geri bildirim döngüsü.** Denetçi sorun bulursa iş Kodlayıcı'ya döner. Sonsuz döngüye girmemek
+   için tur sayısı sınırlıdır; sınır aşılırsa sana sorulur.
+7. **FinishGate.** Görev ancak **canlı kanıtla** kapanır: sunucu HTTP 200 dönüyor, testler geçiyor,
+   tarayıcıda DOM beklenen öğeleri içeriyor.
+
+---
+
+## 🎚️ Her iş için doğru ekip
+
+*"Bir el arabası toprak için kepçe + kamyon + formen çağrılmaz."* Konsey, token maliyeti 4 kata
+çıkabileceği için sadece gerektiğinde toplanır:
+
+| Seviye | Örnek | Çağrılan üyeler | Düzeltme turu | Tahmini token |
+|---|---|---|---|---|
+| **Basit (trivial)** | *"başlığı değiştir"* | — (tek ajan) | 0 | ~500 |
+| **Kolay** | *"tek dosyada şu fonksiyonu düzelt"* | Kodlayıcı + Denetçi | 1 | ~3.000 |
+| **Orta** | Birkaç modüllük özellik | Mimar + Kodlayıcı + Denetçi | 2 | ~7.500 |
+| **Karmaşık** | *"frontend + backend + veritabanlı sistem"* | Tam konsey (4 üye) | 2 | ~15.000 |
+| **Kurumsal** | *"komple, tüm modüller, mikroservis"* | 4 üye + ek denetim turu | 3 | ~30.000 |
+
+Bütçe yetmiyorsa konsey başlamadan önce söylenir: *"Yetersiz token bütçesi (Kalan: …, Gerekli: …)"*.
+
+### Konsey ne zaman toplanmaz?
+- **Hedefli düzeltmede:** *"modal kapanmıyor"*, *"şu butonu düzelt"* → 15 dakikalık senfoni değil,
+  neşter.
+- **Tek dosyalık işte:** *"tek bir index.html yap"* → tek ajan parça parça yazar.
+- **Sadece uzun anlattığında:** Uzun ve samimi bir anlatım (ör. *"kızım için bir org uygulaması…"*)
+  tek başına "karmaşık" sayılmaz; gerçek bir teknik karmaşıklık işareti gerekir (mimari, sistem,
+  backend, veritabanı…).
+
+### Konseyi kendin çağırmak
+İstediğin an konseyi çağırabilirsin — bu, otomatik karmaşıklık kararını atlar:
+
+> *"konseyi topla"* · *"ajanları çağır"* · *"ekibi topla"* · *"takımı çağır"* · *"herkesi topla"* ·
+> *"hep birlikte bak"* · *"swarm council"*
+
+Tersine, ayarlardan konsey modunu tamamen kapatabilirsin.
+
+---
+
+## 🛡️ Denetçi'nin ilk sorusu: "Doğru şeyi mi yaptık?"
+
+Temiz kod her zaman doğru kod değildir. Numex'in canlı testlerinde bir *"Proje Sağlık Kontrolü CLI"*
+isteğinin tamamen alakasız ama kusursuz yazılmış bir *"Hafıza Kartları"* oyununa dönüştüğü
+görülmüştü — ve kod iç tutarlılık açısından mükemmel olduğu için fark edilmemişti.
+
+Bu yüzden Denetçi'nin **ilk** işi, tek bir dosya bile okumadan önce **görev uyum kontrolü**dür:
+
+> *"Kod ne kadar temiz olursa olsun, YANLIŞ ŞEYİN temiz kodu bir BAŞARISIZLIKTIR."*
+
+---
+
+## 📜 Konsey raporu
+
+Her konsey çalışmasının sonunda ne olduğunu düz Türkçe ile anlatan bir özet görürsün:
+
+```
+🏛️ Konsey birlikte çalıştı:
+Mimar önce bir plan hazırladı, Kodlayıcı bu planı takip etti.
+Kodlayıcı uygulamayı yazdı ve 1 self-healing turunda kendi çıkardığı hataları kendi düzeltti.
+Denetçi işi inceledi, sorun buldu; Kodlayıcı bunları 1 turda düzeltti, Denetçi tekrar kontrol edip onayladı.
+Tasarımcı son olarak arayüzü gözden geçirip cilaladı.
+✅ Sonuç: tüm kontroller geçti, onaylandı.
+```
+
+Bir şey çözülemediyse bunu da açıkça söyler: *"🚫 Sonuç: 2 sorun hâlâ çözülmeden kaldı, gözden
+geçirilmeli."* Numex başarısızlığı başarı gibi göstermez.
+
+---
+
+## 🏗️ Scaffold Konseyi
+
+Sıfırdan yeni bir ürün iskeleti kurulurken aynı dört rolün **iskelet versiyonları** çalışır:
+**Scaffold Mimarı**, **Scaffold Kodcusu**, **Scaffold Denetçisi** ve **Scaffold Tasarımcısı**.
+Sonuçları tek bir alan şemasında (veri modeli + API + arayüz) birleştirilir.
+
+---
+
+## 🎯 Neden önemli?
+
+| Tek ajan | Numex Konseyi |
+|---|---|
+| Kendi planını kendi onaylar | Plan, konu sapmasına karşı ayrıca kontrol edilir |
+| Kendi kodunu kendi test eder | Yazamayan, tarafsız bir Denetçi test eder |
+| "Bitti!" der | FinishGate canlı kanıt ister |
+| Her iş için aynı maliyet | İşin büyüklüğüne göre ekip ve bütçe |
+| Ne yaptığı belirsiz | Düz Türkçe konsey raporu + `.numex/audit` kaydı |
+
+---
+
+← [Ana sayfa](../README.md) · [Komutlar](komutlar.md) · [.numex klasörü](numex-klasoru.md)

docs/numex-klasoru.md

@@ -0,0 +1,31 @@
+# 🧠 `.numex/` — Ajanın Şeffaf Hafızası
+
+Codex, her projede **açık ve okunabilir** bir `.numex/` klasörü tutar. Ajanın ne bildiği ve ne
+yaptığı bir kara kutuda değil, **senin diskinde, düz dosyalarda** durur.
+
+| Dosya / klasör | İçerik |
+|---|---|
+| `rag/index.json` · `rag/graph.json` · `rag/symbols.json` · `rag/summary.md` | Kod tabanı indeksi, bağımlılık grafiği, sembol tablosu, proje özeti |
+| `audit/audit-trail.jsonl` | Ajanın yaptığı **her işlemin** zaman damgalı denetim kaydı |
+| `checkpoints/stack.json` · `checkpoints/redo.json` | Geri al / yinele noktaları (`numex undo`) |
+| `mission-state.json` · `async-tasks.json` | Süren otonom misyonlar ve arka plan görevleri |
+| `agent-registry.json` · `services.json` | Kayıtlı ajanlar ve çalışan servisler (ör. geliştirme sunucusu) |
+| `learned-errors.json` · `rag/error-kb-local.json` | Bu projede öğrenilen hatalar ve çözümleri |
+| `chronicle.jsonl` · `digest.md` | Oturum günlüğü ve özet |
+| `project-map-cache.json` | Proje haritası önbelleği |
+| `telemetry/token-usage.jsonl` · `sessions/*-usage.json` | Token kullanımı |
+| `economy-state.json` | Bütçe / maliyet durumu |
+| `logs/` | Ajan logları |
+
+## Neden önemli?
+
+- **Denetlenebilirlik:** "Dün bu projeye ne oldu?" → `audit-trail.jsonl`.
+- **Süreklilik:** Projeyi kapatıp açtığında ajan projeyi yeniden öğrenmez, kaldığı yerden devam eder.
+- **Öğrenme:** Aynı hatayı ikinci kez yaşamamak için çözümler projeye özel saklanır.
+- **Sahiplik:** Hafıza senin projende; istersen okursun, istersen silersin.
+
+> İpucu: `.numex/` klasörünü `.gitignore`'a ekleyebilir ya da ekip arkadaşlarınla indeksi paylaşmak
+> için bazı dosyalarını depoda tutabilirsin.
+
+---
+← [Ana sayfa](../README.md)