agent-enderun 1.1.9 → 1.10.0

package/src/cli/commands/status.ts

@@ -1,93 +1,45 @@
-import fs from "fs";
-import path from "path";
 import chalk from "chalk";
 
-import { getMemoryPath, getFrameworkDir } from "../utils/memory.js";
-import { logger } from "../../shared/logger.js";
+import { listTasks, readState, readStatus } from "../utils/memory.js";
 
 /**
  * Print the current framework status.
  */
-export function statusCommand() {
-    const memoryPath = getMemoryPath();
-    const frameworkDir = getFrameworkDir();
-    if (!fs.existsSync(memoryPath)) {
-        console.error(`❌ Error: ${frameworkDir}/PROJECT_MEMORY.md not found. Please run 'init' first.`);
+export async function statusCommand() {
+    const state = readState();
+    const tasks = listTasks();
+    const agentStatuses = readStatus();
+
+    if (!state) {
+        console.error("❌ Error: Memory state not found. Please run 'init' first.");
         return;
     }
 
-    const content = fs.readFileSync(memoryPath, "utf8");
-    
-    // Format 1: Table Style (Original)
-    const tableMatch = content.match(
-        /\| Active Phase \| Profile \| Last Update \| Active Trace ID \| Blockers \|\n\| :----------- \| :------ \| :---------- \| :-------------- \| :------- \|\n\| (.*?) \| (.*?) \| (.*?) \| (.*?) \| (.*?) \|/,
-    );
-
-    // Format 2: List Style (New)
-    const phaseMatch = content.match(/- Phase: (.*)/);
-    const traceIdMatch = content.match(/- Trace ID: (.*)/);
-    const profileMatch = content.match(/- Profile: (.*)/);
-    const updateMatch = content.match(/- Last Update: (.*)/);
-    const blockersMatch = content.match(/- Blockers: (.*)/);
-
     console.warn("\n📊 --- PROJECT STATUS ---");
-    
-    if (tableMatch) {
-        console.warn(`🔹 Phase: ${tableMatch[1].trim()}`);
-        console.warn(`🧭 Profile: ${tableMatch[2].trim()}`);
-        console.warn(`📅 Update: ${tableMatch[3].trim()}`);
-        console.warn(`🆔 Trace ID: ${tableMatch[4].trim()}`);
-        console.warn(`⛔ Blockers: ${tableMatch[5].trim()}`);
-    } else if (phaseMatch || traceIdMatch) {
-        if (phaseMatch) console.warn(`🔹 Phase: ${phaseMatch[1].trim()}`);
-        if (profileMatch) console.warn(`🧭 Profile: ${profileMatch[1].trim()}`);
-        if (updateMatch) console.warn(`📅 Update: ${updateMatch[1].trim()}`);
-        if (traceIdMatch) console.warn(`🆔 Trace ID: ${traceIdMatch[1].trim()}`);
-        if (blockersMatch) console.warn(`⛔ Blockers: ${blockersMatch[1].trim()}`);
+    console.warn(`🔹 Phase: ${state.phase}`);
+    console.warn(`🆔 Trace ID: ${state.traceId}`);
+    console.warn(`🤖 Manager: ${state.managerState}`);
+
+    // Read Agent Status from Document Store
+    console.warn("\n🎖️  Enderun Army Status (Agent States):");
+    for (const [agentName, info] of Object.entries(agentStatuses)) {
+        const { state, task } = info as { state: string; task: string };
+        let coloredState = state;
+        if (state === "READY") coloredState = chalk.green(state);
+        else if (state === "EXECUTING") coloredState = chalk.yellow(state);
+        else if (state === "BLOCKED" || state === "TIMEOUT") coloredState = chalk.red(state);
+        else if (state === "WAITING") coloredState = chalk.cyan(state);
         
-        // Check for manager state in list style
-        const managerState = content.match(/- @manager state: (.*)/);
-        if (managerState) console.warn(`🤖 Manager: ${managerState[1].trim()}`);
-    } else {
-        console.warn("⚠️  Status data could not be parsed in standard formats.");
+        console.warn(`  ${chalk.bold(agentName.padEnd(12))} : [${coloredState}] - ${task}`);
     }
 
-    // Army status check
-    const statusPath = path.join(frameworkDir, "STATUS.md");
-    if (fs.existsSync(statusPath)) {
-        try {
-            const statusContent = fs.readFileSync(statusPath, "utf8");
-            const lines = statusContent.split("\n");
-            const agentRows = lines.filter(line => line.includes("| @") && line.includes("|"));
-            if (agentRows.length > 0) {
-                console.warn("\n🎖️  Enderun Army Status (Agent States):");
-                agentRows.forEach(row => {
-                    const parts = row.split("|");
-                    if (parts.length >= 4) {
-                        const agentName = parts[1].trim();
-                        const state = parts[2].trim();
-                        const activeTask = parts[3].trim();
-                        
-                        let coloredState = state;
-                        if (state === "READY") coloredState = chalk.green(state);
-                        else if (state === "EXECUTING") coloredState = chalk.yellow(state);
-                        else if (state === "BLOCKED" || state === "TIMEOUT") coloredState = chalk.red(state);
-                        else if (state === "WAITING") coloredState = chalk.cyan(state);
-                        
-                        console.warn(`  ${chalk.bold(agentName.padEnd(12))} : [${coloredState}] - ${activeTask}`);
-                    }
-                });
-            }
-        } catch (err) {
-            logger.debug("Failed to read army status file", err);
-        }
-    }
-
-    const tasksSection = content.match(/## ACTIVE TASKS\n\n([\s\S]*?)(?=\n##|$)/);
-    if (tasksSection) {
+    if (tasks.length > 0) {
         console.warn("\n📋 Active Tasks:");
-        console.warn(tasksSection[1].trim());
+        tasks.forEach((t: { priority: string; status: string; description: string; agent: string }) => {
+            console.warn(`  - [${t.priority}] ${t.status}: ${t.description} (@${t.agent})`);
+        });
     }
 
     console.warn("\n-----------------------\n");
 }
+

package/src/cli/commands/trace.ts

@@ -1,46 +1,31 @@
-import fs from "fs";
-
-import { getMemoryPath, acquireMemoryLock, releaseMemoryLock } from "../utils/memory.js";
-import { generateULID } from "../utils/time.js";
-import { sanitizeTableCell, normalizeAgentName, normalizePriority, insertTaskRow } from "../utils/string.js";
+import { updateDocumentStore, generateULID, getFrameworkDir } from "../utils/memory.js";
+import { sanitizeInput, normalizeAgentName, normalizePriority } from "../utils/string.js";
 
 /**
  * Generate a new Trace ID and add it to project memory.
  */
-export function traceNewCommand(description: string, agent = "manager", priority = "P2"): string | void {
-    const memoryPath = getMemoryPath();
-    if (!fs.existsSync(memoryPath)) {
-        console.error("❌ Error: PROJECT_MEMORY.md not found.");
-        return;
-    }
-
+export async function traceNewCommand(description: string, agent = "manager", priority = "P2"): Promise<string | void> {
     const traceId = generateULID();
-    const safeDescription = sanitizeTableCell(description);
+    const safeDescription = sanitizeInput(description);
     const safeAgent = normalizeAgentName(agent);
     const safePriority = normalizePriority(priority);
-    const newTask = `| ${traceId} | ${safeDescription} | @${safeAgent} | ${safePriority} | IN_PROGRESS |`;
-    const lockPath = `${memoryPath}.lock`;
-
-    if (!acquireMemoryLock(lockPath)) {
-        console.error("❌ Error: Memory lock timeout (5 retries).");
-        return;
-    }
+    const frameworkDir = getFrameworkDir();
+    // ...
 
-    try {
-        const content = fs.readFileSync(memoryPath, "utf8");
-        const updated = insertTaskRow(content, newTask);
-        if (!updated) {
-            console.error("❌ Error: ACTIVE TASKS table not found, task could not be added.");
-            return;
-        }
+    // --- Document Store Write ---
+    updateDocumentStore("task", {
+        traceId,
+        description: safeDescription,
+        agent: safeAgent,
+        priority: safePriority,
+        status: "IN_PROGRESS",
+        createdAt: new Date().toISOString()
+    }, traceId, frameworkDir);
+    // ----------------------------
 
-        fs.writeFileSync(memoryPath, updated);
-        console.warn(`
+    console.warn(`
 ✅ New Trace ID created: ${traceId}`);
-        console.warn(`📝 Added to task list: ${description}
+    console.warn(`📝 Added to task list: ${description}
 `);
-        return traceId;
-    } finally {
-        releaseMemoryLock(lockPath);
-    }
+    return traceId;
 }

package/src/cli/index.ts

@@ -2,6 +2,7 @@
 import fs from "fs";
 import { getPackageVersion, getValidatorPath } from "./utils/pkg.js";
 import { getMemoryPath, readActiveTraceId } from "./utils/memory.js";
+import { planCommand } from "./commands/plan.js";
 import { initCommand } from "./commands/init.js";
 import { checkCommand } from "./commands/check.js";
 import { statusCommand } from "./commands/status.js";
@@ -70,18 +71,21 @@ async function main() {
         }
 
         case "check":
-            checkCommand();
+            await checkCommand();
             break;
 
+        case "plan":
+            await planCommand();
+            break;
         case "status":
-            statusCommand();
+            await statusCommand();
             break;
 
         case "trace:new": {
             const description = args[1] || "Default task";
             const agent = args[2] || "manager";
             const priority = args[3] || "P1";
-            traceNewCommand(description, agent, priority);
+            await traceNewCommand(description, agent, priority);
             break;
         }
 
@@ -92,7 +96,7 @@ async function main() {
                 console.error("❌ Error: section and content are required.");
                 process.exit(64);
             }
-            updateProjectMemoryCommand(section, content);
+            await updateProjectMemoryCommand(section, content);
             break;
         }
 
@@ -100,9 +104,15 @@ async function main() {
             await createAppCommand(args.slice(1));
             break;
 
+        case "dashboard": {
+            const { dashboardCommand } = await import("./commands/dashboard.js");
+            await dashboardCommand(args.slice(1));
+            break;
+        }
+
         case "orchestrate":
         case "loop":
-            orchestrateCommand();
+            await orchestrateCommand();
             break;
 
         case "approve": {
@@ -111,16 +121,16 @@ async function main() {
                 console.error("❌ Error: traceId is required.");
                 process.exit(64);
             }
-            approveCommand(traceId);
+            await approveCommand(traceId);
             break;
         }
 
         case "verify-contract":
-            verifyApiContractCommand();
+            await verifyApiContractCommand();
             break;
     
         case "update-contract":
-            updateApiContractCommand();
+            await updateApiContractCommand();
             break;
 
         case "validate":
@@ -140,34 +150,34 @@ async function main() {
             const memoryContent = fs.existsSync(getMemoryPath()) ? fs.readFileSync(getMemoryPath(), "utf8") : "";
             const traceId = readActiveTraceId(memoryContent) || "T-000";
             const { gitCommitCommand } = await import("./commands/git.js");
-            gitCommitCommand(traceId);
+            await gitCommitCommand(traceId);
             break;
         }
 
         case "git:sync": {
             const { gitSyncCommand } = await import("./commands/git.js");
-            gitSyncCommand();
+            await gitSyncCommand();
             break;
         }
 
         case "check:compliance": {
             const targetPath = args[1] || "src";
             const { complianceCheckCommand } = await import("./commands/compliance.js");
-            complianceCheckCommand(targetPath);
+            await complianceCheckCommand(targetPath);
             break;
         }
 
         case "explorer:graph": {
             const targetPath = args[1] || "src";
             const { explorerGraphCommand } = await import("./commands/explorer.js");
-            explorerGraphCommand(targetPath);
+            await explorerGraphCommand(targetPath);
             break;
         }
 
         case "explorer:audit": {
             const targetPath = args[1] || "src";
             const { explorerAuditCommand } = await import("./commands/explorer.js");
-            explorerAuditCommand(targetPath);
+            await explorerAuditCommand(targetPath);
             break;
         }
 
@@ -175,14 +185,14 @@ async function main() {
             const topic = args[1];
             const content = args[2];
             const { updateKnowledgeBaseCommand } = await import("./commands/knowledge.js");
-            updateKnowledgeBaseCommand(topic, content);
+            await updateKnowledgeBaseCommand(topic, content);
             break;
         }
 
         case "knowledge:search": {
             const query = args[1];
             const { searchKnowledgeBaseCommand } = await import("./commands/knowledge.js");
-            searchKnowledgeBaseCommand(query);
+            await searchKnowledgeBaseCommand(query);
             break;
         }
 
@@ -194,7 +204,7 @@ async function main() {
             const memoryContent = fs.existsSync(getMemoryPath()) ? fs.readFileSync(getMemoryPath(), "utf8") : "";
             const traceId = readActiveTraceId(memoryContent) || "T-000";
             const { logAgentActionCommand } = await import("./commands/log.js");
-            logAgentActionCommand({ agent, action, status, summary, traceId });
+            await logAgentActionCommand({ agent, action, status, summary, traceId });
             break;
         }
 
@@ -202,20 +212,20 @@ async function main() {
             const script = args[1];
             const projectPath = args[2] || ".";
             const { runScriptCommand } = await import("./commands/script.js");
-            runScriptCommand(script, projectPath);
+            await runScriptCommand(script, projectPath);
             break;
         }
 
         case "security:audit": {
             const targetPath = args[1] || "src";
             const { securityAuditCommand } = await import("./commands/security.js");
-            securityAuditCommand(targetPath);
+            await securityAuditCommand(targetPath);
             break;
         }
 
         case "check:lint": {
             const { lintCommand } = await import("./commands/lint.js");
-            lintCommand();
+            await lintCommand();
             break;
         }
 
@@ -263,7 +273,7 @@ async function main() {
 
 function showHelp() {
     console.warn(`
-🎖️  Enderun Core CLI (v${getPackageVersion()}) — The Supreme AI Orchestrator
+🎖️  Agent Enderun CLI (v${getPackageVersion()}) — The Supreme AI Orchestrator
 
 Usage:
   agent-enderun <command> [options]
@@ -299,14 +309,24 @@ Natural Language:
   sent to the @manager for orchestration.
 
 Example:
-  agent-enderun "Projemi denetle"
-  agent-enderun @backend "Login sayfasını oluştur"
+  agent-enderun "Audit my project"
+  agent-enderun @backend "Create the login page"
     `);
 }
 
 import { logger } from "../shared/logger.js";
+import { EnderunBaseError } from "../shared/errors.js";
 
 main().catch((err) => {
+    if (err instanceof EnderunBaseError) {
+        console.error(`\n❌ [${err.code}] Error: ${err.message}`);
+        if (err.solution) {
+            console.warn(`💡 Solution Tip: ${err.solution}\n`);
+        }
+    } else {
+        console.error(`\n❌ Fatal Error: ${err.message || String(err)}`);
+    }
+
     logger.fatal("Fatal exception during CLI execution", err);
     process.exit(1);
 });

package/src/cli/shims.ts

@@ -1,5 +1,5 @@
 export const SHIM_TEMPLATES: Record<string, string> = {
-    gemini: `# 🎖️ Enderun Core — GEMINI Strategy
+    gemini: `# 🎖️ Agent Enderun — GEMINI Strategy
 
 You are the **Gemini Commander** (Strategic Decision Center).
 
@@ -8,7 +8,7 @@ You are the **Gemini Commander** (Strategic Decision Center).
 - **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.
 `,
-    "antigravity-cli": `# 🎖️ Enderun Core — ANTIGRAVITY-CLI Strategy
+    "antigravity-cli": `# 🎖️ Agent Enderun — ANTIGRAVITY-CLI Strategy
 
 You are the **Antigravity Specialist** (Preserve Coding Standards).
 
@@ -17,7 +17,7 @@ You are the **Antigravity Specialist** (Preserve Coding Standards).
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Standard Check:** Run health checks regularly to preserve framework integrity.
 `,
-    claude: `# 🎖️ Enderun Core — CLAUDE Strategy
+    claude: `# 🎖️ Agent Enderun — CLAUDE Strategy
 
 You are the **Claude Field Engineer** (Surgical Operations).
 
@@ -26,7 +26,7 @@ You are the **Claude Field Engineer** (Surgical Operations).
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Surgical Precision:** Do not rewrite files. Execute surgical edits.
 `,
-    grok: `# 🎖️ Enderun Core — GROK Strategy
+    grok: `# 🎖️ Agent Enderun — GROK Strategy
 
 You are the **Grok Explorer** (Experimental Protocols).
 
@@ -34,7 +34,7 @@ You are the **Grok Explorer** (Experimental Protocols).
 - **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
+    cursor: `# 🎖️ Agent Enderun — CURSOR Strategy
 
 You are the **Cursor Implementer** (IDE Integration).
 
@@ -42,7 +42,7 @@ You are the **Cursor Implementer** (IDE Integration).
 - **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
+    codex: `# 🎖️ Agent Enderun — COPILOT Strategy
 
 You are the **Copilot Implementer** (GitHub Copilot Integration).
 

package/src/cli/utils/app-backend.ts

@@ -235,6 +235,14 @@ export function createBackendFiles(spec: AppSpec): void {
         "await app.listen({ port, host: \"0.0.0.0\" });",
     ].join("\n"));
 
+    writeTextFile(path.join(targetDir, backendDir, ".env.example"), [
+        "# Agent Enderun - Backend Environment Variables",
+        "PORT=4000",
+        "NODE_ENV=development",
+        "DATABASE_URL=sqlite://./dev.db",
+        "JWT_SECRET=your_secret_key_here",
+    ].join("\n"));
+
     writeTextFile(path.join(targetDir, backendDir, "README.md"), [
         `# ${spec.title} Backend`,
         "",

package/src/cli/utils/app-docs.ts

@@ -12,6 +12,18 @@ export function updateProjectDocs(spec: AppSpec): void {
     const apiDir = path.join(docsDir, "api");
     ensureDir(apiDir);
 
+    const architecture = [];
+    if (spec.platform === "full-stack" || spec.platform === "backend") {
+        architecture.push(`- \`${pathsMap.backend}\`: Fastify API`);
+        architecture.push(`- \`${pathsMap.backend}/src/types\`: Contract-first backend TypeScript types`);
+    }
+    if (spec.platform === "full-stack" || spec.platform === "web") {
+        architecture.push(`- \`${pathsMap.frontend}\`: React dashboard`);
+    }
+    if (spec.platform === "mobile") {
+        architecture.push(`- \`${pathsMap.mobile || "apps/mobile"}\`: Expo / React Native App`);
+    }
+
     writeTextFile(path.join(docsDir, "project-docs.md"), [
         `# ${spec.title} Requirements`,
         "",
@@ -21,6 +33,7 @@ export function updateProjectDocs(spec: AppSpec): void {
         "",
         "## Generated Scope",
         "",
+        `- Platform: ${spec.platform}`,
         `- Domain: ${spec.domain}`,
         `- Auth: ${spec.modules.auth ? "yes" : "no"}`,
         `- Users: ${spec.modules.users ? "yes" : "no"}`,
@@ -29,9 +42,7 @@ export function updateProjectDocs(spec: AppSpec): void {
         "",
         "## Architecture",
         "",
-        `- \`${pathsMap.backend}\`: Fastify API`,
-        `- \`${pathsMap.frontend}\`: React dashboard`,
-        `- \`${pathsMap.backend}/src/types\`: Contract-first backend TypeScript types`,
+        ...architecture,
     ].join("\n"));
 
     writeTextFile(path.join(apiDir, "README.md"), [
@@ -52,13 +63,20 @@ export function updateMemoryForGeneratedApp(spec: AppSpec, traceId: string): voi
 
     const pathsMap = getConfiguredPaths();
     const today = new Date().toISOString().split("T")[0];
+    
+    const impactedFiles = [];
+    if (spec.platform === "full-stack" || spec.platform === "backend") impactedFiles.push(pathsMap.backend);
+    if (spec.platform === "full-stack" || spec.platform === "web") impactedFiles.push(pathsMap.frontend);
+    if (spec.platform === "mobile") impactedFiles.push(pathsMap.mobile || "apps/mobile");
+    impactedFiles.push("project docs");
+
     const history = [
         `### ${today} — Generated ${spec.title}`,
         "",
         "- **Agent:** @manager",
         `- **Trace ID:** ${traceId}`,
-        "- **Action:** Created full-stack starter from natural language request.",
-        `- **Files:** ${pathsMap.backend}, ${pathsMap.frontend}, project docs`,
+        `- **Action:** Created ${spec.platform} starter from natural language request.`,
+        `- **Files:** ${impactedFiles.join(", ")}`,
     ].join("\n");
 
     updateProjectMemory("HISTORY", history);

package/src/cli/utils/app-frontend.ts

@@ -243,6 +243,12 @@ export function createWebFiles(spec: AppSpec): void {
         "}",
     ].join("\n"));
 
+    writeTextFile(path.join(targetDir, frontendDir, ".env.example"), [
+        "# Agent Enderun - Web Environment Variables",
+        "VITE_API_URL=http://localhost:4000/api/v1",
+        "VITE_APP_TITLE=" + spec.title,
+    ].join("\n"));
+
     writeTextFile(path.join(targetDir, frontendDir, "README.md"), [
         `# ${spec.title} Web`,
         "",

package/src/cli/utils/app-inferrer.ts

@@ -5,6 +5,7 @@ export interface AppSpec {
     appName: string;
     title: string;
     domain: string;
+    platform: "web" | "mobile" | "backend" | "full-stack";
     modules: {
         auth: boolean;
         users: boolean;
@@ -19,13 +20,22 @@ export function inferAppSpec(description: string): AppSpec {
     const hasAuth = /auth|login|giris|giriş|signin|sign in|user|kullanici|kullanıcı|role|rol/.test(normalized);
     const hasRoles = /role|rol|permission|yetki|admin/.test(normalized);
     const hasReports = /report|rapor|analytics|dashboard|chart|metric/.test(normalized);
+    const isMobile = /mobile|ios|android|react native|expo/.test(normalized);
+    const isBackend = /backend|api|server|fastify|express/.test(normalized);
+    const isWeb = /web|frontend|react|vite/.test(normalized);
     const appName = isCrm ? "crm-dashboard" : slugifyName(description).split("-").slice(0, 4).join("-");
 
+    let platform: AppSpec["platform"] = "full-stack";
+    if (isMobile) platform = "mobile";
+    else if (isBackend && !isWeb) platform = "backend";
+    else if (isWeb && !isBackend) platform = "web";
+
     return {
         rawDescription: description,
         appName,
         title: isCrm ? "CRM Dashboard" : titleCase(appName),
         domain: isCrm ? "CRM" : "Business",
+        platform,
         modules: {
             auth: hasAuth || isCrm,
             users: hasAuth || hasRoles || isCrm,
@@ -43,7 +53,7 @@ export async function collectCreateAppDescription(args: string[]): Promise<strin
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     try {
         const idea = await rl.question("What do you want to build? ");
-        const platform = await rl.question("Platform? (full-stack/web/backend) ");
+        const platform = await rl.question("Platform? (full-stack/web/backend/mobile) ");
         const auth = await rl.question("Auth and roles? (yes/no) ");
         const reports = await rl.question("Reports/dashboard? (yes/no) ");
         return [idea, platform, auth.includes("y") ? "with auth and roles" : "", reports.includes("y") ? "with reports dashboard" : ""].filter(Boolean).join(" ");