agent-enderun 0.6.0 → 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()) {
@@ -159,7 +159,7 @@ function mergePackageJson(targetPath, sourcePath) {
     "enderun:check": "agent-enderun check",
     "enderun:test": "vitest run",
     "enderun:test:watch": "vitest",
-    "enderun:build": `${runCmd} build --prefix packages/shared-types && ${runCmd} build --prefix framework-mcp`,
+    "enderun:build": `${runCmd} build --prefix framework-mcp`,
   };
 
   const sourceDevDeps = sourcePkg.devDependencies || {};
@@ -183,7 +183,7 @@ function mergePackageJson(targetPath, sourcePath) {
   if (!targetPkg.name) targetPkg.name = path.basename(process.cwd());
   if (!targetPkg.version) targetPkg.version = "0.1.0";
   if (!targetPkg.type) targetPkg.type = "module";
-  if (!targetPkg.workspaces) targetPkg.workspaces = ["packages/*"];
+  if (!targetPkg.workspaces) targetPkg.workspaces = ["apps/*", "framework-mcp"];
 
   // Add metadata
   targetPkg.enderun = {
@@ -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]);
@@ -382,6 +444,16 @@ async function initCommand(selectedAdapter) {
     Object.values(ADAPTERS).forEach(list => filesToProcess.push(...list));
   }
 
+  // Ensure apps/backend structure for contract file
+  ensureDir(path.join(targetDir, "apps/backend"));
+  const initContractPath = path.join(targetDir, "apps/backend/contract.version.json");
+  if (!fs.existsSync(initContractPath)) {
+    writeJsonFile(initContractPath, {
+      "contract_hash": "initial_hash_placeholder",
+      "last_updated": new Date().toISOString()
+    });
+  }
+
   // Detect target project scope
   let targetPkg = {};
   try {
@@ -497,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") {
@@ -763,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);
@@ -1883,7 +1958,7 @@ async function createAppCommand(args) {
 
   console.log(`\n✅ Created ${spec.title}`);
   console.log("📁 Generated apps/backend and apps/web");
-  console.log("📜 Updated project docs and shared-types contract");
+  console.log("📜 Updated project docs and app-local types contract");
   console.log("\nNext commands:");
   console.log("  npm install");
   console.log("  npm run enderun:build");
@@ -2059,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/bin/update-contract.js

@@ -12,8 +12,8 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.join(__dirname, "..");
 
-const contractPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
-const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+const contractPath = path.join(projectRoot, "apps/backend/contract.version.json");
+const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
 
 function collectTypeFiles(dir) {
   const entries = fs.readdirSync(dir, { withFileTypes: true });

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.