agent-enderun 1.1.9 → 1.10.0

package/src/cli/adapters.ts

@@ -1,244 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { ALL_AGENTS, buildAgentJson } from "../modules/agents/definitions.js";
-import { logger } from "../shared/logger.js";
-import { writeJsonFile } from "./utils/fs.js";
-import { getPackageRoot } from "./utils/pkg.js";
-import { UI } from "./utils/ui.js";
-
-import type { AdapterConfig, AdapterId } from "./adapters/types.js";
-export { ADAPTER_IDS, type AdapterConfig, type AdapterId, type AdapterRole } from "./adapters/types.js";
-
-import { ADAPTER_CONFIGS, POST_INIT_HANDLERS } from "../modules/adapters/definitions.js";
-
-export const ADAPTERS: Record<AdapterId, AdapterConfig> = ADAPTER_CONFIGS;
-
-const POST_INIT_MAP: Record<AdapterId, (projectRoot: string, mcpBlock: unknown) => void> = POST_INIT_HANDLERS;
-
-export const FRAMEWORK_DIR_CANDIDATES = [
-    ".enderun",
-    ".cursor",
-    ".claude",
-    ".github",
-    ".grok",
-    ".windsurf",
-    ".antigravity",
-    ".agent",
-    ".gemini/antigravity-cli",
-    ".gemini",
-    ".agents",
-] as const;
-
-const SHIM_FILES = (Object.keys(ADAPTERS) as AdapterId[]).map((id) => ADAPTERS[id].shimFile);
-
-export function resolveAdapter(input?: string): AdapterConfig {
-    let normalized = (input || "gemini").toLowerCase();
-    if (normalized === "antigravity") {
-        normalized = "antigravity-cli";
-    } else if (normalized === "copilot" || normalized === "github") {
-        normalized = "codex";
-    }
-
-    let config: AdapterConfig;
-    if (normalized in ADAPTERS) {
-        config = { ...ADAPTERS[normalized as AdapterId] };
-    } else {
-        UI.warning(`Unknown adapter "${input}". Falling back to gemini.`);
-        config = { ...ADAPTERS.gemini };
-    }
-
-    return config;
-}
-
-export function isAdapterShimFile(fileName: string): boolean {
-    return SHIM_FILES.includes(fileName);
-}
-
-export function remapFrameworkContent(
-    content: string,
-    frameworkDir: string,
-    adapterId: AdapterId,
-): string {
-    let result = content;
-
-    result = result.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
-    result = result.replace(/\{\{ADAPTER\}\}/g, adapterId);
-
-    let agentFolder = "agents";
-    let knowledgeFolder = "knowledge";
-
-    if (frameworkDir !== ".enderun") {
-        if (adapterId === "antigravity-cli") {
-            agentFolder = "agents";
-            knowledgeFolder = "rules";
-        } else if (adapterId === "grok") {
-            agentFolder = "plugins";
-        }
-    }
-
-    const frameworkPattern = ".enderun/";
-    result = result.replace(new RegExp(frameworkPattern + "agents/", "g"), `${frameworkDir}/${agentFolder}/`);
-    result = result.replace(new RegExp(frameworkPattern + "knowledge/", "g"), `${frameworkDir}/${knowledgeFolder}/`);
-
-    result = result.replace(/\.enderun\//g, `${frameworkDir}/`);
-    result = result.replace(/`\.enderun`/g, `\`${frameworkDir}\``);
-    result = result.replace(/\.enderun(?![\w/-])/g, frameworkDir);
-
-    let backend = "apps/backend";
-    let frontend = "apps/web";
-    let docs = "docs";
-    let tests = "tests";
-    try {
-        const configPath = path.join(process.cwd(), frameworkDir, "config.json");
-        if (fs.existsSync(configPath)) {
-            const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
-            if (config.paths) {
-                if (config.paths.backend) backend = config.paths.backend;
-                if (config.paths.frontend) frontend = config.paths.frontend;
-                if (config.paths.docs) docs = config.paths.docs;
-                if (config.paths.tests) tests = config.paths.tests;
-            }
-        }
-    } catch (err) {
-        logger.debug("Failed to read config.json in remapFrameworkContent", err);
-    }
-
-    result = result.replace(/\{\{BACKEND_DIR\}\}/g, backend);
-    result = result.replace(/\{\{FRONTEND_DIR\}\}/g, frontend);
-    result = result.replace(/\{\{DOCS_DIR\}\}/g, docs);
-    result = result.replace(/\{\{TESTS_DIR\}\}/g, tests);
-
-    return result;
-}
-
-export function buildMcpServerEntry(projectRoot: string) {
-    const packageRoot = getPackageRoot();
-    const mcpServerPath = path.join(packageRoot, "framework-mcp/dist/index.js");
-    const relativePath = path.relative(projectRoot, mcpServerPath) || mcpServerPath;
-
-    return {
-        command: "node",
-        args: [relativePath],
-        env: {
-            ENDERUN_PROJECT_ROOT: projectRoot,
-        },
-    };
-}
-
-export function scaffoldAgents(projectRoot: string, adapterId: AdapterId, dryRun: boolean, agentsToScaffold?: string[]): void {
-    const adapter = ADAPTERS[adapterId];
-    if (!adapter || !adapter.agentsDir || !adapter.agentsExt) return;
-
-    const allowedAgents = agentsToScaffold ? new Set(agentsToScaffold) : undefined;
-    const destAgentsDir = path.join(projectRoot, adapter.agentsDir);
-    const fileExt = adapter.agentsExt;
-
-    try {
-        if (!dryRun) fs.mkdirSync(destAgentsDir, { recursive: true });
-
-        const GLOB_MAP: Record<string, string> = {
-            backend: "apps/backend/**/*",
-            frontend: "apps/web/**/*",
-            database: "apps/backend/src/database/**/*",
-            mobile: "apps/mobile/**/*",
-            native: "apps/native/**/*",
-            quality: "*",
-            security: "*",
-            devops: "*",
-            explorer: "*",
-            git: "*",
-            analyst: "*",
-            manager: "*",
-        };
-
-        for (const agent of ALL_AGENTS) {
-            if (allowedAgents && !allowedAgents.has(agent.name)) continue;
-            const name = agent.name;
-            const displayName = agent.displayName || name;
-            const description = agent.description || "";
-            const systemPrompt = agent.instructions || "";
-            const glob = GLOB_MAP[name] || "*";
-
-            // Support nested format for Antigravity-CLI standard if needed
-            const isAntigravity = adapterId === "antigravity-cli";
-            const agentDir = isAntigravity ? path.join(destAgentsDir, name) : destAgentsDir;
-            const agentFileName = isAntigravity ? "agent.md" : `${name}${fileExt}`;
-
-            if (isAntigravity && !dryRun) fs.mkdirSync(agentDir, { recursive: true });
-
-            let content: string;
-            if (fileExt === ".mdc") {
-                content = `---
-description: Agent Enderun — @${name} rules for ${displayName}. ${description.slice(0, 100)}
-globs: ${glob}
-alwaysApply: false
----
-
-# 🎖️ Agent Enderun — @${name} (${displayName})
-
-You are the **${displayName}** of the Agent Enderun Army.
-
-## 🏛️ Hierarchy of Authority
-1. **Supreme Law:** [\`.enderun/ENDERUN.md\`](\`.enderun/ENDERUN.md\`)
-2. **Global Rules:** [\`.enderun/knowledge/architecture-standards.md\`](\`.enderun/knowledge/architecture-standards.md\`), [\`.enderun/knowledge/security-standards.md\`](\`.enderun/knowledge/security-standards.md\`)
-3. **Project Memory:** [\`.enderun/memory/PROJECT_MEMORY.md\`](\`.enderun/memory/PROJECT_MEMORY.md\`)
-
-## 🤖 Specialist Directive (Role: @${name})
-${systemPrompt}
-
-## 🛡️ Core Mandates
-- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
-- **Traceability:** Inherit and pass the active Trace ID across all delegations.
-- **Approval Signature:** High-risk actions require manager approval signature.
-`;
-            } else if (isAntigravity) {
-                // Antigravity-CLI specific JSON
-                content = buildAgentJson(agent);
-                if (!dryRun) fs.writeFileSync(path.join(agentDir, "agent.json"), content);
-                // Also write MD rule
-                content = `# 🎖️ Agent Enderun — @${name} (${displayName})\n\n${systemPrompt}`;
-            } else {
-                content = `# 🎖️ Agent Enderun — @${name} (${displayName})
-
-You are the **${displayName}** of the Agent Enderun Army.
-
-## 🏛️ Hierarchy of Authority
-1. **Supreme Law:** [\`.enderun/ENDERUN.md\`](\`.enderun/ENDERUN.md\`)
-2. **Global Rules:** [\`.enderun/knowledge/architecture-standards.md\`](\`.enderun/knowledge/architecture-standards.md\`)
-3. **Project Memory:** [\`.enderun/memory/PROJECT_MEMORY.md\`](\`.enderun/memory/PROJECT_MEMORY.md\`)
-
-## 🤖 Specialist Directive (Role: @${name})
-${systemPrompt}
-
-## 🛡️ Core Mandates
-- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
-- **Traceability:** Inherit and pass the active Trace ID across all delegations.
-`;
-            }
-
-            if (!dryRun) {
-                const finalPath = isAntigravity ? path.join(agentDir, "agent.md") : path.join(agentDir, agentFileName);
-                fs.writeFileSync(finalPath, content);
-            }
-        }
-        console.warn(`✅ Generated 13 Agent/Rule definitions under ${path.relative(projectRoot, destAgentsDir)}/`);
-    } catch (e) {
-        console.warn(`⚠️  Failed to scaffold agents: ${e}`);
-    }
-}
-
-export function runAdapterPostInit(adapter: AdapterConfig, projectRoot: string): void {
-    const mcpEntry = buildMcpServerEntry(projectRoot);
-    const mcpBlock = { mcpServers: { "agent-enderun": mcpEntry } };
-
-    const postInitFn = POST_INIT_MAP[adapter.id];
-    if (postInitFn) {
-        postInitFn(projectRoot, mcpBlock);
-        // We handle agent scaffolding centrally now in initCommand
-    }
-
-    const rootMcpPath = path.join(projectRoot, "mcp.json");
-    if (!fs.existsSync(rootMcpPath)) {
-        writeJsonFile(rootMcpPath, mcpBlock);
-    }
-}

package/src/shared/config.ts

@@ -1,73 +0,0 @@
-import { z } from "zod";
-import { ConfigurationError } from "./errors.js";
-
-// Define the schema for framework configuration
-const ConfigSchema = z.object({
-    nodeEnv: z.enum(["development", "production", "test"]).default("development"),
-    logLevel: z.enum(["DEBUG", "INFO", "WARN", "ERROR", "FATAL"]).default("INFO"),
-    projectRoot: z.string().default(process.cwd()),
-    skipInstall: z.boolean().default(false),
-    mcpServerPort: z.preprocess((val) => {
-        if (typeof val === "string") {
-            const parsed = parseInt(val, 10);
-            return isNaN(parsed) ? undefined : parsed;
-        }
-        return val;
-    }, z.number().int().min(1024).max(65535).optional()),
-});
-
-export type AppConfig = z.infer<typeof ConfigSchema>;
-
-class ConfigurationManager {
-    private static instance: ConfigurationManager;
-    private config!: AppConfig;
-
-    private constructor() {
-        this.load();
-    }
-
-    public static getInstance(): ConfigurationManager {
-        if (!ConfigurationManager.instance) {
-            ConfigurationManager.instance = new ConfigurationManager();
-        }
-        return ConfigurationManager.instance;
-    }
-
-    private load(): void {
-        try {
-            const rawConfig = {
-                nodeEnv: process.env.NODE_ENV,
-                logLevel: process.env.LOG_LEVEL || (process.env.NODE_ENV === "production" ? "INFO" : "DEBUG"),
-                projectRoot: process.env.ENDERUN_PROJECT_ROOT || process.cwd(),
-                skipInstall: process.env.ENDERUN_SKIP_INSTALL === "1" || process.env.ENDERUN_SKIP_INSTALL === "true",
-                mcpServerPort: process.env.MCP_SERVER_PORT,
-            };
-
-            const parsed = ConfigSchema.safeParse(rawConfig);
-            if (!parsed.success) {
-                throw new ConfigurationError(
-                    "Failed to validate environment configuration parameters",
-                    parsed.error.format()
-                );
-            }
-
-            // Freeze the configuration to prevent modifications at runtime
-            this.config = Object.freeze(parsed.data);
-        } catch (err) {
-            if (err instanceof ConfigurationError) {
-                throw err;
-            }
-            throw new ConfigurationError(`Failed to load system configuration: ${err}`);
-        }
-    }
-
-    /**
-     * Gets the read-only, validated system configuration object.
-     */
-    public get(): AppConfig {
-        return this.config;
-    }
-}
-
-export const configManager = ConfigurationManager.getInstance();
-export const currentConfig = configManager.get();

package/src/shared/container.ts

@@ -1,67 +0,0 @@
-import { ValidationError } from "./errors.js";
-
-export type FactoryFunction<T> = (container: ServiceContainer) => T;
-
-export class ServiceContainer {
-    private static instance: ServiceContainer;
-    private services: Map<string, unknown> = new Map();
-    private factories: Map<string, FactoryFunction<unknown>> = new Map();
-
-    private constructor() {}
-
-    public static getInstance(): ServiceContainer {
-        if (!ServiceContainer.instance) {
-            ServiceContainer.instance = new ServiceContainer();
-        }
-        return ServiceContainer.instance;
-    }
-
-    /**
-     * Registers a pre-instantiated singleton service.
-     */
-    public register<T>(name: string, service: T): void {
-        if (this.services.has(name)) {
-            throw new ValidationError(`Service '${name}' is already registered.`);
-        }
-        this.services.set(name, service);
-    }
-
-    /**
-     * Registers a factory function for lazy evaluation.
-     */
-    public registerFactory<T>(name: string, factory: FactoryFunction<T>): void {
-        if (this.factories.has(name) || this.services.has(name)) {
-            throw new ValidationError(`Service or factory '${name}' is already registered.`);
-        }
-        this.factories.set(name, factory);
-    }
-
-    /**
-     * Resolves the requested service.
-     */
-    public resolve<T>(name: string): T {
-        if (this.services.has(name)) {
-            return this.services.get(name) as T;
-        }
-
-        if (this.factories.has(name)) {
-            const factory = this.factories.get(name) as FactoryFunction<T>;
-            const service = factory(this);
-            this.services.set(name, service); // Cache it as a singleton
-            this.factories.delete(name);
-            return service;
-        }
-
-        throw new ValidationError(`Dependency resolution failed: Service '${name}' not found in container.`);
-    }
-
-    /**
-     * Resets the container. Useful for test environments.
-     */
-    public reset(): void {
-        this.services.clear();
-        this.factories.clear();
-    }
-}
-
-export const container = ServiceContainer.getInstance();

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

@@ -1,20 +0,0 @@
-# 🐞 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

@@ -1,19 +0,0 @@
-# ✨ 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

@@ -1,21 +0,0 @@
-# 🛠️ 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

@@ -1,23 +0,0 @@
-# 📐 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

@@ -1,21 +0,0 @@
-# 🏛️ 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

@@ -1,38 +0,0 @@
-# 🎨 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

@@ -1,17 +0,0 @@
-# 🌐 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

@@ -1,29 +0,0 @@
-# 🪵 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

@@ -1,24 +0,0 @@
-# 📱 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.
-

package/templates/standards/quality-standards.md

@@ -1,31 +0,0 @@
-# ⚖️ Kurumsal Kod Kalitesi ve Disiplini (Linting & Standards)
-
-Bu belge, Agent Enderun ordusu tarafından üretilen tüm kodların uyması gereken teknik disiplin kurallarını tanımlar. Amaç; sıfır hata, maksimum okunabilirlik ve sürdürülebilirliktir.
-
-## 1. TypeScript Disiplini
-- **Strict Mode:** Tüm projelerde `strict: true` zorunludur.
-- **No Explicit Any:** `any` kullanımı kesinlikle yasaktır. Belirsiz tipler için `unknown` kullanılmalı ve tip muhafazaları (type guards) ile doğrulanmalıdır.
-- **Exhaustive Checks:** `switch-case` yapılarında tüm durumlar (exhaustive) kontrol edilmeli veya `never` tipi ile güvenlik sağlanmalıdır.
-
-## 2. ESLint ve Statik Analiz
-- **Zero Warnings:** Kod tabanında hiçbir ESLint uyarısı (warning) veya hatası (error) bulunamaz.
-- **Naming Conventions:**
-  - Değişkenler ve fonksiyonlar: `camelCase`
-  - Sınıflar ve Tipler: `PascalCase`
-  - Sabitler: `UPPER_SNAKE_CASE`
-  - Dosya isimleri: `kebab-case`
-- **Imports:** Kullanılmayan importlar otomatik olarak temizlenmeli ve import sırası düzenli olmalıdır.
-
-## 3. Formatlama (Prettier)
-- **Consistency:** Tüm dosyalarda tek tip formatlama zorunludur.
-- **Indentation:** 4 boşluk (4 spaces).
-- **Quotes:** Çift tırnak (`"`) kullanımı.
-- **Semicolons:** Her ifade noktalı virgül (`;`) ile bitmelidir.
-
-## 4. Hata Yönetimi (Error Handling)
-- **No Silent Failures:** Boş `catch` blokları yasaktır. Her hata en azından loglanmalı veya üst katmana iletilmelidir.
-- **Custom Errors:** İş mantığı hataları için projeye özgü `AppError` sınıfları kullanılmalıdır.
-
-## 5. Denetim Döngüsü
-- **Pre-commit:** Kod commit edilmeden önce mutlaka `npm run lint` ve `npm run type-check` çalıştırılmalıdır.
-- **@quality Audit:** Tüm değişiklikler `@quality` ajanı tarafından bu standartlara göre denetlenir.

package/templates/standards/security-standards.md

@@ -1,21 +0,0 @@
-# 🛡️ Kurumsal Güvenlik ve Veri Koruma Standartları
-
-Bu belge, Agent Enderun tarafından yönetilen projelerdeki güvenlik protokollerini ve veri koruma standartlarını tanımlar.
-
-## 1. Veri Tabanı Güvenliği (RLS)
-- **Row Level Security (RLS):** Tüm kullanıcı verileri RLS politikaları ile korunmalıdır. Bir kullanıcı, `@manager` tarafından onaylanmış bir izin protokolü dışında başka bir kullanıcının verisine erişemez.
-- **SQL Injection:** Ham SQL sorguları kesinlikle yasaktır (Kysely zorunluluğu).
-- **Encryption at Rest:** Hassas veriler (PII) veritabanında şifrelenmiş olarak saklanmalıdır.
-
-## 2. Kimlik Doğrulama ve Yetkilendirme
-- **JWT / Session:** Sadece `@security` ajanı tarafından onaylanmış güvenli kimlik doğrulama yöntemleri kullanılır.
-- **Role Based Access Control (RBAC):** Yetkilendirme şemaları `apps/backend/src/security/roles.ts` altında merkezi olarak yönetilmelidir.
-
-## 3. API Güvenliği
-- **CORS:** Sadece izin verilen domainler API'ye erişebilir.
-- **Rate Limiting:** Tüm API uç noktaları için rate limiting uygulanmalıdır.
-- **Input Validation:** Zod veya benzeri bir kütüphane ile tüm girdiler (request body, params) sıkı bir şekilde doğrulanmalıdır.
-
-## 4. Sır Yönetimi (Secret Management)
-- **No Hardcoded Secrets:** API anahtarları, şifreler veya gizli anahtarlar asla kod içinde saklanamaz.
-- **.env Discipline:** Tüm gizli değişkenler `.env` dosyası üzerinden yönetilmeli ve bu dosya asla git'e pushlanmamalıdır.