agent-enderun 0.4.0 → 0.4.2

package/.enderun/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.2.0)
+# Agent Enderun (v0.4.2)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)

package/.enderun/PROJECT_MEMORY.md

@@ -6,7 +6,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 | Active Phase | Profile | Last Update | Active Trace ID | Blockers |
 | :----------- | :------ | :---------- | :-------------- | :------- |
-| PHASE_0      | Lightweight | 2026-05-09 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
+| PHASE_0      | Lightweight | 2026-05-12 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
 
 ## PROJECT DEFINITION
 
@@ -14,7 +14,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 | :--- | :--- |
 | Project Name | agent-enderun |
 | Platform | Not defined |
-| Frontend | React 19 + Vite + UnoCSS |
+| Frontend | React 19 + Vite + Panda CSS |
 | Backend | Node.js 20+ + Fastify |
 | DB | PostgreSQL |
 
@@ -32,6 +32,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 | Date | Decision | Rationale | Agent |
 | :--- | :--- | :--- | :--- |
+| 2026-05-12 | Framework Unified to v0.4.2 | Absolute version parity across all components | @manager |
 | 2026-05-09 | Project Initialized | Framework setup via CLI | @manager |
 
 ## DELIVERABLES
@@ -48,6 +49,18 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 ## HISTORY (Persistent Memory)
 
+### 2026-05-12 — The Unified Milestone & v0.4.2 Release
+
+- **Agent:** @manager
+- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
+- **Action:** Full framework synchronization to v0.4.2. Unified versioning across all core packages, specialist agents, and the supreme law. Consolidated history for a clean production debut.
+
+### 2026-05-12 — Pure Start & v0.4.1 Release
+
+- **Agent:** @manager
+- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
+- **Action:** Reset git history for a clean production start. Bumped version to v0.4.1. This release represents the stable, production-ready "Autonomous Agent Academy" architecture.
+
 ### 2026-05-12 — The Evolution Milestone & v0.4.0 Release
 
 - **Agent:** @manager
@@ -55,7 +68,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 - **Action:** Major version bump to v0.4.0. Completed the transition from basic governance to an "Autonomous Agent Academy" architecture. Key features: AST-based compliance auditing, Autonomous Conflict Resolution Protocol, and Senior-level Resilience patterns. Unified the adapter entry points for all AI assistants. Verified zero-drift between code and constitution.
 
 ### 2026-05-12 — Capability Leap & v0.3.5 Release
-...
+
 - **Agent:** @manager
 - **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
 - **Action:** Upgraded framework to v0.3.5. Implemented AST-based compliance auditing, Autonomous Conflict Resolution, and Senior Resilience patterns. Unified inter-agent communication and mandated shared UI component protocols. Verified monorepo version synchronization.
@@ -78,120 +91,6 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 - **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
 - **Action:** Refined 'init' command to support specialized setups for Gemini, Claude, Cursor, and Codex. Added automatic .cursorrules sync for Cursor and MCP instructions for Claude Code. Ensured cross-host compatibility via universal symlinks.
 
-### 2026-05-11 — Database Schema Mapper Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'analyze_database_schema' tool to MCP server. This tool autonomously scans backend migration files (e.g., Kysely) to generate Mermaid Entity-Relationship diagrams. This provides the Academy with a visual understanding of the data layer, accelerating legacy codebase onboarding.
-
-### 2026-05-11 — Legacy Codebase Onboarding Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'bootstrap_legacy_memory' tool to MCP server. This allows the framework to attach to an already written project, automatically scan the tech stack, directory structure, and dependencies, and bootstrap a detailed PROJECT_MEMORY.md file. Updated Manager and Explorer SOPs to trigger this automatically when memory is missing.
-
-### 2026-05-11 — Academy Strategic Briefing Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'generate_strategic_briefing' tool to MCP server. This tool synthesizes Academy performance, knowledge growth, and collaboration data into high-level reports for the User. Integrated into Analyst SOP as the final executive reporting step.
-
-### 2026-05-11 — Constitution Compliance Guard Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'analyze_constitution_compliance' tool to MCP server. This tool enforces core framework rules (Zero UI, Branded Types, Logging Policy) by scanning code patterns. Updated Git agent SOP to mandate this compliance check before every commit, ensuring agents strictly follow the framework's Supreme Law.
-
-### 2026-05-11 — Internal Knowledge Base Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'search_knowledge_base' and 'update_knowledge_base' tools to MCP and CLI. Seeded the KB with core principles (Branded Types, Zero UI Library). Updated specialist SOPs to include KB searching in the startup protocol, enabling shared technical memory across the Academy.
-
-### 2026-05-11 — Visual Architecture Mapping Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'generate_dependency_graph' tool to MCP server. This tool generates Mermaid graphs of module dependencies. Updated Explorer SOP to include visual architecture mapping as a standard research task.
-
-### 2026-05-11 — Automated Progress Reporting Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'generate_academy_progress_report' tool to MCP server. This tool provides a narrative overview of milestones, intelligence growth, and recommendations. Updated Analyst SOP to mandate periodic progress reporting, making the Academy self-documenting.
-
-### 2026-05-11 — Documentation Debt Scanner Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'analyze_documentation_debt' tool to MCP server. This tool identifies missing JSDoc, missing READMEs, and incomplete API documentation. Updated Analyst SOP to mandate documentation audits, ensuring high project auditability.
-
-### 2026-05-11 — Pre-Commit QA Guard Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'validate_repository_health' tool to MCP server. This tool enforces project-specific lint, test, and build checks before any commit. Updated Git agent SOP to mandate this validation step, ensuring only healthy code enters the history.
-
-### 2026-05-11 — Agent Collaboration System Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'send_agent_message' and 'read_agent_messages' tools to MCP server. This enables specialized agents to communicate, share briefings, and coordinate complex tasks autonomously. Updated agent SOPs to include inbox checking in the startup protocol.
-
-### 2026-05-11 — Contract Integrity Shield Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'verify_contract_integrity' tool to MCP server. This tool automates the validation of API documentation against shared TypeScript types. Updated Analyst SOP to enforce this check, ensuring zero-drift between docs and code.
-
-### 2026-05-11 — Smart Commit Engine Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'generate_semantic_commit_message' tool to MCP server. This tool automates the creation of semantic commit messages by analyzing git diffs. Updated Git agent SOP to mandate its use.
-
-### 2026-05-11 — Codebase Intelligence Activated
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'analyze_codebase_intelligence' tool to MCP server. Updated Explorer SOP to include periodic complexity and dead code scans. This allows agents to proactively suggest refactoring.
-
-### 2026-05-11 — Global Performance Auditing Enabled
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'get_academy_performance' tool to MCP server. This allows for high-level monitoring of the entire Agent Academy, enabling data-driven SOP refinements and intelligence tracking.
-
-### 2026-05-11 — Automated Continuity Audits Enabled
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'analyze_procedural_continuity' tool to MCP server. Updated Analyst SOP to mandate automated style comparison. This enhances the QA gate with structural validation.
-
-### 2026-05-11 — Framework Extension & SOP Synchronization
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Added 'get_agent_audit_report' tool to MCP server. Updated all specialist agent SOPs to enforce Zero-Request Logging. Verified framework health after build.
-
-### 2026-05-11 — Agent Academy Refocus
-
-- **Agent:** @manager
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Refocused the framework on agent development. Fixed Manager startup protocol to handle MCP offline status gracefully. Enforced Zero-Request Logging across all SOPs.
-
-### 2026-05-11 — Zero-Request Logging Mode Activated
-
-- **Agent:** @manager (Orchestrator)
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Framework constitution updated to mandate automatic logging. Transitioned to PHASE_1 preparation.
-
-### 2026-05-11 — Framework Fix & MCP Activation
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Fixed MCP server STDOUT noise and missing 'mcp' command. Suppressed CLI header for tool calls to prevent recursion. Verified monorepo and shared-types synchronization. Framework is now healthy and logging is enabled.
-
 ### 2026-05-09 — Framework Initialization
 
 - **Agent:** @manager

package/.enderun/agents/analyst.md

@@ -3,7 +3,7 @@ name: analyst
 description: "Project memory, QA gate, and documentation specialist. Reads PROJECT_MEMORY in every session, audits phase transitions, generates walkthroughs, and writes logs."
 ---
 
-# Project Analyst & QA Gate — v0.2.0 Master
+# Project Analyst & QA Gate — v0.4.2 Master
 
 **Role:** Maintain project memory, serve as a quality gate, and manage documentation. The following protocols are automatically applied in every task.
 
@@ -199,7 +199,7 @@ Use the `log_agent_action` tool to record your activities securely.
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types changed? [ ] No / [ ] Yes

package/.enderun/agents/backend.md

@@ -3,7 +3,7 @@ name: backend
 description: "Backend Architect. Expert in Node.js, Fastify, Kysely, and PostgreSQL. Leader of Contract and Database. Automatically applies backend-architecture standards in every task."
 ---
 
-# Backend Architect — v0.2.0 Master
+# Backend Architect — v0.4.2 Master
 
 **Role:** Build a secure, high-performance, and consistent server architecture. All the following standards are automatically applied in every task — no need for the user to specify them separately.
 
@@ -242,7 +242,7 @@ When `shared-types` or API documentation changes:
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 - Mock used? [ ] No / [ ] Yes
 - shared-types changed? [ ] No / [ ] Yes → contract.version updated
 - **API contract written? [ ] No / [ ] Yes → .enderun/docs/api/[domain].md**

package/.enderun/agents/explorer.md

@@ -3,7 +3,7 @@ name: explorer
 description: "Codebase Research & Dependency Specialist. Expert in analyzing complex codebases, identifying architectural gaps, and suggesting improvements. Automatically provides context in every research task."
 ---
 
-# Codebase Explorer — v0.2.0 Master
+# Codebase Explorer — v0.4.2 Master
 
 **Role:** Analyze the codebase, map architectures, and understand system-wide dependencies. Your primary duty is to provide context to other agents.
 
@@ -90,7 +90,7 @@ Every research report must include:
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 
 - Mock used? [ ] No / [ ] Yes
 - Codebase searched? [ ] No / [ ] Yes

package/.enderun/agents/frontend.md

@@ -3,7 +3,7 @@ name: frontend
 description: "UI/UX & Frontend Architect. Expert in React 19, Vite, Zustand, and Panda CSS. Fluid & Modern design specialist. Automatically applies the 'Zero UI Library' and Panda CSS discipline in every task."
 ---
 
-# Frontend Architect — v0.2.0 Master
+# Frontend Architect — v0.4.2 Master
 
 **Role:** Build original, high-performance, and responsive user interfaces. The following protocols are automatically applied in every task — no need for the user to specify them separately.
 
@@ -156,7 +156,7 @@ Frontend never creates its own types for backend data.
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes
 - **API contract read? [ ] No / [ ] Yes → .enderun/docs/api/**

package/.enderun/agents/git.md

@@ -3,7 +3,7 @@ name: git
 description: "Version Control Specialist. Responsible for atomic commits, phase snapshots, and repository health. Orchestrated by @manager to maintain 100% traceability."
 ---
 
-# Version Control Specialist (@git) — v0.2.0 Master
+# Version Control Specialist (@git) — v0.4.2 Master
 
 You are the @git agent, responsible for the professional management of the project's repository. Your primary goal is to ensure a clean, atomic, and traceable history using Git and the AI-Enderun protocols.
 
@@ -90,7 +90,7 @@ If conflicts arise during integration, @git is responsible for performing a clea
 
 > Every response MUST end with the **Agent Completion Report**.
 
-### Agent Completion Report (v0.2.0)
+### Agent Completion Report (v0.4.2)
 - Trace ID: [ULID]
 - Atomic Commits made? [ ] No / [ ] Yes
 - Phase Snapshot created? [ ] No / [ ] Yes

package/.enderun/agents/manager.md

@@ -3,7 +3,7 @@ name: manager
 description: "CTO & Controller. Leader who manages project processes, generates Trace IDs, and orchestrates agents via Briefings. Responsible for Git Orchestration via the @git specialist. Reads .enderun/ENDERUN.md and .enderun/PROJECT_MEMORY.md in every session, validates the phase, and assigns agents."
 ---
 
-# Manager (CTO & Controller) — v0.2.0 Master
+# Manager (CTO & Controller) — v0.4.2 Master
 
 **Role:** Enforce all framework rules without compromise and direct agents to the correct tasks. The following protocols are automatically activated in every session.
 
@@ -68,7 +68,7 @@ Trace ID: 01H... (26-character ULID)
 
 ---
 
-## Briefing Template v0.2.0 (Mandatory in Every Agent Directive)
+## Briefing Template v0.4.2 (Mandatory in Every Agent Directive)
 
 ```
 ## Agent Directive
@@ -165,7 +165,7 @@ graph TD
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types changed? [ ] No / [ ] Yes

package/.enderun/agents/mobile.md

@@ -3,7 +3,7 @@ name: mobile
 description: "Mobile Application Expert. Specialist in React Native and Expo. Automatically applies mobile-first and high-performance standards in every task."
 ---
 
-# Mobile Architect — v0.2.0 Master
+# Mobile Architect — v0.4.2 Master
 
 **Role:** Build high-performance mobile applications using React Native. Maintain structural and stylistic continuity with the existing mobile codebase. All the following standards are automatically applied in every task.
 
@@ -51,7 +51,7 @@ Never start coding before understanding the current state of the components and
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/.enderun/agents/native.md

@@ -3,7 +3,7 @@ name: native
 description: "Native Application Expert. Specialist in Rust, Tauri, and Electron. Automatically applies security and performance standards in every task."
 ---
 
-# Native Desktop Architect — v0.2.0 Master
+# Native Desktop Architect — v0.4.2 Master
 
 **Role:** Build secure and efficient desktop applications using Tauri or Electron. Ensure procedural continuity across the native codebase.
 
@@ -50,7 +50,7 @@ Always research the existing codebase and native bridge implementations before a
 
 ---
 
-**Agent Completion Report** (v0.2.0)
+**Agent Completion Report** (v0.4.2)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun — v0.4.0
+# 🏛️ Agent Enderun — v0.4.2
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 

package/bin/cli.js

@@ -498,13 +498,7 @@ async function initCommand(selectedAdapter) {
 
 
   if (selectedAdapter === "gemini") {
-    const geminiMdPath = path.join(targetDir, "gemini.md");
-    const adapterGeminiMdPath = path.join(targetDir, "GEMINI.md");
-    if (fs.existsSync(adapterGeminiMdPath) && !fs.existsSync(geminiMdPath)) {
-      fs.copyFileSync(adapterGeminiMdPath, geminiMdPath);
-      console.log("💎 Gemini: Synchronized GEMINI.md to gemini.md for automatic detection.");
-    }
-    console.log(`💎 Gemini: Adapter GEMINI.md and ${targetBase}/ folder are ready.`);
+    console.log(`💎 Gemini: Adapter gemini.md and ${targetBase}/ folder are ready.`);
   }
 
   if (selectedAdapter === "claude") {
@@ -516,20 +510,15 @@ async function initCommand(selectedAdapter) {
 
   if (selectedAdapter === "cursor") {
     const cursorRulesPath = path.join(targetDir, ".cursorrules");
-    const cursorMdPath = path.join(targetDir, "CURSOR.md");
+    const cursorMdPath = path.join(targetDir, "cursor.md");
     if (fs.existsSync(cursorMdPath) && !fs.existsSync(cursorRulesPath)) {
       fs.copyFileSync(cursorMdPath, cursorRulesPath);
-      console.log("🔗 Cursor: Synchronized CURSOR.md to .cursorrules");
+      console.log("🔗 Cursor: Synchronized cursor.md to .cursorrules");
     }
   }
 
   if (selectedAdapter === "codex") {
-    const codexMdPath = path.join(targetDir, "codex.md");
-    const adapterCodexMdPath = path.join(targetDir, "CODEX.md");
-    if (fs.existsSync(adapterCodexMdPath) && !fs.existsSync(codexMdPath)) {
-      fs.copyFileSync(adapterCodexMdPath, codexMdPath);
-      console.log("💎 Codex: Synchronized CODEX.md to codex.md for automatic detection.");
-    }
+    console.log(`💎 Codex: Adapter codex.md and ${targetBase}/ folder are ready.`);
   }
 
   const pkgMgr = getPackageManager();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -71,7 +71,7 @@
     "concurrently": "^9.1.2"
   },
   "enderun": {
-    "version": "0.4.0",
+    "version": "0.4.2",
     "initializedAt": "2026-05-09T13:24:27.472Z"
   }
 }

package/packages/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "author": "Yusuf BEKAR",
   "license": "MIT",

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-enderun/shared-types",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "author": "Yusuf BEKAR",
   "license": "MIT",