agent-enderun 0.6.1 → 0.6.5

package/antigravity.md

@@ -0,0 +1,15 @@
+# Agent Enderun — Antigravity Adapter
+
+This file is the entry point for Antigravity CLI. The project's "Supreme Law" and all instructions are located in the following file:
+
+👉 **[.antigravitycli/ENDERUN.md](.antigravitycli/ENDERUN.md)**
+
+### 🤖 AGENT DIRECTIVE
+You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
+
+⚠️ **CRITICAL STARTUP REQUIREMENT:**
+At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
+1. You **MUST** read `.antigravitycli/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `.antigravitycli/agents/manager.md` (or the specialist's md file in `.antigravitycli/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+
+Please read the Supreme Law thoroughly before taking any action.

package/bin/cli.js

@@ -22,7 +22,7 @@ function getPackageVersion() {
 }
 
 function getFrameworkDir() {
-  const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];
+  const adapters = [".antigravitycli", ".claude", ".cursor", ".enderun", ".codex", ".gemini"];
   for (const adp of adapters) {
     const fullPath = path.join(targetDir, adp);
     if (fs.existsSync(fullPath) && fs.lstatSync(fullPath).isDirectory()) {
@@ -225,6 +225,60 @@ function updateGitIgnore(targetPath, frameworkDir = ".enderun") {
   }
 }
 
+/**
+ * Finds the Claude config file path (if it exists).
+ */
+function findClaudeConfigPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (!home) return null;
+
+  const possiblePaths = [
+    path.join(home, ".config", "claude", "config.json"),
+    path.join(home, ".claude", "config.json"),
+    path.join(home, "Library", "Application Support", "Claude", "config.json"), // macOS Claude Desktop
+    path.join(home, "Library", "Application Support", "Claude Code", "config.json"), // macOS Claude Code
+    path.join(home, ".config", "Claude", "config.json"), // some Linux setups
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p)) {
+      return p;
+    }
+  }
+  return null;
+}
+
+/**
+ * Adds or updates an MCP server entry in Claude's config file.
+ */
+function addMcpServerToClaude(configPath, serverName, serverConfig) {
+  try {
+    let config = { mcpServers: {} };
+
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, "utf8");
+      config = JSON.parse(content);
+    }
+
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+
+    config.mcpServers[serverName] = serverConfig;
+
+    // Ensure parent directory exists
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
 /**
  * Create initial PROJECT_MEMORY.md if missing.
  */
@@ -318,13 +372,21 @@ function getPackageManager() {
  */
 async function initCommand(selectedAdapter) {
   const ADAPTERS = {
-    gemini: ["gemini.md", "gemini-extension.json"],
+    antigravity: ["antigravity.md"],
     claude: ["claude.md"],
     cursor: ["cursor.md"],
     codex: ["codex.md"],
+    gemini: ["gemini.md"],
   };
 
-  const targetBase = selectedAdapter && selectedAdapter !== "codex" ? `.${selectedAdapter}` : ".enderun";
+  let targetBase;
+  if (selectedAdapter === "antigravity") {
+    targetBase = ".antigravitycli";
+  } else if (selectedAdapter && selectedAdapter !== "codex") {
+    targetBase = `.${selectedAdapter}`;
+  } else {
+    targetBase = ".enderun";
+  }
 
   const targetFrameworkDir = path.join(targetDir, targetBase);
 
@@ -374,7 +436,7 @@ async function initCommand(selectedAdapter) {
   let filesToProcess = [...CORE_FILES];
   if (selectedAdapter) {
     if (!ADAPTERS[selectedAdapter]) {
-      console.error(`❌ Invalid adapter: ${selectedAdapter}. Available: gemini, claude, cursor, codex`);
+      console.error(`❌ Invalid adapter: ${selectedAdapter}. Available: antigravity, claude, cursor, codex, gemini`);
       process.exit(1);
     }
     filesToProcess.push(...ADAPTERS[selectedAdapter]);
@@ -507,30 +569,33 @@ async function initCommand(selectedAdapter) {
   console.log("\n🛠️  Running smart configuration for adapters...");
 
 
-  if (selectedAdapter === "gemini") {
-    // Patch gemini-extension.json to wire up the MCP server automatically
-    const geminiExtPath = path.join(targetDir, "gemini-extension.json");
-    try {
-      const ext = JSON.parse(fs.readFileSync(geminiExtPath, "utf8"));
-      ext.mcpServers = {
-        "agent-enderun": {
-          command: "node",
-          args: ["framework-mcp/dist/index.js"]
-        }
-      };
-      fs.writeFileSync(geminiExtPath, JSON.stringify(ext, null, 2) + "\n");
-      console.log("💎 Gemini: MCP server wired up in gemini-extension.json automatically.");
-    } catch (e) {
-      console.warn("⚠️  Gemini: Could not patch gemini-extension.json for MCP. Wire it up manually.");
-    }
-    console.log(`💎 Gemini: Adapter gemini.md and ${targetBase}/ folder are ready.`);
+  if (selectedAdapter === "antigravity") {
+    console.log(`🚀 Antigravity: Adapter antigravity.md and ${targetBase}/ folder are ready.`);
   }
 
   if (selectedAdapter === "claude") {
     const mcpPath = path.join(targetDir, "framework-mcp/src/index.ts");
-    console.log("\n📝 Claude Code Setup:");
-    console.log("To enable Agent Enderun tools in Claude Code, run this command:");
-    console.log(`\x1b[36mclaude config add framework-mcp npx tsx ${mcpPath}\x1b[0m`);
+    const mcpConfig = {
+      command: "npx",
+      args: ["tsx", mcpPath]
+    };
+
+    const claudeConfigPath = findClaudeConfigPath() || path.join(
+      process.env.HOME || process.env.USERPROFILE || "",
+      "Library", "Application Support", "Claude", "config.json"
+    ); // default macOS path if nothing found
+
+    const success = addMcpServerToClaude(claudeConfigPath, "agent-enderun", mcpConfig);
+
+    if (success) {
+      console.log("✅ Claude: MCP server 'agent-enderun' automatically configured.");
+      console.log(`   Config file: ${claudeConfigPath}`);
+      console.log("   (File was created if it did not exist)");
+    } else {
+      console.log("\n📝 Claude Code Setup (Automatic failed):");
+      console.log("Please run this command manually:");
+      console.log(`\x1b[36mclaude config add agent-enderun npx tsx ${mcpPath}\x1b[0m`);
+    }
   }
 
   if (selectedAdapter === "cursor") {
@@ -773,8 +838,8 @@ function copyDir(src, dest, skipSet = new Set(), nonDestructive = false, framewo
 
         const frameworkBase = frameworkDir.startsWith(".") ? frameworkDir.slice(1) : frameworkDir;
         let currentAdapter = frameworkBase;
-        if (entry.name.endsWith(".md") && [ "gemini", "claude", "cursor", "codex" ].some(a => entry.name.startsWith(a))) {
-          currentAdapter = [ "gemini", "claude", "cursor", "codex" ].find(a => entry.name.startsWith(a));
+        if (entry.name.endsWith(".md") && [ "antigravity", "claude", "cursor", "codex", "gemini" ].some(a => entry.name.startsWith(a))) {
+          currentAdapter = [ "antigravity", "claude", "cursor", "codex", "gemini" ].find(a => entry.name.startsWith(a));
         }
 
         content = content.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
@@ -2069,7 +2134,7 @@ async function main() {
 🤖 Agent Enderun CLI (v${FRAMEWORK_VERSION})
 
 Available Commands:
-  init [adapter]      Initialize the framework (gemini, claude, cursor, codex)
+  init [adapter]      Initialize the framework (antigravity, claude, cursor, codex, gemini)
   create-app <idea>   Generate a full-stack starter from natural language
   check               Full health check
   check:security      Run security audit scan

package/docs/README.md

@@ -1,7 +1,12 @@
-# Project Documentation
+# Project Documentation / Proje Dokümantasyonu
 
-This folder is managed by **Agent Enderun agents** and contains documentation
-generated for **your project** — not the framework itself.
+English | [Türkçe](#türkçe)
+
+---
+
+# English
+
+This folder is managed by **Agent Enderun agents** and contains documentation generated for **your project** — not the framework itself.
 
 ## What Goes Here
 
@@ -21,3 +26,28 @@ generated for **your project** — not the framework itself.
 | `/.enderun/docs/` | **Framework** configuration — tech-stack, security policy, privacy policy |
 
 > Agents will populate this folder automatically during **PHASE_2 (Core Development)**.
+
+---
+
+# Türkçe
+
+Bu klasör **Agent Enderun ajanları** tarafından yönetilir ve framework'ün kendisi için değil, **sizin projeniz** için oluşturulan dokümanları içerir.
+
+## Burada Neler Var?
+
+| Dosya | Sahip Ajan | Açıklama |
+| :--- | :--- | :--- |
+| `architecture.md` | @backend | Sistem mimarisi ve veri akış diyagramları |
+| `api-reference.md` | @backend | Genel API uç noktaları ve kullanım örnekleri |
+| `components.md` | @frontend | UI bileşen kataloğu ve kullanım kılavuzları |
+| `deployment.md` | @manager | Dağıtım adımları ve ortam kurulumu |
+| `decisions.md` | @manager | Mimari Karar Kayıtları (ADRs) |
+
+## `.enderun/docs/` Klasöründen Farkı
+
+| Yol | Amaç |
+| :--- | :--- |
+| `/docs/` | **Sizin projenizin** dokümantasyonu — özellikler geliştirildikçe ajanlar tarafından yazılır |
+| `/.enderun/docs/` | **Framework** konfigürasyonu — tech-stack, güvenlik politikası, gizlilik politikası |
+
+> Ajanlar bu klasörü **PHASE_2 (Core Development)** sırasında otomatik olarak dolduracaktır.