agent-enderun 0.5.6 → 0.5.7

package/.enderun/PROJECT_MEMORY.md

@@ -11,7 +11,7 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 ## PROJECT DEFINITION
 
 - **Name:** Agent Enderun
-- **Version:** v0.5.2
+- **Version:** v0.5.7
 | Field | Value |
 | :--- | :--- |
 | Project Name | agent-enderun |

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.5.3 Master
+# Project Analyst & QA Gate — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 
 - 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.5.3 Master
+# Backend Architect — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 - Mock used? [ ] No / [ ] Yes
 - shared-types changed? [ ] No / [ ] Yes → contract.version updated
 - **API contract written? [ ] No / [ ] Yes → {{FRAMEWORK_DIR}}/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.5.3 Master
+# Codebase Explorer — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 
 - 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.5.3 Master
+# Frontend Architect — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes
 - **API contract read? [ ] No / [ ] Yes → {{FRAMEWORK_DIR}}/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.5.3 Master
+# Version Control Specialist (@git) — v0.5.7 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.5.3)
+### Agent Completion Report (v0.5.7)
 - 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 {{FRAMEWORK_DIR}}/ENDERUN.md and {{FRAMEWORK_DIR}}/PROJECT_MEMORY.md in every session, validates the phase, and assigns agents."
 ---
 
-# Manager (CTO & Controller) — v0.5.3 Master
+# Manager (CTO & Controller) — v0.5.7 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.5.3 (Mandatory in Every Agent Directive)
+## Briefing Template v0.5.7 (Mandatory in Every Agent Directive)
 
 ```
 ## Agent Directive
@@ -165,7 +165,7 @@ graph TD
 
 ---
 
-**Agent Completion Report** (v0.5.3)
+**Agent Completion Report** (v0.5.7)
 
 - 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.5.3 Master
+# Mobile Architect — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 
 - 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.5.3 Master
+# Native Desktop Architect — v0.5.7 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.5.3)
+**Agent Completion Report** (v0.5.7)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.5.3)
+# Agent Enderun (v0.5.7)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
@@ -18,11 +18,18 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 
 ## STEP 0 — STARTUP (EVERY SESSION, NON-NEGOTIABLE)
 
-1. **Read ./{{ADAPTER}}.md First:** Read and fully understand this file before taking any action.
-2. **Check `{{FRAMEWORK_DIR}}/docs/` Folder:** Verify the existence of the `{{FRAMEWORK_DIR}}/docs/` folder (located within the framework directory).
-3. **Absorb Context:** Read `{{FRAMEWORK_DIR}}/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
-4. **Demand Context:** If the `{{FRAMEWORK_DIR}}/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
-5. **Automatic @manager Mode:** You are ALWAYS operating as `@manager` (Team-Lead). You do NOT need to be called with `@manager` — this role is your default identity. You analyze, delegate, and orchestrate on EVERY turn without exception.
+1. **Restore Session Memory & Load Role (NON-NEGOTIABLE):**
+   - **Immediately Read `{{FRAMEWORK_DIR}}/PROJECT_MEMORY.md`** (using the `read_project_memory` tool or direct file viewing if MCP is offline) as the very first action of the session. You **MUST NOT** answer or take any actions before loading this file. Extract:
+     - `CURRENT STATUS` (Active Phase, Active Trace ID, Blockers)
+     - `CRITICAL DECISIONS` (Previous design decisions to comply with)
+     - `ACTIVE TASKS` (Ongoing work and agent assignments)
+     - `HISTORY` (To see exactly what agents did recently)
+   - **Load Agent Prompt:** By default, you operate as `@manager`. Immediately read and load `{{FRAMEWORK_DIR}}/agents/manager.md` to adopt its exact rules, workflows, and checklists. If the user explicitly invokes a specialist (e.g., `@backend`), immediately read and load the corresponding agent file (e.g., `{{FRAMEWORK_DIR}}/agents/backend.md`).
+2. **Read ./{{ADAPTER}}.md First:** Read and fully understand this file before taking any action.
+3. **Check `{{FRAMEWORK_DIR}}/docs/` Folder:** Verify the existence of the `{{FRAMEWORK_DIR}}/docs/` folder (located within the framework directory).
+4. **Absorb Context:** Read `{{FRAMEWORK_DIR}}/docs/tech-stack.md`. If it is empty, ask the user to fill it before proceeding.
+5. **Demand Context:** If the `{{FRAMEWORK_DIR}}/docs/` folder does not exist, ask the user for project context and target audience information before writing any code.
+6. **Automatic @manager Mode:** You are ALWAYS operating as `@manager` (Team-Lead). You do NOT need to be called with `@manager` — this role is your default identity. You analyze, delegate, and orchestrate on EVERY turn without exception.
 
 **NEVER SKIP THIS STEP.** Do not assume context; read first, then act as @manager.
 
@@ -34,6 +41,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 - **Team-Lead MANDATORY Orchestration:** Every user request MUST first be handled by the `@manager` (Team-Lead) agent. The `@manager` is responsible for analyzing intent, updating `PROJECT_MEMORY.md`, and delegating tasks to specialists. Agents are FORBIDDEN from acting on a general request without `@manager` delegation.
 - **Zero-Request Logging Policy:** Agents MUST log every action and update `PROJECT_MEMORY.md` automatically at the end of every turn, without waiting for a user directive. This is the "Operating Mode" of the framework.
 - **Immediate Memory Sync:** Every state change, decision, or improved capability must be reflected in the memory files immediately.
+- **Zero Temporary Storage & Single Source of Truth:** Storing, caching, or writing project details, logs, tasks, files, or agent planning documents (including implementation plans, scratch scripts, or intermediate tasks) in the operating system's temporary directory (`/tmp`, `/var/tmp`, `temp`, etc.) is strictly forbidden. All planning, state, tasks, and memory MUST be stored inside the designated persistent framework directory (`{{FRAMEWORK_DIR}}/` or `.gemini/` etc.) or the project workspace. This ensures 100% state persistence and context recovery upon session restarts.
 - **Contract-First Agent Evolution:** Tools and SOPs used by agents must be defined via schemas and contracts first.
 - **Zero Mock Policy:** The use of fake (mock) data or placeholders is strictly forbidden. Every line of code must connect to a real endpoint or a typed contract. (Exception: Controlled mock usage is allowed for external 3rd party services like Stripe, Twilio).
 - **Branded Types Law:** All IDs (UserID, ProjectID, etc.) must be in the "Branded Types" format defined under `packages/shared-types`. Using plain strings or numbers is forbidden.
@@ -103,6 +111,7 @@ Every agent must use the **Mandatory Output Flow** defined in their specific `.m
 - **Raw SQL Strings:** Direct strings cannot be used for SQL queries; strictly use `Kysely`.
 - **Direct DB call in a controller:** Database operations cannot be performed directly inside a Controller.
 - **Missing try/catch on async operations:** Error handling (try/catch) is mandatory for asynchronous operations.
+- **Use of Temporary Directories (e.g. `/tmp`, `temp`):** Saving any project code, files, script logs, intermediate implementation plans, or agent workflows outside the workspace or inside the system's temporary directory is strictly forbidden. All assets and state files must be in the persistent project repository (under `{{FRAMEWORK_DIR}}/` or the workspace root).
 
 ---
 

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun (v0.5.3) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.5.7) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -12,6 +12,10 @@
 
 Agent Enderun, yazılım ekipleri için tasarlanmış, **Anayasal Yönetişim (Constitutional Governance)** ve **Çoklu Ajan Orkestrasyonu (Multi-Agent Orchestration)** sağlayan kurumsal düzeyde bir framework'tür. 
 
+### 🚀 v0.5.7: Persistent Memory & Zero-Temp Governance
+- **Zero Temporary Storage:** All task logs, plans, and state are strictly saved in persistent workspace directories; OS temp directories are completely forbidden.
+- **Session Memory Recovery:** Non-negotiable automatic first-turn state restoration and role initialization across all adapters.
+
 ### 🚀 v0.5.3: Zero-Config & Auto-Wiring
 - **Auto-Wiring:** CLI automatically configures `gemini-extension.json` for MCP.
 - **Automated Build:** Framework now compiles itself during initialization.
@@ -73,7 +77,7 @@ agent-enderun check
 
 Expected output:
 ```
-✅ Framework active (v0.5.3)
+✅ Framework active (v0.5.7)
 ✅ MCP Server ready
 ✅ Shared types compiled
 ✅ Agent logs initialized
@@ -480,7 +484,7 @@ agent-enderun check
 
 Beklenen çıktı:
 ```
-✅ Framework aktif (v0.5.3)
+✅ Framework aktif (v0.5.7)
 ✅ MCP Sunucu hazır
 ✅ Paylaşılan türler derlenmiş
 ✅ Agent logları başlatılmış

package/claude.md

@@ -7,4 +7,9 @@ This file is the entry point for Claude. The project's "Supreme Law" and all ins
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
+⚠️ **CRITICAL STARTUP REQUIREMENT:**
+At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
+1. You **MUST** read `.claude/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `.claude/agents/manager.md` (or the specialist's md file in `.claude/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+
 Please read the Supreme Law thoroughly before taking any action.

package/codex.md

@@ -7,4 +7,9 @@ This file is the entry point for Codex. The project's "Supreme Law" and all inst
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
+⚠️ **CRITICAL STARTUP REQUIREMENT:**
+At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
+1. You **MUST** read `.enderun/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `.enderun/agents/manager.md` (or the specialist's md file in `.enderun/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+
 Please read the Supreme Law thoroughly before taking any action.

package/cursor.md

@@ -7,4 +7,9 @@ This file is the entry point for Cursor. The project's "Supreme Law" and all ins
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
+⚠️ **CRITICAL STARTUP REQUIREMENT:**
+At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
+1. You **MUST** read `.cursor/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `.cursor/agents/manager.md` (or the specialist's md file in `.cursor/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+
 Please read the Supreme Law thoroughly before taking any action.

package/gemini.md

@@ -7,4 +7,9 @@ This file is the entry point for Gemini. The project's "Supreme Law" and all ins
 ### 🤖 AGENT DIRECTIVE
 You are ALWAYS operating as `@manager` (Team-Lead) by default — on every message, every turn. The user does NOT need to type `@manager`. Typing a specific agent (e.g. `@backend`) explicitly will override this and activate that specialist role directly. You are responsible for analysis and delegation.
 
+⚠️ **CRITICAL STARTUP REQUIREMENT:**
+At the start of every new session/conversation or first turn, before you perform any task or respond to the user:
+1. You **MUST** read `.gemini/PROJECT_MEMORY.md` immediately (using the `read_project_memory` tool or the most specific file viewing tool) to restore the project's state, active phase, Trace ID, and recent history.
+2. You **MUST** read `.gemini/agents/manager.md` (or the specialist's md file in `.gemini/agents/` if explicitly overridden) to load your role-specific rules, workflows, and checklists.
+
 Please read the Supreme Law thoroughly before taking any action.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -79,7 +79,7 @@
     "vitest": "^3.0.5"
   },
   "enderun": {
-    "version": "0.5.3",
+    "version": "0.5.7",
     "initializedAt": "2026-05-09T13:24:27.472Z"
   }
 }

package/packages/framework-mcp/dist/utils.js

@@ -1,6 +1,6 @@
 import path from "path";
 import fs from "fs";
-export const FRAMEWORK_VERSION = "0.5.2";
+export const FRAMEWORK_VERSION = "0.5.7";
 export function getFrameworkDir(projectRoot) {
     const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];
     for (const adp of adapters) {

package/packages/framework-mcp/package.json

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

package/packages/framework-mcp/src/utils.ts

@@ -1,7 +1,7 @@
 import path from "path";
 import fs from "fs";
 
-export const FRAMEWORK_VERSION = "0.5.2";
+export const FRAMEWORK_VERSION = "0.5.7";
 
 export function getFrameworkDir(projectRoot: string): string {
     const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];

package/packages/shared-types/package.json

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