agent-enderun 1.1.6 → 1.1.8

package/src/cli/commands/check.ts

@@ -5,6 +5,7 @@ import { execSync } from "child_process";
 import { getFrameworkDir, getMemoryPath, getConfiguredPaths } from "../utils/memory.js";
 import { getPackageVersion, getValidatorPath } from "../utils/pkg.js";
 import { UI } from "../utils/ui.js";
+import { logger } from "../../shared/logger.js";
 
 const FRAMEWORK_VERSION = getPackageVersion();
 
@@ -40,8 +41,8 @@ export function checkCommand() {
                 isFrameworkDevelopment = true;
             }
         }
-    } catch {
-        // ignore
+    } catch (err) {
+        logger.debug("Failed to read package.json in checkCommand", err);
     }
 
     const checks = [
@@ -53,6 +54,17 @@ export function checkCommand() {
         { name: "MCP Config (mcp.json)", path: "mcp.json" },
         { name: "ESLint Config (eslint.config.js)", path: "eslint.config.js", optional: !isFrameworkDevelopment },
         { name: "ESLint Standards", path: path.join(frameworkDir, `${knowledgeDir}/eslint-standards.md`) },
+        { 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: "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`) },
+        { name: "Quality & Discipline Standards", path: path.join(frameworkDir, `${knowledgeDir}/quality-standards.md`) },
+        { name: "Logging & Secrets Standards", path: path.join(frameworkDir, `${knowledgeDir}/logging-and-secrets.md`) },
+        { name: "Testing Standards", path: path.join(frameworkDir, `${knowledgeDir}/testing-standards.md`) },
+        { name: "i18n Standards", path: path.join(frameworkDir, `${knowledgeDir}/i18n-standards.md`) },
+        { name: ".env.example", path: ".env.example" },
         ...(isFrameworkDevelopment ? [{ name: "MCP Server", path: "framework-mcp/package.json" }] : []),
         { name: "Panda CSS Config", path: appPandaPath, optional: true },
         { name: "Brain Dashboard", path: path.join(frameworkDir, "BRAIN_DASHBOARD.md") },
@@ -95,6 +107,14 @@ export function checkCommand() {
         UI.success("No forbidden 'console.log' detected.");
     }
 
+    const anyUsageIssues = checkAnyUsage();
+    if (anyUsageIssues.length > 0) {
+        UI.error(`Forbidden 'any' type usage found in ${anyUsageIssues.length} locations.`);
+        issues++;
+    } else {
+        UI.success("No forbidden 'any' type usage 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.`);
@@ -103,8 +123,9 @@ export function checkCommand() {
     try {
         execSync("npx tsc --noEmit", { stdio: "pipe" });
         UI.success("TypeScript type check PASSED.");
-    } catch {
+    } catch (err) {
         UI.error("TypeScript type check FAILED.");
+        logger.debug("npx tsc --noEmit check failed", err);
         issues++;
     }
 
@@ -146,8 +167,9 @@ export function checkCommand() {
             } else {
                 console.warn("\n📊  Token Consumption Report: No token usage logged yet.");
             }
-        } catch {
+        } catch (err) {
             console.warn("\n📊  Token Consumption Report: Could not read or parse metrics file.");
+            logger.debug("Failed to read or parse metrics.json in checkCommand", err);
         }
     } else {
         console.warn("\n📊  Token Consumption Report: No token usage logged yet.");
@@ -184,6 +206,30 @@ function checkConsoleLogs(): string[] {
     return issues;
 }
 
+function checkAnyUsage(): string[] {
+    const issues: string[] = [];
+    const srcDir = path.join(process.cwd(), "src");
+    if (!fs.existsSync(srcDir)) return [];
+    
+    const walk = (dir: string) => {
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const fullPath = path.join(dir, file);
+            if (fs.statSync(fullPath).isDirectory()) walk(fullPath);
+            else if (file.endsWith(".ts") && !file.includes(".test.")) {
+                const content = fs.readFileSync(fullPath, "utf8");
+                // Match ": any", "<any>", "as any" but try to avoid false positives in comments if possible
+                const anyRegex = /[:<]\s*any\b|\bas\s+any\b/g;
+                if (anyRegex.test(content) && !fullPath.includes("check.ts") && !fullPath.includes("definitions.ts")) {
+                    issues.push(fullPath);
+                }
+            }
+        }
+    };
+    walk(srcDir);
+    return issues;
+}
+
 function checkRootTestFiles(): string[] {
     const rootDir = process.cwd();
     if (!fs.existsSync(rootDir)) return [];
@@ -197,8 +243,8 @@ function checkRootTestFiles(): string[] {
                     testFiles.push(file);
                 }
             }
-        } catch {
-            // Ignore stat errors for broken symlinks or permission issues
+        } catch (err) {
+            logger.debug(`Failed to stat file ${fullPath} in checkRootTestFiles`, err);
         }
     }
     return testFiles;

package/src/cli/commands/init.ts

@@ -2,20 +2,23 @@ import fs from "fs";
 import path from "path";
 import readline from "readline";
 
+import { logger } from "../../shared/logger.js";
 import {
+    remapFrameworkContent,
     resolveAdapter,
     runAdapterPostInit,
-    remapFrameworkContent,
+    scaffoldAgents,
     type AdapterConfig,
     type AdapterId,
 } from "../adapters.js";
-import { getPackageRoot, getPackageVersion } from "../utils/pkg.js";
-import { ensureDir, writeJsonFile } from "../utils/fs.js";
-import { initializeMemory, getConfiguredPaths } from "../utils/memory.js";
 import { SHIM_TEMPLATES } from "../shims.js";
+import { ensureDir, writeJsonFile } from "../utils/fs.js";
+import { initializeMemory } from "../utils/memory.js";
+import { getPackageRoot, getPackageVersion } from "../utils/pkg.js";
+import { UI } from "../utils/ui.js";
 
 // Import Modular Definitions
-import { ALL_AGENTS, buildAgentJson } from "../../modules/agents/definitions.js";
+import { ALL_AGENTS } from "../../modules/agents/definitions.js";
 import { CORE_SKILLS } from "../../modules/skills/definitions.js";
 
 
@@ -26,6 +29,7 @@ const FRAMEWORK_SUBDIRS = [
     "agents",
     "skills",
     "knowledge",
+    "prompts",
     "memory",
     "router",
     "registry",
@@ -80,54 +84,11 @@ function scaffoldConstitution(targetDir: string, frameworkDir: string, adapterId
         console.warn(`⚠️  Failed to read global constitution template: ${e}`);
     }
     content = remapFrameworkContent(content, frameworkDir, adapterId);
-    fs.writeFileSync(path.join(targetDir, "ENDERUN.md"), content);
-    console.warn(`✅ Constitution file created: ENDERUN.md${readSuccess ? "" : " (default template)"}`);
-}
-
-function scaffoldCoreAgents(agentsToScaffold: string[], agentsBaseDir: string, adapterId: string, dryRun: boolean) {
-    if (dryRun) return;
-    ensureDir(agentsBaseDir, dryRun);
-    
-    for (const name of agentsToScaffold) {
-        const ag = ALL_AGENTS.find(a => a.name === name);
-        if (!ag) continue;
-
-        // AGY standard requires nested folders: agents/{name}/agent.md (or .json)
-        const isNestedAdapter = adapterId === "antigravity-cli";
-        const agentDir = isNestedAdapter ? path.join(agentsBaseDir, name) : agentsBaseDir;
-        const agentFileName = isNestedAdapter ? "agent.md" : `${ag.name}.md`;
-        
-        if (isNestedAdapter) ensureDir(agentDir, dryRun);
-
-        if (isNestedAdapter) {
-            if (!dryRun) {
-                const jsonContent = buildAgentJson(ag);
-                fs.writeFileSync(path.join(agentDir, "agent.json"), jsonContent);
-            }
-        } else {
-            const mdContent = `---
-name: "${ag.name}"
-description: "${ag.description}"
----
-
-<!-- capability: ${ag.capability} -->
-<!-- tags: [${ag.tags.map(t => `"${t}"`).join(", ")}] -->
-
-
-# 🎖️ ${FRAMEWORK_NAME} — @${ag.name} (${ag.displayName})
-
-## 🤖 Talimatlar (Instructions)
-${ag.instructions}
 
-## 🛡️ Çekirdek Kurallar (Core Mandates)
-- **Traceability:** Her eylem aktif Trace ID'yi miras almalıdır.
-- **Surgical Precision:** Sadece \`replace_text\` veya \`patch_file\` kullanarak dosya düzenleyin.
-`;
-            if (!dryRun) {
-                fs.writeFileSync(path.join(agentDir, agentFileName), mdContent);
-            }
-        }
-    }
+    // Write ONLY to the framework directory (e.g. .gemini/ENDERUN.md)
+    const destPath = path.join(targetDir, frameworkDir, "ENDERUN.md");
+    fs.writeFileSync(destPath, content);
+    console.warn(`✅ Constitution file created inside: ${frameworkDir}/ENDERUN.md${readSuccess ? "" : " (default template)"}`);
 }
 
 function scaffoldSkills(skillsBaseDir: string, dryRun: boolean) {
@@ -185,7 +146,97 @@ This document outlines the strict ESLint coding standards for Agent Enderun proj
     const knowledgePath = path.join(frameworkDir, knowledgeDir);
     if (!fs.existsSync(knowledgePath)) fs.mkdirSync(knowledgePath, { recursive: true });
     fs.writeFileSync(path.join(knowledgePath, "eslint-standards.md"), eslintStandardsContent);
-    
+
+    // Scaffold Corporate Standards (CRUD & Architecture)
+    const standards = [
+        {
+            file: "crud-governance.md",
+            template: "templates/standards/crud-governance.md",
+            default: "# 🏛️ Kurumsal CRUD ve Yönetişim Standartları\n\n1. **Yüksek Riskli İşlemler:** @manager onayı gerektirir.\n2. **Branded Types:** Zorunludur.\n3. **Kysely:** Ham SQL yasaktır."
+        },
+        {
+            file: "architecture-standards.md",
+            template: "templates/standards/architecture-standards.md",
+            default: "# 📐 Kurumsal Mimari Standartları\n\n1. **Layered Architecture:** Route -> Service -> Repository.\n2. **Zero Mock:** Gerçek veri/kontrat kullanımı zorunludur.\n3. **any Forbidden:** TypeScript disiplini."
+        },
+        {
+            file: "frontend-standards.md",
+            template: "templates/standards/frontend-standards.md",
+            default: "# 🎨 Kurumsal Frontend Standartları\n\n1. **Style Discipline:** Tip güvenli veya utility-first sistemler tercih edilir.\n2. **Responsive-First:** Mobil-ilk tasarım zorunludur.\n3. **WCAG AA:** Erişilebilirlik standarttır."
+        },
+        {
+            file: "tailwind-standards.md",
+            template: "templates/standards/tailwind-standards.md",
+            default: "# 🌊 Kurumsal Tailwind Standartları\n\n1. **No Arbitrary Values:** h-[10px] yasaktır.\n2. **Mobile-First:** sm:, md: kullanımı zorunludur.\n3. **Prettier:** Tailwind plugin kullanımı önerilir."
+        },
+        {
+            file: "mobile-standards.md",
+            template: "templates/standards/mobile-standards.md",
+            default: "# 📱 Kurumsal Mobil Standartları\n\n1. **Expo/React Native:** Standart platformdur.\n2. **Dynamic Scaling:** useWindowDimensions kullanımı zorunludur.\n3. **FlashList:** Büyük listeler için Shopify FlashList kullanılır."
+        },
+        {
+            file: "security-standards.md",
+            template: "templates/standards/security-standards.md",
+            default: "# 🛡️ Kurumsal Güvenlik Standartları\n\n1. **No Ham SQL:** Kysely zorunluluğu.\n2. **RLS:** Row Level Security uygulanmalıdır.\n3. **Secrets:** .env disiplini."
+        },
+        {
+            file: "quality-standards.md",
+            template: "templates/standards/quality-standards.md",
+            default: "# ⚖️ Kurumsal Kod Kalitesi Standartları\n\n1. **Zero any:** TypeScript disiplini.\n2. **Zero Warnings:** ESLint temizliği.\n3. **4 Spaces:** Girintileme kuralı."
+        },
+        {
+            file: "logging-and-secrets.md",
+            template: "templates/standards/logging-and-secrets.md",
+            default: "# 🪵 Kurumsal Loglama Standartları\n\n1. **Zero Console:** console.log yasaktır.\n2. **Logger:** Kurumsal logger kullanılır.\n3. **Secrets:** .env disiplini zorunludur."
+        },
+        {
+            file: "testing-standards.md",
+            template: "templates/standards/testing-standards.md",
+            default: "# 🧪 Kurumsal Test Standartları\n\n1. **Framework:** Vitest kullanılır.\n2. **Naming:** .test.ts formatı.\n3. **Zero Mock:** İç servisler mocklanmaz."
+        },
+        {
+            file: "i18n-standards.md",
+            template: "templates/standards/i18n-standards.md",
+            default: "# 🌐 Kurumsal i18n Standartları\n\n1. **No Hardcoded:** Metinler JSON'da tutulur.\n2. **i18next:** Standart kütüphanedir.\n3. **Centralized:** Locales dizini zorunludur."
+        }
+    ];
+
+    for (const std of standards) {
+        let content = std.default;
+        try {
+            const fullTemplatePath = path.join(getPackageRoot(), std.template);
+            if (fs.existsSync(fullTemplatePath)) {
+                content = fs.readFileSync(fullTemplatePath, "utf8");
+            }
+        } catch {
+            // Intentional: if the template file is unreadable, fall back to the inline default.
+            // No logging needed — the default value is a valid fallback, not an error condition.
+        }
+        fs.writeFileSync(path.join(knowledgePath, std.file), content);
+    }
+
+    // Scaffold Prompt Recipes
+    const promptsPath = path.join(frameworkDir, "prompts");
+    if (!fs.existsSync(promptsPath)) fs.mkdirSync(promptsPath, { recursive: true });
+
+    const recipes = [
+        { file: "refactoring-recipe.md", template: "templates/prompts/refactoring-recipe.md" },
+        { file: "bug-fix-recipe.md", template: "templates/prompts/bug-fix-recipe.md" },
+        { file: "new-feature-recipe.md", template: "templates/prompts/new-feature-recipe.md" }
+    ];
+
+    for (const recipe of recipes) {
+        try {
+            const fullTemplatePath = path.join(getPackageRoot(), recipe.template);
+            if (fs.existsSync(fullTemplatePath)) {
+                const content = fs.readFileSync(fullTemplatePath, "utf8");
+                fs.writeFileSync(path.join(promptsPath, recipe.file), content);
+            }
+        } catch (e) {
+            logger.debug(`Failed to scaffold prompt recipe: ${recipe.file}`, e);
+        }
+    }
+
     // Scaffold cli-commands.json
     const cliCommands = {
         commands: {
@@ -248,159 +299,117 @@ List of active agents, their roles, capacities, and matching directory patterns.
     // Scaffold observability files
     const obsDir = path.join(frameworkDir, "observability");
     if (!fs.existsSync(obsDir)) fs.mkdirSync(obsDir, { recursive: true });
-    fs.writeFileSync(
-        path.join(obsDir, "audit_log.md"),
-        `# 🕵️ Agent Enderun — Audit Log
 
-This log tracks all asynchronous agent communication and state transitions handled by the Hermes Message Broker.
+    // Add audit log
+    const auditLogPath = path.join(obsDir, "audit_log.md");
+    if (!fs.existsSync(auditLogPath)) {
+        fs.writeFileSync(auditLogPath, "# 🎖️ Agent Enderun — Audit Log\n\n| Timestamp | Agent | Action | Trace ID | Status |\n|---|---|---|---|---|\n");
+    }
+
+    // Add metrics.json
+    const metricsPath = path.join(obsDir, "metrics.json");
+    if (!fs.existsSync(metricsPath)) {
+        fs.writeFileSync(metricsPath, "[]");
+    }
 
-## Hermes Event Log
-`
-    );
-    fs.writeFileSync(
-        path.join(obsDir, "telemetry.md"),
-        `# 📊 Agent Enderun — Telemetry & Memory Observability
+    // Scaffold rules
+    const rulesDir = path.join(frameworkDir, "rules");
+    if (!fs.existsSync(rulesDir)) fs.mkdirSync(rulesDir, { recursive: true });
+    fs.writeFileSync(path.join(rulesDir, "global_rules.mdc"), `---
+description: Global Rules for Agent Enderun Army
+globs: **/*
+---
 
-## 🧠 Context & Token Observability
-- **Memory File:** \`${fDir}/memory/PROJECT_MEMORY.md\` (SSOT)
-- **Pruning Trigger:** Active history entries are pruned and archived under \`${fDir}/memory-graph/archive/\` once the log exceeds 10 records.
-- **Audit Logs:** Agent interactions are saved locally inside \`observability/audit_log.md\` to keep API usage transparent and track performance bottlenecks.
-`
-    );
+# 🎖️ Agent Enderun — Global Army Rules
 
-    if (fDir === adapter.frameworkDir) {
-        const entryFileName = adapter.shimFile || `${adapter.id.toUpperCase()}.md`;
-        const destShimPath = path.join(targetDir, entryFileName);
-        
-        let shimContent = SHIM_TEMPLATES[adapter.id] || `# 🎖️ ${FRAMEWORK_NAME} — ${adapter.id.toUpperCase()} Strategy\n`;
-        shimContent = remapFrameworkContent(shimContent, fDir, adapter.id);
-        
-        fs.writeFileSync(destShimPath, shimContent);
-        console.warn(`✅ Strategy shim created: ${entryFileName}`);
-    }
+- **Traceability:** Prefix every commit and log with the active Trace ID.
+- **Surgical Edits:** Use \`replace_text\` or \`patch_file\` tools. Overwriting entire files is forbidden.
+- **Contract-First:** Verify types before implementation.
+- **Zero Mock:** Use real data contracts.
+- **any Forbidden:** Strictly use TypeScript types.
+`);
 }
 
-function scaffoldKnowledgeDocs(targetDir: string, fDir: string, dryRun: boolean) {
-    if (dryRun) return;
-    const pkgRoot = getPackageRoot();
-    const sourceDocsDir = path.join(pkgRoot, "templates");
-    const frameworkDir = path.join(targetDir, fDir);
-    
-    let knowledgeDirName = "knowledge";
-    if (fDir === ".github") knowledgeDirName = "instructions";
-    const destKnowledgeDir = path.join(frameworkDir, knowledgeDirName);
-    
-    if (!fs.existsSync(destKnowledgeDir)) {
-        fs.mkdirSync(destKnowledgeDir, { recursive: true });
+export async function initCommand(adapterName: string, options: { unified?: boolean, dryRun?: boolean, yes?: boolean }) {
+    const adapterId = (adapterName || "gemini") as AdapterId;
+    const adapter = resolveAdapter(adapterId);
+
+    if (!adapter) {
+        UI.error(`Unknown adapter: ${adapterId}`);
+        process.exit(1);
     }
 
-    const filesToCopy = [
-        { src: "architecture/standards/data-fetching-patterns.md", dest: "data-fetching-patterns.md" },
-        { src: "architecture/standards/design-system.md", dest: "design-system.md" },
-        { src: "architecture/standards/logging.md", dest: "logging.md" },
-        { src: "architecture/standards/tech-stack.md", dest: "tech-stack.md" },
-        { src: "architecture/standards/documentation-ownership.md", dest: "documentation_ownership.md" },
-        { src: "architecture/standards/mobile-standards.md", dest: "mobile_standards.md" },
-        { src: "architecture/standards/crud-governance.md", dest: "crud-governance.md" },
-        { src: "backend/error-handling.md", dest: "error-handling.md" },
-        { src: "frontend/component-patterns.md", dest: "component-patterns.md" },
-        { src: "architecture/enterprise-architecture.md", dest: "enterprise-architecture.md" },
-        { src: "architecture/approval-flows.md", dest: "approval-flows.md" },
-        { src: "architecture/agents-manifest.md", dest: "agents-manifest.md" }
-    ];
+    const projectRoot = process.cwd();
+    const isUnified = options.unified || false;
 
-    for (const item of filesToCopy) {
-        const srcPath = path.join(sourceDocsDir, item.src);
-        const destPath = path.join(destKnowledgeDir, item.dest);
-        try {
-            if (fs.existsSync(srcPath)) {
-                let content = fs.readFileSync(srcPath, "utf8");
-                content = remapFrameworkContent(content, fDir, fDir === ".github" ? "codex" : "gemini");
-                fs.writeFileSync(destPath, content);
-                console.warn(`✅ Copied document: ${item.dest} to ${fDir}/${knowledgeDirName}/`);
-            }
-        } catch (e) {
-            console.warn(`⚠️  Failed to copy ${item.src} to ${destPath}: ${e}`);
-        }
-    }
-}
+    // STRICT ISOLATION STRATEGY
+    const coreDir = ".enderun"; // Pure Memory & Knowledge
+    const aiToolDir = isUnified ? ".agents" : adapter.frameworkDir; // Pure Agents & Skills
 
-export async function initCommand(adapterInput?: string, dryRun = false, isInteractive = false) {
-    const selections = isInteractive ? await runInteractiveInit() : { selectedDirs: FRAMEWORK_SUBDIRS, selectedAgents: ALL_AGENTS.map(a => a.name), selectedPalette: "Modern Blue" };
-    const targetDir = process.cwd();
-    const adapter = resolveAdapter(adapterInput);
-    const frameworkDirs = [adapter.frameworkDir];
-
-    for (const fdir of [...new Set(frameworkDirs)]) {
-        const base = path.join(targetDir, fdir);
-        ensureDir(base, dryRun);
-
-        for (const sub of selections.selectedDirs) ensureDir(path.join(base, sub), dryRun);
-        
-        scaffoldCoreAgents(selections.selectedAgents, path.join(base, "agents"), adapter.id, dryRun);
-        scaffoldSkills(path.join(base, "skills"), dryRun);
-        scaffoldFrameworkConfigs(targetDir, fdir, adapter, dryRun, selections.selectedPalette);
-        scaffoldKnowledgeDocs(targetDir, fdir, dryRun);
-
-        // NATIVE TOOL CONFIGURATION (MCP REGISTRATION)
-        if (!dryRun) {
-            runAdapterPostInit(adapter, targetDir);
-        }
-    }
-    
-    scaffoldConstitution(targetDir, adapter.frameworkDir, adapter.id, dryRun);
-    ensureDir(path.join(targetDir, "apps"), dryRun);
-
-    // Scaffold target project docs/ folder
-    const targetDocsDir = path.join(targetDir, "docs");
-    ensureDir(targetDocsDir, dryRun);
-    if (!dryRun) {
-        const readmePath = path.join(targetDocsDir, "README.md");
-        if (!fs.existsSync(readmePath)) {
-            fs.writeFileSync(readmePath, "# 📝 Project Documentation\n\nWelcome to your new project scaffolded with Agent Enderun.\n\n## Project Overview\nWrite your project description, goals, and target audience here. The AI agents will read this file to understand the scope.\n");
-        }
-        const gettingStartedPath = path.join(targetDocsDir, "getting-started.md");
-        if (!fs.existsSync(gettingStartedPath)) {
-            fs.writeFileSync(gettingStartedPath, "# 🚀 Getting Started\n\n## Project Requirements\nWrite the core requirements and features of your application here.\n");
-        }
-        console.warn("✅ Project docs folder initialized with placeholders.");
+    const dryRun = options.dryRun || false;
+    const forceYes = options.yes || false;
+
+    UI.intent("Enderun Initialization", `Bootstrapping ${FRAMEWORK_NAME} (v${FRAMEWORK_VERSION}) with ${adapterId} adapter...`);
+
+    let selectedDirs: string[];
+    let selectedAgents: string[];
+    let selectedPalette: string;
+
+    if (forceYes) {
+        selectedDirs = ["knowledge", "prompts", "memory", "router", "registry", "observability", "rules"];
+        selectedAgents = ALL_AGENTS.map(a => a.name);
+        selectedPalette = "Modern Blue";
+        UI.success("Non-interactive mode: Using default configurations.");
+    } else {
+        const result = await runInteractiveInit();
+        selectedDirs = result.selectedDirs.filter(d => d !== "agents" && d !== "skills");
+        selectedAgents = result.selectedAgents;
+        selectedPalette = result.selectedPalette;
     }
 
-    initializeMemory(path.join(targetDir, adapter.frameworkDir, "memory/PROJECT_MEMORY.md"), adapter.frameworkDir, dryRun);
-    
-    interface McpConfig {
-        mcpServers?: Record<string, unknown>;
+    // 1. Create Core Framework Structure (.enderun) - EXCLUSIVELY FOR DATA
+    ensureDir(path.join(projectRoot, coreDir), dryRun);
+    selectedDirs.forEach(dir => {
+        ensureDir(path.join(projectRoot, coreDir, dir), dryRun);
+    });
+
+    // 2. Create AI Tool Specific Structure (.agents, .claude, etc.) - EXCLUSIVELY FOR AGENTS/SKILLS
+    ensureDir(path.join(projectRoot, aiToolDir), dryRun);
+    if (adapter.nestedDirs) {
+        adapter.nestedDirs.forEach(dir => ensureDir(path.join(projectRoot, aiToolDir, dir), dryRun));
     }
-    
-    let mcpConfig: McpConfig = {};
-    const mcpPath = path.join(targetDir, "mcp.json");
-    if (fs.existsSync(mcpPath)) {
-        try {
-            mcpConfig = JSON.parse(fs.readFileSync(mcpPath, "utf8")) as McpConfig;
-        } catch {
-            // ignore
+
+    // 3. Scaffold Constitution (Inside .enderun)
+    scaffoldConstitution(projectRoot, coreDir, adapterId, dryRun);
+
+    // 4. Scaffold Core Agents (Inside AI Tool Dir ONLY - Centralized)
+    scaffoldAgents(projectRoot, adapterId, dryRun, selectedAgents);
+
+    // 5. Scaffold Skills (Inside AI Tool Dir ONLY)
+    const skillsBaseDir = path.join(projectRoot, aiToolDir, "skills");
+    scaffoldSkills(skillsBaseDir, dryRun);
+
+    // 6. Scaffold Memory & Knowledge (Inside .enderun ONLY)
+    initializeMemory(projectRoot, coreDir, dryRun);
+    scaffoldFrameworkConfigs(projectRoot, coreDir, adapter, dryRun, selectedPalette);
+
+    // 7. Platform Specific Shims (At project root)
+    for (const [name, content] of Object.entries(SHIM_TEMPLATES)) {
+        if (name.toLowerCase() === adapterId.split("-")[0] || name === adapterId) {
+            const shimContent = remapFrameworkContent(content, coreDir, adapterId);
+            const shimFileName = adapter.shimFile || `${name.toUpperCase()}.md`;
+            if (!dryRun) fs.writeFileSync(path.join(projectRoot, shimFileName), shimContent);
+            console.warn(`✅ Platform shim created: ${shimFileName}`);
         }
     }
-    if (!mcpConfig.mcpServers) {
-        mcpConfig.mcpServers = {};
-    }
-    mcpConfig.mcpServers["agent-enderun"] = {
-        command: "node",
-        args: [path.join(getPackageRoot(), "framework-mcp/dist/index.js")],
-        env: { ENDERUN_PROJECT_ROOT: targetDir }
-    };
-    
-    if (!dryRun) {
-        fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2));
-    }
-    
-    const paths = getConfiguredPaths();
-    const frontendDir = path.join(targetDir, paths.frontend);
-    ensureDir(frontendDir, dryRun);
-
-    const pandaTemplate = `import { defineConfig } from "@pandacss/dev";\nexport default defineConfig({ theme: { extend: { tokens: { colors: { primary: { value: "${COLOR_PALETTES[selections.selectedPalette as keyof typeof COLOR_PALETTES]?.primary || "#0ea5e9"}" } } } } } });`;
-    if (!dryRun) {
-        fs.writeFileSync(path.join(frontendDir, "panda.config.ts"), pandaTemplate);
-    }
-    console.warn(`\n✨ ${FRAMEWORK_NAME} scaffolded! (v${FRAMEWORK_VERSION})`);
+
+    // 8. Run Adapter Post-Init
+    runAdapterPostInit(adapter, projectRoot);
+
+    UI.success(`\n🚀 ${FRAMEWORK_NAME} initialized successfully!`);
+    console.warn(`\n- Brain & Memory Hub (Protected): ${coreDir}/`);
+    console.warn(`- AI Agent Commands (Active): ${aiToolDir}/`);
+    console.warn("\nNext Steps:");
+    console.warn("  1. Run 'agent-enderun status' to verify the environment.");
+    console.warn(`  2. Open ${adapterId === "claude" ? "Claude Desktop" : "your AI Assistant"} and start commanding the Army.`);
 }

package/src/cli/commands/orchestrate.ts

@@ -4,6 +4,7 @@ import chalk from "chalk";
 import { getFrameworkDir } from "../utils/memory.js";
 import { UI } from "../utils/ui.js";
 import { z } from "zod";
+import { logger } from "../../shared/logger.js";
 
 export const HermesMessageSchema = z.object({
     timestamp: z.string(),
@@ -62,8 +63,9 @@ export async function orchestrateCommand() {
             if (updatedStatus) {
                 fs.writeFileSync(statusPath, newLines.join("\n"));
             }
-        } catch {
+        } catch (err) {
             UI.error("Ajan zaman aşımı kontrolü sırasında hata oluştu.");
+            logger.debug("Agent timeout check failed", err);
         }
     }
 
@@ -97,8 +99,9 @@ export async function orchestrateCommand() {
                 }
             });
             fileMessagesMap[file] = allMsgs;
-        } catch {
+        } catch (err) {
             UI.error(`${file} mesajı okunurken hata oluştu.`);
+            logger.debug(`Failed to read message file ${file}`, err);
         }
     }
 
@@ -181,8 +184,9 @@ export async function orchestrateCommand() {
                 fs.appendFileSync(archivePath, archiveContent, "utf8");
                 UI.success(`Archived ${processedMsgs.length} messages for @${agentName}`);
             }
-        } catch {
+        } catch (err) {
             UI.error(`${file} mesaj dosyası güncellenirken ve arşivlenirken hata oluştu.`);
+            logger.debug(`Failed to update and archive message file ${file}`, err);
         }
     }
 }
@@ -203,7 +207,7 @@ export async function sendMessage(args: {
     const messagesDir = path.join(frameworkDir, "messages");
     const agentName = args.to.replace("@", "");
     const messagePath = path.join(messagesDir, `${agentName}.json`);
-    const lockPath = path.join(messagesDir, ".lock");
+    const lockPath = path.join(messagesDir, `${agentName}.lock`);
 
     let retries = 3;
     let acquired = false;
@@ -215,8 +219,8 @@ export async function sendMessage(args: {
                     if (Date.now() - stats.mtimeMs > 5000) {
                         fs.unlinkSync(lockPath);
                     }
-                } catch {
-                    // ignore if concurrently unlinked
+                } catch (err) {
+                    logger.debug(`Failed to unlink stale Hermes lock for ${agentName} concurrently`, err);
                 }
             }
             if (!fs.existsSync(messagesDir)) {
@@ -263,8 +267,9 @@ export async function sendMessage(args: {
         }
         
         return message;
-    } catch {
+    } catch (err) {
         UI.error(`Mesaj iletilemedi: ${args.from} -> ${args.to}`);
+        logger.debug(`Hermes sendMessage failed (${args.from} -> ${args.to})`, err);
     } finally {
         if (acquired && fs.existsSync(lockPath)) {
             try {
@@ -297,7 +302,8 @@ function transitionAgentState(agent: string, state: string, task: string) {
             return line;
         });
         fs.writeFileSync(statusPath, newLines.join("\n"));
-    } catch {
+    } catch (err) {
         UI.error("STATUS.md güncellenemedi.");
+        logger.debug(`Failed to transition agent state for ${agent}`, err);
     }
 }