agent-enderun 1.1.10 → 1.10.0

package/src/cli/utils/memory.ts

@@ -2,9 +2,9 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { logger } from "../../shared/logger.js";
-import { ensureDir } from "../../shared/fs.js";
-import { sleep } from "./time.js";
+import { ensureDir, writeTextFile, writeJsonFile } from "../../shared/fs.js";
 import { StateSchema, AgentStatusSchema, TaskSchema } from "./schemas.js";
+import type { TraceID } from "../../shared/types.js";
 
 export { generateULID } from "./time.js";
 export { FRAMEWORK_DIR_CANDIDATES } from "../adapters/index.js";
@@ -36,6 +36,14 @@ export function getLocalFrameworkDir(): string {
 export function getConfigDir(): string {
     const localDir = findFrameworkDir(CWD);
     if (localDir) return localDir;
+
+    // Check for standard local directories if package.json doesn't specify
+    const localCandidates = [".enderun", ".gemini", ".claude", ".cursor", ".antigravity", ".agent"];
+    for (const cand of localCandidates) {
+        const p = path.join(CWD, cand);
+        if (fs.existsSync(p)) return p;
+    }
+
     return path.join(HOME, ".gemini");
 }
 
@@ -46,9 +54,7 @@ export function getFrameworkDir(): string {
 
 export function getDocumentStorePath() {
     const frameworkDir = getFrameworkDir();
-    const store = path.join(frameworkDir, "memory");
-    console.warn(`[DEBUG] getDocumentStorePath returning ${store}`);
-    return store;
+    return path.join(frameworkDir, "memory");
 }
 
 export function initDocumentStore(frameworkDir?: string) {
@@ -59,12 +65,15 @@ export function initDocumentStore(frameworkDir?: string) {
     
     const stateFile = path.join(storePath, "state.json");
     if (!fs.existsSync(stateFile)) {
-        fs.writeFileSync(stateFile, JSON.stringify({ phase: "PHASE_0", traceId: "T-000", managerState: "ACTIVE" }, null, 2));
+        writeJsonFile(stateFile, { phase: "PHASE_0", traceId: "T-000", managerState: "ACTIVE" });
     }
     const statusFile = path.join(storePath, "status.json");
     if (!fs.existsSync(statusFile)) {
-        fs.writeFileSync(statusFile, JSON.stringify({}, null, 2));
+        writeJsonFile(statusFile, {});
     }
+
+    // Ensure the initial Markdown view is created
+    syncMarkdownMemory(frameworkDir);
 }
 
 export function readState() {
@@ -111,14 +120,14 @@ export function updateProjectMemory(section: string, content: string) {
     }
 }
 
-export function initializeMemory(memoryPathOrBase: string, targetBaseOrDryRun?: string | boolean, dryRun = false): void {
-    const targetBase = typeof targetBaseOrDryRun === 'string' ? targetBaseOrDryRun : memoryPathOrBase;
+export function initializeMemory(memoryPathOrBase: string, targetBaseOrDryRun?: string | boolean): void {
+    const targetBase = typeof targetBaseOrDryRun === "string" ? targetBaseOrDryRun : memoryPathOrBase;
     initDocumentStore(targetBase);
     logger.info("✅ Document store initialized.");
 }
 
-export function getConfiguredPaths(): { backend: string; frontend: string; docs: string; tests: string } {
-    const defaultPaths = { backend: "apps/backend", frontend: "apps/web", docs: "docs", tests: "tests" };
+export function getConfiguredPaths(): { backend: string; frontend: string; mobile: string; docs: string; tests: string } {
+    const defaultPaths = { backend: "apps/backend", frontend: "apps/web", mobile: "apps/mobile", docs: "docs", tests: "tests" };
     try {
         const frameworkDir = getConfigDir();
         const configPath = path.join(frameworkDir, "config.json");
@@ -132,43 +141,117 @@ export function getConfiguredPaths(): { backend: string; frontend: string; docs:
     return defaultPaths;
 }
 
-export function updateDocumentStore(type: "state" | "task" | "history" | "status", data: unknown, id?: string, frameworkDir?: string) {
+export function updateDocumentStore(type: "state" | "task" | "history" | "status", data: unknown, id?: string | TraceID, frameworkDir?: string) {
     const storePath = frameworkDir ? path.join(frameworkDir, "memory") : getDocumentStorePath();
     ensureDir(storePath);
 
     switch (type) {
         case "state":
             StateSchema.parse(data);
-            fs.writeFileSync(path.join(storePath, "state.json"), JSON.stringify(data, null, 2));
+            writeJsonFile(path.join(storePath, "state.json"), data);
             break;
         case "status":
             AgentStatusSchema.parse(data);
-            fs.writeFileSync(path.join(storePath, "status.json"), JSON.stringify(data, null, 2));
+            writeJsonFile(path.join(storePath, "status.json"), data);
             break;
         case "task":
             TaskSchema.parse(data);
             ensureDir(path.join(storePath, "tasks"));
-            fs.writeFileSync(path.join(storePath, "tasks", `${id}.json`), JSON.stringify(data, null, 2));
+            writeJsonFile(path.join(storePath, "tasks", `${id}.json`), data);
             break;
         case "history":
             ensureDir(path.join(storePath, "history"));
-            fs.writeFileSync(path.join(storePath, "history", `${id}.json`), JSON.stringify(data, null, 2));
+            writeJsonFile(path.join(storePath, "history", `${id}.json`), data);
             break;
     }
+
+    // Auto-sync Markdown view after any change
+    syncMarkdownMemory(frameworkDir);
+}
+
+/**
+ * Single Source of Truth Bridge: JSON -> Markdown
+ * Regenerates PROJECT_MEMORY.md from structured state.
+ */
+export function syncMarkdownMemory(fDir?: string) {
+    const frameworkDir = fDir || getFrameworkDir();
+    const storePath = path.join(frameworkDir, "memory");
+    const mdPath = path.join(storePath, "PROJECT_MEMORY.md");
+
+    try {
+        const state = readState();
+        const status = readStatus();
+        const tasks = listTasks();
+
+        if (!state) return;
+
+        const lines = [
+            "# 🧠 Agent Enderun — Project Memory",
+            "",
+            "## 📍 Current State",
+            `- **Phase:** ${state.phase || "PHASE_0"}`,
+            `- **Trace ID:** ${state.traceId || "N/A"}`,
+            `- **@manager state:** ${state.managerState || "ACTIVE"}`,
+            "",
+            "## 📋 Active Tasks",
+            "| Trace ID | Task | Agent | Priority | Status |",
+            "| :--- | :--- | :--- | :--- | :--- |",
+        ];
+
+        tasks.forEach(t => {
+            if (t.status !== "COMPLETED") {
+                lines.push(`| ${t.traceId} | ${t.description} | ${t.agent} | ${t.priority} | ${t.status} |`);
+            }
+        });
+
+        lines.push("", "## 🤖 Agent Statuses");
+        lines.push("| Agent | State | Active Task | Last Updated |");
+        lines.push("| :--- | :--- | :--- | :--- |");
+
+        for (const [agent, info] of Object.entries(status)) {
+            const data = info as { state: string; task: string; lastUpdated?: string };
+            lines.push(`| @${agent} | ${data.state} | ${data.task} | ${data.lastUpdated || "-"} |`);
+        }
+
+        lines.push("", "## 📜 HISTORY");
+        
+        // Add last 5 history items
+        const historyDir = path.join(storePath, "history");
+        if (fs.existsSync(historyDir)) {
+            const histFiles = fs.readdirSync(historyDir)
+                .filter(f => f.endsWith(".json"))
+                .sort()
+                .reverse()
+                .slice(0, 10);
+            
+            histFiles.forEach(f => {
+                const hist = JSON.parse(fs.readFileSync(path.join(historyDir, f), "utf8"));
+                lines.push(`### ${f.replace(".json", "")}`);
+                lines.push(hist.content);
+                lines.push("");
+            });
+        }
+
+        writeTextFile(mdPath, lines.join("\n"));
+        logger.debug("Markdown memory synchronized.");
+    } catch (err) {
+        logger.debug("Markdown memory sync failed", err);
+    }
 }
 
 
 export function acquireMemoryLock(lockPath: string): boolean {
     try {
-        fs.writeFileSync(lockPath, String(Date.now()), { flag: 'wx' });
+        fs.writeFileSync(lockPath, String(Date.now()), { flag: "wx" });
         return true;
-    } catch (err: any) {
-        if (err.code === 'EEXIST') {
+    } catch (err: unknown) {
+        const error = err as { code?: string };
+        if (error.code === "EEXIST") {
             try {
                 const stat = fs.statSync(lockPath);
                 if (Date.now() - stat.mtimeMs > 10000) {
                     fs.unlinkSync(lockPath);
-                    fs.writeFileSync(lockPath, String(Date.now()), { flag: 'wx' });
+                    fs.writeFileSync(lockPath, String(Date.now()), { flag: "wx" });
                     return true;
                 }
             } catch {

package/src/cli/utils/pkg.ts

@@ -1,5 +1,6 @@
 import fs from "fs";
 import path from "path";
+import { writeTextFile, writeJsonFile } from "./fs.js";
 
 export function getPackageVersion() {
     const root = getPackageRoot();
@@ -43,7 +44,7 @@ function findAgentEnderunPackageRoot(): string {
         if (fs.existsSync(pkgPath)) {
             try {
                 const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-                if (pkg.name === "agent-enderun" || pkg.name === "enderun-core") {
+                if (pkg.name === "agent-enderun") {
                     return current;
                 }
             } catch {
@@ -203,7 +204,7 @@ export function mergePackageJson(targetPath: string, sourcePath: string): void {
       initializedAt: new Date().toISOString(),
   };
 
-  fs.writeFileSync(targetPath, JSON.stringify(targetPkg, null, 2));
+  writeJsonFile(targetPath, targetPkg);
   console.warn("✅ package.json updated with Enderun scripts and dependencies.");
 }
 
@@ -226,20 +227,20 @@ export function sanitizeJson(obj: unknown, targetScope = ""): unknown {
         if (targetScope) {
             const scopeName = targetScope.startsWith("@") ? targetScope.slice(1) : targetScope;
 
-            // Handle scoped: @ai-enderun/foo -> @target/foo
-            if (typeof key === "string" && key.startsWith("@ai-enderun/")) {
-                finalKey = key.replace("@ai-enderun/", `${targetScope}/`);
+            // Handle scoped: @agent-enderun/foo -> @target/foo
+            if (typeof key === "string" && key.startsWith("@agent-enderun/")) {
+                finalKey = key.replace("@agent-enderun/", `${targetScope}/`);
             }
-            if (typeof value === "string" && value.startsWith("@ai-enderun/")) {
-                finalValue = value.replace("@ai-enderun/", `${targetScope}/`);
+            if (typeof value === "string" && value.startsWith("@agent-enderun/")) {
+                finalValue = value.replace("@agent-enderun/", `${targetScope}/`);
             }
 
-            // Handle unscoped: ai-enderun-foo -> target-foo
-            if (typeof key === "string" && key.startsWith("ai-enderun-")) {
-                finalKey = key.replace("ai-enderun-", `${scopeName}-`);
+            // Handle unscoped: agent-enderun-foo -> target-foo
+            if (typeof key === "string" && key.startsWith("agent-enderun-")) {
+                finalKey = key.replace("agent-enderun-", `${scopeName}-`);
             }
-            if (typeof value === "string" && value.startsWith("ai-enderun-")) {
-                finalValue = value.replace("ai-enderun-", `${scopeName}-`);
+            if (typeof value === "string" && value.startsWith("agent-enderun-")) {
+                finalValue = value.replace("agent-enderun-", `${scopeName}-`);
             }
       
             // Handle agent-enderun -> target (ONLY for the package name)
@@ -276,7 +277,7 @@ export function deepCleanProtocols(dir: string, targetScope = ""): void {
                 const content = fs.readFileSync(fullPath, "utf8");
                 const json = JSON.parse(content);
                 const cleaned = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
-                fs.writeFileSync(fullPath, cleaned);
+                writeTextFile(fullPath, cleaned);
             } catch {
                 // ignore malformed json
             }

package/src/cli/utils/string.ts

@@ -18,7 +18,7 @@ export function insertTaskRow(memoryContent: string, row: string): string | null
 export function sanitizeInput(input: string): string {
     return String(input)
         .replace(/\\/g, "\\\\")
-        .replace(/"/g, '\\"')
+        .replace(/"/g, "\\\"")
         .replace(/[\r\n]+/g, " ")
         .replace(/<script\b[^>]*>([\s\S]*?)<\/script>/gim, "") 
         .replace(/--/g, "-") 

package/src/cli/utils/ui.ts

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 
 /**
- * Professional UI Utilities for Enderun Core CLI.
+ * Professional UI Utilities for Agent Enderun CLI.
  * Standardizes headers, status boxes, and strategic intent reporting.
  */
 

package/src/modules/adapters/shared.ts

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs";
 import os from "os";
-import { writeJsonFile } from "../../shared/fs.js";
+import { writeJsonFile, writeTextFile } from "../../shared/fs.js";
 import { ALL_AGENTS, toAntigravityJson } from "../agents/definitions.js";
 import { CORE_SKILLS } from "../skills/definitions.js";
 
@@ -42,10 +42,10 @@ export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
                 // 1. Nested format (agents/{agent_name}/agent.json)
                 const nestedAgentDir = path.join(agentsBaseDir, ag.name);
                 fs.mkdirSync(nestedAgentDir, { recursive: true });
-                fs.writeFileSync(path.join(nestedAgentDir, "agent.json"), agentJson);
+                writeTextFile(path.join(nestedAgentDir, "agent.json"), agentJson);
 
-                // 2. Direct flat format (agents/{agent_name}.json) as subagent definition templates
-                fs.writeFileSync(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
+                // 2. Direct flat format (agents/{agent_name}.json)
+                writeTextFile(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
             }
 
             // Scaffold skills
@@ -53,10 +53,10 @@ export function registerGlobalAntigravityPlugins(mcpBlock: unknown): void {
             fs.mkdirSync(skillsDir, { recursive: true });
             for (const [key, skill] of Object.entries(CORE_SKILLS)) {
                 const skillContent = `# 🛠️ Skill — ${skill.name}\n\n${skill.mandates.join("\n")}\n`;
-                fs.writeFileSync(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
+                writeTextFile(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
             }
 
-            // Scaffold rules (Optional custom codebase rules files)
+            // Scaffold rules
             const rulesDir = path.join(globalPluginDir, "rules");
             fs.mkdirSync(rulesDir, { recursive: true });
             for (const ag of ALL_AGENTS) {
@@ -78,7 +78,7 @@ ${ag.instructions.rules.map(r => `- ${r}`).join("\n")}
 - **Traceability:** Inherit and pass the active Trace ID across all delegations.
 - **Approval Signature:** High-risk actions require manager approval signature.
 `;
-                fs.writeFileSync(path.join(rulesDir, `${ag.name}.md`), ruleContent);
+                writeTextFile(path.join(rulesDir, `${ag.name}.md`), ruleContent);
             }
 
             // Scaffold optional empty hooks.json