agent-enderun 0.9.5 → 1.0.0

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