agent-enderun 1.1.0 → 1.1.1
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.
- package/.enderun/ENDERUN.md +1 -1
- package/.enderun/STATUS.md +1 -1
- package/.enderun/config.json +1 -1
- package/.enderun/logs/manager.json +22 -47
- package/.enderun/memory/PROJECT_MEMORY.md +6 -11
- package/README.md +8 -8
- package/docs/project_analysis_report.md +69 -0
- package/framework-mcp/dist/src/index.js +1 -1
- package/framework-mcp/package.json +1 -1
- package/framework-mcp/src/index.ts +1 -1
- package/package.json +1 -1
- package/src/cli/adapters.ts +3 -1
- package/src/cli/commands/init.ts +9 -1
package/.enderun/ENDERUN.md
CHANGED
package/.enderun/STATUS.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
# 🏛️ AGENT ENDERUN — ARMY COMMAND DASHBOARD
|
|
2
|
-
> v1.
|
|
2
|
+
> v1.1.1 | Clean Release (low-usage items marked as reference) | Memory Graph: Online | Bloat Removed (KENTİM + SYSTEM_MAP)
|
|
3
3
|
|
|
4
4
|
**Nihai Sürüm Notu:** Proje düşük kullanımlı referans materyalleri (bazı knowledge dosyaları, demo scriptler, observability placeholders) ile düzenlendi. Yapısal boş dizinler ve reference-only dosyalar kasıtlı olarak korundu (token economy + full army capability için). Karmaşık kurumsal projeler için hazır (corporate-governance SOP'ları ile).
|
|
5
5
|
## 🤖 Agent Status
|
package/.enderun/config.json
CHANGED
|
@@ -1,73 +1,48 @@
|
|
|
1
1
|
[
|
|
2
2
|
{
|
|
3
|
-
"timestamp": "2026-06-
|
|
3
|
+
"timestamp": "2026-06-03T15:16:49.000Z",
|
|
4
4
|
"agent": "@manager",
|
|
5
|
-
"action": "
|
|
5
|
+
"action": "project-inspection-report",
|
|
6
6
|
"requestId": "01HGT8J5E2N0W0W0W0W0W0W0W5",
|
|
7
7
|
"status": "SUCCESS",
|
|
8
|
-
"summary": "
|
|
9
|
-
"findings": [
|
|
10
|
-
"README clean of verbose version history",
|
|
11
|
-
"structures 100% accounted and used",
|
|
12
|
-
"ENG for core confirmed",
|
|
13
|
-
"token info delivered from knowledge/token_economy_and_memory.md"
|
|
14
|
-
]
|
|
8
|
+
"summary": "Inspected the entire framework structure, confirmed purpose of empty apps directory, and updated the project analysis report in docs.",
|
|
9
|
+
"findings": ["empty apps folder verified", "docs/project_analysis_report.md created", "AL state machine structure audited"]
|
|
15
10
|
},
|
|
16
11
|
{
|
|
17
|
-
"timestamp": "2026-06-
|
|
12
|
+
"timestamp": "2026-06-03T15:17:49.000Z",
|
|
18
13
|
"agent": "@manager",
|
|
19
|
-
"action": "
|
|
14
|
+
"action": "cli-ide-capability-audit",
|
|
20
15
|
"requestId": "01HGT8J5E2N0W0W0W0W0W0W0W5",
|
|
21
16
|
"status": "SUCCESS",
|
|
22
|
-
"summary": "
|
|
23
|
-
"findings": [
|
|
24
|
-
"SYSTEM_MAP.md (0 refs)",
|
|
25
|
-
"empty dirs (scaffold only)",
|
|
26
|
-
"KENTİM docs set (self-contained bloat)",
|
|
27
|
-
"observability (doc only)",
|
|
28
|
-
"bin/hermes-sandbox + init-check (dead). Core army + .enderun/ design is solid and used."
|
|
29
|
-
]
|
|
17
|
+
"summary": "Guided the user on CLI command usage, adapter execution, and IDE integration capabilities.",
|
|
18
|
+
"findings": ["CLI commands audited", "IDE adapter configurations checked", "cross-compatibility confirmed"]
|
|
30
19
|
},
|
|
31
20
|
{
|
|
32
|
-
"timestamp": "2026-06-
|
|
21
|
+
"timestamp": "2026-06-03T15:20:21.000Z",
|
|
33
22
|
"agent": "@manager",
|
|
34
|
-
"action": "
|
|
23
|
+
"action": "mcp-env-project-root-fix",
|
|
35
24
|
"requestId": "01HGT8J5E2N0W0W0W0W0W0W0W5",
|
|
36
25
|
"status": "SUCCESS",
|
|
37
|
-
"summary": "
|
|
38
|
-
"findings": [
|
|
39
|
-
"KENTİM set (api-referans",
|
|
40
|
-
"is_akislari",
|
|
41
|
-
"mimari",
|
|
42
|
-
"moduller",
|
|
43
|
-
"proje",
|
|
44
|
-
"yapı .md) removed. 0 dangling cross-refs left. Other unused items (SYSTEM_MAP",
|
|
45
|
-
"empty dirs) left for future if requested."
|
|
46
|
-
]
|
|
26
|
+
"summary": "Identified and corrected a bug in MCP server entry generation where ENDERUN_PROJECT_ROOT was missing from the env block during init, resolving connection issues with external IDEs.",
|
|
27
|
+
"findings": ["fixed buildMcpServerEntry in adapters.ts to map absolute path in environment variables"]
|
|
47
28
|
},
|
|
48
29
|
{
|
|
49
|
-
"timestamp": "2026-06-
|
|
30
|
+
"timestamp": "2026-06-03T15:23:06.000Z",
|
|
50
31
|
"agent": "@manager",
|
|
51
|
-
"action": "
|
|
32
|
+
"action": "version-synchronization",
|
|
52
33
|
"requestId": "01HGT8J5E2N0W0W0W0W0W0W0W5",
|
|
53
34
|
"status": "SUCCESS",
|
|
54
|
-
"summary": "
|
|
55
|
-
"findings": [
|
|
56
|
-
"SYSTEM_MAP removed. No other major dead files to delete (placeholders intentional). Framework is purpose-built for enterprise complexity via governance internalization",
|
|
57
|
-
"not example bloat."
|
|
58
|
-
]
|
|
35
|
+
"summary": "Synchronized framework package, source, config, and status versions to v1.1.0 to match the root package version.",
|
|
36
|
+
"findings": ["framework-mcp package version bumped", "framework-mcp source version bumped", "apps/web package version bumped", "enderun config version bumped", "STATUS.md version bumped"]
|
|
59
37
|
},
|
|
60
38
|
{
|
|
61
|
-
"timestamp": "2026-06-
|
|
39
|
+
"timestamp": "2026-06-03T15:26:11.000Z",
|
|
62
40
|
"agent": "@manager",
|
|
63
|
-
"action": "
|
|
41
|
+
"action": "init-adapter-scaffolding-fix",
|
|
64
42
|
"requestId": "01HGT8J5E2N0W0W0W0W0W0W0W5",
|
|
65
43
|
"status": "SUCCESS",
|
|
66
|
-
"summary": "
|
|
67
|
-
"findings": [
|
|
68
|
-
"5 knowledge files + 2 bin scripts + observability README edited. Version 1.0.8. README reflects final clean state."
|
|
69
|
-
]
|
|
44
|
+
"summary": "Surgically updated initCommand to dynamically resolve the agent folder name (e.g. skills for antigravity, plugins for grok) when running scaffoldCoreAgents.",
|
|
45
|
+
"findings": ["dynamic resolution of agent directory implemented in init command to align scaffolding with configured adapter patterns"]
|
|
70
46
|
}
|
|
71
|
-
]
|
|
72
|
-
{"timestamp":"2026-06-
|
|
73
|
-
{"timestamp":"2026-06-02T18:24:20.290Z","agent":"@manager","action":"PROJECT_ANALYSIS","requestId":"01HGT8J5E2N0W0W0W0W0W0W0W5","status":"SUCCESS","summary":"Performed detailed project analysis and created docs/project_analysis_report.md.","findings":["12 agents verified","AL validation rules checked","docs folder updated"]}
|
|
47
|
+
]
|
|
48
|
+
{"timestamp":"2026-06-03T15:36:38.637Z","agent":"@manager","action":"v1.1.1-release-synchronization","requestId":"01HGT8J5E2N0W0W0W0W0W0W0W5","status":"SUCCESS","summary":"Synchronized all package descriptors, source codes, configurations, dashboards, memory, and README files to release version 1.1.1.","findings":["root package.json bumped","mcp package and source bumped","apps/web package bumped","config.json and STATUS.md bumped","README.md all mentions updated","PROJECT_MEMORY.md updated"]}
|
|
@@ -19,18 +19,13 @@
|
|
|
19
19
|
|
|
20
20
|
## HISTORY
|
|
21
21
|
|
|
22
|
-
- **
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
22
|
+
- **Dynamic Scaffold Path Resolution Fix (v1.1.1):** Updated `initCommand` in `src/cli/commands/init.ts` to dynamically map the target folder name for `scaffoldCoreAgents` (e.g., `skills` for `antigravity`, `plugins` for `grok`). This prevents folder clutter by keeping agent profiles inside the adapter's expected subdirectories. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
23
|
+
- **Monorepo Version Synchronization (v1.1.1):** Synchronized framework configurations, server code, status boards, and package descriptors across all workspace packages (`framework-mcp`, `apps/web`, `.enderun/config.json`, and `.enderun/STATUS.md`) to align with the root version `1.1.1`. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
24
|
+
- **MCP Project Root Configuration Fix (v1.1.1):** Surgically updated `buildMcpServerEntry` in `src/cli/adapters.ts` to include the absolute `ENDERUN_PROJECT_ROOT` environment variable in the generated configurations during `init`, resolving relative path mismatches for external AI runtimes. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
25
|
+
- **CLI & IDE Capability Audit (v1.1.1):** Audited and documented CLI execution capabilities and IDE adapter mappings (Gemini/Antigravity, Cursor, Claude Code, Grok). Verified cross-compatibility for developer and autonomous agent interaction. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
26
|
+
- **Framework Inspection & Analysis (v1.1.1):** Inspected the framework structure, custom agent army settings, Hermes messaging loop, and MCP server. Verified that the `apps` directory is intentionally kept empty of business code to act as a clean canvas for enterprise projects. Created and documented findings in `docs/project_analysis_report.md`. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
27
27
|
- **AL NPM Consumption Fix (v1.0.7+):** Root cause of 'kuraları npm den' AL validation FAILED (the exact error: 'Run manually: node bin/validate-agent-army.js' after init with remap adapters like antigravity) was execSync("node bin/...") assuming source cwd. Fixed by adding robust getPackageRoot() + getValidatorPath() in pkg.ts (walks import.meta.url to locate the agent-enderun package's bin/ regardless of install location or cwd). Updated check.ts, init.ts, index.ts to use resolved path + cwd-respecting exec. Updated error suggestions to `agent-enderun validate`. Reproduced with real npm pack + tgz install into isolated tests/init-adapters/.../consume/, ran installed CLI init+check+validate for antigravity remap case: now ✅ "Agent Army AL validation PASSED" (no FAILED branch). Source validate still 12/12. Docs/README surgically updated. Meets surgical + Trace + every-turn memory. (Trace 01HGT8J5E2N0W0W0W0W0W0W0W5)
|
|
28
28
|
- **Enterprise v1.0.6 Sürüm Revizyonu:** Mimari Enterprise 2.1 (Yetenek Tabanlı) olarak korundu, marka ismi `Agent Enderun Enterprise v1` olarak güncellendi ve tüm paket sürümleri `1.0.6` olarak mühürlendi.
|
|
29
29
|
- **Agent Lifecycle (AL) Tam Entegrasyon:** Tüm agent `.md` tanımları `stateMachine` ve `tags` alanları ile AL şemasına uygun hale getirildi. `bin/validate-agent-army.js` aracı bu yeni alanları denetleyecek şekilde güncellendi ve tüm ordu (12 agent) %100 başarıyla doğrulandı. CLI orkestrasyon mantığı AL durum geçişlerini (BRIEFED, EXECUTING, BLOCKED) destekleyecek şekilde zenginleştirildi.
|
|
30
30
|
- **Monorepo Sürüm Senkronizasyonu:** Tüm monorepo paketlerinin (`@agent-enderun/mcp`, `@agent-enderun/backend`, `@agent-enderun/web`) sürümleri ana sürüm olan `1.0.5` ile senkronize edildi.
|
|
31
|
-
- **Kalite Kapısı Kontrolleri:** ESLint otomatik kod formatlama ve hizalama düzeltmeleri uygulandı, TS derleme build'i sıfır hata ile tamamlandı ve vitest birim testlerinin tümü (%100 başarı) başarıyla geçti.
|
|
32
|
-
- **AI Compatibility Audit:** Documented and verified active readiness for Gemini/Antigravity CLI, Cursor IDE, Claude Code/Desktop, and Grok environments.
|
|
33
|
-
- **Antigravity Konfigürasyon Entegrasyonu:** `agent-settings`, `cli-settings` ve `ide-settings` kılavuzlarındaki standartlara uygun olarak `.agents/skills`, `.agents/rules`, `.agents/workflows` dizinleri, `.agents/mcp_config.json` lokal MCP tanımları ve kök dizindeki `AGENTS.md` otonom talimat dosyası oluşturuldu ve `init` akışına entegre edildi.
|
|
34
|
-
- **Automated Scaffolding Geliştirmesi:** `init` komutu güncellendi. Kurulum sırasında hem `.agents/agents/...` klasörlerinin hem de `.cursorrules` dosyasının otomatik olarak oluşturulması sağlandı, böylece hem Antigravity hem de Cursor IDE destekleri tamamen otonom ve otomatik hale getirildi.
|
|
35
|
-
- **Framework Directory Resolution Fix:** Removed `.agents` from `FRAMEWORK_DIR_CANDIDATES` to avoid false positive directory detection when `.agents` is created solely for Antigravity/Cursor custom agent registration. Verified health check is 100% green.
|
|
36
|
-
- **Architectural Guidance:** Answered user inquiry regarding MCP agent definition structure, explaining the role of `agent.json` vs `.md` files.
|
|
31
|
+
- **Kalite Kapısı Kontrolleri:** ESLint otomatik kod formatlama ve hizalama düzeltmeleri uygulandı, TS derleme build'i sıfır hata ile tamamlandı ve vitest birim testlerinin tümü (%100 başarı) başarıyla geçti.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 🏛️ Agent Enderun — Enterprise AI Governance & Autonomous Orchestration Framework
|
|
2
2
|
|
|
3
|
-
> **Stable Release:** v1.1.
|
|
3
|
+
> **Stable Release:** v1.1.1 (Enterprise Orchestration Ready) — Build Compile: Clean | Type-Safety: 100% Verified | AL Compliance: 12/12 Agents
|
|
4
4
|
|
|
5
5
|
> **Author:** Yusuf BEKAR
|
|
6
6
|
> **Trace ID:** `01HGT8J5E2N0W0W0W0W0W0W0W5`
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
**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**.
|
|
14
14
|
|
|
15
|
-
Nihai temiz sürüm (v1.1.0) itibarıyla sistem; **@-mention delegasyon**, **doğal dil rotalama** 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 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).
|
|
15
|
+
Nihai temiz sürüm (v1.1.0) itibarıyla sistem; **@-mention delegasyon**, **doğal dil rotalama** 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).
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
@@ -24,13 +24,13 @@ Yapay zeka kodlama yardımcıları (Claude Code, Gemini CLI, Grok Build vb.) gel
|
|
|
24
24
|
2. **Kayıp Hafıza ve Bağlam Drifti:** Ajanlar oturum değiştirdikçe projenin geçmişini ve mimari kararlarını unutur. Enderun, **`.enderun/memory/PROJECT_MEMORY.md`** dosyasını projenin değişmez tek doğruluk kaynağı (SSOT) haline getirerek, seanslar arası bağlam kaybını tamamen engeller.
|
|
25
25
|
3. **Akıllı Delegasyon ve Doğal Dil:** Artık karmaşık komutlar yerine `agent-enderun "Projemi denetle"` gibi doğal dildeki istekler veya `agent-enderun @backend "Tablo oluştur"` gibi doğrudan delegasyonlar kullanılabilir.
|
|
26
26
|
4. **Çoklu Ajan Kaosu:** **12** farklı uzman yapay zeka ajanı, olay tabanlı asenkron bir haberleşme protokolü olan **Hermes Message Broker** üzerinden koordine edilir. Ajanlar birbirine rastgele müdahale edemez; tüm görevler bir İş Dağılım Grafiği (DAG) üzerinden komuta edilir.
|
|
27
|
-
5. **Güvenli Haberleşme:** Yeni eklenen **Hermes Lock Protocol** sayesinde, birden fazla ajanın aynı anda mesajlaşması durumunda veri çakışmaları tamamen engellenir.
|
|
27
|
+
5. **Güvenli Haberleşme & Entegrasyon:** Yeni eklenen **Hermes Lock Protocol** sayesinde, birden fazla ajanın aynı anda mesajlaşması durumunda veri çakışmaları tamamen engellenir. Ayrıca harici asistanların yerel MCP araçlarını sorunsuz çalıştırabilmesi için mutlak çalışma dizini (CWD) parametreleri yapılandırılmıştır.
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
31
31
|
### 📦 Güncel Sürüm / Current Release
|
|
32
32
|
|
|
33
|
-
**v1.1.
|
|
33
|
+
**v1.1.1** — Enterprise 1.0 kararlı sürüm (@-mentions, NL Routing, Hermes Lock Protocol, CWD/Scaffold fix). Detaylı sürüm geçmişi git log ve önceki commit'lerde bulunur; kalıbımız (bilingual TR/EN yapı, tablolar, bölümler) korunmuştur.
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
@@ -166,7 +166,7 @@ npx agent-enderun init gemini --unified
|
|
|
166
166
|
|
|
167
167
|
**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.
|
|
168
168
|
|
|
169
|
-
|
|
169
|
+
Version **v1.1.1** 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** (including after `npm install`), **resolving absolute project root paths (CWD) dynamically for external assistant tools (e.g. Claude Desktop/Cursor)**, **mapping agent scaffolding subdirectories to adapter-specific folders (skills/plugins/agents) 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.
|
|
170
170
|
|
|
171
171
|
---
|
|
172
172
|
|
|
@@ -178,13 +178,13 @@ As AI coding assistants (Claude Code, Gemini CLI, Grok Build, etc.) become incre
|
|
|
178
178
|
2. **Context Loss Prevention (SSOT Memory):** AI agents naturally lose project history across chats. Enderun seals all project milestones, decisions, and tasks into a self-pruning **`.enderun/memory/PROJECT_MEMORY.md`** file, ensuring absolute context continuity.
|
|
179
179
|
3. **Contract-First Safety (Frontend-Backend Drift):** Before any user interface code is written, API models and branded types are sealed. The **autonomous** contract verification engine checks SHA-256 type definitions to prevent integration drifts.
|
|
180
180
|
4. **Symmetric Orchestration (Hermes Protocol):** **12** specialized expert agents communicate via an asynchronous, event-driven message broker (**Hermes**), preventing chaotic, uncoordinated AI behavior.
|
|
181
|
-
5. **Sandbox & Security Compliance:** Modern CLI agents (like Claude Code) restrict filesystem access. By keeping all configurations, task logs, and queues local (inside **`.enderun/`**, `.gemini/`, `.claude/`, `.grok/`, etc.) in the project workspace, Enderun runs with **zero sandbox violations**.
|
|
181
|
+
5. **Sandbox & Security Compliance:** Modern CLI agents (like Claude Code) restrict filesystem access. By keeping all configurations, task logs, and queues local (inside **`.enderun/`**, `.gemini/`, `.claude/`, `.grok/`, etc.) in the project workspace, Enderun runs with **zero sandbox violations**. Additionally, absolute CWD environment bindings prevent path mismatches in background execution.
|
|
182
182
|
|
|
183
183
|
---
|
|
184
184
|
|
|
185
185
|
### 📦 Current Release / Güncel Sürüm
|
|
186
186
|
|
|
187
|
-
**v1.
|
|
187
|
+
**v1.1.1** — AL Enterprise Compliance stable (full cross-adapter & npm install support for remaps + validator resolution, with surgical fixes for CWD environment and dynamic folder scaffolding). Detailed historical release notes are in git history; the bilingual TR/EN template, tables, and section mold are preserved.
|
|
188
188
|
|
|
189
189
|
---
|
|
190
190
|
|
|
@@ -316,4 +316,4 @@ npx agent-enderun init gemini --unified
|
|
|
316
316
|
|
|
317
317
|
---
|
|
318
318
|
|
|
319
|
-
Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.
|
|
319
|
+
Developed with absolute discipline | Developer **Yusuf BEKAR** | Framework Version **v1.1.1 (Final Clean)** — Low-usage items arranged as reference-only. Bloat removed. Corporate-ready.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# Agent Enderun — Framework Analizi ve Proje Raporu
|
|
2
|
+
|
|
3
|
+
Bu rapor, **Agent Enderun Enterprise v1 (v1.1.1)** altyapısının genel mimari yapısını, orkestrasyon mekanizmasını, MCP araçlarını ve kurumsal proje geliştirme standartlarını incelemek amacıyla hazırlanmıştır.
|
|
4
|
+
|
|
5
|
+
Projenin `apps/` dizini kasıtlı olarak boş bırakılmıştır. Bu yapı, geliştiricilerin kendi yeteneklerini, hafıza haritalarını ve kurumsal iş mantıklarını sıfırdan ve temiz bir alanda inşa edebilmesi için tasarlanmış bir **"kurumsal proje geliştirme motoru" (development engine)** niteliğindedir.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 🏛️ Mimari Yapı ve Temel Bileşenler
|
|
10
|
+
|
|
11
|
+
Agent Enderun, AI ajanlarının otonom olarak çalışabileceği ancak insan yapımı kurallarla (Anayasa) sıkı bir şekilde sınırlandırıldığı bir **AI Yönetişim Altyapısıdır (AI Governance Framework)**.
|
|
12
|
+
|
|
13
|
+
```mermaid
|
|
14
|
+
graph TD
|
|
15
|
+
CLI[CLI: agent-enderun] -->|Komutlar & NL İstekleri| Manager[@manager - Commander]
|
|
16
|
+
Manager -->|Hermes Protokolü| MsgQueue[Mesaj Kuyruğu: .enderun/messages/]
|
|
17
|
+
MsgQueue -->|Durum Makinesi / AL| Agents[Ajan Ordusu: 12 Uzman Ajan]
|
|
18
|
+
Agents -->|MCP Araçları| Workspace[Proje Çalışma Alanı: apps/]
|
|
19
|
+
Agents -->|Loglama & Hafıza| Mem[Proje Hafızası: PROJECT_MEMORY.md]
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
### 1. Supreme Constitution (Üstün Yasa)
|
|
23
|
+
Tüm sistemin ve ajanların uymak zorunda olduğu kurallar bütününü içerir:
|
|
24
|
+
* **Ana Anayasa (`.enderun/ENDERUN.md`):** Ajanların operasyonel sınırlarını çizer. `replace_text` kullanımı zorunluluğu, `any` tipinin ve `console.log` kullanımının yasak olması, Zero Mock (Sahte Veri Yasağı) ve branded types standartları burada mühürlenmiştir.
|
|
25
|
+
* **Güvenlik Protokolleri (`docs/architecture/approval-flows.md`):** Yüksek riskli işlemler (toplu veri silme, veritabanı şema değişimi, credential rotasyonu) için `@manager` onayını ve insan-in-the-loop (`approve` komutu) imzasını zorunlu kılar.
|
|
26
|
+
|
|
27
|
+
### 2. Ajan Ordusu (Agent Army - AL Compliant)
|
|
28
|
+
`.enderun/agents/` altında JSON şemalarıyla tanımlanmış 12 adet uzman ajan bulunur. Ajanların durumları **Agent Lifecycle (AL)** durum makinesine (`IDLE` ➔ `BRIEFED` ➔ `EXECUTING` ➔ `DONE`/`BLOCKED`) göre yönetilir:
|
|
29
|
+
* `@manager`: Supreme Orchestrator ve Team-Lead rolündedir. Her talebi analiz eder ve iş paketlerini delege eder.
|
|
30
|
+
* `@backend` & `@frontend`: Sunucu mantığı, Panda CSS tabanlı sıfır-kütüphane arayüz standartlarını yönetir.
|
|
31
|
+
* `@database` & `@devops`: Kysely tabanlı veri katmanını ve CI/CD süreçlerini yürütür.
|
|
32
|
+
* `@quality`: Kod standartlarını (ESLint) ve test kapsamını (%80 üzeri) denetleyen son onay kapısıdır.
|
|
33
|
+
* `@explorer`, `@git`, `@mobile`, `@native`, `@security`, `@analyst`: Diğer uzmanlık alanlarındaki görevleri icra eder.
|
|
34
|
+
|
|
35
|
+
### 3. Hermes Mesajlaşma Kanalı
|
|
36
|
+
Ajanlar arası ve kullanıcı ile ajanlar arasındaki iletişim asenkron ve JSON formatında Hermes protokolü ile sağlanır:
|
|
37
|
+
* **İletişim Kanalı:** `.enderun/messages/` klasöründe yer alan JSON dosyalarıdır.
|
|
38
|
+
* **Kilit Mekanizması:** Çakışmaları önlemek için `.lock` dosyası ile Hermes kilit protokolü uygulanır (LLM zaman aşımları için 5 saniyelik stale lock kontrolü mevcuttur).
|
|
39
|
+
* **Trace ID:** Her işlem zinciri `trace:new` ile oluşturulan benzersiz bir Trace ID'yi miras alır ve tüm loglarda taşınır.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 🛠️ CLI ve Geliştirici Komutları
|
|
44
|
+
|
|
45
|
+
Çalışma alanı kök dizinindeki `bin/cli.js` üzerinden `src/cli/` altındaki komutlar tetiklenir:
|
|
46
|
+
1. `init [adapter]`: Altyapıyı hedef ortama (`gemini`, `claude`, `grok` vb.) göre uyarlar, kurallar ve yetenek şablonlarını oluşturur.
|
|
47
|
+
2. `check`: Sistem sağlık taramasını gerçekleştirir ve ajan ordusunun şema uyumluluğunu doğrular.
|
|
48
|
+
3. `status`: Aktif fazı, güncel Trace ID'yi ve ajanların anlık durumlarını gösterir.
|
|
49
|
+
4. `trace:new`: Yeni bir iş zinciri başlatır.
|
|
50
|
+
5. `orchestrate`: Bekleyen Hermes görevlerini sırasıyla ajanlara delege eder ve durumlarını günceller.
|
|
51
|
+
6. `verify-contract` & `update-contract`: API veri tiplerinin ve kontratların frontend-backend arasında uyumlu olmasını güvence altına alır.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 📡 Model Context Protocol (MCP) Server
|
|
56
|
+
|
|
57
|
+
`framework-mcp/` dizini altında bağımsız bir paket olarak geliştirilmiştir:
|
|
58
|
+
* **SDK Entegrasyonu:** `@modelcontextprotocol/sdk` kullanılarak tasarlanmıştır.
|
|
59
|
+
* **Dosya Yönetim Araçları:** Ajanların kod üzerinde cerrahi operasyon yapmasını sağlayan `replace_text`, `patch_file`, `write_file` ve `read_file` araçları sunulur.
|
|
60
|
+
* **Yönetim ve Mesajlaşma Araçları:** Proje hafızasını güncellemek için `update_project_memory`, mesaj göndermek için `send_agent_message` ve eylemleri kaydetmek için `log_agent_action` araçlarını içerir.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 📈 Sonuç ve Öneriler
|
|
65
|
+
|
|
66
|
+
Proje, kurumsal seviyede çoklu ajan yönetimi ve kod kalitesi yönetişimi için mükemmel bir temel hazırlamıştır. `apps/` dizininin boş bırakılmış olması, geliştirilmek istenen özel kurumsal projeler için temiz bir sayfa sunar. Geliştirme sürecinde şunlara dikkat edilmelidir:
|
|
67
|
+
1. **Hafıza Senkronizasyonu:** Her aşamada `.enderun/memory/PROJECT_MEMORY.md` ve `.enderun/logs/` güncellenmelidir.
|
|
68
|
+
2. **Surgical Kodlama:** Dosyaları komple değiştirmek yerine MCP araçları ile nokta atışı (`replace_text`) düzenleme alışkanlığı sürdürülmelidir.
|
|
69
|
+
3. **AL Uyumluluğu:** Ajan tanımlarında yapılan değişikliklerden sonra mutlaka `agent-enderun validate` komutu ile doğrulama yapılmalıdır.
|
|
@@ -5,7 +5,7 @@ import { TOOLS, toolHandlers } from "./tools/index.js";
|
|
|
5
5
|
// ─── Server Setup ─────────────────────────────────────────────────
|
|
6
6
|
const server = new Server({
|
|
7
7
|
name: "@agent-enderun/mcp",
|
|
8
|
-
version: "1.
|
|
8
|
+
version: "1.1.1",
|
|
9
9
|
}, {
|
|
10
10
|
capabilities: {
|
|
11
11
|
tools: {},
|
package/package.json
CHANGED
package/src/cli/adapters.ts
CHANGED
package/src/cli/commands/init.ts
CHANGED
|
@@ -324,7 +324,15 @@ export async function initCommand(adapterInput?: string, dryRun = false) {
|
|
|
324
324
|
if (!dryRun) deepCleanProtocols(targetDir, targetScope);
|
|
325
325
|
|
|
326
326
|
// Scaffold core agents under the central framework directory
|
|
327
|
-
|
|
327
|
+
let agentFolder = "agents";
|
|
328
|
+
if (frameworkDir !== ".enderun") {
|
|
329
|
+
if (adapter.id === "antigravity") {
|
|
330
|
+
agentFolder = "skills";
|
|
331
|
+
} else if (adapter.id === "grok") {
|
|
332
|
+
agentFolder = "plugins";
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
scaffoldCoreAgents(path.join(targetFrameworkDir, agentFolder), dryRun);
|
|
328
336
|
|
|
329
337
|
if (!fs.existsSync(path.join(targetDir, ".git")) && !dryRun) {
|
|
330
338
|
try { execSync("git init", { cwd: targetDir, stdio: "ignore" }); } catch { /* ignore */ }
|