agent-enderun 1.0.8 → 1.1.0

package/src/cli/commands/memory.ts

@@ -5,6 +5,10 @@ import { getMemoryPath, acquireMemoryLock, releaseMemoryLock } from "../utils/me
 
 export function updateProjectMemoryCommand(section: string, content: string) {
     const memoryPath = getMemoryPath();
+    console.log("DEBUG: updateProjectMemoryCommand - memoryPath:", memoryPath);
+    console.log("DEBUG: updateProjectMemoryCommand - section:", section);
+    console.log("DEBUG: updateProjectMemoryCommand - content (first 100 chars):", content.substring(0, 100));
+
     if (!fs.existsSync(memoryPath)) {
         console.error("❌ Error: PROJECT_MEMORY.md not found.");
         return;
@@ -18,6 +22,7 @@ export function updateProjectMemoryCommand(section: string, content: string) {
 
     try {
         let memoryContent = fs.readFileSync(memoryPath, "utf8");
+        console.log("DEBUG: updateProjectMemoryCommand - original memoryContent (first 100 chars):", memoryContent.substring(0, 100));
 
         if (section === "HISTORY") {
             const headers = ["## HISTORY (Persistent Memory)", "## HISTORY"];

package/src/cli/commands/orchestrate.ts

@@ -88,6 +88,59 @@ export async function orchestrateCommand() {
     }
 }
 
+export function sendMessage(args: {
+  from: string;
+  to: string;
+  category: string;
+  content: string;
+  traceId: string;
+}) {
+    const frameworkDir = getFrameworkDir();
+    const messagesDir = path.join(process.cwd(), frameworkDir, "messages");
+    const agentName = args.to.replace("@", "");
+    const messagePath = path.join(messagesDir, `${agentName}.json`);
+    const lockPath = path.join(messagesDir, ".lock");
+
+    // Hermes Lock Protocol: Retry 3 times with 500ms delay
+    let retries = 3;
+    while (retries > 0 && fs.existsSync(lockPath)) {
+        const stats = fs.statSync(lockPath);
+        // Stale lock check (older than 5 seconds)
+        if (Date.now() - stats.mtimeMs > 5000) {
+            fs.unlinkSync(lockPath);
+            break;
+        }
+        retries--;
+        if (retries > 0) {
+            // Synchronous sleep for CLI simplicity
+            const g = global as unknown as { Atomics: { wait: (ia: Int32Array, index: number, value: number, timeout: number) => string }; SharedArrayBuffer: { new (size: number): ArrayBufferLike } };
+            if (g.Atomics && g.SharedArrayBuffer) {
+                g.Atomics.wait(new Int32Array(new g.SharedArrayBuffer(4)), 0, 0, 500);
+            }
+        }
+    }
+
+    try {
+        fs.mkdirSync(messagesDir, { recursive: true });
+        fs.writeFileSync(lockPath, `Locked by ${args.from} at ${new Date().toISOString()}`);
+        
+        const message = {
+            timestamp: new Date().toISOString(),
+            from: args.from,
+            to: args.to,
+            category: args.category,
+            traceId: args.traceId,
+            content: args.content,
+            status: "PENDING"
+        };
+
+        fs.appendFileSync(messagePath, JSON.stringify(message) + "\n");
+        return message;
+    } finally {
+        if (fs.existsSync(lockPath)) fs.unlinkSync(lockPath);
+    }
+}
+
 function transitionAgentState(agent: string, state: string, task: string) {
     const frameworkDir = getFrameworkDir();
     const statusPath = path.join(process.cwd(), frameworkDir, "STATUS.md");

package/src/cli/index.ts

@@ -8,7 +8,7 @@ import { traceNewCommand } from "./commands/trace.js";
 import { updateProjectMemoryCommand } from "./commands/memory.js";
 import { createAppCommand } from "./commands/app.js";
 import { verifyApiContractCommand, updateApiContractCommand } from "./commands/contract.js";
-import { orchestrateCommand } from "./commands/orchestrate.js";
+import { orchestrateCommand, sendMessage } from "./commands/orchestrate.js";
 
 /**
  * Main CLI entry point.
@@ -17,6 +17,48 @@ async function main() {
     const args = process.argv.slice(2);
     const command = args[0];
 
+    const KNOWN_COMMANDS = [
+        "init", "check", "status", "trace:new", "update_project_memory", 
+        "create-app", "orchestrate", "verify-contract", "update-contract", 
+        "validate", "validate-army", "check:al", "version", "-v", "--version", "help", "-h", "--help"
+    ];
+
+    // Handle @agent delegation syntax
+    if (command?.startsWith("@")) {
+        const to = command;
+        const content = args.slice(1).join(" ");
+        if (!content) {
+            console.error(`❌ Error: Missing task content for ${to}.`);
+            console.log(`Usage: agent-enderun ${to} "Your task description"`);
+            process.exit(64);
+        }
+
+        const { getMemoryPath } = await import("./utils/memory.js");
+        const fs = await import("fs");
+        const memoryPath = getMemoryPath();
+
+        let traceId = "T-000";
+        if (fs.default.existsSync(memoryPath)) {
+            const content = fs.default.readFileSync(memoryPath, "utf8");
+            // More robust regex: look for any ULID-like string in the Active Trace ID column or near the label
+            const match = content.match(/Active Trace ID\s*\|.*\|\s*\n\|.*\|.*\|.*\|\s*([A-Z0-9]+)\s*\|/i) || 
+                          content.match(/Active Trace ID[:\s|]+([A-Z0-9]+)/i);
+            if (match) traceId = match[1].trim();
+        }
+
+        sendMessage({
+            from: "@manager",
+            to,
+            category: "DELEGATION",
+            content,
+            traceId
+        });
+
+        console.log(`✅ Task delegated to ${to} (Trace: ${traceId})`);
+        console.log("👉 Run \"agent-enderun orchestrate\" to process.");
+        return;
+    }
+
     switch (command) {
     case "init": {
         const dryRun = args.includes("--dry-run");
@@ -57,6 +99,13 @@ async function main() {
         break;
 
     case "orchestrate":
+        orchestrateCommand();
+        break;
+
+    case "verify-contract":
+        verifyApiContractCommand();
+        break;
+    
     case "update-contract":
         updateApiContractCommand();
         break;
@@ -64,14 +113,12 @@ async function main() {
     case "validate":
     case "validate-army":
     case "check:al": {
-        // Dedicated AL (Agent Lifecycle) army validation - can be run independently after init
-        // Always resolve via getValidatorPath() so 'agent-enderun validate' works after npm install (cross-adapter too).
         const { execSync } = await import("child_process");
         try {
             const validatorPath = getValidatorPath();
             execSync(`node "${validatorPath}"`, { stdio: "inherit" });
         } catch {
-            // validation script itself handles exit codes and messaging
+            // handled by validator
         }
         break;
     }
@@ -85,17 +132,56 @@ async function main() {
     case "help":
     case "-h":
     case "--help":
+        showHelp();
+        break;
+
     default:
-        console.log(`
+        if (command && !KNOWN_COMMANDS.includes(command)) {
+            // Natural language request fallback to @manager
+            const content = args.join(" ");
+            const { getMemoryPath } = await import("./utils/memory.js");
+            const fs = await import("fs");
+            const memoryPath = getMemoryPath();
+
+            let traceId = "T-000";
+            if (fs.default.existsSync(memoryPath)) {
+                const content = fs.default.readFileSync(memoryPath, "utf8");
+                // More robust regex: look for any ULID-like string in the Active Trace ID column or near the label
+                const match = content.match(/Active Trace ID\s*\|.*\|\s*\n\|.*\|.*\|.*\|\s*([A-Z0-9]+)\s*\|/i) || 
+                              content.match(/Active Trace ID[:\s|]+([A-Z0-9]+)/i);
+                if (match) traceId = match[1].trim();
+            }
+
+            sendMessage({
+                from: "@user",
+                to: "@manager",
+                category: "ACTION",
+                content,
+                traceId
+            });
+
+            console.log(`📡 Request sent to @manager: "${content}" (Trace: ${traceId})`);
+            console.log("👉 Run 'agent-enderun orchestrate' to process.");
+        } else {
+            showHelp();
+        }
+        break;
+    }
+}
+
+function showHelp() {
+    console.log(`
 🤖 Agent Enderun CLI — Enterprise AI Orchestration
 
 Usage:
   agent-enderun <command> [options]
+  agent-enderun @<agent> "task description"
+  agent-enderun "natural language request"
 
 Commands:
+  @<agent> <task>     Delegate a task to a specialist agent (e.g. @backend, @frontend)
   init [adapter]      Initialize Agent Enderun framework (gemini, claude, grok, etc.)
-  check               Perform an enterprise-grade system health check (includes automatic AL validation)
-  validate            Run dedicated Agent Lifecycle (AL) army validation (validate-agent-army)
+  check               Perform an enterprise-grade system health check
   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
@@ -104,20 +190,14 @@ Commands:
   update-contract     Generate and synchronize a new contract hash
   version             Show version information
 
-Supported adapters (one init per IDE — separate folder each):
-  - gemini       → .enderun/ (SSOT) + gemini.md
-  - claude       → .enderun/ (SSOT) + claude.md
-  - grok         → .enderun/ (SSOT) + grok.md
-  - antigravity  → .enderun/ (SSOT) + agent.md
+Natural Language:
+  If you provide a sentence that is not a known command, it will be automatically
+  sent to the @manager for orchestration.
 
 Example:
-  agent-enderun init gemini
-  agent-enderun check
-  agent-enderun status
-  agent-enderun trace:new "Auth module design" backend P1
-      `);
-        break;
-    }
+  agent-enderun "Projemi denetle"
+  agent-enderun @backend "Login sayfasını oluştur"
+    `);
 }
 
 main().catch(console.error);

package/src/cli/utils/app.ts

@@ -5,6 +5,7 @@ import { ensureDir, writeTextFile, writeJsonFile } from "../utils/fs.js";
 import { updateProjectMemoryCommand } from "../commands/memory.js"; 
 import { slugifyName, titleCase } from "../utils/string.js";
 import { getConfiguredPaths, getMemoryPath } from "./memory.js";
+import { getDependencyVersions } from "./pkg.js";
 
 
 const targetDir = process.cwd(); // Assuming targetDir is process.cwd() in the CLI context
@@ -293,6 +294,7 @@ interface AppSpec {
 export function createBackendFiles(spec: AppSpec) {
     const pathsMap = getConfiguredPaths();
     const backendDir = pathsMap.backend;
+    const { fastify, "@fastify/cors": fastifyCors, zod, "@types/node": typesNode, tsx, typescript, "vitest-backend": vitest } = getDependencyVersions();
 
     createBaseTypeFiles(path.join(targetDir, backendDir, "src"));
     writeJsonFile(path.join(targetDir, backendDir, "contract.version.json"), {
@@ -311,15 +313,15 @@ export function createBackendFiles(spec: AppSpec) {
             test: "vitest run",
         },
         dependencies: {
-            "@fastify/cors": "^11.0.0",
-            fastify: "^5.0.0",
-            zod: "^3.24.2",
+            "@fastify/cors": fastifyCors,
+            fastify: fastify,
+            zod: zod,
         },
         devDependencies: {
-            "@types/node": "^22.13.4",
-            tsx: "^4.19.4",
-            typescript: "^5.9.3",
-            vitest: "^3.0.5",
+            "@types/node": typesNode,
+            tsx: tsx,
+            typescript: typescript,
+            vitest: vitest,
         },
     });
 
@@ -431,6 +433,7 @@ export function createBackendFiles(spec: AppSpec) {
 export function createWebFiles(spec: AppSpec) {
     const pathsMap = getConfiguredPaths();
     const frontendDir = pathsMap.frontend;
+    const { "@vitejs/plugin-react": vitePluginReact, vite, react, "react-dom": reactDom, "lucide-react": lucideReact, "@types/react": typesReact, "@types/react-dom": typesReactDom, typescript, "vitest-frontend": vitest } = getDependencyVersions();
 
     createBaseTypeFiles(path.join(targetDir, frontendDir, "src"));
     writeJsonFile(path.join(targetDir, frontendDir, "package.json"), {
@@ -445,17 +448,17 @@ export function createWebFiles(spec: AppSpec) {
             test: "vitest run",
         },
         dependencies: {
-            "@vitejs/plugin-react": "^5.0.0",
-            vite: "^7.0.0",
-            react: "^19.0.0",
-            "react-dom": "^19.0.0",
-            "lucide-react": "^0.468.0",
+            "@vitejs/plugin-react": vitePluginReact,
+            vite: vite,
+            react: react,
+            "react-dom": reactDom,
+            "lucide-react": lucideReact,
         },
         devDependencies: {
-            "@types/react": "^19.0.0",
-            "@types/react-dom": "^19.0.0",
-            typescript: "^5.9.3",
-            vitest: "^3.0.5",
+            "@types/react": typesReact,
+            "@types/react-dom": typesReactDom,
+            typescript: typescript,
+            vitest: vitest,
         },
     });
 

package/src/cli/utils/claude.ts

@@ -55,7 +55,8 @@ export function addMcpServerToClaude(configPath: string, serverName: string, ser
 
         fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
         return true;
-    } catch {
+    } catch (e) {
+        console.error(`⚠️  Failed to add MCP server to Claude config at ${configPath}:`, e);
         return false;
     }
 }

package/src/cli/utils/fs.ts

@@ -131,13 +131,14 @@ export function copyDir(
                     try {
                         const json = JSON.parse(content);
                         content = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
-                        content = remapFrameworkContent(content, frameworkDir, adapterId); // Remap again after JSON.stringify for any placeholders
                     } catch {
                         content = content.replace(/workspace:[^"'\s]*/g, "*");
                     }
                 } else {
                     content = content.replace(/workspace:[^"'\s]*/g, "*");
                 }
+                content = remapFrameworkContent(content, frameworkDir, adapterId); // Apply remap once to the final content
+
 
                 if (dryRun) {
                     console.warn(`[DRY RUN] Would process and write: ${destPath}`);

package/src/cli/utils/memory.ts

@@ -20,7 +20,7 @@ export function getFrameworkDir(): string {
             }
         }
     } catch {
-        // ignore
+        // ignore: non-critical parsing errors
     }
 
     // 2. Fall back to dynamic candidate scanning
@@ -74,7 +74,7 @@ export function getConfiguredPaths(): { backend: string; frontend: string; docs:
             }
         }
     } catch {
-        // ignore
+        // ignore: non-critical parsing errors
     }
     return { backend, frontend, docs, tests };
 }

package/src/cli/utils/pkg.ts

@@ -62,6 +62,38 @@ export function getValidatorPath(): string {
     return path.join(getPackageRoot(), "bin", "validate-agent-army.js");
 }
 
+export function getDependencyVersions() {
+    const root = getPackageRoot();
+    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+    const devDependencies = pkg.devDependencies || {};
+    const dependencies = pkg.dependencies || {};
+
+    return {
+        // Backend dependencies
+        "fastify": dependencies["fastify"] || "^5.0.0",
+        "@fastify/cors": dependencies["@fastify/cors"] || "^11.0.0",
+        "zod": dependencies["zod"] || "^3.24.2",
+
+        // Backend devDependencies
+        "@types/node": devDependencies["@types/node"] || "^22.13.4",
+        "tsx": devDependencies["tsx"] || "^4.19.4",
+        "typescript": devDependencies["typescript"] || "^5.9.3",
+        "vitest-backend": devDependencies["vitest"] || "^3.0.5", // Renamed to avoid conflict
+
+        // Frontend dependencies
+        "@vitejs/plugin-react": dependencies["@vitejs/plugin-react"] || "^5.0.0",
+        "vite": dependencies["vite"] || "^7.0.0",
+        "react": dependencies["react"] || "^19.0.0",
+        "react-dom": dependencies["react-dom"] || "^19.0.0",
+        "lucide-react": dependencies["lucide-react"] || "^0.468.0",
+        
+        // Frontend devDependencies
+        "@types/react": devDependencies["@types/react"] || "^19.0.0",
+        "@types/react-dom": devDependencies["@types/react-dom"] || "^19.0.0",
+        "vitest-frontend": devDependencies["vitest"] || "^3.0.5", // Renamed to avoid conflict
+    };
+}
+
 interface PackageJson {
     name?: string;
     version?: string;

package/.enderun/agents/analyst.md

@@ -1,32 +0,0 @@
----
-name: analyst
-description: "Contract Verification & Business Analyst Agent for Agent Enderun"
-role: "Contract Verification & Business Analyst"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["specialist", "quality", "governance"]
-permittedTools: ["read_file", "search_codebase"]
----
-
-# @analyst — Contract Verification & Business Analyst (STRICT_RULES)
-
-- **Identity:** Contract Integrity & Governance Auditor.
-- **Role:** Contract Verification & Business Analyst
-- **Capability Score:** 9
-- **Permitted Directories:** `["*", ".enderun", "docs"]`
-- **Hermes Channels:** `["@analyst->*", "@analyst->@manager"]`
-- **Goal:** Independently verify compliance with contracts and specifications between frontend, backend, and the constitution.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **Independent Stance:** Act as an objective verification gate.
-- **Contract-First Law:** Ensure `contract.version.json` perfectly matches types.
-- **Escalation Priority:** Report all contract drift to `@manager` immediately.
-- **Surgical Edits:** Use `replace_text` for all document updates.
-
----
-**Agent Completion Report**
-- Contract drift audited? [ ] No / [ ] Yes
-- Governance rules validated? [ ] No / [ ] Yes
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
----

package/.enderun/agents/backend.md

@@ -1,49 +0,0 @@
----
-name: backend
-description: "Domain Logic & Databases Specialist Agent for Agent Enderun"
-role: "Domain Logic & Databases Specialist"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["core", "specialist"]
-permittedTools: ["read_file", "replace_text", "write_file", "search_codebase", "run_tests"]
----
-
-# @backend — Domain Logic & Databases (STRICT_RULES)
-
-- **Identity:** Domain Logic & Databases Specialist.
-- **Role:** Domain Logic & Databases Specialist
-- **Capability Score:** 9
-- **Permitted Directories:** `["apps/backend", ".enderun", "docs"]`
-- **Hermes Channels:** `["@backend->*", "@backend->@manager"]`
-- **Goal:** Build secure, high-performance, and consistent server architecture.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **No UI:** Never implement UI or frontend logic.
-- **Contract-First:** Define shared contracts/branded types BEFORE any consumer code.
-- **Branded Types Law:** ALL IDs must use branded types (e.g., `UserID`). Plain strings are forbidden.
-- **Zero Mock Policy:** Use real endpoints/contracts only.
-- **Surgical Edits:** Use `replace_text` for all code changes.
-- **Audit Logging:** Every state-mutating operation (POST, PUT, PATCH, DELETE) MUST trigger `AuditService.log()`.
-- **Async Safety:** Error handling (try/catch) is mandatory for every async block.
-- **Logging Standard:** `console.log` is FORBIDDEN. Use centralized Logger service.
-
-## 🔌 SESSION PROTOCOL
-1. **Restore:** Read `PROJECT_MEMORY.md`.
-2. **Context:** Search codebase for existing patterns before editing.
-3. **Reference:** If implementing architecture, READ `.enderun/knowledge/backend_reference_guide.md` once.
-4. **Log:** Update `PROJECT_MEMORY.md` and log action at the end of every turn.
-
-## 🏗️ ARCHITECTURE (Summary)
-- **Layered:** Route -> Controller -> Service -> Repository -> DB (Kysely only).
-- **Errors:** Use `DomainError` hierarchy only.
-- **Contract:** Sync `apps/backend/src/types` and update `contract.version.json`.
-
----
-**Agent Completion Report** 
-- Reference Guide read? [ ] No / [ ] Yes
-- App types changed? [ ] No / [ ] Yes
-- API contract written? [ ] No / [ ] Yes → .enderun/docs/api/
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
-- Log written? [ ] No / [ ] Yes
----

package/.enderun/agents/database.md

@@ -1,41 +0,0 @@
----
-name: database
-description: "Database Architecture, Performance Tuning & Seeding Authority"
-role: "Database Migrations & Tuning Specialist"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["infrastructure", "specialist"]
-permittedTools: ["read_file", "write_file", "run_migration"]
----
-
-# @database — Database Architecture (STRICT_RULES)
-
-- **Identity:** Database Architecture & Multi-Engine Authority.
-- **Role:** Database Migrations & Tuning Specialist
-- **Capability Score:** 9
-- **Permitted Directories:** `["apps/backend/src/database", ".enderun", "docs"]`
-- **Hermes Channels:** `["@database->*", "@database->@manager"]`
-- **Goal:** Build secure, optimized, and scalable data layers.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **Self-Contained DB:** Every backend application MUST manage its own schema/migrations/seeds in its own `src/database/` directory.
-- **Contract-First:** All schemas MUST be derived from branded types.
-- **Kysely Standard:** Use Kysely for application queries. Raw SQL is forbidden.
-- **Zero Mock Policy:** Realistic, contract-aware seed data only.
-- **Audit Logging:** Log every configuration/tuning action to `.enderun/logs/database.json`.
-- **Surgical Edits:** Use `replace_text` for all schema/migration changes.
-
-## 🔌 SESSION PROTOCOL
-1. **Restore:** Read `PROJECT_MEMORY.md`.
-2. **Context:** Read existing migration patterns before creating new ones.
-3. **Reference:** If designing schemas or tuning, READ `.enderun/knowledge/database_reference_guide.md` once.
-4. **Log:** Update `PROJECT_MEMORY.md` and log action at the end of every turn.
-
----
-**Agent Completion Report** 
-- Reference Guide read? [ ] No / [ ] Yes
-- Contract-First applied? [ ] No / [ ] Yes
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
-- Log written? [ ] No / [ ] Yes
----

package/.enderun/agents/devops.md

@@ -1,41 +0,0 @@
----
-name: devops
-description: "Infrastructure & Deployment Orchestration Specialist Agent for Agent Enderun"
-role: "Infrastructure & CI/CD Specialist"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["infrastructure", "specialist"]
-permittedTools: ["read_file", "write_file", "run_pipeline", "deploy_staging"]
----
-
-# @devops — Infrastructure & Deployment (STRICT_RULES)
-
-- **Identity:** Infrastructure & Deployment Orchestration Specialist.
-- **Role:** Infrastructure & CI/CD Specialist
-- **Capability Score:** 8
-- **Permitted Directories:** `["apps", ".enderun", "docs"]`
-- **Hermes Channels:** `["@devops->*", "@devops->@manager"]`
-- **Goal:** Ensure reliable execution in every environment with strict quality gates.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **Gate Approvals:** NEVER deploy to production without @quality gate approval.
-- **No Docker Policy:** Prefer native Node.js unless explicitly overridden by @manager.
-- **Environment Parity:** Identical configs across dev/staging/prod (except secrets).
-- **Secrets Security:** NEVER hardcode secrets. Use environment variables.
-- **Rollback First:** Deployment is BLOCKED if no documented rollback plan exists.
-- **Health Checks:** Mandatory for every deployed service.
-- **Audit Logging:** Log every deployment to `.enderun/logs/devops.json`.
-
-## 🔌 SESSION PROTOCOL
-1. **Restore:** Read `PROJECT_MEMORY.md`.
-2. **Reference:** If designing pipelines or deploying, READ `.enderun/knowledge/devops_reference_guide.md` once.
-3. **Log:** Update `PROJECT_MEMORY.md` and log action at the end of every turn.
-
----
-**Agent Completion Report** 
-- Reference Guide read? [ ] No / [ ] Yes
-- Gate approvals checked? [ ] No / [ ] Yes
-- Rollback plan documented? [ ] No / [ ] Yes
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
----

package/.enderun/agents/explorer.md

@@ -1,40 +0,0 @@
----
-name: explorer
-description: "Codebase Discovery & Architecture Specialist Agent for Agent Enderun"
-role: "Codebase Discovery Specialist"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["core", "specialist"]
-permittedTools: ["read_file", "search_codebase"]
----
-
-# @explorer — Research & Discovery (STRICT_RULES)
-
-- **Identity:** Codebase Discovery & Architecture Specialist.
-- **Role:** Codebase Discovery Specialist
-- **Capability Score:** 8
-- **Permitted Directories:** `["*", ".enderun", "docs"]`
-- **Hermes Channels:** `["@explorer->*", "@explorer->@manager"]`
-- **Goal:** Map project structure and provide deep context to other agents.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **Read-Only:** Never write production code. Only discover, map, and report.
-- **Search-First:** Always use `search_codebase` before reading large files.
-- **Surgical Discovery:** Focus on entry points and core domain logic.
-- **Zero Mock Policy:** Analyze real system state only.
-- **Traceability:** All findings must be linked to a Trace ID.
-
-## 🔌 SESSION PROTOCOL
-1. **Restore:** Read `PROJECT_MEMORY.md`. If empty, trigger `bootstrap_legacy_memory`.
-2. **Scan:** Identify core folders (`apps/`, `docs/`) and configs.
-3. **Reference:** If performing deep analysis, READ `.enderun/knowledge/explorer_reference_guide.md` once.
-4. **Log:** Update `PROJECT_MEMORY.md` and log action at the end of every turn.
-
----
-**Agent Completion Report** 
-- Reference Guide read? [ ] No / [ ] Yes
-- Codebase searched? [ ] No / [ ] Yes
-- Dependencies analyzed? [ ] No / [ ] Yes
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
----

package/.enderun/agents/frontend.md

@@ -1,48 +0,0 @@
----
-name: frontend
-description: "Fluid Responsive UI Specialist Agent for Agent Enderun"
-role: "Fluid Responsive UI Specialist"
-capability: 9
-stateMachine:
-  schemaRef: "../schema/agent-lifecycle-schema.json"
-tags: ["core", "specialist"]
-permittedTools: ["read_file", "write_file", "replace_text"]
----
-
-# @frontend — Fluid Responsive UI (STRICT_RULES)
-
-- **Identity:** Fluid Responsive UI Specialist.
-- **Role:** Fluid Responsive UI Specialist
-- **Capability Score:** 9
-- **Permitted Directories:** `["apps/web", ".enderun", "docs"]`
-- **Hermes Channels:** `["@frontend->*", "@frontend->@manager"]`
-- **Goal:** Build original, high-performance, and responsive user interfaces.
-
-## 🛑 NON-NEGOTIABLE CORE RULES
-- **Responsive-First:** Mobile-First (320px) is mandatory. Fixed-width is forbidden.
-- **Zero UI Library Policy:** No `shadcn/ui`, `MUI`, etc. Build everything with Panda CSS.
-- **Zero Mock Policy:** Use real endpoints/contracts only.
-- **Contract-First:** Use branded types from `apps/backend/src/types`.
-- **No Native Alerts:** Use integrated Toaster/Modal components.
-- **Surgical Edits:** Use `replace_text` for all code changes.
-- **Consistency:** Follow existing architectural and stylistic patterns.
-
-## 🔌 SESSION PROTOCOL
-1. **Restore:** Read `PROJECT_MEMORY.md`.
-2. **Contract:** READ `.enderun/docs/api/` written by @backend before coding.
-3. **Reference:** If building UI, READ `.enderun/knowledge/frontend_reference_guide.md` once.
-4. **Log:** Update `PROJECT_MEMORY.md` and log action at the end of every turn.
-
-## 🏗️ ARCHITECTURE (Summary)
-- **Styling:** Panda CSS tokens only.
-- **Logic:** Hook-based API architecture (useListPage, useDetailPage, useFormPage).
-- **State:** Zustand for global state.
-
----
-**Agent Completion Report** 
-- Reference Guide read? [ ] No / [ ] Yes
-- API contract read? [ ] No / [ ] Yes
-- Zero UI Library Policy applied? [ ] No / [ ] Yes
-- PROJECT_MEMORY updated? [ ] No / [ ] Yes
-- Log written? [ ] No / [ ] Yes
----