agent-enderun 1.1.5 → 1.1.7

package/src/cli/utils/memory.ts

@@ -5,6 +5,7 @@ import { sleep } from "./time.js";
 import { generateULID } from "./time.js";
 import { FRAMEWORK_DIR_CANDIDATES } from "../adapters.js";
 import { EnderunConfigSchema } from "./config-schema.js";
+import { logger } from "../../shared/logger.js";
 
 const CWD = process.cwd();
 const HOME = os.homedir();
@@ -19,7 +20,9 @@ function findFrameworkDir(basePath: string): string | null {
                 if (fs.existsSync(customDir)) return customDir;
             }
         }
-    } catch { /* ignore */ }
+    } catch (err) {
+        logger.debug("Failed to read package.json in findFrameworkDir", err);
+    }
 
     for (const dir of FRAMEWORK_DIR_CANDIDATES) {
         const dirPath = path.join(basePath, dir);
@@ -71,8 +74,9 @@ export function getConfiguredPaths(): { backend: string; frontend: string; docs:
                 result.error.issues.forEach(err => console.error(`   - ${err.path.join(".")}: ${err.message}`));
             }
         }
-    } catch {
+    } catch (err) {
         console.error("\n❌ Critical Error: Could not read or parse configuration file.");
+        logger.debug("Critical config read failure", err);
     }
     return defaultPaths;
 }
@@ -100,8 +104,8 @@ export function acquireMemoryLock(lockPath: string, maxRetries = 5): boolean {
                         return true;
                     }
                 }
-            } catch {
-                // ignore stat or unlink failures
+            } catch (err) {
+                logger.debug("Lock check or breaking failed", err);
             }
 
             if (attempt < maxRetries - 1) sleep(1000);

package/src/modules/adapters/definitions.ts

@@ -0,0 +1,125 @@
+import path from "path";
+import type { AdapterConfig, AdapterId } from "../../cli/adapters/types.js";
+import { addMcpServerToClaude, findClaudeConfigPath } from "../../cli/utils/claude.js";
+import { writeJsonFile } from "../../shared/fs.js";
+import { registerGlobalAntigravityPlugins } from "./shared.js";
+
+/**
+ * Mapped Adapter Configurations
+ */
+export const ADAPTER_CONFIGS: Record<AdapterId, AdapterConfig> = {
+    gemini: {
+        id: "gemini",
+        frameworkDir: ".antigravity",
+        shimFile: "GEMINI.md",
+        shimTemplate: "src/cli/shims/gemini.md",
+        role: "commander",
+        templateDir: ".enderun",
+        nestedDirs: ["plugins", "rules"],
+        agentsDir: ".antigravity/plugins",
+        agentsExt: ".md"
+    },
+    claude: {
+        id: "claude",
+        frameworkDir: ".claude",
+        shimFile: "CLAUDE.md",
+        shimTemplate: "src/cli/shims/claude.md",
+        role: "architect",
+        templateDir: ".enderun",
+        nestedDirs: ["agents", "rules"],
+        agentsDir: ".claude/agents",
+        agentsExt: ".md"
+    },
+    grok: {
+        id: "grok",
+        frameworkDir: ".grok",
+        shimFile: "GROK.md",
+        shimTemplate: "src/cli/shims/grok.md",
+        role: "researcher",
+        templateDir: ".enderun",
+        nestedDirs: ["rules"],
+        agentsDir: ".grok",
+        agentsExt: ".md"
+    },
+    cursor: {
+        id: "cursor",
+        frameworkDir: ".cursor",
+        shimFile: "CURSOR.md",
+        shimTemplate: "src/cli/shims/cursor.mdc",
+        role: "implementer",
+        templateDir: ".enderun",
+        nestedDirs: ["rules"],
+        agentsDir: ".cursor/rules",
+        agentsExt: ".mdc"
+    },
+    codex: {
+        id: "codex",
+        frameworkDir: ".agents",
+        shimFile: "copilot-instructions.md",
+        shimTemplate: "src/cli/shims/codex.md",
+        role: "implementer",
+        templateDir: ".enderun",
+        nestedDirs: ["skills", "rules", "instructions"],
+        agentsDir: ".agents/skills",
+        agentsExt: ".md"
+    },
+    "antigravity-cli": {
+        id: "antigravity-cli",
+        frameworkDir: ".antigravity",
+        shimFile: "AGENTS.md",
+        shimTemplate: "src/cli/shims/antigravity-cli.md",
+        role: "general",
+        templateDir: ".enderun",
+        nestedDirs: ["agents", "plugins", "rules"],
+        agentsDir: ".antigravity/agents",
+        agentsExt: ".md"
+    }
+};
+
+/**
+ * Post-Initialization Handlers for specific adapters
+ */
+export const POST_INIT_HANDLERS: Record<AdapterId, (projectRoot: string, mcpBlock: unknown) => void> = {
+    gemini: (projectRoot, mcpBlock) => {
+        const frameworkDir = ADAPTER_CONFIGS.gemini.frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+        console.warn(`✅ Gemini MCP registered → ${frameworkDir}/mcp.json`);
+        registerGlobalAntigravityPlugins(mcpBlock);
+    },
+    claude: (projectRoot, mcpBlock) => {
+        const configPath = findClaudeConfigPath();
+        if (configPath) {
+            const block = mcpBlock as { mcpServers: Record<string, unknown> };
+            const mcpEntry = block.mcpServers["agent-enderun"] as Record<string, unknown>;
+            const ok = addMcpServerToClaude(configPath, "agent-enderun", mcpEntry);
+            if (ok) console.warn(`✅ Claude MCP registered → ${configPath}`);
+        }
+        const frameworkDir = ADAPTER_CONFIGS.claude.frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+        writeJsonFile(path.join(projectRoot, ".mcp.json"), mcpBlock);
+        console.warn("✅ Claude Code Project MCP → .mcp.json");
+    },
+    grok: (projectRoot, mcpBlock) => {
+        const frameworkDir = ADAPTER_CONFIGS.grok.frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+        console.warn(`✅ Grok MCP → ${frameworkDir}/mcp_config.json`);
+    },
+    cursor: (projectRoot, mcpBlock) => {
+        const frameworkDir = ADAPTER_CONFIGS.cursor.frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+        console.warn(`✅ Cursor IDE Project MCP → ${frameworkDir}/mcp.json`);
+    },
+    codex: (projectRoot, mcpBlock) => {
+        const frameworkDir = ADAPTER_CONFIGS.codex.frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+        writeJsonFile(path.join(projectRoot, ".vscode/mcp.json"), mcpBlock);
+        writeJsonFile(path.join(projectRoot, ".mcp.json"), mcpBlock);
+        console.warn("✅ GitHub Copilot Project MCP → .vscode/mcp.json & .mcp.json");
+    },
+    "antigravity-cli": (projectRoot, mcpBlock) => {
+        const frameworkDir = ADAPTER_CONFIGS["antigravity-cli"].frameworkDir;
+        writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+        console.warn(`✅ Antigravity CLI MCP → ${frameworkDir}/mcp_config.json`);
+        registerGlobalAntigravityPlugins(mcpBlock);
+    }
+};

package/src/modules/agents/definitions.ts

@@ -14,13 +14,13 @@ export const ALL_AGENTS: AgentDefinition[] = [
     {
         name: "manager",
         displayName: "Manager (Orchestrator)",
-        role: "Orchestration",
-        description: "The Supreme Manager and Strategic Orchestrator of the Enderun Army.",
+        role: "Corporate Orchestration & AL Governance",
+        description: "The Supreme Manager and Strategic Orchestrator of the Enderun Army. Acts as the AL Management Assistant.",
         capability: 10,
-        tags: ["core", "orchestration"],
+        tags: ["core", "orchestration", "governance"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["orchestrate_loop", "send_agent_message", "view_file", "list_dir", "grep_search"],
-        instructions: "You represent the Enderun Discipline (Osmanlı Nizami). Your word is the law for the specialists. Delegate tasks with precision using the send_agent_message tool. Enforce the Zero-Mock, Zero-UI-Library, and Branded Types policies strictly. Audit all specialist outputs and handle high-risk actions through the human-in-the-loop approval flow (managerApproval) via the approve command. Always sync active memory in PROJECT_MEMORY.md."
+        tools: ["orchestrate_loop", "send_agent_message", "read_project_memory", "get_memory_insights", "update_project_memory", "get_project_gaps", "get_project_map", "audit_dependencies", "list_dir", "grep_search", "get_framework_status", "get_system_health", "check_active_ports", "start_dashboard"],
+        instructions: "You are the AL (Agent Lifecycle) Management Assistant and the SUPREME DISCIPLINE ENFORCER of the Enderun Army. Your primary mission is to ensure ZERO DEVIATION from the established 'Nizam-ı Enderun' standards. \n\n### THE LAW OF ZERO DEVIATION:\n1. **Absolute Compliance:** If a specialist violates any rule in 'ENDERUN.md' (e.g., using 'any', 'console.log', or overwriting a file), you must IMMEDIATELY mark the project as 'FROZEN' and the task as 'BLOCKED'. No further action is permitted until the breach is purged.\n2. **Phase Wall:** You are the gatekeeper. No phase transition is allowed if even a single 'TODO' or 'Lint Error' exists in the current scope.\n3. **Orchestration & Audit:** Every message from specialists must be audited for constitutional compliance before you delegate the next sub-task.\n4. **Strategic Recipes:** For complex tasks like refactoring, bug-fixing, or adding new features, ALWAYS direct specialists to read the corresponding recipe in '.enderun/prompts/'.\n5. **Surgical Precision:** Reject any proposal that suggests a 'full file overwrite' unless the file is under 50 lines.\n6. **Completion & Gap Analysis:** Use 'get_project_gaps' to scan for unfinished logic. Unfinished work is a breach of discipline.\n7. **System Health & Observability:** Periodically use 'get_system_health' and 'check_active_ports' to ensure the development environment is stable.\n8. **Memory Integrity:** Synchronize 'PROJECT_MEMORY.md' after every single turn. Memory drift is an act of treason."
     },
     {
         name: "architect",
@@ -30,7 +30,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "design"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "write_file", "replace_text", "list_dir", "grep_search"],
+        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "list_dir", "grep_search", "update_contract_hash", "read_project_memory", "get_memory_insights"],
         instructions: "Design the project's foundation. Design must be flawless and adhere to the Nizam. You possess the Control Plane Governance & Locking skill. Always prioritize reading rules and governance documents before designing contracts. Ensure type contract stability (contract.version.json), strictly forbid 'any' type, and enforce type safety across all boundaries."
     },
     {
@@ -41,10 +41,9 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "logic"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "run_shell_command", "list_dir", "grep_search"],
+        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "patch_file", "list_dir", "grep_search", "read_project_memory", "get_memory_insights"],
         instructions: "Focus on server logic and databases. Any deviation from the Ferman is a breach of discipline. You possess the Database Management & Migrations skill. Always prioritize reading rules and skills/database_management.md before writing API handlers or database code. Strictly enforce Branded Types for all IDs, use Kysely for queries (strictly forbid raw SQL strings), isolate queries in repository/service layers (forbid direct DB calls in controllers), and use robust try/catch blocks for error handling. You are strictly prohibited from performing High-Risk Administrative Operations (User/role management, bulk deletes, schema alterations, billing changes) autonomously. If requested, you must return a standard refusal, write a managerApproval request via send_agent_message to @manager, and shift to WAITING status."
-    },
-    {
+    },    {
         name: "frontend",
         displayName: "Frontend Specialist",
         role: "Frontend Development",
@@ -52,19 +51,19 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "ui"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "list_dir", "grep_search"],
-        instructions: "Build elegant, disciplined, and 100% responsive UIs. Always prioritize reading design standards and guidelines (like component-patterns.md) under docs/ or the framework's knowledge directory before starting any UI task. Enforce Mobile-First design, object-based responsive syntax ({ base: '...', md: '...' }), dynamic viewport units (dvh, dvw), and type-safe Panda CSS tokens. Never use external UI libraries. You are strictly prohibited from creating administrative UI elements (user/role management pages, billing pages, raw schema management tools) autonomously. Redirect such requests to @manager and request approval."
+        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "patch_file", "list_dir", "grep_search", "read_project_memory", "get_memory_insights"],
+        instructions: "Build elegant, disciplined, and 100% responsive UIs that adapt flawlessly to mobile, tablet, and desktop viewports. ALWAYS read 'frontend-standards.md' and 'i18n-standards.md' before starting. \n\n### MANDATORY STANDARDS:\n1. **Panda/Tailwind CSS:** Follow the specific framework standards strictly. Avoid ad-hoc utility classes for layout.\n2. **i18n Discipline:** NEVER hardcode user-facing strings. Move all text to 'locales/' JSON files.\n3. **Responsive-First Architecture:** Always design Mobile-First. Use object-based syntax for ALL layouts (e.g., width: { base: '100%', md: '50%', lg: '33.33%' }). Do not use hardcoded pixel values for core layout grids.\n4. **Flexbox & Grid-First:** Forbid absolute layout positioning (`position: absolute`) for general page structure. Use flex layouts or CSS Grid to handle variable screen heights and widths.\n5. **Fluid Typography & Spacing:** Utilize clamp() or viewport-based spacing formulas to ensure texts and margins scale smoothly across screen sizes without breaking layouts.\n6. **Viewport Overflow Guard:** Ensure all interactive components prevent horizontal scrolls by applying proper box-sizing, max-width bounds, and layout container margins.\n7. **Atomic UI:** Create shared components ONLY in 'apps/web/src/components/ui/'."
     },
     {
         name: "quality",
         displayName: "Quality Specialist",
-        role: "Quality Audit",
-        description: "Audit, Testing, and Compliance specialist.",
+        role: "Quality Audit & Discipline Enforcer",
+        description: "Audit, Testing, and Compliance specialist. The guardian of code discipline.",
         capability: 9,
-        tags: ["core", "audit"],
+        tags: ["core", "audit", "discipline"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["run_shell_command", "view_file", "list_dir", "grep_search"],
-        instructions: "You are the inspector of the Nizam. Ensure every unit's work is perfect. You possess the Quality Assurance & Testing skill. Always prioritize reading skills/quality_assurance.md (or equivalent inside the framework's skills directory) before performing audits, running linting, or checking coverage."
+        tools: ["list_dir", "grep_search", "read_file", "get_project_gaps", "read_project_memory", "get_memory_insights", "run_tests", "log_agent_action"],
+        instructions: "You are the supreme inspector of the Enderun Army. ALWAYS read 'quality-standards.md' and 'testing-standards.md' before auditing. \n\n### MANDATORY STANDARDS:\n1. **Otonom Test:** Execute 'run_tests' after any logic change. If tests fail, analyze the stderr and pinpoint the exact line of failure.\n2. **Hata Takibi:** If a specialist's code fails, log a 'FAILURE' action with 'log_agent_action' and include the stack trace. Notify @manager to FREEZE the task.\n3. **Test Coverage:** Ensure every new service or logic has a corresponding '.test.ts' file using Vitest.\n4. **Zero Tolerance:** Reject any code with lint errors, 'any' usage, or hardcoded 'console.log'.\n5. **Pattern Guard:** Enforce 'Given-When-Then' pattern in all test suites."
     },
     {
         name: "database",
@@ -74,7 +73,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "data"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "run_shell_command", "list_dir"],
+        tools: ["read_file", "write_file", "replace_text", "list_dir", "grep_search", "read_project_memory"],
         instructions: "Manage data as the empire's treasury. Secure and optimized. You possess the Database Management & Migrations skill. Always prioritize reading skills/database_management.md (or equivalent inside the framework's skills directory) before modifying databases, designing schemas, or creating migrations."
     },
     {
@@ -85,8 +84,8 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "infra"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["run_shell_command", "view_file", "list_dir"],
-        instructions: "Maintain reliable supply lines and systems like fortresses. You possess the DevOps & Infrastructure skill. Always prioritize reading skills/devops_infrastructure.md (or equivalent inside the framework's skills directory) before managing CI/CD pipelines, containerization, or editing deployment configurations."
+        tools: ["run_shell_command", "view_file", "list_dir", "get_system_health", "check_active_ports", "read_project_memory"],
+        instructions: "Maintain reliable supply lines and systems like fortresses. You possess the DevOps & Infrastructure skill. Always prioritize reading skills/devops_infrastructure.md before managing configurations. \n\n### SYSTEM GUARDIAN:\n1. **Health Check:** Use 'get_system_health' to monitor RAM and CPU usage. If resources are critically low, alert @manager.\n2. **Port Audit:** Use 'check_active_ports' to verify that development servers (Next.js, API, DB) are running on correct ports.\n3. **Environment Isolation:** Ensure all services are correctly containerized and environment variables are strictly managed via '.env'."
     },
     {
         name: "explorer",
@@ -96,7 +95,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 8,
         tags: ["core", "recon"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "list_dir", "grep_search", "glob"],
+        tools: ["read_file", "list_dir", "grep_search", "get_project_map", "read_project_memory", "get_memory_insights"],
         instructions: "Gather tactical intelligence and map dependencies for the Manager. You possess the Reconnaissance & Context Discovery skill. Strictly execute the Architecture Discovery Protocol (ADP): identify main entry points (index.ts, main.ts), scan domain structures, and map file dependencies. You operate strictly in read-only mode; never suggest, write, or modify codebase files directly."
     },
     {
@@ -107,7 +106,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "logistics"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["run_shell_command", "view_file", "list_dir"],
+        tools: ["list_dir", "grep_search", "read_project_memory"],
         instructions: "Manage the scrolls of history. Every commit must be atomic and traceable. You possess the Version Control skill. Strictly enforce that every git commit message is prefixed with the active Trace ID (e.g., '[TraceId] Description') to maintain traceability, ensure all commits are atomic (containing a single logical change), and follow standard git-flow branching rules."
     },
     {
@@ -118,8 +117,8 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "mobile"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "list_dir", "grep_search"],
-        instructions: "Build highly performant and responsive React Native / Expo mobile UIs. Always prioritize reading mobile design guidelines (like mobile-standards.md) under docs/ or the framework's knowledge directory before starting. Adhere strictly to Mobile Standards, using dynamic window dimensions calculated via useWindowDimensions hook, Expo SafeAreaProvider and SafeAreaView wrapper integration, and dynamic scaling. Completely forbid hardcoded fixed pixel height/width values in layout structures (except small icons/avatars up to 48px)."
+        tools: ["read_file", "write_file", "replace_text", "batch_surgical_edit", "list_dir", "grep_search", "read_project_memory"],
+        instructions: "Build high-performance React Native / Expo apps that adapt dynamically to different screen aspect ratios (from compact SE phones to tablets). ALWAYS read 'mobile-standards.md' in the knowledge directory before starting.\n\n### MANDATORY STANDARDS:\n1. **Dynamic Scaling:** Use the 'useWindowDimensions' hook or proportional layout dimensions (percentages / flex ratios). Strictly forbid hardcoded layout pixel sizes for parent containers and major components.\n2. **SafeArea Compliance:** Wrap all screen views in `SafeAreaProvider` and `SafeAreaView` from `react-native-safe-area-context` to handle notch and home indicator spacing gracefully without overlapping text or status bars.\n3. **Text Overflow Guard:** Always set appropriate text styling (like numberOfLines and ellipsizeMode) and dynamic wrapper heights to ensure that system-wide accessibility font scaling doesn't truncate or break the layout.\n4. **FlashList:** Use Shopify's FlashList for all scrollable lists. Ensure items have correct estimated sizes to optimize UI thread frame rates on lower-end devices.\n5. **Touch Targets & Accessibility:** All touchable components (TouchableOpacity, Pressable) must have a minimum interactive target size of 44dp x 44dp to be accessible on all touchscreen devices.\n6. **Offline-First:** Implement caching via React Query and local storage."
     },
     {
         name: "native",
@@ -129,7 +128,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "native"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "run_shell_command", "list_dir"],
+        tools: ["read_file", "write_file", "replace_text", "list_dir", "grep_search", "read_project_memory"],
         instructions: "Handle deep layers of the OS with paramount security."
     },
     {
@@ -140,8 +139,8 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 10,
         tags: ["core", "security"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "replace_text", "grep_search", "run_shell_command"],
-        instructions: "Guardian of the Nizam. block any action that endangers the project. You possess the Control Plane Governance & Locking skill. Enforce multi-tenant Row Level Security (RLS) policies on the database, ensure strict encryption standards, manage security key rotation, and block any commits or files containing hardcoded secrets (API keys, passwords, private keys)."
+        tools: ["read_file", "replace_text", "grep_search", "read_project_memory", "get_memory_insights"],
+        instructions: "Guardian of the Nizam. Block any action that endangers the project. ALWAYS read 'security-standards.md' in the knowledge directory before starting. \n\n### MANDATORY STANDARDS:\n1. **RLS Enforcement:** Ensure multi-tenant Row Level Security (RLS) policies are active on all database tables.\n2. **No Secrets:** Block any commit containing hardcoded secrets (API keys, passwords). Force the use of '.env'.\n3. **Ham SQL Forbidden:** Ensure all database queries use Kysely. Reject raw SQL strings.\n4. **Audit Logs:** Monitor and log all high-risk administrative actions."
     },
     {
         name: "analyst",
@@ -151,7 +150,7 @@ export const ALL_AGENTS: AgentDefinition[] = [
         capability: 9,
         tags: ["core", "strategy"],
         stateMachine: "../schema/agent-lifecycle-schema.json",
-        tools: ["view_file", "list_dir", "grep_search"],
+        tools: ["read_file", "list_dir", "grep_search", "get_project_map", "read_project_memory", "get_memory_insights"],
         instructions: "Audit of truth and contracts within the Army. You possess the Strategy Analysis & Specification Validation skill. Verify that user requirements (from docs/ or specifications) are correctly mapped to API schemas and types, enforce the Contract-First development model strictly before any application code is written, and validate that API versioning changes are correctly registered in contract.version.json."
     }
 ];

package/src/shared/logger.ts

@@ -47,7 +47,8 @@ export class EnterpriseLogger {
                     fs.mkdirSync(dir, { recursive: true });
                 }
             } catch (err) {
-                console.error(`[Logger] Failed to create log directory: ${err}`);
+                // Directly write to stderr — using console here would be circular
+                process.stderr.write(`[Logger] Failed to create log directory: ${err}\n`);
             }
         }
     }
@@ -98,11 +99,12 @@ export class EnterpriseLogger {
 
         const formatted = this.formatMessage(level, message, meta);
 
-        // Output to console
+        // Route to stderr for ERROR/FATAL, stdout otherwise.
+        // Using process.write directly here is intentional — this IS the logger.
         if (level >= LogLevel.ERROR) {
-            console.error(formatted);
+            process.stderr.write(formatted + "\n");
         } else {
-            console.log(formatted);
+            process.stdout.write(formatted + "\n");
         }
 
         // Output to file if configured
@@ -110,7 +112,8 @@ export class EnterpriseLogger {
             try {
                 fs.appendFileSync(this.config.logFile, formatted + "\n", "utf8");
             } catch (err) {
-                console.error(`[Logger] Failed to write to log file: ${err}`);
+                // Directly write to stderr — using console here would be circular
+                process.stderr.write(`[Logger] Failed to write to log file: ${err}\n`);
             }
         }
     }

package/templates/prompts/bug-fix-recipe.md

@@ -0,0 +1,20 @@
+# 🐞 Bilimsel Hata Ayıklama (Bug-Fix) Reçetesi
+
+Bu reçete, bir hatayı otonom olarak nasıl tespit edip kalıcı olarak çözeceğinizi tanımlar.
+
+## 1. Yeniden Üretim (Reproduction)
+- Hatayı bildiren logları (`audit_log.md`) analiz edin.
+- Hatayı tetikleyen en küçük test vakasını (failing test) yazın.
+
+## 2. Kök Neden Analizi (Root Cause)
+- `get_system_health` ile sistem kaynaklarını kontrol edin.
+- `check_active_ports` ile servislerin durumunu doğrulayın.
+- `read_file` ile ilgili kod bloklarını satır satır inceleyin.
+
+## 3. Onarım (Surgical Fix)
+- Sadece hatayı düzeltecek cerrahi müdahaleyi yapın.
+- ".env" içinde eksik bir değişken olup olmadığını kontrol edin.
+
+## 4. Kalıcı Çözüm
+- Yazdığınız testin geçtiğini doğrulayın.
+- Benzer hataların oluşmaması için `quality-standards.md` güncellenmesi gerekiyorsa öneri sunun.

package/templates/prompts/new-feature-recipe.md

@@ -0,0 +1,19 @@
+# ✨ Yeni Özellik (New Feature) Geliştirme Reçetesi
+
+Yeni bir modül veya özellik eklerken takip edilmesi gereken "Nizam-ı Enderun" adımları.
+
+## 1. Kontrat Tasarımı (Phase 1)
+- Önce `contract.version.json` dosyasını ve ilgili TypeScript tiplerini güncelleyin.
+- `@architect` onayı almadan kod yazmaya başlamayın.
+
+## 2. Mock-Free Geliştirme (Phase 2)
+- Yeni özelliği `apps/backend` veya `apps/web` altında doğru dizine ekleyin.
+- Veritabanı değişikliği gerekiyorsa `@database` ajanıyla koordine olun.
+
+## 3. Responsive & i18n (Phase 3)
+- Frontend geliştirmelerinde `{ base: '...', md: '...' }` responsive sözdizimini kullanın.
+- Tüm metinleri anında `locales/` altına taşıyın.
+
+## 4. Tamamlama (Phase 4)
+- `get_project_gaps` ile hiçbir TODO kalmadığından emin olun.
+- `audit_dependencies` ile yeni bir paket kirliliği yaratmadığınızı doğrulayın.

package/templates/prompts/refactoring-recipe.md

@@ -0,0 +1,21 @@
+# 🛠️ Cerrahi Refactoring Reçetesi
+
+Bu reçete, mevcut bir kodu projenin diğer kısımlarını bozmadan nasıl modernize edeceğinizi tanımlar.
+
+## 1. Keşif (Reconnaissance)
+- `grep_search` kullanarak refactor edilecek fonksiyonun tüm referanslarını bulun.
+- `get_project_map` ile modülün bağımlılık grafiğini anlayın.
+- Mevcut testleri koşturarak (`run_tests`) baz hattını (baseline) doğrulayın.
+
+## 2. Planlama (Strategy)
+- Değişikliği küçük, atomik adımlara bölün.
+- Yeni tipleri ve arayüzleri (interfaces) önce tanımlayın.
+
+## 3. Uygulama (Surgical Execution)
+- **KURAL:** Dosyayı asla tamamen silmeyin. Sadece `replace_text` veya `batch_surgical_edit` kullanın.
+- Her adımda tip güvenliğini (`any` yasağı) koruyun.
+- Her büyük değişiklikten sonra `PROJECT_MEMORY.md`'yi güncelleyin.
+
+## 4. Doğrulama (Validation)
+- `run_tests` ile hiçbir regresyon oluşmadığından emin olun.
+- `@quality` ajanıyla kod kalitesini denetleyin.

package/templates/standards/architecture-standards.md

@@ -0,0 +1,23 @@
+# 📐 Kurumsal Mimari Standartları (AL Framework)
+
+Bu proje, Agent Enderun tarafından belirlenen "Nizam-ı Mimari" kurallarına uygun olarak geliştirilmektedir.
+
+## 1. Klasör Yapısı (Monorepo Standardı)
+- `apps/backend/`: İş mantığı, API ve veritabanı katmanları.
+- `apps/web/`: Frontend (React/Next.js) katmanı.
+- `packages/shared/`: Backend ve Frontend arasında paylaşılan tip tanımları ve yardımcılar.
+
+## 2. Katmanlı Mimari (Layered Architecture)
+Tüm iş mantığı şu hiyerarşiyi takip etmelidir:
+1. **Routes/Controllers:** API giriş noktaları ve request validasyonu.
+2. **Services:** İş mantığının (Business Logic) koordine edildiği yer.
+3. **Repositories/Models:** Veritabanı erişimi ve ham veri mutasyonları.
+
+## 3. Tip Güvenliği ve Kontratlar
+- `contract.version.json` dosyasındaki hash, aktif kodla her zaman uyumlu olmalıdır.
+- `any` tipi kullanımı kesinlikle yasaktır.
+- Tüm asenkron operasyonlar `try-catch` blokları ve uygun hata yönetimi (ErrorHandler) ile sarılmalıdır.
+
+## 4. AL (Agent Lifecycle) Faz Disiplini
+- Geliştirme, Faz 0'dan Faz 4'e kadar sırayla ilerler.
+- Kontratlar onaylanmadan (Faz 1) uygulama kodu yazılamaz (Faz 2).

package/templates/standards/crud-governance.md

@@ -0,0 +1,21 @@
+# 🏛️ Kurumsal CRUD ve Yönetişim Standartları
+
+Bu belge, Agent Enderun ordusu tarafından yönetilen projelerde veri mutasyonu ve idari işlemler için geçerli olan katı kuralları tanımlar.
+
+## 1. Yüksek Riskli İşlemler (High-Risk Operations)
+Aşağıdaki işlemler "Yüksek Riskli" olarak kabul edilir ve uzman ajanlar (@backend, @database vb.) tarafından otonom olarak gerçekleştirilemez:
+- Veritabanı şeması değişiklikleri (DDL).
+- Toplu veri silme veya temizleme (Bulk Delete/Purge).
+- Kullanıcı yetkilendirme ve rol atama sistemleri.
+- Ödeme sistemi (Billing) entegrasyonları.
+- PII (Kişisel Veri) dışa aktarımı.
+
+## 2. Onay Akışı (Approval Flow)
+- Uzman ajan, bir yüksek riskli işlem talebi aldığında işlemi reddetmeli ve durumu `@manager`'a bildirmelidir.
+- `@manager`, talebi analiz eder ve `managerApproval` bekleyen bir görev oluşturur.
+- İnsan denetçi (Human-in-the-Loop), `agent-enderun approve [TraceID]` komutu ile onay verene kadar işlem bekletilir.
+
+## 3. Veri Disiplini
+- **Branded Types:** Tüm ID'ler (UserID, OrderID vb.) kesinlikle branded types formatında olmalıdır.
+- **Kysely Only:** Ham SQL sorguları yasaktır. Sadece tip güvenli Kysely sorgu oluşturucu kullanılabilir.
+- **Repository Pattern:** Veritabanı işlemleri doğrudan controller'lar içinde yapılamaz; mutlaka servis ve repository katmanlarından geçmelidir.

package/templates/standards/frontend-standards.md

@@ -0,0 +1,38 @@
+# 🎨 Kurumsal Frontend ve Responsive Standartları
+
+Bu belge, Agent Enderun tarafından yönetilen projelerdeki UI/UX standartlarını tanımlar. Tüm arayüzler "Mobile-First", "Fluid Responsive" ve "Cross-Device Adaptive" prensiplerine uygun olmalıdır.
+
+## 1. Tasarım Sistemi: Panda CSS & Tailwind Entegrasyonu
+- **Sıfır UI Kütüphanesi:** Ant Design, MUI gibi hantal harici UI kütüphaneleri kullanılmaz. Tüm stiller tip güvenli **Panda CSS** veya yapılandırılmış **Tailwind CSS** ile yazılır.
+- **Token Kullanımı:** Renkler, boşluklar ve font boyutları mutlaka `token()` fonksiyonu veya standart CSS değişkenleri üzerinden yönetilmelidir.
+- **Responsive Syntax:** Obje tabanlı responsive syntax zorunludur:
+  ```typescript
+  css({
+    width: { base: '100%', md: '50%', lg: '33.33%' },
+    padding: { base: '4', md: '8' }
+  })
+  ```
+
+## 2. Mobil-First ve Akıcı Tasarım (Fluid Design)
+- **Mobile-First Yaklaşımı:** Stiller her zaman en küçük ekran boyutu (`base`) için yazılmalı, ardından `sm`, `md`, `lg`, `xl`, `2xl` breakpoint'leri ile geniş ekranlara doğru genişletilmelidir.
+- **Fluid Grid & Flexbox:** Düzenler sabit genişliklerle sınırlandırılmamalıdır. `flex-wrap`, CSS Grid (`grid-template-columns: repeat(auto-fit, minmax(280px, 1fr))`) tercih edilmelidir.
+- **Fluid Typography:** Yazı boyutları ekran genişliğine göre dinamik ölçeklenmelidir:
+  ```css
+  font-size: clamp(1rem, 2vw + 0.5rem, 2rem);
+  ```
+- **Kapsayıcı Sınırları (Container Bounds):** Sayfa ana gövdesi mutlaka responsive padding'e ve maksimum genişlik sınırına sahip olmalıdır (`max-width: 1280px` veya `1440px` standardı).
+
+## 3. Ekran Boyutu ve Cihaz Güvenliği (Viewport Safety)
+- **Viewport Taşması (Overflow Guard):** Sayfalarda yatay kaydırma çubuğu (horizontal scrollbar) oluşması kesinlikle yasaktır. Tüm elemanlara `box-sizing: border-box` uygulanmalı ve genişlikler `max-width: 100%` ile sınırlandırılmalıdır.
+- **Dinamik Viewport Birimleri:** Mobil tarayıcıların adres çubuğu değişimlerinden etkilenmemek için `vh` yerine `dvh` (Dynamic Viewport Height) ve `vw` yerine `dvw` birimleri kullanılmalıdır.
+- **Dokunmatik Hedefler (Touch Targets):** Mobil cihazlarda tıklanabilir elemanların (buton, link, input) boyutu en az `44px x 44px` olmalıdır.
+
+## 4. Bileşen Disiplini (Component Governance)
+- **Atomic Design:** UI bileşenleri `apps/web/src/components/ui/` altında toplanmalıdır.
+- **Sayfa İzolasyonu:** Sayfa dosyaları içinde stil tanımlamak yerine, reusable atomic bileşenler tercih edilmelidir.
+- **Görsel Optimizasyonu:** Responsive resimler için `picture` tagi veya `srcset` kullanılmalı, retina ekranlar için `@2x` çözünürlükleri desteklenmelidir. SVG'ler her zaman `viewBox` ile ölçeklenebilir kılınmalıdır.
+
+## 5. Erişilebilirlik ve Performans
+- **WCAG AA:** Tüm renk kontrastları ve klavye navigasyon yapıları WCAG AA standartlarına uygun olmalıdır.
+- **Lighthouse Score:** Tüm sayfalar için performans, erişilebilirlik ve SEO skorları 90+ hedeflenmelidir.
+

package/templates/standards/i18n-standards.md

@@ -0,0 +1,17 @@
+# 🌐 Kurumsal Çoklu Dil (i18n) Standartları
+
+Bu belge, Agent Enderun tarafından yönetilen projelerdeki yerelleştirme ve çoklu dil yönetim kurallarını tanımlar.
+
+## 1. Merkezi Yönetim
+- **Hardcoded Yasak:** Kullanıcıya görünen hiçbir metin doğrudan kod içine (JSX/HTML/TS) yazılmaz.
+- **Locales Dizini:** Tüm diller `apps/web/public/locales/` veya `apps/web/src/locales/` altında JSON dosyaları olarak saklanır.
+- **Key-Value Standardı:** Anlamlı ve hiyerarşik anahtarlar kullanılır (örn: `common.buttons.save`, `errors.auth.invalid_password`).
+
+## 2. Teknik Uygulama
+- **i18next:** Projelerde `next-i18next` veya `react-i18next` kütüphanesi standarttır.
+- **Dynamic Content:** Değişken içeren metinlerde mutlaka i18n interpolation (`{{name}}`) kullanılmalıdır.
+- **Pluralization:** Tekil/çoğul durumları i18n kütüphanesinin kendi kuralları ile yönetilmelidir.
+
+## 3. Denetim
+- `@frontend` ajanı, yeni bir UI bileşeni oluşturduğunda metinleri otomatik olarak ilgili JSON dosyalarına taşır.
+- Eksik çeviri (missing key) kontrolü `@quality` tarafından denetlenir.

package/templates/standards/logging-and-secrets.md

@@ -0,0 +1,29 @@
+# 🪵 Kurumsal Loglama ve Sır Yönetimi (.env) Standartları
+
+Bu belge, Agent Enderun ordusu tarafından yönetilen projelerdeki loglama disiplini ve hassas veri (secret) yönetim kurallarını tanımlar.
+
+## 1. Loglama Disiplini (Zero Console Policy)
+- **console.log Yasaktır:** Üretim (production) kodunda `console.log`, `console.warn` veya `console.error` kullanımı kesinlikle yasaktır.
+- **Enterprise Logger Kullanımı:** Tüm loglama işlemleri projenin merkezi logger sistemi (`src/shared/logger.ts`) üzerinden yapılmalıdır.
+  ```typescript
+  import { logger } from "@/shared/logger";
+  
+  logger.info("Kullanıcı giriş yaptı", { userId: "..." });
+  logger.error("Veritabanı bağlantı hatası", { error: "..." });
+  ```
+- **Log Seviyeleri (Levels):**
+  - `DEBUG`: Geliştirme aşamasındaki detaylı teknik bilgiler.
+  - `INFO`: Normal sistem akışı (örn: servis başlatıldı, görev tamamlandı).
+  - `WARN`: Hata olmayan ama dikkat edilmesi gereken durumlar.
+  - `ERROR`: Sistem çalışmasını bozmayan ama incelenmesi gereken hatalar.
+  - `FATAL`: Sistemin çökmesine neden olan kritik hatalar.
+
+## 2. Sır Yönetimi ve .env Disiplini
+- **Hassas Veriler (Secrets):** API anahtarları, veritabanı şifreleri, JWT secret'ları ve özel anahtarlar ASLA kod içine yazılmaz (hardcoded).
+- **.env Kullanımı:** Tüm hassas veriler ve çevreye özgü (environment-specific) ayarlar `.env` dosyası üzerinden yönetilir.
+- **.env.example:** Projenin kök dizininde her zaman güncel bir `.env.example` dosyası bulunmalıdır. Bu dosya sadece anahtarları içermeli, gerçek değerleri içermemelidir.
+- **Dinamik Kontrol:** Ajanlar, `.env` dosyasındaki bir değerin eksikliğini uygulama çalışma zamanından (runtime) önce doğrulamalıdır.
+
+## 3. Güvenlik Kuralları
+- **Git Ignored:** `.env` dosyası her zaman `.gitignore` içinde yer almalı ve asla source control sistemine commit edilmemelidir.
+- **Masking:** Loglarda şifre, kredi kartı numarası veya API anahtarı gibi hassas veriler asla açık bir şekilde yazılmamalıdır (Maskelenmelidir).

package/templates/standards/mobile-standards.md

@@ -0,0 +1,24 @@
+# 📱 Kurumsal Mobil Geliştirme Standartları (React Native / Expo)
+
+Bu belge, mobil uygulama geliştirme süreçlerindeki katı kuralları ve performans standartlarını tanımlar.
+
+## 1. Teknoloji Stack ve Yapı
+- **Framework:** Expo (Managed Workflow) ve React Native.
+- **Styling:** `react-native-reanimated` ve tip güvenli stil objeleri veya Tailwind (NativeWind).
+- **Navigation:** Expo Router (File-based navigation) ve Safe Link yapıları.
+
+## 2. Her Ekrana Uygun Tasarım (Responsive Mobil Düzen)
+- **Ekran Çözünürlüğü Bağımsızlığı:** Sabit `px` genişlikleri ve yükseklikleri asla kullanılmamalıdır. Bunun yerine, flexbox oranları, yüzdesel genişlikler ve `useWindowDimensions` kancasından alınan dinamik değerler kullanılmalıdır.
+- **SafeArea Güvenliği:** Tüm ekran yapıları `react-native-safe-area-context` içindeki `SafeAreaProvider` ve `SafeAreaView` (veya dinamik `insets` nesnesi) ile sarmalanarak çentikli (notch) ekranlar, durum çubukları (status bars) ve ana ekran çizgileri (home indicators) ile çakışması önlenmelidir.
+- **Yazı Boyutları ve Erişilebilirlik:** Sistem yazı boyutlarının değiştirilmesi (Accessibility Font Scaling) durumunda metinlerin kesilmemesi (truncation) veya sınırların dışına taşmaması için `Text` bileşenlerinde `numberOfLines` / `ellipsizeMode` kullanılmalı veya dinamik yükseklik sağlayan kapsayıcılar tasarlanmalıdır.
+- **Yönlendirme Adaptasyonu (Orientation):** Arayüzler hem dikey (portrait) hem de yatay (landscape) kullanım senaryolarına adapte olabilmeli; özellikle tabletlerde çift sütunlu (Master-Detail) veya Grid düzeni dinamik ekran eni/boyu oranına göre ayarlanmalıdır.
+
+## 3. Performans ve Akıcılık
+- **Performanslı Listeler:** Büyük veri listelerinde performansı korumak için `ScrollView` veya `FlatList` yerine mutlaka `FlashList` (Shopify) kullanılmalıdır.
+- **Görsel Kaynakları:** Görseller `expo-image` ile önbelleğe alınmalı, hızlı yüklenmeleri için WebP formatları tercih edilmeli ve ölçeklenirken en boy oranları (`contentFit`) korunmalıdır.
+- **Dokunmatik Hedefler (Touch Targets):** Tüm dokunmatik etkileşim alanları en az `44dp x 44dp` olmalıdır.
+
+## 4. Donanım ve Çevrimdışı Çalışma
+- **İzinler (Permissions):** Hassas izinler (konum, kamera, bildirimler) yalnızca özellik kullanılırken istenmeli ve kullanıcıya açıkça gerekçesi gösterilmelidir.
+- **Offline First (Çevrimdışı Öncelik):** Ağ istekleri `React Query` ile önbelleğe alınmalı; yerel kalıcı saklama için MMKV (veya SQLite) kullanılmalıdır.
+