atabey 0.0.6 → 0.0.8

package/{src/cli/commands/check.ts → framework-mcp/dist/src/cli/commands/check.js}

@@ -1,7 +1,6 @@
 import fs from "fs";
 import path from "path";
 import { execSync } from "child_process";
-
 import { getFrameworkDir, getMemoryPath, getConfiguredPaths, isFrameworkDevelopmentRepo, readState } from "../utils/memory.js";
 import { getPackageVersion, getValidatorPath } from "../utils/pkg.js";
 import { UI } from "../utils/ui.js";
@@ -9,25 +8,19 @@ import { logger } from "../../shared/logger.js";
 import { scanProjectCompliance } from "../utils/compliance.js";
 import { ALL_AGENTS } from "../../modules/agents/definitions.js";
 import { detectActiveAgentLayouts, findAgentInstruction } from "../adapters/paths.js";
-
 import { verifyApiContractCommand } from "./contract.js";
-
 export async function checkCommand() {
     UI.intent("Agent Atabey Health Check", `Checking system health and discipline rules (v${getPackageVersion()})...`);
     let issues = 0;
-
     const state = readState();
     if (!state) {
         UI.error("Memory state not found. Run 'init' first.");
         return;
     }
-
     const frameworkDir = getFrameworkDir();
     const memoryPath = getMemoryPath();
     const pathsMap = getConfiguredPaths();
-
     UI.success(`Using framework dir: ${frameworkDir}`);
-
     // --- Contract Gate (Phase 2+ Discipline) ---
     if (["PHASE_2", "PHASE_3", "PHASE_4"].includes(state.phase)) {
         console.warn("\n📝 Validating API Contracts (Phase 2+ Required)...");
@@ -36,30 +29,27 @@ export async function checkCommand() {
             if (!contractOk) {
                 UI.error("Contract verification FAILED! You cannot be in Phase 2+ with unverified contracts.");
                 issues++;
-            } else {
+            }
+            else {
                 UI.success("API Contracts verified and sealed.");
             }
-        } catch {
+        }
+        catch {
             UI.error("Error during contract verification.");
             issues++;
         }
     }
-
     let knowledgeDir = "knowledge";
-    if (frameworkDir === ".github") knowledgeDir = "instructions";
-
+    if (frameworkDir === ".github")
+        knowledgeDir = "instructions";
     const constitutionPath = fs.existsSync(path.join(process.cwd(), "ATABEY.md")) ? "ATABEY.md" : path.join(frameworkDir, "ATABEY.md");
-    
     const rootPandaPath = path.join(process.cwd(), "panda.config.ts");
     const appPandaPath = path.join(pathsMap.frontend, "panda.config.ts");
-
     if (fs.existsSync(rootPandaPath)) {
         UI.error(`Panda CSS config must NOT be at the root directory! Move it to '${pathsMap.frontend}/panda.config.ts'.`);
         issues++;
     }
-
     const isFrameworkDevelopment = isFrameworkDevelopmentRepo();
-
     const checks = [
         { name: "Constitution (ATABEY.md)", path: constitutionPath },
         { name: "Memory (PROJECT_MEMORY.md)", path: path.relative(process.cwd(), memoryPath) },
@@ -72,6 +62,8 @@ export async function checkCommand() {
         { name: "CRUD Governance Standards", path: path.join(frameworkDir, `${knowledgeDir}/crud-governance.md`) },
         { name: "Architecture Standards", path: path.join(frameworkDir, `${knowledgeDir}/architecture-standards.md`) },
         { name: "Frontend Standards", path: path.join(frameworkDir, `${knowledgeDir}/frontend-standards.md`) },
+        { name: "Vite Standards", path: path.join(frameworkDir, `${knowledgeDir}/vite-standards.md`), optional: true },
+        { name: "Next.js Standards", path: path.join(frameworkDir, `${knowledgeDir}/nextjs-standards.md`), optional: true },
         { name: "Tailwind Standards", path: path.join(frameworkDir, `${knowledgeDir}/tailwind-standards.md`), optional: true },
         { name: "Mobile Standards", path: path.join(frameworkDir, `${knowledgeDir}/mobile-standards.md`) },
         { name: "Security Standards", path: path.join(frameworkDir, `${knowledgeDir}/security-standards.md`) },
@@ -83,56 +75,56 @@ export async function checkCommand() {
         ...(isFrameworkDevelopment ? [{ name: "MCP Server", path: "framework-mcp/package.json" }] : []),
         { name: "Panda CSS Config", path: appPandaPath, optional: true },
     ];
-
     for (const check of checks) {
         const fullPath = path.isAbsolute(check.path) ? check.path : path.join(process.cwd(), check.path);
         if (fs.existsSync(fullPath)) {
             UI.success(`${check.name} found.`);
-        } else {
+        }
+        else {
             if (check.optional) {
                 UI.warning(`${check.name} MISSING! (${check.path}) [Optional]`);
-            } else {
+            }
+            else {
                 UI.error(`${check.name} MISSING! (${check.path})`);
                 issues++;
             }
         }
     }
-
     // Agent Army Check
-    console.warn("\n🛡️  Running Agent Army Compliance...");
+    console.warn("\n[SECURITY]  Running Agent Army Compliance...");
     try {
         const validatorScript = getValidatorPath();
         execSync(`node "${validatorScript}"`, { stdio: "pipe" });
         UI.success("Agent Army AL validation PASSED.");
-    } catch (error: unknown) {
-        const err = error as Error & { stderr?: Buffer };
+    }
+    catch (error) {
+        const err = error;
         UI.error(`Agent Army AL validation FAILED: ${err.message}`);
-        if (err.stderr) console.error(err.stderr.toString());
+        if (err.stderr)
+            console.error(err.stderr.toString());
         issues++;
     }
-
     // Agent Documentation Check (Live Integrity)
     console.warn("\n📚 Checking Agent Integrity (Instructions)...");
-
     const projectRoot = process.cwd();
     const activeLayouts = detectActiveAgentLayouts(projectRoot);
-
     if (activeLayouts.length > 0) {
         UI.success(`Active agent layout(s): ${activeLayouts.join(", ")}`);
         ALL_AGENTS.forEach((agent) => {
             const found = findAgentInstruction(projectRoot, agent.name);
             if (found) {
                 UI.success(`Instructions for @${agent.name} found at ${found}`);
-            } else {
+            }
+            else {
                 UI.error(`Instructions for @${agent.name} MISSING! Run 'atabey init' to scaffold.`);
                 issues++;
             }
         });
-    } else {
+    }
+    else {
         UI.warning("No active agent instruction directory detected. Run 'atabey init [adapter]' first.");
         issues++;
     }
-
     // Code Quality - Using the new Compliance Scanner
     console.warn("\n⚖️  Checking Discipline (Code Quality)...");
     const complianceIssues = scanProjectCompliance();
@@ -141,37 +133,37 @@ export async function checkCommand() {
             UI.error(`${issue.rule} in ${issue.file}:${issue.line}`);
         });
         issues += complianceIssues.length;
-    } else {
+    }
+    else {
         UI.success("No compliance issues detected.");
     }
-
     const rootTestFiles = checkRootTestFiles();
     if (rootTestFiles.length > 0) {
         UI.warning(`Test files found in the root directory: ${rootTestFiles.join(", ")}. It is recommended to place all test files under the 'tests/' folder or application-specific directories.`);
     }
-
     try {
         UI.intent("Type Check", "Running 'npx tsc --noEmit' (this may take a few seconds)...");
         execSync("npx tsc --noEmit", { stdio: "pipe" });
         UI.success("TypeScript type check PASSED.");
-    } catch (err) {
+    }
+    catch (err) {
         UI.warning("TypeScript type check FAILED or 'tsc' not found. This is a non-blocking warning for lightweight checks.");
         logger.debug("npx tsc --noEmit check failed", err);
     }
-
     if (issues === 0) {
-        UI.success("\n🚀 All systems green! Agent Atabey is ready.");
-    } else {
-        UI.error(`\n⚠️  Found ${issues} issues. Please fix them.`);
+        UI.success("\n[START] All systems green! Agent Atabey is ready.");
+    }
+    else {
+        UI.error(`\n[WARN]  Found ${issues} issues. Please fix them.`);
         process.exit(1);
     }
 }
-
-function checkRootTestFiles(): string[] {
+function checkRootTestFiles() {
     const rootDir = process.cwd();
-    if (!fs.existsSync(rootDir)) return [];
+    if (!fs.existsSync(rootDir))
+        return [];
     const files = fs.readdirSync(rootDir);
-    const testFiles: string[] = [];
+    const testFiles = [];
     for (const file of files) {
         const fullPath = path.join(rootDir, file);
         try {
@@ -180,7 +172,8 @@ function checkRootTestFiles(): string[] {
                     testFiles.push(file);
                 }
             }
-        } catch (err) {
+        }
+        catch (err) {
             logger.debug(`Failed to stat file ${fullPath} in checkRootTestFiles`, err);
         }
     }

package/{src/cli/commands/compliance.ts → framework-mcp/dist/src/cli/commands/compliance.js}

@@ -1,15 +1,11 @@
 import fs from "fs";
 import path from "path";
-
 import { collectFiles } from "../utils/fs.js";
-
 const targetDir = process.cwd(); // Assuming targetDir is process.cwd() in the CLI context
-
-export async function complianceCheckCommand(targetPath: string) {
+export async function complianceCheckCommand(targetPath) {
     console.warn(`📜 Checking Constitution Compliance: ${targetPath}...`);
-    const violations: string[] = [];
+    const violations = [];
     const forbidden = ["@shadcn", "mui", "@chakra-ui", "tailwindcss"];
-
     // 1. package.json scan (Blind Spot 5)
     const pkgJsonPath = path.join(targetDir, "package.json");
     if (fs.existsSync(pkgJsonPath)) {
@@ -21,21 +17,20 @@ export async function complianceCheckCommand(targetPath: string) {
                     violations.push(`package.json: Forbidden library dependency '${lib}' found in package.json.`);
                 }
             });
-        } catch {
+        }
+        catch {
             // ignore
         }
     }
-
     // 2. Source files scan
     const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx", ".js", ".jsx", ".md"]);
     files.forEach(f => {
         const isTypesFile = f.includes("brands.ts") || f.includes("brands.js") || f.includes("brands.tsx") || f.includes("src/types/brands");
-
         const content = fs.readFileSync(f, "utf8");
         forbidden.forEach(lib => {
-            if (content.includes(lib)) violations.push(`${path.relative(targetDir, f)}: Forbidden library '${lib}' found.`);
+            if (content.includes(lib))
+                violations.push(`${path.relative(targetDir, f)}: Forbidden library '${lib}' found.`);
         });
-
         // Robust Branded Types validation (Blind Spot 4)
         if ((f.endsWith(".ts") || f.endsWith(".tsx")) && !isTypesFile && content.includes("interface")) {
             const plainIdMatches = content.match(/\b\w*(?:id|Id|ID)\??\s*:\s*(?:string|number)\b/g);
@@ -46,10 +41,10 @@ export async function complianceCheckCommand(targetPath: string) {
             }
         }
     });
-
     if (violations.length === 0) {
-        console.warn("✅ All systems compliant with ATABEY.md.");
-    } else {
-        violations.forEach(v => console.warn(`❌ ${v}`));
+        console.warn("[OK] All systems compliant with ATABEY.md.");
+    }
+    else {
+        violations.forEach(v => console.warn(`[ERROR] ${v}`));
     }
 }

package/{src/cli/commands/contract.ts → framework-mcp/dist/src/cli/commands/contract.js}

@@ -3,41 +3,32 @@ import fs from "fs";
 import { getConfiguredPaths } from "../utils/memory.js";
 import { computeTypesHash, writeJsonFile } from "../utils/fs.js";
 import { ValidationError } from "../../shared/errors.js";
-
 /**
  * Verify type safety between backend and frontend contracts.
  */
-export async function verifyApiContractCommand(options: { silent?: boolean } = {}): Promise<boolean> {
+export async function verifyApiContractCommand(options = {}) {
     const projectRoot = process.cwd();
     const pathsMap = getConfiguredPaths();
     const sharedDir = path.join(projectRoot, pathsMap.backend, "src/types");
     const contractPath = path.join(projectRoot, pathsMap.backend, "contract.version.json");
-
     if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) {
-        if (options.silent) return false;
-        throw new ValidationError(
-            "API types or contract version file missing.",
-            null,
-            "Ensure you have initialized the project and the backend directory is correctly configured in config.json."
-        );
+        if (options.silent)
+            return false;
+        throw new ValidationError("API types or contract version file missing.", null, "Ensure you have initialized the project and the backend directory is correctly configured in config.json.");
     }
-
     const currentHash = computeTypesHash(projectRoot, sharedDir);
     const contract = JSON.parse(fs.readFileSync(contractPath, "utf8"));
-
     if (contract.contract_hash === currentHash) {
-        if (!options.silent) console.warn("✅ Contract is valid and synchronized.");
+        if (!options.silent)
+            console.warn("[OK] Contract is valid and synchronized.");
         return true;
-    } else {
-        if (options.silent) return false;
-        throw new ValidationError(
-            "Contract drift detected!",
-            { stored: contract.contract_hash, actual: currentHash },
-            "Run 'npx atabey update-contract' to re-synchronize the API contracts."
-        );
+    }
+    else {
+        if (options.silent)
+            return false;
+        throw new ValidationError("Contract drift detected!", { stored: contract.contract_hash, actual: currentHash }, "Run 'npx atabey update-contract' to re-synchronize the API contracts.");
     }
 }
-
 /**
  * Update and synchronize type safety between backend and frontend contracts.
  */
@@ -46,23 +37,14 @@ export async function updateApiContractCommand() {
     const pathsMap = getConfiguredPaths();
     const sharedDir = path.join(projectRoot, pathsMap.backend, "src/types");
     const contractPath = path.join(projectRoot, pathsMap.backend, "contract.version.json");
-
     if (!fs.existsSync(sharedDir)) {
-        throw new ValidationError(
-            "API types directory missing.",
-            null,
-            "The directory specified for backend types does not exist. Check your framework configuration."
-        );
+        throw new ValidationError("API types directory missing.", null, "The directory specified for backend types does not exist. Check your framework configuration.");
     }
-
     const currentHash = computeTypesHash(projectRoot, sharedDir);
-    
     const contractData = {
         contract_hash: currentHash,
         last_updated: new Date().toISOString()
     };
-    
     writeJsonFile(contractPath, contractData);
-    console.warn(`✅ Contract successfully synchronized. New hash: ${currentHash}`);
+    console.warn(`[OK] Contract successfully synchronized. New hash: ${currentHash}`);
 }
-

package/framework-mcp/dist/src/cli/commands/dashboard.js

@@ -0,0 +1,123 @@
+import http from "http";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { getFrameworkDir } from "../utils/memory.js";
+import { UI } from "../utils/ui.js";
+import { FRAMEWORK } from "../../shared/constants.js";
+/**
+ * Serves a JSON file.
+ */
+function serveJson(res, filePath) {
+    if (fs.existsSync(filePath)) {
+        try {
+            const content = fs.readFileSync(filePath, "utf8");
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(content);
+        }
+        catch (e) {
+            res.writeHead(500);
+            res.end(JSON.stringify({ error: "Read Error", message: e.message }));
+        }
+    }
+    else {
+        res.writeHead(404);
+        res.end(JSON.stringify({ error: "Not Found", path: filePath }));
+    }
+}
+/**
+ * Serves a file with specific content type.
+ */
+function serveFile(res, filePath, contentType) {
+    if (fs.existsSync(filePath)) {
+        try {
+            const content = fs.readFileSync(filePath);
+            res.writeHead(200, { "Content-Type": contentType });
+            res.end(content);
+        }
+        catch (e) {
+            res.writeHead(500);
+            res.end(e.message);
+        }
+    }
+    else {
+        res.writeHead(404);
+        res.end("Not Found");
+    }
+}
+/**
+ * 🖥️ Hermes Visual Control Plane (Dashboard Server)
+ * Serves the framework state as a JSON API and the bundled Web UI.
+ */
+export async function dashboardCommand(port = FRAMEWORK.DASHBOARD_PORT) {
+    const frameworkDir = getFrameworkDir();
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const projectRoot = path.resolve(__dirname, "../../../");
+    const uiDistPath = path.join(projectRoot, "dist/ui");
+    const server = http.createServer((req, res) => {
+        // CORS Headers
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = req.url || "/";
+        // API Routes
+        if (url === "/api/status") {
+            const statusPath = path.join(frameworkDir, "memory", "status.json");
+            serveJson(res, statusPath);
+            return;
+        }
+        if (url === "/api/memory") {
+            const memoryPath = path.join(frameworkDir, "memory", "PROJECT_MEMORY.md");
+            serveFile(res, memoryPath, "text/markdown");
+            return;
+        }
+        if (url.startsWith("/api/logs/")) {
+            const agent = url.replace("/api/logs/", "");
+            const logPath = path.join(frameworkDir, "logs", `${agent}.json`);
+            serveJson(res, logPath);
+            return;
+        }
+        if (url === "/api/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "healthy", version: "0.0.6", frameworkDir }));
+            return;
+        }
+        // Static UI Serving
+        let filePath = path.join(uiDistPath, url === "/" ? "index.html" : url);
+        // Fallback to index.html for SPA routing if file not found
+        if (!fs.existsSync(filePath) && !url.startsWith("/api")) {
+            filePath = path.join(uiDistPath, "index.html");
+        }
+        if (fs.existsSync(filePath) && !fs.statSync(filePath).isDirectory()) {
+            const ext = path.extname(filePath).toLowerCase();
+            const mimeTypes = {
+                ".html": "text/html",
+                ".js": "application/javascript",
+                ".css": "text/css",
+                ".json": "application/json",
+                ".png": "image/png",
+                ".jpg": "image/jpg",
+                ".gif": "image/gif",
+                ".svg": "image/svg+xml",
+                ".ico": "image/x-icon",
+            };
+            const contentType = mimeTypes[ext] || "application/octet-stream";
+            serveFile(res, filePath, contentType);
+        }
+        else {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Not Found", message: "Route not found" }));
+        }
+    });
+    server.listen(port, () => {
+        UI.success("\n[START] Hermes Visual Control Plane is running!");
+        UI.success(`[INFO] Web UI:    http://localhost:${port}`);
+        UI.success(`[DATA] API Base:  http://localhost:${port}/api`);
+        UI.warning("\n(Press Ctrl+C to stop the server)\n");
+    });
+}

package/{src/cli/commands/explorer.ts → framework-mcp/dist/src/cli/commands/explorer.js}

@@ -1,14 +1,11 @@
 import fs from "fs";
 import path from "path";
-
 import { collectFiles } from "../utils/fs.js";
-
 const targetDir = process.cwd();
-
-export async function explorerGraphCommand(targetPath: string) {
+export async function explorerGraphCommand(targetPath) {
     console.warn(`🗺️  Generating Dependency Graph for: ${targetPath}...`);
     const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
-    const edges: string[] = [];
+    const edges = [];
     files.forEach((f) => {
         const content = fs.readFileSync(f, "utf8");
         const name = path.basename(f, path.extname(f));
@@ -20,26 +17,26 @@ export async function explorerGraphCommand(targetPath: string) {
     });
     if (edges.length === 0) {
         console.warn("ℹ️ No internal dependencies found.");
-    } else {
-        console.warn(
-            "```mermaid\ngraph TD\n" + Array.from(new Set(edges)).join("\n") + "\n```",
-        );
+    }
+    else {
+        console.warn("```mermaid\ngraph TD\n" + Array.from(new Set(edges)).join("\n") + "\n```");
     }
 }
-
-export async function explorerAuditCommand(targetPath: string) {
-    console.warn(`🧠 Codebase Intelligence Scan: ${targetPath}...`);
+export async function explorerAuditCommand(targetPath) {
+    console.warn(`[MEMORY] Codebase Intelligence Scan: ${targetPath}...`);
     const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
-    const complexity: string[] = [];
+    const complexity = [];
     files.forEach((f) => {
         const content = fs.readFileSync(f, "utf8");
         const lines = content.split("\n").length;
-        if (lines > 300) complexity.push(`${path.relative(targetDir, f)} (${lines} lines)`);
+        if (lines > 300)
+            complexity.push(`${path.relative(targetDir, f)} (${lines} lines)`);
     });
     if (complexity.length > 0) {
-        console.warn("\n⚠️ Complexity Spikes:");
+        console.warn("\n[WARN] Complexity Spikes:");
         complexity.forEach((c) => console.warn(`- ${c}`));
-    } else {
-        console.warn("✅ Codebase structure looks clean.");
+    }
+    else {
+        console.warn("[OK] Codebase structure looks clean.");
     }
 }

package/{src/cli/commands/git.ts → framework-mcp/dist/src/cli/commands/git.js}

@@ -1,8 +1,7 @@
 import cp from "child_process";
 import path from "path";
 import { getConfiguredPaths } from "../utils/memory.js";
-
-export async function gitCommitCommand(traceId: string) {
+export async function gitCommitCommand(traceId) {
     try {
         const diff = cp.execSync("git diff --staged", { encoding: "utf8" });
         if (!diff) {
@@ -16,24 +15,26 @@ export async function gitCommitCommand(traceId: string) {
         const backendTypesPath = path.join(pathsMap.backend, "src/types");
         let type = "feat";
         const scope = "code";
-        if (files.some((f) => f.includes(".md"))) type = "docs";
-        else if (files.some((f) => f.includes(backendTypesPath))) type = "arch";
-        else if (files.some((f) => f.includes("bin/cli.js"))) type = "fix";
-
-        const summary =
-      files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
+        if (files.some((f) => f.includes(".md")))
+            type = "docs";
+        else if (files.some((f) => f.includes(backendTypesPath)))
+            type = "arch";
+        else if (files.some((f) => f.includes("bin/cli.js")))
+            type = "fix";
+        const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
         console.warn(`\n### SUGGESTED COMMIT MESSAGE ###\n\n[${traceId}] ${type}(${scope}): ${summary}\n`);
-    } catch {
-        console.warn("❌ Git command failed.");
+    }
+    catch {
+        console.warn("[ERROR] Git command failed.");
     }
 }
-
 export async function gitSyncCommand() {
     console.warn("🔄 Syncing with remote repository...");
     try {
         cp.execSync("git pull origin main --rebase", { stdio: "inherit" });
-        console.warn("✅ Successfully synced and rebased.");
-    } catch {
-        console.warn("❌ Sync failed. Please resolve conflicts manually.");
+        console.warn("[OK] Successfully synced and rebased.");
+    }
+    catch {
+        console.warn("[ERROR] Sync failed. Please resolve conflicts manually.");
     }
 }

package/framework-mcp/dist/src/cli/commands/init/create-agent.js

@@ -0,0 +1,58 @@
+import fs from "fs";
+import path from "path";
+import { UI } from "../../utils/ui.js";
+import { writeTextFile } from "../../../shared/fs.js";
+/**
+ * Plugin SDK: Creates a new custom agent template.
+ */
+export async function createAgentCommand(name) {
+    const projectRoot = process.cwd();
+    const agentsDir = path.join(projectRoot, "src/modules/agents/registry");
+    if (!fs.existsSync(agentsDir)) {
+        UI.error("Ajan kayıt dizini bulunamadı. Lütfen Atabey geliştirme ortamında olduğunuzdan emin olun.");
+        return;
+    }
+    const filePath = path.join(agentsDir, `${name}.ts`);
+    if (fs.existsSync(filePath)) {
+        UI.error(`Ajan '${name}' zaten mevcut.`);
+        return;
+    }
+    const template = `import { AgentDefinition } from "../types.js";
+
+const STATE_MACHINE = "../schema/agent-lifecycle-schema.json" as const;
+
+export const ${name}: AgentDefinition = {
+    name: "${name}",
+    displayName: "${name.charAt(0).toUpperCase() + name.slice(1)} Specialist",
+    role: "Custom Specialty",
+    description: "Automatically generated custom agent for specific project needs.",
+    capability: 7,
+    tier: "core",
+    tags: ["custom"],
+    stateMachine: STATE_MACHINE,
+    tools: [
+        "read_file",
+        "write_file",
+        "replace_text",
+        "grep_search",
+        "send_agent_message",
+    ],
+    instructions: {
+        identity: "${name.toUpperCase()} Domain Expert",
+        mission: "Execute tasks related to ${name} with high precision and following Atabey standards.",
+        chainOfThought: "1. Analyze Task\\n2. Plan Steps\\n3. Execute\\n4. Verify",
+        rules: [
+            "Always maintain type safety.",
+            "Log all critical actions.",
+        ],
+        knowledgeFiles: [],
+    },
+    specialties: {
+        ${name}: 10,
+    },
+};
+`;
+    writeTextFile(filePath, template);
+    UI.success(`[OK] New agent '${name}' created at src/modules/agents/registry/${name}.ts`);
+    UI.warning("[INFO] Don't forget to register the agent in src/modules/agents/definitions.ts");
+}