agent-enderun 0.9.4 → 1.0.0

package/src/cli/commands/orchestrate.ts

@@ -1,111 +1,117 @@
 import fs from "fs";
 import path from "path";
-import { execSync } from "child_process";
 import { getFrameworkDir } from "../utils/memory.js";
 
 interface HermesMessage {
   timestamp: string;
   from: string;
   to: string;
-  category: "ACTION" | "DELEGATION" | "INFO" | "ALERT";
-  traceId: string;
+  category: string;
   content: string;
+  traceId: string;
   status: "PENDING" | "PROCESSED";
 }
 
-/**
- * Start the live Hermes Orchestration & Message Loop
- */
-export function orchestrateCommand() {
-  const frameworkDir = getFrameworkDir();
-  const messagesDir = path.join(process.cwd(), frameworkDir, "messages");
-  const statusPath = path.join(process.cwd(), frameworkDir, "STATUS.md");
-
-  console.log(`\n================================================================`);
-  console.log(`🏛️  AGENT ENDERUN — DYNAMIC HERMES ORCHESTRATÖR DÖNGÜSÜ`);
-  console.log(`================================================================`);
-  console.log(`🛰️  Hermes Message Broker dinleniyor: ${frameworkDir}/messages/...`);
-
-  if (!fs.existsSync(messagesDir)) {
-    fs.mkdirSync(messagesDir, { recursive: true });
-  }
-
-  // Scan all JSON files in the messages directory
-  const messageFiles = fs.readdirSync(messagesDir).filter(f => f.endsWith(".json"));
-  const pendingMessages: HermesMessage[] = [];
-
-  for (const file of messageFiles) {
-    const filePath = path.join(messagesDir, file);
-    try {
-      const content = fs.readFileSync(filePath, "utf8").trim();
-      if (!content) continue;
-      // Messages are stored as newline-delimited JSON
-      const lines = content.split("\n");
-      lines.forEach((line, index) => {
-        if (!line.trim()) return;
-        const msg = JSON.parse(line) as HermesMessage;
-        if (msg.status === "PENDING") {
-          pendingMessages.push(msg);
+export async function orchestrateCommand() {
+    const frameworkDir = getFrameworkDir();
+    const messagesDir = path.join(process.cwd(), frameworkDir, "messages");
+
+    if (!fs.existsSync(messagesDir)) {
+        console.log("ℹ️ Henüz işlenecek bir mesaj yok (.messages dizini bulunamadı).");
+        return;
+    }
+
+    const messageFiles = fs.readdirSync(messagesDir).filter((f) => f.endsWith(".json"));
+    const pendingMessages: HermesMessage[] = [];
+
+    for (const file of messageFiles) {
+        const filePath = path.join(messagesDir, file);
+        try {
+            const content = fs.readFileSync(filePath, "utf8").trim();
+            if (!content) continue;
+            // Messages are stored as newline-delimited JSON
+            const lines = content.split("\n");
+            lines.forEach((line) => {
+                if (!line.trim()) return;
+                const msg = JSON.parse(line) as HermesMessage;
+                if (msg.status === "PENDING") {
+                    pendingMessages.push(msg);
+                }
+            });
+        } catch {
+            console.error(`❌ ${file} mesajı okunurken hata oluştu.`);
         }
-      });
-    } catch (e) {
-      // ignore malformed lines
     }
-  }
-
-  if (pendingMessages.length === 0) {
-    console.log(`\n🟢 Kuyruk Temiz: İşlenecek aktif Hermes mesajı bulunamadı.`);
-    console.log(`💡 İpucu: Bir uzman ajanı tetiklemek için send_agent_message aracını kullanın.`);
-    return;
-  }
-
-  console.log(`\n📥 Kuyrukta ${pendingMessages.length} adet bekleyen Hermes mesajı tespit edildi:\n`);
-
-  // Process the first pending message
-  const activeMessage = pendingMessages[0];
-  const toAgent = activeMessage.to;
-  const fromAgent = activeMessage.from;
-
-  console.log(`✉️  [GÖNDEREN]   : ${fromAgent}`);
-  console.log(`📥 [ALICI]      : ${toAgent}`);
-  console.log(`🆔 [TRACE ID]   : ${activeMessage.traceId}`);
-  console.log(`🏷️  [KATEGORİ]   : ${activeMessage.category}`);
-  console.log(`💬 [MESAJ]      : "${activeMessage.content}"`);
-  console.log(`----------------------------------------------------------------`);
-
-  // 1. Transition the target agent state to EXECUTING in STATUS.md
-  console.log(`⏳ Ajan Durum Geçişi: ${toAgent} durumu EXECUTING olarak kilitleniyor...`);
-  transitionAgentState(statusPath, toAgent, "EXECUTING", activeMessage.content);
-
-  console.log(`\n🤖 Görev Devredildi!`);
-  console.log(`👉 Lütfen ${toAgent} agent talimatlarını (${frameworkDir}/agents/${toAgent.replace("@", "")}.md) okuyun ve görevi yerine getirin.`);
-  console.log(`💡 Görev tamamlandığında, mesajı PROCESSED olarak işaretlemek ve ajanı boşa çıkarmak için:`);
-  console.log(`   npx agent-enderun status komutuyla kontrol edin.`);
-}
 
-function transitionAgentState(statusPath: string, agent: string, state: string, task: string) {
-  if (!fs.existsSync(statusPath)) return;
-  try {
-    let content = fs.readFileSync(statusPath, "utf8");
-    const lines = content.split("\n");
-    const targetName = agent;
-
-    for (let i = 0; i < lines.length; i++) {
-      if (lines[i].includes(`| ${targetName} |`)) {
-        // e.g., | @backend | IDLE | — | — | 9.2/10 | — |
-        const parts = lines[i].split("|");
-        if (parts.length >= 7) {
-          parts[2] = ` ${state} `;
-          parts[3] = ` ${task.slice(0, 20)}... `;
-          lines[i] = parts.join("|");
-          break;
+    if (pendingMessages.length === 0) {
+        console.log("✅ Tüm mesajlar işlenmiş, bekleyen görev yok.");
+        return;
+    }
+
+    console.log(`📡 ${pendingMessages.length} adet bekleyen görev bulundu. İşleniyor...\n`);
+
+    for (const msg of pendingMessages) {
+        const { to, content, traceId } = msg;
+
+        console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+        console.log(`🔹 HEDEF: ${to}`);
+        console.log(`🔹 TRACE: ${traceId}`);
+        console.log(`🔹 GÖREV: ${content}`);
+
+        // Determine agent folder based on adapter (detection or default)
+        let agentFolder = "agents";
+        if (frameworkDir === ".agent") {
+            agentFolder = "skills";
+        } else if (frameworkDir === ".grok") {
+            agentFolder = "plugins";
         }
-      }
+
+        // 1. Transition the target agent state to EXECUTING in STATUS.md
+        transitionAgentState(to, "EXECUTING", content);
+
+        console.log("\n🤖 Görev Devredildi!");
+        console.log(`👉 Lütfen ${to} agent talimatlarını (${frameworkDir}/${agentFolder}/${to.replace("@", "")}.md) okuyun ve görevi yerine getirin.`);
+        console.log("\n💡 İpucu: İş bittiğinde, mesajı PROCESSED olarak işaretlemek ve ajanı boşa çıkarmak için:");
+        console.log("   npx agent-enderun status komutuyla kontrol edin.");
     }
+}
+
+function transitionAgentState(agent: string, state: string, task: string) {
+    const frameworkDir = getFrameworkDir();
+    const statusPath = path.join(process.cwd(), frameworkDir, "STATUS.md");
+
+    if (!fs.existsSync(statusPath)) return;
 
-    fs.writeFileSync(statusPath, lines.join("\n"));
-    console.log(`✅ STATUS.md üzerinde ${agent} durumu başarıyla '${state}' yapıldı.`);
-  } catch (e) {
-    console.error("❌ STATUS.md güncellenirken hata oluştu:", e);
-  }
+    try {
+        const content = fs.readFileSync(statusPath, "utf8");
+        const lines = content.split("\n");
+        const targetName = agent.startsWith("@") ? agent : `@${agent}`;
+
+        const newLines: string[] = [];
+        let found = false;
+
+        lines.forEach((line) => {
+            if (line.includes(`| ${targetName} |`)) {
+                found = true;
+                // Example: | @backend | IDLE | — | — | 9.2/10 | — |
+                const parts = line.split("|");
+                if (parts.length >= 7) {
+                    parts[2] = ` ${state} `;
+                    parts[3] = ` ${task.slice(0, 20)}... `;
+                    newLines.push(parts.join("|"));
+                } else {
+                    newLines.push(line);
+                }
+            } else {
+                newLines.push(line);
+            }
+        });
+
+        if (found) {
+            fs.writeFileSync(statusPath, newLines.join("\n"));
+            console.log(`✅ STATUS.md üzerinde ${agent} durumu başarıyla '${state}' yapıldı.`);
+        }
+    } catch {
+        console.error("❌ STATUS.md güncellenirken hata oluştu.");
+    }
 }

package/src/cli/index.ts

@@ -18,9 +18,12 @@ async function main() {
     const command = args[0];
 
     switch (command) {
-    case "init":
-        await initCommand(args[1]);
+    case "init": {
+        const dryRun = args.includes("--dry-run");
+        const adapter = args.find(a => !a.startsWith("-") && a !== "init");
+        await initCommand(adapter, dryRun);
         break;
+    }
 
     case "check":
         checkCommand();

package/src/cli/utils/app.ts

@@ -4,7 +4,7 @@ import crypto from "crypto";
 import { ensureDir, writeTextFile, writeJsonFile } from "../utils/fs.js";
 import { updateProjectMemoryCommand } from "../commands/memory.js"; 
 import { slugifyName, titleCase } from "../utils/string.js";
-import { getConfiguredPaths, getFrameworkDir, getMemoryPath } from "./memory.js";
+import { getConfiguredPaths, getMemoryPath } from "./memory.js";
 
 
 const targetDir = process.cwd(); // Assuming targetDir is process.cwd() in the CLI context

package/src/cli/utils/fs.ts

@@ -4,7 +4,7 @@ import path from "path";
 import { remapFrameworkContent } from "../adapters.js"; // Import from the new adapters.js
 import type { AdapterId } from "../adapters.js";
 
-export function updateGitIgnore(targetPath: string, frameworkDir = ".gemini"): void {
+export function updateGitIgnore(targetPath: string, frameworkDir = ".gemini", dryRun = false): void {
     const IGNORE_LINES = [
         "# AI-Enderun",
         `${frameworkDir}/logs/*.json`,
@@ -29,29 +29,41 @@ export function updateGitIgnore(targetPath: string, frameworkDir = ".gemini"): v
     }
 
     if (added) {
-        fs.writeFileSync(targetPath, content);
-        console.warn("✅ .gitignore updated.");
+        if (dryRun) {
+            console.warn(`[DRY RUN] Would update .gitignore at ${targetPath}`);
+        } else {
+            fs.writeFileSync(targetPath, content);
+            console.warn("✅ .gitignore updated.");
+        }
     }
 }
 
-export function ensureDir(dirPath: string): void {
+export function ensureDir(dirPath: string, dryRun = false): void {
     if (!fs.existsSync(dirPath)) {
-        fs.mkdirSync(dirPath, { recursive: true });
+        if (dryRun) {
+            console.warn(`[DRY RUN] Would create directory: ${dirPath}`);
+        } else {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
     }
 }
 
-export function writeTextFile(filePath: string, content: string): void {
+export function writeTextFile(filePath: string, content: string, dryRun = false): void {
+    if (dryRun) {
+        console.warn(`[DRY RUN] Would write file: ${filePath}`);
+        return;
+    }
     ensureDir(path.dirname(filePath));
     // Use template literal for content handling to avoid issues with raw newlines
     fs.writeFileSync(filePath, content.endsWith("\n") ? content : `${content}\n`);
 }
 
-export function writeJsonFile(filePath: string, value: unknown): void {
-    writeTextFile(filePath, JSON.stringify(value, null, 2));
+export function writeJsonFile(filePath: string, value: unknown, dryRun = false): void {
+    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
 }
 
 interface SanitizeJsonFunction {
-  (obj: any, targetScope?: string): any;
+  (obj: unknown, targetScope?: string): unknown;
 }
 
 export function copyDir(
@@ -63,11 +75,12 @@ export function copyDir(
     targetScope = "",
     sanitizeJson: SanitizeJsonFunction,
     adapterId: AdapterId = "gemini",
+    dryRun = false,
 ): void {
     const DEFAULT_SKIP = new Set(["node_modules", ".git", ".DS_Store", "package-lock.json"]);
     const actualSkip = new Set([...DEFAULT_SKIP, ...skipSet]);
 
-    if (!fs.existsSync(dest)) {
+    if (!fs.existsSync(dest) && !dryRun) {
         fs.mkdirSync(dest, { recursive: true });
     }
 
@@ -75,7 +88,19 @@ export function copyDir(
         if (actualSkip.has(entry.name)) return;
 
         const srcPath = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
+        
+        // Physical folder remapping during copy
+        let effectiveEntryName = entry.name;
+        if (entry.isDirectory()) {
+            if (entry.name === "agents") {
+                if (adapterId === "antigravity") effectiveEntryName = "skills";
+                else if (adapterId === "grok") effectiveEntryName = "plugins";
+            } else if (entry.name === "knowledge") {
+                if (adapterId === "antigravity") effectiveEntryName = "rules";
+            }
+        }
+        
+        const destPath = path.join(dest, effectiveEntryName);
 
         if (entry.isDirectory()) {
             copyDir(
@@ -87,6 +112,7 @@ export function copyDir(
                 targetScope,
                 sanitizeJson,
                 adapterId,
+                dryRun,
             );
         } else {
             if (nonDestructive && fs.existsSync(destPath)) {
@@ -112,9 +138,17 @@ export function copyDir(
                     content = content.replace(/workspace:[^"'\s]*/g, "*");
                 }
 
-                fs.writeFileSync(destPath, content);
+                if (dryRun) {
+                    console.warn(`[DRY RUN] Would process and write: ${destPath}`);
+                } else {
+                    fs.writeFileSync(destPath, content);
+                }
             } else {
-                fs.copyFileSync(srcPath, destPath);
+                if (dryRun) {
+                    console.warn(`[DRY RUN] Would copy binary file: ${destPath}`);
+                } else {
+                    fs.copyFileSync(srcPath, destPath);
+                }
             }
         }
     });

package/src/cli/utils/memory.ts

@@ -11,7 +11,9 @@ export function getFrameworkDir(): string {
         const dirPath = path.join(targetDir, dir);
         if (!fs.existsSync(dirPath)) continue;
         const hasMemory = fs.existsSync(path.join(dirPath, "PROJECT_MEMORY.md"));
-        const hasAgents = fs.existsSync(path.join(dirPath, "agents"));
+        const hasAgents = fs.existsSync(path.join(dirPath, "agents")) || 
+                           fs.existsSync(path.join(dirPath, "skills")) ||
+                           fs.existsSync(path.join(dirPath, "plugins"));
         if (hasMemory || hasAgents) {
             return dir;
         }
@@ -74,7 +76,7 @@ export function releaseMemoryLock(lockPath: string): void {
 /**
  * Create initial PROJECT_MEMORY.md if missing.
  */
-export function initializeMemory(memoryPath: string, targetBase: string): void {
+export function initializeMemory(memoryPath: string, targetBase: string, dryRun = false): void {
     if (fs.existsSync(memoryPath)) return;
 
     const traceId = generateULID();
@@ -136,6 +138,11 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 `;
 
     const finalTemplate = template.replace(/\{\{FRAMEWORK_DIR\}\}/g, targetBase);
-    fs.writeFileSync(memoryPath, finalTemplate);
-    console.warn(`✅ PROJECT_MEMORY.md initialized in ${targetBase}`);
+
+    if (dryRun) {
+        console.warn(`[DRY RUN] Would initialize PROJECT_MEMORY.md at ${memoryPath}`);
+    } else {
+        fs.writeFileSync(memoryPath, finalTemplate);
+        console.warn(`✅ PROJECT_MEMORY.md initialized in ${targetBase}`);
+    }
 }

package/src/cli/utils/pkg.ts

@@ -136,11 +136,12 @@ export function mergePackageJson(targetPath: string, sourcePath: string): void {
   console.warn("✅ package.json updated with Enderun scripts and dependencies.");
 }
 
-export function sanitizeJson(obj: Record<string, unknown>, targetScope = ""): Record<string, unknown> {
+export function sanitizeJson(obj: unknown, targetScope = ""): unknown {
     if (typeof obj !== "object" || obj === null) return obj;
-    if (Array.isArray(obj)) return obj.map(item => sanitizeJson(item as Record<string, unknown>, targetScope)) as unknown as Record<string, unknown>;
+    if (Array.isArray(obj)) return obj.map(item => sanitizeJson(item, targetScope));
     const cleaned: Record<string, unknown> = {};
-    for (const [key, value] of Object.entries(obj)) {
+    const record = obj as Record<string, unknown>;
+    for (const [key, value] of Object.entries(record)) {
         let finalKey = key;
         let finalValue = value;
 
@@ -185,7 +186,7 @@ export function sanitizeJson(obj: Record<string, unknown>, targetScope = ""): Re
             finalValue = "*";
         }
 
-        cleaned[finalKey] = (typeof finalValue === "object" && finalValue !== null) ? sanitizeJson(finalValue as Record<string, unknown>, targetScope) : finalValue;
+        cleaned[finalKey] = (typeof finalValue === "object" && finalValue !== null) ? sanitizeJson(finalValue, targetScope) : finalValue;
     }
     return cleaned;
 }

package/docs/architecture/README.md

@@ -1,9 +0,0 @@
-# Architecture Patterns — Agent Enderun
-
-This directory contains the non-negotiable technical standards and architectural patterns for the Agent Enderun framework.
-
-## Directory Structure
-- `standards/`: Technical SOPs, design systems, and compliance mandates.
-
-## Core Mandate
-All agents MUST read and adhere to these documents before initiating any implementation task.

package/docs/user/README.md

@@ -1,35 +0,0 @@
-# Agent Enderun — Governance and Architecture Portal
-
-This portal is the **Central Knowledge Source** for enterprise projects developed under the Agent Enderun framework. The project's architectural decisions, standards, and governance protocols are sealed here.
-
-Unlike ordinary projects, Agent Enderun projects are built on a structure where AI agents operate autonomously but are bound by a rigid, human-authored constitution. This documentation is the **Immutable Guide** for both AI agents (Army) and human developers.
-
-### 📋 Documentation Guide
-
-#### [1. Architecture & Governance](architecture/)
-*   **[Architecture Decision Records (ADRs)](architecture/decisions/)**: Answers to "Why" and "How" questions at critical project milestones.
-*   **[Approval & High-Risk Workflows](architecture/approval-flows.md)**: Explains how tokens are generated, audited, and how high-risk actions (e.g., database deletion, privilege escalation) are sealed.
-*   **[Notification Strategy](architecture/notification-strategy.md)**: Dynamic and corporate notification patterns that do not disrupt the user experience.
-
-#### [2. Frontend Standards](frontend/)
-*   **[Component Patterns](frontend/component-patterns.md)**: Zero-UI-Library policy, guide on how all components are hand-crafted and type-safe using Panda CSS.
-*   **[Form Validations](frontend/forms.md)**: Zero-error form management systems managed with Zod and React hooks.
-*   **[Toaster Configuration](frontend/notifications.md)**: Integration of tools like Sonner with the corporate theme.
-
-#### [3. Backend Standards](backend/)
-*   **[Error Handling](backend/error-handling.md)**: Professional error management hierarchy that does not leak to the front-end and is traceable in logs.
-*   **[Audit Logging](backend/audit-logging.md)**: Contracts for how every operation is permanently processed into the database with a Trace ID.
-
-## 🛰️ Phase-Based Development Life Cycle
-All projects must pass the following 5 phases sequentially and completely:
-
-1.  **PHASE_0 (Discovery):** Tech-stack (`tech-stack.md`) sealed, risk analysis performed.
-2.  **PHASE_1 (Architecture & Contract):** First, types and API contracts are written. Contracts must be approved before a single line of application code is written.
-3.  **PHASE_2 (Core Development):** Backend and Frontend are built in parallel. Branded Types usage is mandatory.
-4.  **PHASE_3 (Integration & Test):** @quality agent takes over. 80% Test Coverage threshold must be met before proceeding to the next phase.
-5.  **PHASE_4 (Optimization & Deployment):** Security scans and performance tests are completed.
-
-> **Agent Directive:** The documents under this folder define the operational boundaries of the agents. An agent cannot deviate from a rule defined here. If a rule needs to be updated, this can only be done with @manager approval and ADR registration.
-
-**Version:** v0.9.0  
-**Status:** Active Governance