agent-enderun 1.1.5 → 1.1.7

package/src/cli/commands/init.ts

@@ -6,13 +6,16 @@ import {
     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 { logger } from "../../shared/logger.js";
 import { SHIM_TEMPLATES } from "../shims.js";
+import { UI } from "../utils/ui.js";
 
 // Import Modular Definitions
 import { ALL_AGENTS, buildAgentJson } from "../../modules/agents/definitions.js";
@@ -26,6 +29,7 @@ const FRAMEWORK_SUBDIRS = [
     "agents",
     "skills",
     "knowledge",
+    "prompts",
     "memory",
     "router",
     "registry",
@@ -80,8 +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)"}`);
+    
+    // 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 scaffoldCoreAgents(agentsToScaffold: string[], agentsBaseDir: string, adapterId: string, dryRun: boolean) {
@@ -185,6 +192,96 @@ 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 = {
@@ -248,135 +345,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
+    
+    // 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");
+    }
 
-This log tracks all asynchronous agent communication and state transitions handled by the Hermes Message Broker.
+    // 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);
+export async function initCommand(adapterName: string, options: { unified?: boolean, dryRun?: boolean, yes?: boolean }) {
+    const adapterId = (adapterName || "gemini") as AdapterId;
+    const adapter = resolveAdapter(adapterId);
     
-    let knowledgeDirName = "knowledge";
-    if (fDir === ".github") knowledgeDirName = "instructions";
-    const destKnowledgeDir = path.join(frameworkDir, knowledgeDirName);
+    if (!adapter) {
+        UI.error(`Unknown adapter: ${adapterId}`);
+        process.exit(1);
+    }
+
+    const projectRoot = process.cwd();
+    const isUnified = options.unified || false;
+    
+    // STRICT ISOLATION STRATEGY
+    const coreDir = ".enderun"; // Pure Memory & Knowledge
+    const aiToolDir = isUnified ? ".agents" : adapter.frameworkDir; // Pure Agents & Skills
     
-    if (!fs.existsSync(destKnowledgeDir)) {
-        fs.mkdirSync(destKnowledgeDir, { recursive: true });
+    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;
     }
 
-    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" }
-    ];
+    // 1. Create Core Framework Structure (.enderun) - EXCLUSIVELY FOR DATA
+    ensureDir(path.join(projectRoot, coreDir), dryRun);
+    ["knowledge", "memory", "logs", "observability", "router", "registry", "rules", "prompts"].forEach(dir => {
+        ensureDir(path.join(projectRoot, coreDir, dir), dryRun);
+    });
 
-    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}`);
-        }
+    // 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));
     }
-}
 
-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];
+    // 3. Scaffold Constitution (Inside .enderun)
+    scaffoldConstitution(projectRoot, coreDir, adapterId, dryRun);
 
-    for (const fdir of [...new Set(frameworkDirs)]) {
-        const base = path.join(targetDir, fdir);
-        ensureDir(base, dryRun);
+    // 4. Scaffold Core Agents (Inside AI Tool Dir ONLY - Centralized)
+    scaffoldAgents(projectRoot, adapterId, 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");
+    // 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}`);
         }
-        console.warn("✅ Project docs folder initialized with placeholders.");
     }
 
-    initializeMemory(path.join(targetDir, adapter.frameworkDir, "memory/PROJECT_MEMORY.md"), adapter.frameworkDir, dryRun);
-    const mcpConfig = { mcpServers: { "agent-enderun": { command: "node", args: [path.join(getPackageRoot(), "framework-mcp/dist/index.js")], env: { ENDERUN_PROJECT_ROOT: targetDir } } } };
-    fs.writeFileSync(path.join(targetDir, "mcp.json"), JSON.stringify(mcpConfig, null, 2));
-    
-    const paths = getConfiguredPaths();
-    const frontendDir = path.join(targetDir, paths.frontend);
-    ensureDir(frontendDir, dryRun);
+    // 8. Run Adapter Post-Init
+    runAdapterPostInit(adapter, projectRoot);
 
-    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})`);
+    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);
     }
 }

package/src/cli/commands/status.ts

@@ -3,6 +3,7 @@ import path from "path";
 import chalk from "chalk";
 
 import { getMemoryPath, getFrameworkDir } from "../utils/memory.js";
+import { logger } from "../../shared/logger.js";
 
 /**
  * Print the current framework status.
@@ -77,8 +78,8 @@ export function statusCommand() {
                     }
                 });
             }
-        } catch {
-            // Ignore status read errors
+        } catch (err) {
+            logger.debug("Failed to read army status file", err);
         }
     }
 

package/src/cli/index.ts

@@ -62,9 +62,10 @@ async function main() {
     switch (command) {
         case "init": {
             const dryRun = args.includes("--dry-run");
-            const isInteractive = args.includes("--interactive");
-            const adapter = args.find(a => !a.startsWith("-") && a !== "init");
-            await initCommand(adapter, dryRun, isInteractive);
+            const isUnified = args.includes("--unified");
+            const forceYes = args.includes("--yes") || args.includes("-y");
+            const adapter = args.find(a => !a.startsWith("-") && a !== "init") || "gemini";
+            await initCommand(adapter, { dryRun, unified: isUnified, yes: forceYes });
             break;
         }
 

package/src/cli/shims.ts

@@ -4,7 +4,7 @@ export const SHIM_TEMPLATES: Record<string, string> = {
 You are the **Gemini Commander** (Strategic Decision Center).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Zero-Request Logging:** Write logs to \`{{FRAMEWORK_DIR}}/logs/\` at the end of every turn.
 `,
@@ -13,7 +13,7 @@ You are the **Gemini Commander** (Strategic Decision Center).
 You are the **Antigravity Specialist** (Preserve Coding Standards).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Standard Check:** Run health checks regularly to preserve framework integrity.
 `,
@@ -22,7 +22,7 @@ You are the **Antigravity Specialist** (Preserve Coding Standards).
 You are the **Claude Field Engineer** (Surgical Operations).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Surgical Precision:** Do not rewrite files. Execute surgical edits.
 `,
@@ -31,7 +31,7 @@ You are the **Claude Field Engineer** (Surgical Operations).
 You are the **Grok Explorer** (Experimental Protocols).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `,
     cursor: `# 🎖️ Enderun Core — CURSOR Strategy
@@ -39,7 +39,7 @@ You are the **Grok Explorer** (Experimental Protocols).
 You are the **Cursor Implementer** (IDE Integration).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `,
     codex: `# 🎖️ Enderun Core — COPILOT Strategy
@@ -47,7 +47,7 @@ You are the **Cursor Implementer** (IDE Integration).
 You are the **Copilot Implementer** (GitHub Copilot Integration).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `
 };