agent-enderun 1.0.4 → 1.0.6

package/src/cli/commands/init.ts

@@ -70,6 +70,10 @@ function buildDirsToCreate(adapter: AdapterConfig): string[] {
             dirs.push(`${adapter.frameworkDir}/${nested}`);
         }
     }
+    // Add logic for shimFile directory if it's nested (like .cursor/rules/)
+    if (adapter.shimFile.includes("/")) {
+        dirs.push(path.dirname(adapter.shimFile));
+    }
     return [...new Set(dirs)];
 }
 
@@ -262,7 +266,7 @@ export async function initCommand(adapterInput?: string, dryRun = false) {
     
     updateGitIgnore(path.join(targetDir, ".gitignore"), frameworkDir, dryRun);
 
-    const finalMemoryPath = path.join(targetFrameworkDir, "PROJECT_MEMORY.md");
+    const finalMemoryPath = path.join(targetFrameworkDir, "memory/PROJECT_MEMORY.md");
     initializeMemory(finalMemoryPath, frameworkDir, dryRun);
 
     if (!dryRun) {
@@ -287,6 +291,45 @@ describe("Initial Setup", () => {
         );
     }
 
+    const cursorRulesPath = path.join(targetDir, ".cursorrules");
+    if (!fs.existsSync(cursorRulesPath)) {
+        writeTextFile(
+            cursorRulesPath,
+            `# Agent Enderun — Cursor IDE Rules
+
+This is the primary entry point when using Agent Enderun within the Cursor IDE (Chat & Composer).
+
+The framework operates under a unified governance structure located in the ${frameworkDir}/ directory.
+
+### Primary Constitution
+All governance rules, agent checklists, and project memory live here:
+
+👉 **[${frameworkDir}/ENDERUN.md](${frameworkDir}/ENDERUN.md)**
+
+### 🤖 Agent Directive
+You are operating under the Agent Enderun governance framework.
+
+At the **start of every session**, before any work:
+1. **Restore Memory:** Read ${frameworkDir}/PROJECT_MEMORY.md to restore state, active Trace ID, and history.
+2. **Load Identity:** Read the relevant agent definition under ${frameworkDir}/agents/{agent}.md (default to @manager).
+3. **Internalize Knowledge:** Reference the ${frameworkDir}/knowledge/ base for architectural and coding standards.
+
+### 💾 Memory Tiers
+- **Project Memory (Shared):** ${frameworkDir}/PROJECT_MEMORY.md is the source of truth for task history, Trace IDs, and architectural decisions. **Update this at the end of every turn.**
+- **Private Memory (User-Specific):** Use the local .gitignored memory directory (e.g. ${frameworkDir}/memory/) for personal workflows or user-specific notes that should not be committed to Git. Never use the system's /tmp directory.
+- **Project Instructions:** This .cursorrules file contains the "Supreme Law" and coding standards.
+
+### 🛡️ Core Mandates
+- **Surgical Edits:** Use replace_text or patch_file via MCP for precise changes.
+- **Traceability:** Every action must inherit the active Trace ID from memory.
+- **Contract First:** No implementation without verified types.
+- **NEVER FORGET:** @manager MUST update ${frameworkDir}/PROJECT_MEMORY.md at the end of EVERY session without exception. This is a non-negotiable process integrity rule.
+
+All paths and references inside the project must comply with the Supreme Constitution located at ${frameworkDir}/ENDERUN.md`.trim() + "\n",
+            dryRun,
+        );
+    }
+
     if (!fs.existsSync(path.join(targetDir, ".git"))) {
         try {
             if (dryRun) {
@@ -308,131 +351,175 @@ describe("Initial Setup", () => {
     }
 
     // Always scaffold Antigravity (.agents/) workspace directory for cross-compatibility with agy CLI
-    if (adapter.id === "antigravity" || adapter.id === "antigravity-cli") {
+    if (adapter.id === "antigravity" || adapter.id === "antigravity-cli" || adapter.id === "gemini") {
         const agentsFrameworkDir = path.join(targetDir, ".agents");
         if (!dryRun) {
             try {
                 fs.mkdirSync(agentsFrameworkDir, { recursive: true });
                 const agentsSubdir = path.join(agentsFrameworkDir, "agents");
                 fs.mkdirSync(agentsSubdir, { recursive: true });
-            
-            // Write the 12 agent folders and agent.json files
-            const allAgents = [
-                {
-                    name: "manager",
-                    displayName: "Orchestration & Governance (Team-Lead)",
-                    description: "CTO, Lead Architect, and Orchestrator for Agent Enderun.",
-                    instructions: "You are the manager agent. Orchestrate workspace tasks, manage DAG dependency graphs, handle phase transitions, and enforce architectural standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Single Point of Authority: You are the sole entry point. No specialist acts without your briefing.\n- Traceability: Every action MUST inherit the active Trace ID.\n- Memory Discipline: MUST update PROJECT_MEMORY.md and log actions at the end of EVERY turn."
-                },
-                {
-                    name: "backend",
-                    displayName: "Domain Logic & Databases Specialist",
-                    description: "Responsible for core business logic, database migrations, security standards, API contracts, and server architecture.",
-                    instructions: "You are the backend agent. Build secure, high-performance, and consistent server architecture.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- No UI: Never implement UI or frontend logic.\n- Contract-First: Define shared contracts/branded types BEFORE any consumer code.\n- Branded Types Law: ALL IDs must use branded types (e.g., UserID). Plain strings are forbidden.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Surgical Edits: Use replace_text for all code changes."
-                },
-                {
-                    name: "frontend",
-                    displayName: "Fluid Responsive UI Specialist",
-                    description: "Builds responsive fluid user interfaces, manages styling tokens with Panda CSS, and implements state machines.",
-                    instructions: "You are the frontend agent. Build original, high-performance, and responsive user interfaces.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Responsive-First: Mobile-First (320px) is mandatory. Fixed-width is forbidden.\n- Zero UI Library Policy: No shadcn/ui, MUI, etc. Build everything with Panda CSS.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Contract-First: Use branded types from apps/backend/src/types.\n- No Native Alerts: Use integrated Toaster/Modal components."
-                },
-                {
-                    name: "quality",
-                    displayName: "Automated Testing & Quality Specialist",
-                    description: "Verifies test coverage, audits compliance with the constitution, conducts AST scanning, and verifies CI/CD status.",
-                    instructions: "You are the quality agent. Ensure no code is merged or deployed without meeting standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Final Gate: No code merges or deploys proceed without quality sign-off.\n- Verification-First: Audit lint, typecheck, contract drift, and branded types before sign-off.\n- Never Implement: Audit and assess only. Never write application features.\n- Zero Mock Policy: Integration tests must use real/service-compatible backends.\n- Coverage Gate: Reject approvals if coverage falls below >80% threshold in core."
-                },
-                {
-                    name: "database",
-                    displayName: "Database Migrations & Tuning Specialist",
-                    description: "Designs SQL schemas, manages migration scripts via Kysely, optimizes queries, indexes, and seeding logic.",
-                    instructions: "You are the database agent. Build secure, optimized, and scalable data layers.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Self-Contained DB: Every backend application MUST manage its own schema/migrations/seeds in its own src/database/ directory.\n- Contract-First: All schemas MUST be derived from branded types.\n- Kysely Standard: Use Kysely for application queries. Raw SQL is forbidden.\n- Zero Mock Policy: Realistic, contract-aware seed data only.\n- Surgical Edits: Use replace_text for all schema/migration changes."
-                },
-                {
-                    name: "devops",
-                    displayName: "Infrastructure & CI/CD Specialist",
-                    description: "Handles deployment pipelines, environment variables, system containerization, logging & telemetry integrations.",
-                    instructions: "You are the devops agent. Ensure reliable execution in every environment with strict quality gates.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Gate Approvals: NEVER deploy to production without quality gate approval.\n- No Docker Policy: Prefer native Node.js unless explicitly overridden by manager.\n- Environment Parity: Identical configs across dev/staging/prod (except secrets).\n- Secrets Security: NEVER hardcode secrets. Use environment variables.\n- Rollback First: Deployment is BLOCKED if no documented rollback plan exists."
-                },
-                {
-                    name: "explorer",
-                    displayName: "Codebase Discovery Specialist",
-                    description: "Maps code dependencies, performs project scans, identifies architectural gaps, and supports legacy onboarding.",
-                    instructions: "You are the explorer agent. Map project structure and provide deep context to other agents.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Read-Only: Never write production code. Only discover, map, and report.\n- Search-First: Always use search_codebase before reading large files.\n- Surgical Discovery: Focus on entry points and core domain logic.\n- Zero Mock Policy: Analyze real system state only.\n- Traceability: All findings must be linked to a Trace ID."
-                },
-                {
-                    name: "git",
-                    displayName: "Version Control Specialist",
-                    description: "Manages commit histories, branches, Trace ID alignment, semantic tagging, and merge conflicts.",
-                    instructions: "You are the git agent. Ensure a clean, atomic, and traceable repository history.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Trace ID Tagging: EVERY commit must include the active Trace ID in the message.\n- Atomic Integrity: Every commit must represent exactly one logical change.\n- Health-First: Never commit code that fails build or basic tests.\n- No Push: Do not run git push without explicit USER approval.\n- No Force: Never use git push --force on public branches."
-                },
-                {
-                    name: "mobile",
-                    displayName: "Mobile App Specialist",
-                    description: "Develops cross-platform mobile apps using React Native and Expo with clean component states.",
-                    instructions: "You are the mobile agent. Build high-performance, responsive mobile apps (React Native/Expo).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Zero UI Library: Same discipline as web. Build UI from scratch.\n- Contract-First: Use shared types from apps/backend/src/types.\n- Responsive-First: Mobile-First approach is mandatory.\n- Safe Area: Handle iOS/Android safe area insets on every screen.\n- Performance: Target 60 FPS."
-                },
-                {
-                    name: "native",
-                    displayName: "Native OS Integration Specialist",
-                    description: "Builds lightweight desktop wrappers and system integrations using Tauri or Electron.",
-                    instructions: "You are the native agent. Build secure, efficient desktop apps (Tauri/Electron).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Security-First: No remote code execution. Mandatory sandboxing and strict CSP.\n- Secure Storage: Use Keychain/Credential Manager for sensitive data.\n- IPC Contract: All communication between frontend and native MUST be typed.\n- Contract-First: Define IPC and data contracts before implementation.\n- Surgical Edits: Use replace_text for all code changes."
-                },
-                {
-                    name: "security",
-                    displayName: "Security & Cryptography Specialist",
-                    description: "Enforces authentication flows, CSP policies, credential rotation, RLS constraints, and cryptographic safety.",
-                    instructions: "You are the security agent. Ensure all endpoints, database connections, and authentication flows satisfy strict enterprise compliance policies.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Sandboxed Security First: Enforce Row Level Security (RLS) on all database tables.\n- Credential Rotation Policy: Credentials, keys, and tokens must never be hardcoded. Use vault/env variables.\n- CSP & CORS Strictness: Never open wildcards (*) for CORS or CSP policies.\n- Surgical Edits: Use replace_text for all security patches."
-                },
-                {
-                    name: "analyst",
-                    displayName: "Contract Verification & Business Analyst",
-                    description: "Validates business specifications, tests database contract integrity, and audits constitutional compliance.",
-                    instructions: "You are the analyst agent. Independently verify compliance with contracts and specifications between frontend, backend, and the constitution.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Independent Stance: Act as an objective verification gate.\n- Contract-First Law: Ensure contract.version.json perfectly matches types.\n- Escalation Priority: Report all contract drift to manager immediately.\n- Surgical Edits: Use replace_text for all document updates."
-                }
-            ];
 
-            for (const ag of allAgents) {
-                const agentDir = path.join(agentsSubdir, ag.name);
-                fs.mkdirSync(agentDir, { recursive: true });
-                
-                const payload = {
-                    name: ag.name,
-                    displayName: ag.displayName,
-                    description: ag.description,
-                    hidden: false,
-                    customAgentSpec: {
-                        customAgent: {
-                            systemPromptSections: [
-                                {
-                                    title: "Instructions",
-                                    content: ag.instructions
-                                }
-                            ],
-                            toolNames: [
-                                "view_file",
-                                "replace_file_content",
-                                "write_to_file",
-                                "run_command",
-                                "grep_search",
-                                "list_dir"
-                            ]
+                // Create other standard Antigravity directories for custom workspace customizations
+                fs.mkdirSync(path.join(agentsFrameworkDir, "skills"), { recursive: true });
+                fs.mkdirSync(path.join(agentsFrameworkDir, "rules"), { recursive: true });
+                fs.mkdirSync(path.join(agentsFrameworkDir, "workflows"), { recursive: true });
+
+                // Write workspace-specific MCP config
+                const mcpBlock = {
+                    mcpServers: {
+                        "agent-enderun": {
+                            command: "node",
+                            args: [path.join(targetDir, "framework-mcp/dist/index.js")],
+                            env: {
+                                "ENDERUN_PROJECT_ROOT": targetDir
+                            }
                         }
                     }
                 };
-                
                 fs.writeFileSync(
-                    path.join(agentDir, "agent.json"),
-                    JSON.stringify(payload, null, 2),
+                    path.join(agentsFrameworkDir, "mcp_config.json"),
+                    JSON.stringify(mcpBlock, null, 2),
                     "utf8"
                 );
-            }
-            console.warn(`✅ Scaffolding ${allAgents.length} Antigravity agents under .agents/agents/...`);
-        } catch (e) {
+
+                // Write AGENTS.md at the project root for prepended global rules
+                const agentsMdPath = path.join(targetDir, "AGENTS.md");
+                if (!fs.existsSync(agentsMdPath)) {
+                    fs.writeFileSync(
+                        agentsMdPath,
+                        `# Agent Enderun Workspace Instructions
+
+You are operating under the Agent Enderun AI governance and orchestration framework.
+
+### 🛡️ Critical Guidelines
+1. **Traceability First:** Every action or execution MUST inherit the active Trace ID from \`${frameworkDir}/PROJECT_MEMORY.md\`.
+2. **Surgical Operations:** Use precise file replacements or patches. NEVER rewrite entire source files unnecessarily.
+3. **Contract-First Design:** Backend models and type contracts must be locked and verified before frontend components are created.
+4. **Memory Synchronization:** All agent runs must update the project memory logs before concluding the session.
+
+All rules and constraints defined in \`${frameworkDir}/ENDERUN.md\` are strictly binding.
+`.trim() + "\n",
+                        "utf8"
+                    );
+                }
+            
+                // Write the 12 agent folders and agent.json files
+                const allAgents = [
+                    {
+                        name: "manager",
+                        displayName: "Orchestration & Governance (Team-Lead)",
+                        description: "CTO, Lead Architect, and Orchestrator for Agent Enderun.",
+                        instructions: "You are the manager agent. Orchestrate workspace tasks, manage DAG dependency graphs, handle phase transitions, and enforce architectural standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Single Point of Authority: You are the sole entry point. No specialist acts without your briefing.\n- Traceability: Every action MUST inherit the active Trace ID.\n- Memory Discipline: MUST update PROJECT_MEMORY.md and log actions at the end of EVERY turn."
+                    },
+                    {
+                        name: "backend",
+                        displayName: "Domain Logic & Databases Specialist",
+                        description: "Responsible for core business logic, database migrations, security standards, API contracts, and server architecture.",
+                        instructions: "You are the backend agent. Build secure, high-performance, and consistent server architecture.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- No UI: Never implement UI or frontend logic.\n- Contract-First: Define shared contracts/branded types BEFORE any consumer code.\n- Branded Types Law: ALL IDs must use branded types (e.g., UserID). Plain strings are forbidden.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Surgical Edits: Use replace_text for all code changes."
+                    },
+                    {
+                        name: "frontend",
+                        displayName: "Fluid Responsive UI Specialist",
+                        description: "Builds responsive fluid user interfaces, manages styling tokens with Panda CSS, and implements state machines.",
+                        instructions: "You are the frontend agent. Build original, high-performance, and responsive user interfaces.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Responsive-First: Mobile-First (320px) is mandatory. Fixed-width is forbidden.\n- Zero UI Library Policy: No shadcn/ui, MUI, etc. Build everything with Panda CSS.\n- Zero Mock Policy: Use real endpoints/contracts only.\n- Contract-First: Use branded types from apps/backend/src/types.\n- No Native Alerts: Use integrated Toaster/Modal components."
+                    },
+                    {
+                        name: "quality",
+                        displayName: "Automated Testing & Quality Specialist",
+                        description: "Verifies test coverage, audits compliance with the constitution, conducts AST scanning, and verifies CI/CD status.",
+                        instructions: "You are the quality agent. Ensure no code is merged or deployed without meeting standards.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Final Gate: No code merges or deploys proceed without quality sign-off.\n- Verification-First: Audit lint, typecheck, contract drift, and branded types before sign-off.\n- Never Implement: Audit and assess only. Never write application features.\n- Zero Mock Policy: Integration tests must use real/service-compatible backends.\n- Coverage Gate: Reject approvals if coverage falls below >80% threshold in core."
+                    },
+                    {
+                        name: "database",
+                        displayName: "Database Migrations & Tuning Specialist",
+                        description: "Designs SQL schemas, manages migration scripts via Kysely, optimizes queries, indexes, and seeding logic.",
+                        instructions: "You are the database agent. Build secure, optimized, and scalable data layers.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Self-Contained DB: Every backend application MUST manage its own schema/migrations/seeds in its own src/database/ directory.\n- Contract-First: All schemas MUST be derived from branded types.\n- Kysely Standard: Use Kysely for application queries. Raw SQL is forbidden.\n- Zero Mock Policy: Realistic, contract-aware seed data only.\n- Surgical Edits: Use replace_text for all schema/migration changes."
+                    },
+                    {
+                        name: "devops",
+                        displayName: "Infrastructure & CI/CD Specialist",
+                        description: "Handles deployment pipelines, environment variables, system containerization, logging & telemetry integrations.",
+                        instructions: "You are the devops agent. Ensure reliable execution in every environment with strict quality gates.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Gate Approvals: NEVER deploy to production without quality gate approval.\n- No Docker Policy: Prefer native Node.js unless explicitly overridden by manager.\n- Environment Parity: Identical configs across dev/staging/prod (except secrets).\n- Secrets Security: NEVER hardcode secrets. Use environment variables.\n- Rollback First: Deployment is BLOCKED if no documented rollback plan exists."
+                    },
+                    {
+                        name: "explorer",
+                        displayName: "Codebase Discovery Specialist",
+                        description: "Maps code dependencies, performs project scans, identifies architectural gaps, and supports legacy onboarding.",
+                        instructions: "You are the explorer agent. Map project structure and provide deep context to other agents.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Read-Only: Never write production code. Only discover, map, and report.\n- Search-First: Always use search_codebase before reading large files.\n- Surgical Discovery: Focus on entry points and core domain logic.\n- Zero Mock Policy: Analyze real system state only.\n- Traceability: All findings must be linked to a Trace ID."
+                    },
+                    {
+                        name: "git",
+                        displayName: "Version Control Specialist",
+                        description: "Manages commit histories, branches, Trace ID alignment, semantic tagging, and merge conflicts.",
+                        instructions: "You are the git agent. Ensure a clean, atomic, and traceable repository history.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Trace ID Tagging: EVERY commit must include the active Trace ID in the message.\n- Atomic Integrity: Every commit must represent exactly one logical change.\n- Health-First: Never commit code that fails build or basic tests.\n- No Push: Do not run git push without explicit USER approval.\n- No Force: Never use git push --force on public branches."
+                    },
+                    {
+                        name: "mobile",
+                        displayName: "Mobile App Specialist",
+                        description: "Develops cross-platform mobile apps using React Native and Expo with clean component states.",
+                        instructions: "You are the mobile agent. Build high-performance, responsive mobile apps (React Native/Expo).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Zero UI Library: Same discipline as web. Build UI from scratch.\n- Contract-First: Use shared types from apps/backend/src/types.\n- Responsive-First: Mobile-First approach is mandatory.\n- Safe Area: Handle iOS/Android safe area insets on every screen.\n- Performance: Target 60 FPS."
+                    },
+                    {
+                        name: "native",
+                        displayName: "Native OS Integration Specialist",
+                        description: "Builds lightweight desktop wrappers and system integrations using Tauri or Electron.",
+                        instructions: "You are the native agent. Build secure, efficient desktop apps (Tauri/Electron).\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Security-First: No remote code execution. Mandatory sandboxing and strict CSP.\n- Secure Storage: Use Keychain/Credential Manager for sensitive data.\n- IPC Contract: All communication between frontend and native MUST be typed.\n- Contract-First: Define IPC and data contracts before implementation.\n- Surgical Edits: Use replace_text for all code changes."
+                    },
+                    {
+                        name: "security",
+                        displayName: "Security & Cryptography Specialist",
+                        description: "Enforces authentication flows, CSP policies, credential rotation, RLS constraints, and cryptographic safety.",
+                        instructions: "You are the security agent. Ensure all endpoints, database connections, and authentication flows satisfy strict enterprise compliance policies.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Sandboxed Security First: Enforce Row Level Security (RLS) on all database tables.\n- Credential Rotation Policy: Credentials, keys, and tokens must never be hardcoded. Use vault/env variables.\n- CSP & CORS Strictness: Never open wildcards (*) for CORS or CSP policies.\n- Surgical Edits: Use replace_text for all security patches."
+                    },
+                    {
+                        name: "analyst",
+                        displayName: "Contract Verification & Business Analyst",
+                        description: "Validates business specifications, tests database contract integrity, and audits constitutional compliance.",
+                        instructions: "You are the analyst agent. Independently verify compliance with contracts and specifications between frontend, backend, and the constitution.\n\n🛑 NON-NEGOTIABLE CORE RULES:\n- Independent Stance: Act as an objective verification gate.\n- Contract-First Law: Ensure contract.version.json perfectly matches types.\n- Escalation Priority: Report all contract drift to manager immediately.\n- Surgical Edits: Use replace_text for all document updates."
+                    }
+                ];
+
+                for (const ag of allAgents) {
+                    const agentDir = path.join(agentsSubdir, ag.name);
+                    fs.mkdirSync(agentDir, { recursive: true });
+                
+                    const payload = {
+                        name: ag.name,
+                        displayName: ag.displayName,
+                        description: ag.description,
+                        hidden: false,
+                        customAgentSpec: {
+                            customAgent: {
+                                systemPromptSections: [
+                                    {
+                                        title: "Instructions",
+                                        content: ag.instructions
+                                    }
+                                ],
+                                toolNames: [
+                                    "view_file",
+                                    "replace_file_content",
+                                    "write_to_file",
+                                    "run_command",
+                                    "grep_search",
+                                    "list_dir"
+                                ]
+                            }
+                        }
+                    };
+                
+                    fs.writeFileSync(
+                        path.join(agentDir, "agent.json"),
+                        JSON.stringify(payload, null, 2),
+                        "utf8"
+                    );
+                }
+                console.warn(`✅ Scaffolding ${allAgents.length} Antigravity agents under .agents/agents/...`);
+            } catch {
             // fallback
+            }
         }
     }
-}
 
     console.warn(`\n♊ ${adapter.id.toUpperCase()}: Setup complete.`);
     console.warn(`   • Framework runtime: ${frameworkDir}/`);
@@ -446,6 +533,8 @@ describe("Initial Setup", () => {
     const buildCmd = pkgMgr === "npm" ? "npm run enderun:build" : `${pkgMgr} run enderun:build`;
 
     console.warn(`\n✨ Framework scaffolded! (v${FRAMEWORK_VERSION})`);
+    console.warn("\n🛡️  AL (Agent Lifecycle) Note: Your init is now configured for full army compliance.");
+    console.warn("   Run `agent-enderun check` (or the validate script) to confirm all agents have proper stateMachine + tags.");
 
     if (dryRun || process.env.ENDERUN_SKIP_INSTALL === "1") {
         console.warn(`\n⏭️  Skipping install steps (${dryRun ? "Dry-Run" : "ENDERUN_SKIP_INSTALL=1"}).`);
@@ -453,11 +542,19 @@ describe("Initial Setup", () => {
     }
 
     try {
-        execSync(installCmd, { stdio: "inherit" });
-        console.warn(`\n🏗️  Step 2/3: Running '${buildCmd}'...`);
-        execSync(buildCmd, { stdio: "inherit" });
-        console.warn("\n🔍 Step 3/3: Running 'agent-enderun check'...");
+        console.warn("\n🔍 Step 3/3: Running 'agent-enderun check' (includes AL validation)...");
         checkCommand();
+
+        // Automatic dedicated AL (Agent Lifecycle) check after init
+        console.warn("\n🛡️  Automatic post-init AL Army Validation (validate-agent-army)...");
+        try {
+          execSync("node bin/validate-agent-army.js", { stdio: "inherit" });
+          console.warn("✅ Automatic AL validation PASSED - all agents are lifecycle compliant (stateMachine + tags)!");
+        } catch (alErr) {
+          console.warn("⚠️  Automatic AL validation reported issues (see above in check output).");
+          console.warn("   You can re-run manually: node bin/validate-agent-army.js or agent-enderun check");
+        }
+
         console.warn("\n🚀 Agent Enderun is fully installed and verified!");
     } catch (e: unknown) {
         const message = e instanceof Error ? e.message : String(e);

package/src/cli/commands/orchestrate.ts

@@ -51,23 +51,35 @@ export async function orchestrateCommand() {
     console.log(`📡 ${pendingMessages.length} adet bekleyen görev bulundu. İşleniyor...\n`);
 
     for (const msg of pendingMessages) {
-        const { to, content, traceId } = msg;
+        const { to, content, traceId, category } = msg;
 
         console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
         console.log(`🔹 HEDEF: ${to}`);
         console.log(`🔹 TRACE: ${traceId}`);
+        console.log(`🔹 KATEGORİ: ${category}`);
         console.log(`🔹 GÖREV: ${content}`);
 
         // Determine agent folder based on adapter (detection or default)
         let agentFolder = "agents";
-        if (frameworkDir === ".agent") {
+        if (frameworkDir === ".agents") {
             agentFolder = "skills";
         } else if (frameworkDir === ".grok") {
             agentFolder = "plugins";
         }
 
-        // 1. Transition the target agent state to EXECUTING in STATUS.md
-        transitionAgentState(to, "EXECUTING", content);
+        // Determine target state based on category
+        let targetState = "EXECUTING";
+        if (category === "DELEGATION") targetState = "BRIEFED";
+        if (category === "ALERT" || category === "FAILED") targetState = "BLOCKED";
+
+        // 1. Transition the target agent state in STATUS.md
+        transitionAgentState(to, targetState, content);
+
+        if (targetState === "BRIEFED") {
+            console.log(`\n📝 ${to} agent'ı bilgilendirildi (BRIEFED). Hazırlık bekleniyor...`);
+            // Auto-transition to EXECUTING for CLI flow if no blockers
+            transitionAgentState(to, "EXECUTING", content);
+        }
 
         console.log("\n🤖 Görev Devredildi!");
         console.log(`👉 Lütfen ${to} agent talimatlarını (${frameworkDir}/${agentFolder}/${to.replace("@", "")}.md) okuyun ve görevi yerine getirin.`);

package/src/cli/index.ts

@@ -57,16 +57,27 @@ async function main() {
         break;
 
     case "orchestrate":
-    case "loop":
-        orchestrateCommand();
+    case "update-contract":
+        updateApiContractCommand();
         break;
 
-    case "verify-contract":
-        verifyApiContractCommand();
+    case "validate":
+    case "validate-army":
+    case "check:al": {
+        // Dedicated AL (Agent Lifecycle) army validation - can be run independently after init
+        const { execSync } = await import("child_process");
+        try {
+            execSync("node bin/validate-agent-army.js", { stdio: "inherit" });
+        } catch (e) {
+            // validation script itself handles exit codes and messaging
+        }
         break;
+    }
 
-    case "update-contract":
-        updateApiContractCommand();
+    case "version":
+    case "-v":
+    case "--version":
+        console.log(`v${getPackageVersion()}`);
         break;
 
     case "version":
@@ -87,7 +98,8 @@ Usage:
 
 Commands:
   init [adapter]      Initialize Agent Enderun framework (gemini, claude, grok, etc.)
-  check               Perform an enterprise-grade system health check
+  check               Perform an enterprise-grade system health check (includes automatic AL validation)
+  validate            Run dedicated Agent Lifecycle (AL) army validation (validate-agent-army)
   status              Show active phase, trace ID, and agent statuses
   trace:new <desc>    Start a new task chain with a unique Trace ID
   create-app <idea>   Generate a new full-stack app from natural language

package/src/cli/utils/memory.ts

@@ -27,10 +27,15 @@ export function getFrameworkDir(): string {
     for (const dir of FRAMEWORK_DIR_CANDIDATES) {
         const dirPath = path.join(targetDir, dir);
         if (!fs.existsSync(dirPath)) continue;
-        const hasMemory = fs.existsSync(path.join(dirPath, "PROJECT_MEMORY.md"));
+
+        // Support both legacy flat memory and current memory/ subdir layout (AL/cross-adapter fix)
+        const hasMemory = fs.existsSync(path.join(dirPath, "PROJECT_MEMORY.md")) ||
+                          fs.existsSync(path.join(dirPath, "memory", "PROJECT_MEMORY.md"));
+
         const hasAgents = fs.existsSync(path.join(dirPath, "agents")) || 
                            fs.existsSync(path.join(dirPath, "skills")) ||
                            fs.existsSync(path.join(dirPath, "plugins"));
+
         if (hasMemory || hasAgents) {
             return dir;
         }
@@ -44,7 +49,10 @@ export function getFrameworkDir(): string {
 }
 
 export function getMemoryPath() {
-    return path.join(targetDir, getFrameworkDir(), "PROJECT_MEMORY.md");
+    const frameworkDir = getFrameworkDir();
+    const subPath = path.join(targetDir, frameworkDir, "memory/PROJECT_MEMORY.md");
+    if (fs.existsSync(subPath)) return subPath;
+    return path.join(targetDir, frameworkDir, "PROJECT_MEMORY.md");
 }
 
 export function getConfiguredPaths(): { backend: string; frontend: string; docs: string; tests: string } {

package/.enderun/PROJECT_MEMORY.md

@@ -1,23 +0,0 @@
-## CURRENT STATUS
-
-- Phase: PHASE_0 (Genesis)
-- Trace ID: 01HGT8J5E2N0W0W0W0W0W0W0W5
-- @manager state: ENTERPRISE_FULL_PROFILE_ACTIVE
-
-## ACTIVE TASKS
-
-| Trace ID | Task | Agent | Priority | Status |
-| :--- | :--- | :--- | :--- | :--- |
-
-## CRITICAL DECISIONS
-
-- **Tech Stack:** Node.js/Fastify, React/Vite, PostgreSQL, Kysely.
-- **Surgical Standard:** replace_text/patch_file is mandatory for all edits.
-- **Contract First:** All developments must start with type definitions.
-- **Memory Standard:** Auto-pruning active (max 10 entries).
-- **Sovereign Backend Structure:** Every backend service MUST maintain its own database logic (schema, migrations, seeds) within `src/database/` to ensure full isolation.
-
-## HISTORY
-
-- **Framework Scaffolding:** Initialized using Agent Enderun templates.
-- **Stable Release v1.0.3:** Promoted and mühürlendi with Unified Brain Architecture, conditional clean scaffolds, Grok army resolution, and 100% passing integration tests.

package/claude.md

@@ -1,25 +0,0 @@
-# Agent Enderun — Claude Code Adapter
-
-This is the primary entry point when using Agent Enderun within the Claude Code (CLI & Desktop) ecosystem.
-
-The framework operates under a unified governance structure located in the .enderun/ directory.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
-
-### 🤖 Agent Directive
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. **Restore Memory:** Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. **Load Identity:** Read the relevant agent definition under `.enderun/agents/{agent}.md` (default to `@manager`).
-3. **Internalize Knowledge:** Reference the `.enderun/knowledge/` base for architectural and coding standards.
-
-### 🛡️ Core Mandates
-- **Surgical Edits:** Use `replace_text` or `patch_file` via MCP for precise changes.
-- **Traceability:** Every action must inherit the active Trace ID from memory.
-- **Contract First:** No implementation without verified types.
-
-All paths and references inside the project must comply with the Supreme Constitution located at `.enderun/ENDERUN.md`.

package/gemini.md

@@ -1,31 +0,0 @@
-# Agent Enderun — Gemini CLI Adapter
-
-This is the primary entry point when using Agent Enderun within the Gemini CLI ecosystem.
-
-The framework operates under a unified governance structure located in the .enderun/ directory.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
-
-### 🤖 Agent Directive
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. **Restore Memory:** Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. **Load Identity:** Read the relevant agent definition under `.enderun/agents/{agent}.md` (default to `@manager`).
-3. **Internalize Knowledge:** Reference the `.enderun/knowledge/` base for architectural and coding standards.
-
-### 💾 Memory Tiers
-- **Project Memory (Shared):** `.enderun/PROJECT_MEMORY.md` is the source of truth for task history, Trace IDs, and architectural decisions. **Update this at the end of every turn.**
-- **Private Memory (User-Specific):** Use the local `.gitignored` memory directory (e.g. `.enderun/memory/`) for personal workflows or user-specific notes that should not be committed to Git. Never use the system's `/tmp` directory.
-- **Project Instructions:** This `gemini.md` file contains the "Supreme Law" and coding standards.
-
-### 🛡️ Core Mandates
-- **Surgical Edits:** Use `replace_text` or `patch_file` via MCP for precise changes.
-- **Traceability:** Every action must inherit the active Trace ID from memory.
-- **Contract First:** No implementation without verified types.
-- **NEVER FORGET:** @manager MUST update `.enderun/PROJECT_MEMORY.md` at the end of EVERY session without exception. This is a non-negotiable process integrity rule.
-
-All paths and references inside the project must comply with the Supreme Constitution located at `.enderun/ENDERUN.md`.

package/grok.md

@@ -1,25 +0,0 @@
-# Agent Enderun — Grok / X.ai Adapter
-
-This is the primary entry point when using Agent Enderun within the Grok / X.ai ecosystem.
-
-The framework operates under a unified governance structure located in the .enderun/ directory.
-
-### Primary Constitution
-All governance rules, agent checklists, and project memory live here:
-
-👉 **[.enderun/ENDERUN.md](.enderun/ENDERUN.md)**
-
-### 🤖 Agent Directive
-You are operating under the Agent Enderun governance framework.
-
-At the **start of every session**, before any work:
-1. **Restore Memory:** Read `.enderun/PROJECT_MEMORY.md` to restore state, active Trace ID, and history.
-2. **Load Identity:** Read the relevant agent definition under `.enderun/agents/{agent}.md` (default to `@manager`).
-3. **Internalize Knowledge:** Reference the `.enderun/knowledge/` base for architectural and coding standards.
-
-### 🛡️ Core Mandates
-- **Surgical Edits:** Use `replace_text` or `patch_file` via MCP for precise changes.
-- **Traceability:** Every action must inherit the active Trace ID from memory.
-- **Contract First:** No implementation without verified types.
-
-All paths and references inside the project must comply with the Supreme Constitution located at `.enderun/ENDERUN.md`.