agent-enderun 0.7.2 → 0.7.5

package/bin/validate-agent-army.js

@@ -3,8 +3,8 @@
 import fs from "fs";
 import path from "path";
 
-const AGENTS_DIR = path.resolve("./.antigravitycli/agents");
-const SCHEMA_PATH = path.resolve("./.antigravitycli/agents/agent_army_schema.json");
+const AGENTS_DIR = path.resolve("./.gemini/agents");
+const SCHEMA_PATH = path.resolve("./.gemini/agents/agent_army_schema.json");
 
 console.log("🛡️  STARTING AUTOMATED AGENT ARMY VALIDATION...");
 
@@ -29,7 +29,7 @@ try {
             console.log(`| ${agentDirName.padEnd(9)} | ❌ FAILED  | ----- | ${`Missing keys: ${missing.join(", ")}`.slice(0, 14)} |`);
             totalFailed++;
         } else {
-            console.log(`| ${agent.id.padEnd(9)} | ✅ PASSED  | ${agent.capabilityRating.padEnd(5)} | ${agent.category.padEnd(14).slice(0, 14)} |`);
+            console.log(`| ${agent.name.padEnd(9)} | ✅ PASSED  | ${String(agent.capability).padEnd(5)} | ${agent.role.substring(0,14).padEnd(14)} |`);
         }
     }
 

package/docs/architecture/approval-flows.md

@@ -1,38 +1,3 @@
-# Approval & High-Risk Workflows
+# Enterprise Approval Flows Protocol
 
-This document establishes the security guidelines, contracts, and state machines for **High-Risk Administrative Actions** that require dynamic `@manager` signature payloads.
-
----
-
-## 🔒 High-Risk Actions Matrix
-
-The following operations require an explicit `managerApproval` token injection:
-
-| Action Category | Target Resource | Verification Criteria | Rollback Strategy |
-| :--- | :--- | :--- | :--- |
-| **Identity & Access** | suspends users, role updates | Signed token from `@manager` | demote role to standard User |
-| **Data Purge** | bulk database catalog purge | `@manager` + Human dual signature | Restore from daily pg_dump |
-| **System Settings** | updating cache parameters | Verified `@manager` hash | Reload last active env config |
-
----
-
-## 🛰️ hermesApproval Transaction Payload
-
-Every high-risk action must inject this exact JSON contract in the transaction header/payload:
-
-```typescript
-interface ManagerApproval {
-  approved: boolean;
-  traceId: string;           // active ULID Trace ID
-  approvedBy: "@manager";    // signed coordinator identifier
-  approvedAt: string;        // ISO timestamp
-  reason: string;            // justification for database auditing
-  riskLevel: "Critical" | "High";
-  rollbackPlan: string;      // automated/manual rollback script steps
-}
-```
-
----
-
-> [!WARNING]
-> **Audit Lock:** Any transaction failing to present a verified `ManagerApproval` signature will trigger an automatic transaction abort and generate a high-priority security alert.
+This document defines the protocols for cross-agent approval flows in enterprise development.

package/docs/backend/error-handling.md

@@ -1,52 +1,3 @@
-# Backend Error Handling & DomainError Hierarchy
+# Professional Error Handling Pattern
 
-This document defines the error handling architecture, status codes, and standard API responses for all Fastify backend microservices.
-
----
-
-## 🔒 DomainError Class Structure
-
-Never throw raw javascript errors. Always extend the abstract `DomainError` class to ensure all failures carry typed status codes and machine-readable error codes:
-
-```typescript
-export abstract class DomainError extends Error {
-  public readonly statusCode: number;
-  public readonly code: string;
-
-  constructor(message: string, statusCode: number, code: string) {
-    super(message);
-    this.name = this.constructor.name;
-    this.statusCode = statusCode;
-    this.code = code;
-    Error.captureStackTrace(this, this.constructor);
-  }
-}
-```
-
----
-
-## 📝 Error Map Example
-
-Map domain errors securely inside Fastify error handlers:
-
-```typescript
-fastify.setErrorHandler((error, request, reply) => {
-  if (error instanceof DomainError) {
-    reply.status(error.statusCode).send({
-      success: false,
-      code: error.code,
-      message: error.message,
-      traceId: request.headers["x-trace-id"]
-    });
-    return;
-  }
-  
-  // Log unexpected internal errors securely
-  fastify.log.error(error);
-  reply.status(500).send({
-    success: false,
-    code: "INTERNAL_ERROR",
-    message: "An unexpected error occurred."
-  });
-});
-```
+This document defines the standardized error handling patterns for backend services.

package/docs/frontend/component-patterns.md

@@ -1,48 +1,3 @@
-# Frontend Component Patterns & Panda CSS Standards
+# Atomic Component Standards
 
-Guidelines for crafting custom, high-performance, and highly accessible React components styled exclusively with Panda CSS.
-
----
-
-## 🎨 Zero UI Library Policy
-
-In our framework, using ready-made external UI libraries (such as Radix UI, Shadcn, or Tailwind CSS) is **strictly forbidden**. This prevents bundle bloat, ensures design consistency, and protects codebase hygiene.
-
-All components must be:
-- Written as custom vanilla HTML elements.
-- Styled with type-safe Panda CSS design tokens.
-- Bound to state using lightweight React hooks.
-
----
-
-## 💻 Panda CSS Styling Example
-
-Create fütüristik glassmorphic containers using type-safe tokens:
-
-```tsx
-import { css } from "../../styled-system/css";
-
-export const Card = ({ children }) => {
-  return (
-    <div className={css({
-      padding: "6",
-      borderRadius: "xl",
-      background: "rgba(255, 255, 255, 0.05)",
-      backdropFilter: "blur(12px)",
-      border: "1px solid rgba(255, 255, 255, 0.1)",
-      transition: "all 0.3s ease",
-      _hover: {
-        background: "rgba(255, 255, 255, 0.08)",
-        transform: "translateY(-4px)"
-      }
-    })}>
-      {children}
-    </div>
-  );
-};
-```
-
----
-
-> [!IMPORTANT]
-> **Unique Test IDs:** Every interactive component (buttons, inputs, select triggers) must include a unique `data-testid` attribute to facilitate automated QA auditing.
+This document defines the atomic design principles and component standards for the frontend.

package/docs/getting-started.md

@@ -62,25 +62,17 @@ This command:
 - Installs all core governance files (`ENDERUN.md`, `PROJECT_MEMORY.md`, agents, knowledge, etc.)
 - Adds the default framework configuration files
 
-#### 💡 Optional: Installing with a Specific Adapter
-If you want to configure the framework for a specific AI assistant or editor environment (e.g. Antigravity, Claude, Cursor, Codex, Gemini), you can specify it as an option:
+#### 💡 Gemini Adapter (Only Supported Path)
 
 ```bash
-npx agent-enderun init antigravity
-# or
-npx agent-enderun init claude
-# or
-npx agent-enderun init cursor
-# or
-npx agent-enderun init codex
-# or
+npx agent-enderun init
+# or explicitly
 npx agent-enderun init gemini
 ```
 
-- If you run `init antigravity`, it will create `.antigravitycli/` instead of `.enderun/` and place `antigravity.md` at the project root.
-- If you run `init claude`, it will create `.claude/` and automatically configure the Claude Desktop MCP settings.
-- If you run `init cursor`, it will create `.cursor/` and copy the cursor rules configuration.
-- If you run `init gemini`, it will create `.gemini/` and place `gemini.md` at the project root.
+This creates the `.gemini/` runtime folder + `gemini.md` shim at the root for Gemini CLI users.
+
+Other legacy adapters (`claude`, `cursor`, `codex`) may still work for editor-specific workflows.
 
 ---
 
@@ -144,7 +136,7 @@ Write your project's goals, business requirements, and primary features here.
 
 ### 4.3 `.enderun/PROJECT_MEMORY.md`
 
-Automatically created during initial setup. Review its content. *(Note: If you initialized with a custom adapter, this file will be located inside your adapter's folder, e.g., `.antigravitycli/PROJECT_MEMORY.md`)*.
+Automatically created during initial setup inside `.gemini/PROJECT_MEMORY.md`. The Gemini adapter uses the `.gemini/` runtime folder.
 
 ---
 

package/docs/roadmap.md

@@ -16,8 +16,8 @@ This document outlines the development roadmap for the Agent Enderun framework *
 - **Version:** v0.6.6 (ready for npm release)
 - **System Health:** 🟢 GREEN
 - **Key Accomplishments:**
-  - Full support for the Antigravity adapter (primary recommended adapter)
-  - Gemini adapter completely removed
+  - Only Gemini adapter supported (installs to .gemini/)
+  - Antigravity adapter and all related code fully removed
   - Lint technical debt resolved (reduced from 43 to 0 issues)
   - Published `docs/getting-started.md` guide
   - Updated memory structures and workspace hygiene

package/framework-mcp/dist/schemas.js

@@ -6,8 +6,8 @@ export const SEARCH_CODEBASE_ARGS_SCHEMA = z.object({
     query: z.string().min(1).max(300),
     extension: z
         .string()
-        .regex(/^[a-z0-9]+$/i)
-        .default("ts"),
+        .default("ts")
+        .refine((s) => /^[a-z0-9]+$/i.test(s), { message: "extension must be alphanumeric" }),
 });
 export const UPDATE_MEMORY_ARGS_SCHEMA = z.object({
     section: z.enum(["CURRENT STATUS", "HISTORY", "ACTIVE TASKS"]),
@@ -23,7 +23,7 @@ export const LOG_AGENT_ACTION_ARGS_SCHEMA = z.object({
     files: z.array(z.string()).default([]),
     status: z.enum(["SUCCESS", "FAILURE"]),
     summary: z.string().min(1),
-    details: z.record(z.any()).default({}),
+    details: z.record(z.string(), z.any()).default({}),
 });
 export const SEND_AGENT_MESSAGE_ARGS_SCHEMA = z.object({
     from: z.string().min(1),

package/framework-mcp/dist/tools/framework.js

@@ -13,11 +13,6 @@ export const frameworkTools = [
         description: "Scans the project structure against the defined standards in ENDERUN.md and identifies missing files, folders, or documentation.",
         inputSchema: { type: "object", properties: {} },
     },
-    {
-        name: "codebase_status",
-        description: "Compatibility alias for get_framework_status.",
-        inputSchema: { type: "object", properties: {} },
-    },
     {
         name: "get_memory_insights",
         description: "Analyze PROJECT_MEMORY.md and BRAIN_DASHBOARD.md to provide insights on what was done, what is being done, and the history.",
@@ -100,8 +95,8 @@ export const frameworkHandlers = {
         const missing = [];
         const frameworkDir = getFrameworkDir(projectRoot);
         const checkPaths = [
-            { path: "apps/backend/src/types", type: "folder" },
-            { path: "apps/web/src/types", type: "folder" },
+            { path: "apps/backend/src/types", type: "folder", optional: true },
+            { path: "apps/web/src/types", type: "folder", optional: true },
             { path: "framework-mcp/src", type: "folder" },
             { path: ".env", type: "file", optional: true },
             { path: ".env.example", type: "file" },
@@ -109,9 +104,9 @@ export const frameworkHandlers = {
             { path: path.join(frameworkDir, "BRAIN_DASHBOARD.md"), type: "file" },
             { path: "docs/README.md", type: "file" },
             { path: "docs/getting-started.md", type: "file" },
-            { path: "docs/architecture/approval-flows.md", type: "file" },
-            { path: "docs/backend/error-handling.md", type: "file" },
-            { path: "docs/frontend/component-patterns.md", type: "file" },
+            { path: "docs/architecture/approval-flows.md", type: "file", optional: true },
+            { path: "docs/backend/error-handling.md", type: "file", optional: true },
+            { path: "docs/frontend/component-patterns.md", type: "file", optional: true },
         ];
         for (const item of checkPaths) {
             const fullPath = path.join(projectRoot, item.path);
@@ -135,6 +130,18 @@ export const frameworkHandlers = {
                     missing.push(`[MISSING LOG FILE] ${frameworkDir}/logs/${agentName}.json (Expected for agent ${agentName})`);
                 }
             }
+            // v1.0 Army infrastructure checks
+            const v1Dirs = [
+                path.join(projectRoot, frameworkDir, "memory-graph"),
+                path.join(projectRoot, frameworkDir, "memory-graph", "agent-contexts"),
+                path.join(projectRoot, frameworkDir, "queue"),
+                path.join(projectRoot, frameworkDir, "agents", "schema"),
+            ];
+            for (const d of v1Dirs) {
+                if (!fs.existsSync(d)) {
+                    missing.push(`[MISSING v1.0 DIR] ${path.relative(projectRoot, d)}`);
+                }
+            }
         }
         return { content: [{ type: "text", text: missing.length > 0 ? `Detected Gaps:\n${missing.join("\n")}` : "No structural gaps detected based on core standards." }] };
     },