agent-enderun 1.1.9 → 1.10.0

package/README.md

@@ -1,6 +1,6 @@
-# 🏛️ Agent Enderun — Enterprise AI Governance & Autonomous Orchestration Framework
+# 🏛️ Agent Enderun — The Supreme AI Governance & Autonomous Orchestration Framework
 
-> **Stable Release:** v1.1.9 (Enterprise Orchestration Ready) — Build Compile: Clean | Type-Safety: 100% Verified | AL Compliance: 13/13 Agents
+> **Stable Release:** v1.10.0 (Enterprise Orchestration Ready) — Build Compile: Clean | Type-Safety: 100% Verified | AL Compliance: 13/13 Agents
 
 > **Author:** Yusuf BEKAR
 > **Trace ID:** `01HGT8J5E2N0W0W0W0W0W0W0W5`
@@ -10,7 +10,7 @@
 
 ## 🇹🇷 TÜRKÇE — Proje Tanıtımı & Detaylı Kullanım Kılavuzu
 
-**Agent Enderun**, sıradan bir kod şablon üreteci veya basit bir AI asistanı değildir; karmaşık, ölçeklenebilir ve kurumsal (enterprise) düzeydeki yazılım projeleri için özel olarak tasarlanmış bir **Yapay Zeka Yönetişimi ve Otonom Ordu Komuta Sistemidir**.
+**Agent Enderun**, Kurumsal Gelişim için En Üstün Yapay Zeka Yönetişimi ve Otonom Orkestrasyon Çerçevesidir. Kurumsal Yapay Zeka Yönetim Asistanı olarak görev yapar. Sıradan bir kod şablon üreteci veya basit bir AI asistanı değildir; karmaşık, ölçeklenebilir ve kurumsal (enterprise) düzeydeki yazılım projeleri için özel olarak tasarlanmış bir **Yapay Zeka Yönetişimi ve Otonom Ordu Komuta Sistemidir**.
 
 Güncel sürüm itibarıyla sistem; **@-mention delegasyon**, **doğal dil rotalama**, **Kurumsal CRUD Yönetişimi** ve **Hermes Kilit Protokolü** ile güçlendirilmiş; kendi hafızasını yönetebilen, monorepo proje yollarını dinamik olarak haritalayan, tüm ajan seanslarını güvenli şekilde günlükleyen, farklı yapay zeka ekosistemlerini anayasal bir disiplin altında birleştiren, **Agent Lifecycle (AL) tam uyumlu init ve ordu validasyonunu** (npm kurulumu sonrası dahil) otomatikleştiren, **harici IDE entegrasyonlarında (Claude Desktop/Cursor vb.) mutlak proje kök dizini (CWD) uyumluluğu sunan**, **scaffold adımlarında ajan klasörlerini adapter tipine göre dinamik olarak eşleyen** ve **macOS & Windows çapraz platform standartlarına tam uyum sağlayan** yaşayan bir mühendislik organizmasıdır. Karmaşık kurumsal projeler için optimize edilmiştir (corporate-governance SOP'ları ile).
 
@@ -31,13 +31,9 @@ Yapay zeka kodlama yardımcıları (Claude Code, Gemini CLI, Grok Build vb.) gel
 
 ### 📦 Güncel Sürüm / Current Release
 
-**v1.1.7** — Modülerleşme & Test Kararlı Sürümü.
-*   **TR:** 850+ satırlık devasa `app.ts` dosyası 5 ayrı alt modüle bölünerek modülerleştirildi. `ServiceContainer` ve `Hermes` protokolü için kapsamlı birim testleri yazıldı. Ek olarak, ajanlar için **Mobil-First akıcı responsive (Grid/Flex, dvh/dvw, 44px dokunmatik hedef, yazı tipi ölçekleme koruması)** standartları tanımlandı ve `antigravity-cli` adaptörü dizin çelişkisi çözüldü.
-*   **EN:** Refactored `app.ts` into 5 sub-modules. Added unit tests for `ServiceContainer` and `Hermes` message loop. Implemented strict **Mobile-First fluid responsive design standards (Grid/Flex, dvh/dvw, 44dp touch targets, font scaling safeguards)** for agents and consolidated the `antigravity-cli` adapter directory structure.
-
-**v1.1.6** — Enterprise 1.0 kararlı sürüm (@-mentions, NL Routing, Hermes Lock Protocol, CWD/Scaffold fix, Token Tracker).
-*   **TR:** Kilitlerin 10s sonrasında otomatik çözülmesi (Stale Lock breaking), opsiyonel Panda CSS yapılandırması ile esnek sağlık denetimi, `config.json` içinde dinamik sürüm yönetimi ve Hermes mesaj durumunun güncellenerek sonsuz döngünün önlenmesi sağlandı.
-*   **EN:** Implemented stale lock breaking after 10s, optional Panda CSS configuration for flexible health checks, dynamic config versioning from package metadata, and message status updates to prevent infinite loops in the Hermes messaging broker.
+**v1.10.0** — Kararlı Sürüm (Dinamik Mobil Scaffolding & Performans).
+*   **TR:** Mobil (Expo/React Native) uygulama üretme desteği eklendi. Orkestrasyon döngüsü bellek içi önbellekleme (in-memory cache) ile optimize edildi. Nizam denetimi (`check`) ajan dökümantasyonunu kapsayacak şekilde genişletildi.
+*   **EN:** Added Mobile (Expo/React Native) scaffolding support. Optimized orchestration loop with in-memory caching. Expanded discipline check (`check`) to audit agent documentation.
 
 ---
 
@@ -121,14 +117,34 @@ xAI Grok Build veya topluluk CLI araçları için:
 npx agent-enderun init grok
 ```
 
-#### 4. Antigravity Adaptörü Kurulumu
-Antigravity IDE ve CLI entegrasyonlerini etkinleştirmek için:
+#### 4. Cursor Adaptörü Kurulumu
+Cursor IDE kuralları ve MCP entegrasyonu için:
 ```bash
-npx agent-enderun init antigravity
+npx agent-enderun init cursor
+```
+
+#### 5. Codex (GitHub Copilot) Adaptörü Kurulumu
+VSCode ve GitHub Copilot özel talimatları için:
+```bash
+npx agent-enderun init codex
+```
+
+#### 6. Antigravity Adaptörü Kurulumu
+Antigravity IDE ve CLI entegrasyonlarını etkinleştirmek için:
+```bash
+npx agent-enderun init antigravity-cli
 ```
 
 ---
 
+### 🧠 Mimari Yapı: Beyin & Hafıza Merkezi (.enderun)
+
+Sistem artık tüm zekasını ve persistence verilerini projenin kök dizininde kalabalık yapmadan **`.enderun/`** klasörü altında toplar:
+
+*   **`.enderun/memory/`**: `state.json`, `status.json` ve aktif görevler (`tasks/`).
+*   **`.enderun/knowledge/`**: Kurumsal standartlar ve ESLint kuralları.
+*   **`.enderun/ENDERUN.md`**: Proje anayasası ve disiplin kuralları.
+
 ### 🕹️ CLI Komut Referansı ve Parametreleri
 
 Enderun CLI, `agent-enderun` (veya `npx agent-enderun`) komutu ile yönetilir.
@@ -141,7 +157,7 @@ Enderun CLI, `agent-enderun` (veya `npx agent-enderun`) komutu ile yönetilir.
 *   **`orchestrate` / `loop`**: Hermes Message Broker asenkron event-driven ajanlar arası iletişim döngüsünü canlı olarak başlatır.
 *   **`verify-contract`**: Frontend ve backend katmanları arasındaki tip bütünlüğünü denetler.
 *   **`update-contract`**: Backend tiplerinde yapılan değişiklikleri tarayarak `contract.version.json` üzerindeki SHA-256 hash imzalarını günceller.
-*   **`create-app [idea]`**: Doğal dildeki açıklamalardan, kurumsal standartlarda kontrat-tabanlı monorepo uygulaması üretir.
+*   **`create-app [idea]`**: Doğal dildeki açıklamalardan; kurumsal standartlarda **Web, Mobil (Expo/React Native) veya Backend** tabanlı kontrat-tabanlı monorepo uygulaması üretir.
 *   **`approve [traceId]`**: Ajanlar tarafından gönderilen idari veya yüksek riskli işlemleri (şema değişiklikleri, toplu silme vb.) doğrulamak ve onaylamak için insan denetçi (Human-in-the-Loop) onay komutudur.
 
 ---
@@ -173,7 +189,7 @@ npx agent-enderun init gemini --unified
 
 ## 🇺🇸 ENGLISH — Detailed Product Guide & Documentation
 
-**Agent Enderun** is not a generic boilerplate generator or a simple AI wrapper; it is an elite, state-of-the-art **AI Governance and Autonomous Army Command System** designed for complex, scalable, and highly auditable enterprise software projects.
+**Agent Enderun** is the Supreme AI Governance & Autonomous Orchestration Framework for Enterprise Development. It acts as a Corporate AI Management Assistant. It is not a generic boilerplate generator or a simple AI wrapper; it is an elite, state-of-the-art **AI Governance and Autonomous Army Command System** designed for complex, scalable, and highly auditable enterprise software projects.
 
 The framework operates as a **"Living Engineering Organism"** capable of managing its own persistent memory, dynamically mapping project directory scopes, secure-logging expert agent activities, **automatically enforcing Agent Lifecycle (AL) compliance on every init**, **resolving absolute project root paths (CWD) dynamically for external assistant tools (e.g. Claude Desktop/Cursor)**, **enforcing Corporate CRUD & Admin Governance rules**, **providing atomic concurrency safety via Hermes Lock Protocol**, **mapping agent scaffolding subdirectories to adapter-specific folders dynamically during init**, and **fully complying with cross-platform (macOS & Windows) scripting and standard setups**. Low-usage reference materials arranged (knowledge files, demo scripts, observability placeholders marked). Bloat removed. Optimized for complex corporate/enterprise projects via corporate-governance knowledge and SOPs.
 
@@ -194,9 +210,9 @@ As AI coding assistants (Claude Code, Gemini CLI, Grok Build, etc.) become incre
 
 ### 📦 Current Release / Güncel Sürüm
 
-**v1.1.6** — AL Enterprise Compliance stable (full cross-adapter & npm install support for remaps + validator resolution, with surgical fixes for CWD environment, dynamic folder scaffolding, and token tracker).
-*   **EN:** Implemented stale lock breaking after 10s, optional Panda CSS configuration for flexible health checks, dynamic config versioning from package metadata, and message status updates to prevent infinite loops in the Hermes messaging broker.
-*   **TR:** Kilitlerin 10s sonrasında otomatik çözülmesi (Stale Lock breaking), opsiyonel Panda CSS yapılandırması ile esnek sağlık denetimi, `config.json` içinde dinamik sürüm yönetimi ve Hermes mesaj durumunun güncellenerek sonsuz döngünün önlenmesi sağlandı.
+**v1.10.0** — Stable Release (Dynamic Mobile Scaffolding & Performance).
+*   **EN:** Added Mobile (Expo/React Native) scaffolding support. Optimized orchestration loop with in-memory caching. Expanded discipline check (`check`) to audit agent documentation.
+*   **TR:** Mobil (Expo/React Native) uygulama üretme desteği eklendi. Orkestrasyon döngüsü bellek içi önbellekleme (in-memory cache) ile optimize edildi. Nizam denetimi (`check`) ajan dökümantasyonunu kapsayacak şekilde genişletildi.
 
 ---
 
@@ -301,10 +317,10 @@ Execute commands via `agent-enderun` (or `npx agent-enderun`):
 *   **`orchestrate` / `loop`**: Launch the Hermes live event-driven message-routing loop for asynchronous agent synchronization.
 *   **`verify-contract`**: Perform a contract audit to ensure frontend types match backend schemas.
 *   **`update-contract`**: Re-calculate type definitions and update `contract.version.json` with a new SHA-256 hash.
-*   **`create-app [idea]`**: Autonomously generate a full-stack monorepo project starter based on natural language inputs.
+*   **`create-app [idea]`**: Autonomously generate a full-stack monorepo, **Web, Mobile (Expo/React Native), or Backend** project starter based on natural language inputs.
 *   **`approve [traceId]`**: Human-in-the-Loop command to sign off and approve high-risk/administrative tasks requested by agents.
 
 
 ---
 
-Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.1.7 (Final Clean)** — Low-usage items arranged as reference-only. Bloat removed. Corporate-ready.
+Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.10.0 (Final Clean)** — Low-usage items arranged as reference-only. Bloat removed. Corporate-ready.

package/bin/cli.js

@@ -2,12 +2,19 @@
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+import fs from "node:fs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 const cliPath = join(__dirname, "../dist/src/cli/index.js");
 
+if (!fs.existsSync(cliPath)) {
+    process.stderr.write("\n❌ Error: Compiled CLI not found at 'dist/src/cli/index.js'\n");
+    process.stderr.write("💡 Solution Tip: Run 'npm run build' to compile the project first.\n\n");
+    process.exit(1);
+}
+
 const cmd = "node";
 const child = spawn(cmd, [cliPath, ...process.argv.slice(2)], {
     stdio: "inherit",