agent-enderun 1.1.3 → 1.1.5

package/dist/framework-mcp/src/tools/messaging/send_message.js

@@ -11,20 +11,43 @@ export async function handleSendAgentMessage(projectRoot, args) {
     const lockPath = path.join(messagesDir, ".lock");
     // Hermes Lock Protocol: Retry 3 times with 500ms delay
     let retries = 3;
-    while (retries > 0 && fs.existsSync(lockPath)) {
-        const stats = fs.statSync(lockPath);
-        if (Date.now() - stats.mtimeMs > 5000) {
-            fs.unlinkSync(lockPath);
+    let acquired = false;
+    while (retries > 0) {
+        try {
+            if (fs.existsSync(lockPath)) {
+                try {
+                    const stats = fs.statSync(lockPath);
+                    if (Date.now() - stats.mtimeMs > 5000) {
+                        fs.unlinkSync(lockPath);
+                    }
+                }
+                catch {
+                    // ignore if concurrently unlinked
+                }
+            }
+            fs.mkdirSync(messagesDir, { recursive: true });
+            fs.writeFileSync(lockPath, `Locked by ${from} at ${new Date().toISOString()}`, { flag: "wx" });
+            acquired = true;
             break;
         }
-        retries--;
-        if (retries > 0) {
-            await new Promise((resolve) => setTimeout(resolve, 500));
+        catch (err) {
+            const error = err;
+            if (error.code === "EEXIST") {
+                retries--;
+                if (retries > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, 500));
+                }
+            }
+            else {
+                return { content: [{ type: "text", text: `❌ Unexpected lock acquisition error: ${error.message || String(err)}` }], isError: true };
+            }
         }
     }
+    if (!acquired) {
+        return { content: [{ type: "text", text: `❌ Could not send message to ${to}: Hermes lock is busy.` }], isError: true };
+    }
     try {
-        fs.mkdirSync(messagesDir, { recursive: true });
-        fs.writeFileSync(lockPath, `Locked by ${from} at ${new Date().toISOString()}`);
+        const defaultPriority = (category === "ALERT" || category === "ACTION") ? "HIGH" : "NORMAL";
         const message = {
             timestamp: new Date().toISOString(),
             from,
@@ -32,14 +55,21 @@ export async function handleSendAgentMessage(projectRoot, args) {
             category,
             traceId,
             content,
+            priority: args.priority || defaultPriority,
             status: "PENDING"
         };
         fs.appendFileSync(messagePath, JSON.stringify(message) + "\n");
         return { content: [{ type: "text", text: `✅ Message sent to ${to} (from: ${from})` }] };
     }
     finally {
-        if (fs.existsSync(lockPath))
-            fs.unlinkSync(lockPath);
+        if (acquired && fs.existsSync(lockPath)) {
+            try {
+                fs.unlinkSync(lockPath);
+            }
+            catch {
+                // ignore
+            }
+        }
     }
 }
 //# sourceMappingURL=send_message.js.map

package/dist/framework-mcp/src/tools/messaging/send_message.js.map

@@ -1 +1 @@
-{"version":3,"file":"send_message.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/messaging/send_message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB,EAAE,IAAc;IAC5E,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAA2E,CAAC;IACvH,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,MAAM,CAAC;IAE7C,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEjD,uDAAuD;IACvD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;YACpC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxB,MAAM;QACV,CAAC;QACD,OAAO,EAAE,CAAC;QACV,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7D,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,aAAa,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE/E,MAAM,OAAO,GAAG;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI;YACJ,EAAE;YACF,QAAQ;YACR,OAAO;YACP,OAAO;YACP,MAAM,EAAE,SAAS;SACpB,CAAC;QAEF,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;IAC5F,CAAC;YAAS,CAAC;QACP,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;AACL,CAAC"}
+{"version":3,"file":"send_message.js","sourceRoot":"","sources":["../../../../../framework-mcp/src/tools/messaging/send_message.ts"],"names":[],"mappings":"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"}

package/dist/framework-mcp/src/tools/types.d.ts

@@ -37,6 +37,7 @@ export interface ToolArgs {
     allowMultiple?: boolean;
     timeout?: number;
     from?: string;
+    priority?: "HIGH" | "NORMAL" | "LOW";
 }
 export interface ToolResult {
     isError?: boolean;

package/{framework-mcp/dist → dist/framework-mcp}/tests/tools/file_system/file_system_tools.test.js

@@ -59,6 +59,19 @@ describe("File System Tools", () => {
             expect(result.content[0].text).toContain("✅ Surgical edit successful");
             expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello there there");
         });
+        it("should log usage to metrics.json upon replace", () => {
+            fs.writeFileSync(TEST_FILE, "hello world", "utf8");
+            const args = {
+                path: TEST_FILE,
+                oldText: "world",
+                newText: "there",
+            };
+            handleReplaceText(TEST_DIR, args);
+            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            expect(fs.existsSync(metricsPath)).toBe(true);
+            const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
+            expect(metrics[0].action).toContain("replace_text");
+        });
     });
     describe("handlePatchFile", () => {
         it("should replace lines in specified range", () => {
@@ -93,6 +106,20 @@ describe("File System Tools", () => {
             };
             expect(() => handlePatchFile(TEST_DIR, args)).toThrowError("Invalid end line");
         });
+        it("should log usage to metrics.json upon patch", () => {
+            fs.writeFileSync(TEST_FILE, "line1\nline2\nline3\nline4", "utf8");
+            const args = {
+                path: TEST_FILE,
+                startLine: 2,
+                endLine: 3,
+                newContent: "patched2\npatched3",
+            };
+            handlePatchFile(TEST_DIR, args);
+            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            expect(fs.existsSync(metricsPath)).toBe(true);
+            const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
+            expect(metrics[0].action).toContain("patch_file");
+        });
     });
     describe("handleReadFile", () => {
         it("should read full file content", () => {
@@ -131,6 +158,18 @@ describe("File System Tools", () => {
             expect(result.content[0].text).toContain("✅ File written");
             expect(fs.readFileSync(TEST_FILE, "utf8")).toBe("hello world");
         });
+        it("should write new file and log usage to metrics.json", () => {
+            const args = {
+                path: TEST_FILE,
+                content: "hello world"
+            };
+            handleWriteFile(TEST_DIR, args);
+            const metricsPath = path.join(TEST_DIR, ".gemini/observability/metrics.json");
+            expect(fs.existsSync(metricsPath)).toBe(true);
+            const metrics = JSON.parse(fs.readFileSync(metricsPath, "utf8"));
+            expect(metrics[0].action).toContain("write_file");
+            expect(metrics[0].estimatedTokens).toBeGreaterThan(0);
+        });
         it("should append update to PROJECT_MEMORY.md if it exists", () => {
             fs.mkdirSync(MEMORY_DIR, { recursive: true });
             fs.writeFileSync(MEMORY_FILE, "## CURRENT STATUS\n", "utf8");
@@ -145,3 +184,4 @@ describe("File System Tools", () => {
         });
     });
 });
+//# sourceMappingURL=file_system_tools.test.js.map

package/dist/framework-mcp/tests/tools/file_system/file_system_tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_system_tools.test.js","sourceRoot":"","sources":["../../../../../framework-mcp/tests/tools/file_system/file_system_tools.test.ts"],"names":[],"mappings":"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"}

package/dist/framework-mcp/tests/tools/messaging/send_message.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/framework-mcp/tests/tools/messaging/send_message.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { handleSendAgentMessage } from "../../../src/tools/messaging/send_message.js";
+const TEST_DIR = path.resolve(__dirname, "../../_temp_messaging_tests");
+const MESSAGES_DIR = path.join(TEST_DIR, ".gemini/messages");
+const LOCK_FILE = path.join(MESSAGES_DIR, ".lock");
+beforeEach(() => {
+    fs.mkdirSync(TEST_DIR, { recursive: true });
+    // Write a dummy package.json to test directory to lock frameworkDir as .gemini
+    const dummyPkg = {
+        name: "test-pkg",
+        enderun: {
+            frameworkDir: ".gemini"
+        }
+    };
+    fs.writeFileSync(path.join(TEST_DIR, "package.json"), JSON.stringify(dummyPkg, null, 2), "utf8");
+});
+afterEach(() => {
+    fs.rmSync(TEST_DIR, { recursive: true, force: true });
+});
+describe("Hermes Lock Protocol & Message sending", () => {
+    it("should successfully send message when lock is not present", async () => {
+        const args = {
+            to: "@backend",
+            from: "@manager",
+            category: "ACTION",
+            content: "Build database models",
+            traceId: "T-123",
+            priority: "HIGH"
+        };
+        const result = await handleSendAgentMessage(TEST_DIR, args);
+        expect(result.content[0].text).toContain("✅ Message sent to @backend");
+        // Verify the message file contains the sent message
+        const messageFilePath = path.join(MESSAGES_DIR, "backend.json");
+        expect(fs.existsSync(messageFilePath)).toBe(true);
+        const content = fs.readFileSync(messageFilePath, "utf8");
+        const msg = JSON.parse(content.trim());
+        expect(msg.from).toBe("@manager");
+        expect(msg.to).toBe("@backend");
+        expect(msg.category).toBe("ACTION");
+        expect(msg.content).toBe("Build database models");
+        expect(msg.traceId).toBe("T-123");
+        expect(msg.priority).toBe("HIGH");
+        expect(msg.status).toBe("PENDING");
+    });
+    it("should retry and fail to send message if lock is kept busy", async () => {
+        // Prepare a busy lock file
+        fs.mkdirSync(MESSAGES_DIR, { recursive: true });
+        fs.writeFileSync(LOCK_FILE, "Locked by @test at " + new Date().toISOString(), "utf8");
+        const args = {
+            to: "@backend",
+            from: "@manager",
+            category: "ACTION",
+            content: "Build database models",
+            traceId: "T-123"
+        };
+        const startTime = Date.now();
+        const result = await handleSendAgentMessage(TEST_DIR, args);
+        const duration = Date.now() - startTime;
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("❌ Could not send message to @backend: Hermes lock is busy.");
+        // Retries takes 3 attempts with 500ms delay -> duration should be at least ~1000ms
+        expect(duration).toBeGreaterThanOrEqual(1000);
+    });
+    it("should bypass and acquire lock if existing lock is stale (older than 5s)", async () => {
+        fs.mkdirSync(MESSAGES_DIR, { recursive: true });
+        // Set lock file mtime to 10 seconds ago
+        fs.writeFileSync(LOCK_FILE, "Locked by @test at " + new Date().toISOString(), "utf8");
+        const tenSecondsAgo = new Date(Date.now() - 10000);
+        fs.utimesSync(LOCK_FILE, tenSecondsAgo, tenSecondsAgo);
+        const args = {
+            to: "@backend",
+            from: "@manager",
+            category: "ACTION",
+            content: "Build database models",
+            traceId: "T-123"
+        };
+        const result = await handleSendAgentMessage(TEST_DIR, args);
+        expect(result.content[0].text).toContain("✅ Message sent to @backend");
+        expect(fs.existsSync(LOCK_FILE)).toBe(false); // Lock should have been unlinked in finally
+    });
+    it("should safely resolve concurrent messages and execute them in sequence", async () => {
+        const send1Promise = handleSendAgentMessage(TEST_DIR, {
+            to: "@backend",
+            from: "@manager",
+            category: "ACTION",
+            content: "Job 1",
+            traceId: "T-123"
+        });
+        // Delay starting the second call slightly to make sure lock is acquired by Job 1 first
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        const send2Promise = handleSendAgentMessage(TEST_DIR, {
+            to: "@backend",
+            from: "@frontend",
+            category: "INFO",
+            content: "Job 2",
+            traceId: "T-123"
+        });
+        const [res1, res2] = await Promise.all([send1Promise, send2Promise]);
+        expect(res1.isError).toBeFalsy();
+        expect(res2.isError).toBeFalsy();
+        expect(res1.content[0].text).toContain("✅ Message sent to @backend");
+        expect(res2.content[0].text).toContain("✅ Message sent to @backend");
+        // Verify both messages exist in order in the message log file
+        const messageFilePath = path.join(MESSAGES_DIR, "backend.json");
+        const lines = fs.readFileSync(messageFilePath, "utf8").trim().split("\n");
+        expect(lines.length).toBe(2);
+        const msg1 = JSON.parse(lines[0]);
+        const msg2 = JSON.parse(lines[1]);
+        expect(msg1.content).toBe("Job 1");
+        expect(msg2.content).toBe("Job 2");
+    });
+});
+//# sourceMappingURL=send_message.test.js.map

package/dist/framework-mcp/tests/tools/messaging/send_message.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send_message.test.js","sourceRoot":"","sources":["../../../../../framework-mcp/tests/tools/messaging/send_message.test.ts"],"names":[],"mappings":"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"}

package/dist/init-adapters/antigravity-cli/.agents/config.json

@@ -1,6 +1,6 @@
 {
   "name": "Enderun Core",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "theme": {
     "palette": "Modern Blue",
     "colors": {

package/dist/init-adapters/antigravity-cli/.agents/knowledge/agents-manifest.md

@@ -0,0 +1,79 @@
+# 🎖️ Agent Enderun — Agent Army Manifest
+
+This document serves as the complete manifest of the 13 specialist agents forming the **Enderun Army**. Each agent is mapped to a specific capability index, toolset, and specialized directive under the Enderun Discipline (Osmanlı Nizami).
+
+---
+
+## 🏛️ Agent Army Overview
+
+| Agent Name | Role | Capability | Primary Tools | Tags |
+| :--- | :--- | :--- | :--- | :--- |
+| **`@manager`** | Orchestration | 10/10 | `orchestrate_loop`, `send_agent_message` | `core`, `orchestration` |
+| **`@architect`** | System Design | 9/10 | `write_file`, `replace_text` | `core`, `design` |
+| **`@backend`** | Backend Logic | 9/10 | `replace_text`, `run_shell_command` | `core`, `logic` |
+| **`@frontend`** | User Interface | 9/10 | `replace_text`, `view_file` | `core`, `ui` |
+| **`@quality`** | Quality Audit | 9/10 | `run_shell_command`, `view_file` | `core`, `audit` |
+| **`@database`** | Data Management | 9/10 | `replace_text`, `run_shell_command` | `core`, `data` |
+| **`@devops`** | Infrastructure | 9/10 | `run_shell_command`, `view_file` | `core`, `infra` |
+| **`@explorer`** | Reconnaissance | 8/10 | `grep_search`, `list_dir`, `glob` | `core`, `recon` |
+| **`@git`** | Version Control | 9/10 | `run_shell_command`, `view_file` | `core`, `logistics` |
+| **`@mobile`** | Mobile Apps | 9/10 | `replace_text`, `view_file` | `core`, `mobile` |
+| **`@native`** | System-Level | 9/10 | `run_shell_command`, `replace_text` | `core`, `native` |
+| **`@security`** | Security Audit | 10/10 | `grep_search`, `run_shell_command` | `core`, `security` |
+| **`@analyst`** | Requirements | 9/10 | `grep_search`, `list_dir` | `core`, `strategy` |
+
+---
+
+## 🤖 Specialist Directives
+
+### 1. `@manager` (Orchestrator)
+- **Directive:** Strategic commander of the army. Coordinates executions, schedules traces, and delegates tasks to specialists.
+- **Mandate:** Enforces Enderun discipline, inherits and passes Trace IDs, and handles final compliance approvals.
+
+### 2. `@architect` (Lead Architect)
+- **Directive:** Outlines initial codebase design, defines schema contracts, and manages the architectural blueprint.
+- **Mandate:** Enforces strict modular boundaries and verifies structural sanity.
+
+### 3. `@backend` (Backend Specialist)
+- **Directive:** Builds REST/GraphQL API systems, develops server components, and manages server business rules.
+- **Mandate:** Ensures robust error handling, schema boundaries, and server logic.
+
+### 4. `@frontend` (Frontend Specialist)
+- **Directive:** Builds user interfaces, manages layouts and states using modern styling (Panda CSS, CSS variables).
+- **Mandate:** Enforces design systems, accessibility, and high performance rendering.
+
+### 5. `@quality` (Quality Specialist)
+- **Directive:** Validates unit coverage, performs static analyses, and ensures code rules compliance.
+- **Mandate:** Runs ESLint rules, checks console logs, and audits project safety.
+
+### 6. `@database` (Database Specialist)
+- **Directive:** Designs relational/NoSQL schemas, writes migrations, and optimizes SQL query metrics.
+- **Mandate:** Guarantees data transaction integrity and index configurations.
+
+### 7. `@devops` (Infrastructure Specialist)
+- **Directive:** Establishes CI/CD pipelines, configures Docker environments, and tracks cloud deployments.
+- **Mandate:** Ensures high availability, automation scripts, and safe release cycles.
+
+### 8. `@explorer` (Intel Explorer)
+- **Directive:** Gathers codebase intelligence, discovers file dependencies, and maps codebase symbols.
+- **Mandate:** Guides planning agents by providing context graphs and code dependencies.
+
+### 9. `@git` (Logistics Master)
+- **Directive:** Handles atomic commit flows, merges code, resolves conflicts, and manages release tags.
+- **Mandate:** Enforces descriptive commit tags mapped to active Trace IDs.
+
+### 10. `@mobile` (Mobile Specialist)
+- **Directive:** Implements mobile interfaces using cross-platform layouts (React Native / Expo).
+- **Mandate:** Optimizes mobile assets, native performance, and state stores.
+
+### 11. `@native` (Native Division)
+- **Directive:** Interfaces with native operating system hooks, constructs desktop platforms, and manages hardware bridges.
+- **Mandate:** Exercises deep security protocols during system interactions.
+
+### 12. `@security` (Security Specialist)
+- **Directive:** Audits repositories for credentials/secrets, evaluates package dependencies, and verifies authentication flows.
+- **Mandate:** Rejects insecure actions, validates cryptographic keys, and enforces access control checks.
+
+### 13. `@analyst` (Business Analyst)
+- **Directive:** Maps requirements to codebase implementations, writes business specification rules, and audits contracts.
+- **Mandate:** Validates feature alignment against system specifications.

package/dist/init-adapters/antigravity-cli/.agents/knowledge/approval-flows.md

@@ -0,0 +1,61 @@
+# Enterprise Approval Flows & Governance Protocol (v0.8.5)
+
+This protocol defines the strict governance model for high-risk operations and cross-agent approval flows within the Agent Enderun framework. It ensures that no critical mutations or sensitive actions are executed by AI specialists without formal orchestration and explicit authorization.
+
+---
+
+## 🔒 1. High-Risk Action Catalog
+
+Specialist agents (@backend, @frontend, @devops, etc.) are strictly prohibited from performing any of the following administrative operations autonomously. If requested, they must halt work, shift to `WAITING` status, and escalate to `@manager` via the **Hermes Protocol**.
+
+| Category | High-Risk Operations | Designated Controller |
+| :--- | :--- | :--- |
+| **Data Management** | Bulk delete/purge, data migration, PII export, schema modifications. | `@manager` |
+| **System Security** | Security credentials modification, CSP rule changes, private keys rotation. | `@security` & `@manager` |
+| **Infrastructure** | Production deployment triggers, container orchestration changes, ENV vars rotation. | `@devops` & `@manager` |
+| **Contract Stability**| Breaking API modifications, major type updates inside `src/types/`. | `@backend` & `@manager` |
+
+---
+
+## 💬 2. Hermes approval Flow (`managerApproval`)
+
+When a specialist agent encounters a high-risk operation, it must execute the following message queue protocol.
+
+### Step 1: Lock the Hermes Inbox
+To prevent race conditions, the agent must check for `.agents/messages/.lock`. If the lock is active, the agent retries (up to 3 times, waiting 500ms between attempts). If no lock exists, it creates `.lock` to claim the channel.
+
+### Step 2: Write Approval Request File
+The requesting agent writes a structured JSON file inside `.agents/queue/pending/` or `.agents/messages/` with the unique `Trace ID` (ULID) and a `managerApproval` request flag:
+
+```json
+{
+  "traceId": "01JM5S8A0F2B4C6D8E0G2H4J6K",
+  "from": "@backend",
+  "to": "@manager",
+  "category": "ALERT",
+  "priority": "HIGH",
+  "action": "RUN_DATABASE_MIGRATION",
+  "payload": {
+    "migrationFile": "20260527_add_tenant_rls_policy.sql",
+    "rationale": "Enables multi-tenant Row Level Security (RLS) on PostgreSQL."
+  },
+  "timestamp": "2026-05-27T20:45:00Z"
+}
+```
+
+### Step 3: Shift Agent State
+The requesting agent updates its state inside `.agents/STATUS.md` to `WAITING` and appends `BLOCKED_BY_APPROVAL` to its action log.
+
+### Step 4: Human-in-the-Loop Signing
+In production workspaces, the `@manager` compiles the war-room report and requests the human architect (CTO) to sign off on the transaction. The human developer signs the transaction by executing:
+```bash
+npx agent-enderun approve 01JM5S8A0F2B4C6D8E0G2H4J6K
+```
+Or by writing a signed token to the message queue.
+
+---
+
+## 🚦 3. Conflict Resolution & Rollback
+
+1.  **Approval Rejection:** If the transaction is rejected, `@manager` issues a `REJECTED` signal. The specialist agent rolls back any staged changes and returns to `IDLE` state.
+2.  **Stale Lock Recovery:** If a Hermes inbox `.lock` remains for more than 1.5 seconds, the active agent assumes a **stale lock** (LLM timeout), deletes the lock, and logs the incident to `@manager`.

package/dist/init-adapters/antigravity-cli/.agents/knowledge/enterprise-architecture.md

@@ -0,0 +1,69 @@
+# 🎖️ Agent Enderun — Enterprise Architecture & Standards
+
+This document establishes the architecture patterns, design guidelines, and code structures of the **Enderun Core Framework** for enterprise deployments.
+
+---
+
+## 🏛️ Project Directory Structure
+
+```text
+agent-enderun/
+├── bin/                       # Executable CLI entrypoints
+├── docs/                      # Technical documentation & design guides
+├── framework-mcp/             # Modular MCP server implementation (workspace)
+│   ├── src/                   # MCP server source files
+│   └── tests/                 # Unit tests for MCP server tools
+├── src/                       # CLI & Core framework logic
+│   ├── cli/                   # Command line interface commands & adapters
+│   │   ├── adapters/          # Target-specific IDE adapters (VS Code, Cursor, etc.)
+│   │   ├── commands/          # Subcommand handlers (init, status, check)
+│   │   └── utils/             # CLI-specific utilities
+│   ├── modules/               # Core framework modules
+│   │   ├── adapters/          # Target environment adapter profiles
+│   │   ├── agents/            # Orchestrator & Specialist Agent definitions
+│   │   └── skills/            # Capability templates for specialist actions
+│   └── shared/                # Core shared business components
+│       ├── config.ts          # Zod environment configuration
+│       ├── container.ts       # Dependency injection container
+│       ├── errors.ts          # Standard typed domain errors
+│       ├── fs.ts              # File system helper wrappers
+│       └── logger.ts          # Enterprise logging subsystem
+```
+
+---
+
+## ⚙️ Core Design Principles
+
+### 1. Unified Domain Errors
+All errors thrown by modules must inherit from `EnderunBaseError` in [src/shared/errors.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/errors.ts).
+This ensures:
+- Unique error codes (`CONFIGURATION_ERROR`, `VALIDATION_ERROR`, etc.)
+- Metadata enrichment via the `details` field
+- Structured JSON serialization in production environments
+
+### 2. Zod-Validated Environments
+Configuration options must never be read directly from raw environment variables (`process.env`). Instead, they are parsed and frozen inside [src/shared/config.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/config.ts) at initialization. If a required value is missing, the application crashes immediately with a clean explanation.
+
+### 3. Service Container (Dependency Injection)
+To write testable and decoupled code, singletons and factories are registered and resolved using the `ServiceContainer` defined in [src/shared/container.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/container.ts).
+```typescript
+import { container } from "./shared/container.js";
+
+// Register
+container.register("Logger", logger);
+
+// Resolve
+const logger = container.resolve<EnterpriseLogger>("Logger");
+```
+
+### 4. Structured Observability
+Use `EnterpriseLogger` in [src/shared/logger.ts](file:///Users/ybekar/Desktop/Projeler/agent-enderun/src/shared/logger.ts) for logging:
+- In **development**, logs are colorized and formatted for human readability.
+- In **production**, logs are structured as JSON for log aggregators (e.g. Datadog, ELK).
+
+---
+
+## 🛡️ Code & Type Guidelines
+- **Strict Typing:** Always keep `"strict": true` in `tsconfig.json`. Explicit return types are required on all exports.
+- **Asynchronous Flow:** Use async/await over raw promise chains. Handle failures with localized try/catch blocks and wrap in domain errors.
+- **Atomic Operations:** Always use transactional or surgical replacements when editing configuration/code files.

package/dist/init-adapters/antigravity-cli/.agents/knowledge/eslint-standards.md

@@ -0,0 +1,10 @@
+# 🎖️ Agent Enderun — ESLint Standards
+
+This document outlines the strict ESLint coding standards for Agent Enderun projects.
+
+## 📏 Core Rules
+- **Indentation:** 4 spaces (strict).
+- **Quotes:** Double quotes (`"`) for strings.
+- **Semicolons:** Always terminate statements with a semicolon (`;`).
+- **No Explicit Any:** Avoid using `any`. Use strongly typed interfaces, generics, or `unknown` with type assertions.
+- **Unused Variables:** Warning on unused variables unless prefixed with an underscore (`_`).

package/dist/init-adapters/antigravity-cli/.agents/memory/DECISIONS.md

@@ -0,0 +1,10 @@
+# 🏛️ Architectural Decisions Log (ADR)
+
+This file contains the fixed architectural choices and constraints for this project.
+
+## Decided Constraints
+- **Framework Integration:** Agent Enderun is the primary governance and orchestration layer.
+- **Language & Runtime:** TypeScript on Node.js.
+- **Package Manager:** npm.
+- **Monorepo Structure:** Monorepo using npm workspaces.
+- **Styling:** Panda CSS.

package/dist/init-adapters/antigravity-cli/.agents/memory/PROJECT_MEMORY.md

@@ -1,7 +1,7 @@
 ## CURRENT STATUS
 
 - Phase: PHASE_0 (Genesis)
-- Trace ID: 01KTBKQYG1EH5C3VAK3FDWBD02
+- Trace ID: 01KTCDPF6NSAC8346HE2A1YQ6Q
 
 ## HISTORY
 ### 2026-06-05 — Initialization

package/dist/init-adapters/antigravity-cli/.agents/observability/audit_log.md

@@ -0,0 +1,5 @@
+# 🕵️ Agent Enderun — Audit Log
+
+This log tracks all asynchronous agent communication and state transitions handled by the Hermes Message Broker.
+
+## Hermes Event Log

package/dist/init-adapters/antigravity-cli/.agents/observability/telemetry.md

@@ -0,0 +1,6 @@
+# 📊 Agent Enderun — Telemetry & Memory Observability
+
+## 🧠 Context & Token Observability
+- **Memory File:** `.agents/memory/PROJECT_MEMORY.md` (SSOT)
+- **Pruning Trigger:** Active history entries are pruned and archived under `.agents/memory-graph/archive/` once the log exceeds 10 records.
+- **Audit Logs:** Agent interactions are saved locally inside `observability/audit_log.md` to keep API usage transparent and track performance bottlenecks.

package/dist/init-adapters/antigravity-cli/.agents/registry/agent_registry.md

@@ -0,0 +1,18 @@
+# 🎖️ Agent Enderun — Army Registry
+
+List of active agents, their roles, capacities, and matching directory patterns.
+
+| Agent Name | Role | Scope / Globs | Action Compliance |
+|---|---|---|---|
+| `@manager` | Orchestrator & Controller | `*` | Rules Verification |
+| `@quality` | Quality & Test Enforcer | `*` | AST Security Scans |
+| `@database` | Database Optimizer | `apps/backend/src/database/**/*` | Schema & Migrations |
+| `@backend` | Core Domain Developer | `apps/backend/**/*` | Branded Types & APIs |
+| `@frontend` | UI/UX Developer | `apps/web/**/*` | Panda CSS, Fluid UI |
+| `@mobile` | Mobile App Specialist | `apps/mobile/**/*` | Expo/React Native |
+| `@native` | Desktop / Native Integrator | `apps/native/**/*` | Electron/Tauri |
+| `@devops` | Deployment & CI/CD | CI/CD YAML & Deployment files | Native Rollbacks |
+| `@explorer` | Codebase Discovery | All source directories | Onboarding & Audit |
+| `@git` | Version Control System | `.git/` & Commit traces | Trace ID commits |
+| `@security` | Security Officer | All source directories | RLS & Secrets Scan |
+| `@analyst` | Contract Validator | Contract and API schema definitions | SHA-256 validation |

package/dist/init-adapters/antigravity-cli/.agents/router/routing_rules.md

@@ -0,0 +1,8 @@
+# 📡 Agent Enderun — Natural Language & Event Router
+
+This configuration governs how user inputs and event messages are routed across the 12 expert agents.
+
+## 🧭 Routing Engine Protocols
+- **User Input Routing:** By default, all un-targeted natural language prompts are routed to the `@manager` agent for analysis and decomposition into a Directed Acyclic Graph (DAG) task list.
+- **Targeted Input Routing:** Prompts beginning with `@<agent_name>` (e.g., `@backend`) bypass the general manager routing and are directly appended to the target agent's Hermes mailbox.
+- **Hermes Event Loops:** Agents publish status changes and handoffs which the message broker routes dynamically according to active dependencies.

package/dist/init-adapters/antigravity-cli/.agents/rules/analyst.md

@@ -0,0 +1,16 @@
+# 🎖️ Agent Enderun — @analyst (Business Analyst)
+
+You are the **Business Analyst** of the Agent Enderun Army.
+
+## 🏛️ Hierarchy of Authority
+1. **Supreme Law:** [`.agents/ENDERUN.md`](`.agents/ENDERUN.md`)
+2. **Global Rules:** [`.agents/knowledge/ARCHITECTURE.md`](`.agents/knowledge/ARCHITECTURE.md`), [`.agents/knowledge/SECURITY.md`](`.agents/knowledge/SECURITY.md`)
+3. **Project Memory:** [`.agents/memory/PROJECT_MEMORY.md`](`.agents/memory/PROJECT_MEMORY.md`)
+
+## 🤖 Specialist Directive (Role: @analyst)
+Audit of truth and contracts within the Army.
+
+## 🛡️ Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.