agent-enderun 1.0.2 → 1.0.4

package/gemini.md

@@ -19,7 +19,7 @@ At the **start of every session**, before any work:
 
 ### 💾 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 system's temporary directory memory folder for personal workflows or user-specific notes that should not be committed to Git.
+- **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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -82,7 +82,7 @@
     "zod": "^3.24.2"
   },
   "enderun": {
-    "version": "1.0.2",
+    "version": "1.0.4",
     "initializedAt": "2026-05-31T09:58:25.773Z"
   },
   "dependencies": {}

package/src/cli/adapters.ts

@@ -39,7 +39,7 @@ export const ADAPTERS: Record<AdapterId, AdapterConfig> = {
         frameworkDir: ".grok",
         shimFile: "grok.md",
         templateDir: ".enderun",
-        nestedDirs: ["plugins", "knowledge"],
+        nestedDirs: ["plugins", "agents", "knowledge"],
     },
     antigravity: {
         id: "antigravity",
@@ -74,11 +74,43 @@ const SHIM_FILES = ADAPTER_IDS.map((id) => ADAPTERS[id].shimFile);
 
 export function resolveAdapter(input?: string): AdapterConfig {
     const normalized = (input || "gemini").toLowerCase() as AdapterId;
+    let config: AdapterConfig;
     if (ADAPTER_IDS.includes(normalized)) {
-        return ADAPTERS[normalized];
+        config = { ...ADAPTERS[normalized] };
+    } else {
+        console.warn(`⚠️  Unknown adapter "${input}". Falling back to gemini (.gemini/).`);
+        config = { ...ADAPTERS.gemini };
     }
-    console.warn(`⚠️  Unknown adapter "${input}". Falling back to gemini (.gemini/).`);
-    return ADAPTERS.gemini;
+
+    // Dynamic Unified Mode Check:
+    // If a root `.enderun` folder exists, --unified flag is passed, or configured in package.json,
+    // we override `frameworkDir` to be `.enderun` to avoid folder clutter!
+    // We bypass the folder exists check if running unit tests (Vitest) to preserve test integrity.
+    const targetDir = process.cwd();
+    const enderunExists = fs.existsSync(path.join(targetDir, ".enderun"));
+    const hasUnifiedFlag = process.argv.includes("--unified");
+    const isTesting = process.env.VITEST === "true" || process.env.NODE_ENV === "test";
+    
+    let forceEnderun = (enderunExists && !isTesting) || hasUnifiedFlag;
+    try {
+        const pkgPath = path.join(targetDir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+            if (pkg.enderun && (pkg.enderun.frameworkDir === ".enderun" || pkg.enderun.frameworkDir === "unified")) {
+                forceEnderun = true;
+            }
+        }
+    } catch {
+        // ignore
+    }
+
+    if (forceEnderun) {
+        config.frameworkDir = ".enderun";
+        // Ensure standard folder names inside .enderun for universal access
+        config.nestedDirs = ["agents", "skills", "knowledge"];
+    }
+
+    return config;
 }
 
 export function isAdapterShimFile(fileName: string): boolean {
@@ -92,15 +124,17 @@ export function remapFrameworkContent(
 ): string {
     let result = content;
 
-    // 1. Dynamic Agent Folder Mapping based on adapter
+    // 1. Dynamic Agent Folder Mapping based on adapter (Only remap if NOT in unified .enderun mode)
     let agentFolder = "agents";
     let knowledgeFolder = "knowledge";
     
-    if (adapterId === "antigravity") {
-        agentFolder = "skills";
-        knowledgeFolder = "rules";
-    } else if (adapterId === "grok") {
-        agentFolder = "plugins";
+    if (frameworkDir !== ".enderun") {
+        if (adapterId === "antigravity") {
+            agentFolder = "skills";
+            knowledgeFolder = "rules";
+        } else if (adapterId === "grok") {
+            agentFolder = "plugins";
+        }
     }
 
     // 2. Replacements

package/src/cli/commands/init.ts

@@ -202,6 +202,22 @@ export async function initCommand(adapterInput?: string, dryRun = false) {
                 adapter.id,
                 dryRun,
             );
+
+            if (item === templateDir && adapter.id === "grok") {
+                const grokAgentsDest = path.join(targetDir, frameworkDir, "agents");
+                ensureDir(grokAgentsDest, dryRun);
+                copyDir(
+                    path.join(src, "agents"),
+                    grokAgentsDest,
+                    new Set(skipFiles),
+                    nonDestructive,
+                    frameworkDir,
+                    targetScope,
+                    sanitizeJson,
+                    adapter.id,
+                    dryRun,
+                );
+            }
         } else {
             if (item === "package.json") continue;
 
@@ -292,12 +308,13 @@ describe("Initial Setup", () => {
     }
 
     // Always scaffold Antigravity (.agents/) workspace directory for cross-compatibility with agy CLI
-    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 });
+    if (adapter.id === "antigravity" || adapter.id === "antigravity-cli") {
+        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 = [
@@ -415,6 +432,7 @@ describe("Initial Setup", () => {
             // fallback
         }
     }
+}
 
     console.warn(`\n♊ ${adapter.id.toUpperCase()}: Setup complete.`);
     console.warn(`   • Framework runtime: ${frameworkDir}/`);

package/src/cli/utils/fs.ts

@@ -9,6 +9,7 @@ export function updateGitIgnore(targetPath: string, frameworkDir = ".gemini", dr
         "# AI-Enderun",
         `${frameworkDir}/logs/*.json`,
         `${frameworkDir}/*.lock`,
+        `${frameworkDir}/memory/`,
         ".env",
         ".DS_Store",
     ];

package/src/cli/utils/memory.ts

@@ -7,6 +7,23 @@ import { FRAMEWORK_DIR_CANDIDATES } from "../adapters.js";
 const targetDir = process.cwd();
 
 export function getFrameworkDir(): string {
+    // 1. Check if configured in package.json to force a single, unified framework directory
+    try {
+        const pkgPath = path.join(targetDir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+            if (pkg.enderun && typeof pkg.enderun.frameworkDir === "string") {
+                const customDir = pkg.enderun.frameworkDir;
+                if (fs.existsSync(path.join(targetDir, customDir))) {
+                    return customDir;
+                }
+            }
+        }
+    } catch {
+        // ignore
+    }
+
+    // 2. Fall back to dynamic candidate scanning
     for (const dir of FRAMEWORK_DIR_CANDIDATES) {
         const dirPath = path.join(targetDir, dir);
         if (!fs.existsSync(dirPath)) continue;