agent-enderun 0.5.7 → 0.5.9

package/.enderun/PROJECT_MEMORY.md

@@ -6,19 +6,19 @@ 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-16 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
+| PHASE_0      | Lightweight | 2026-05-20 | 01KR6EJA6GG3RPS849097KS37Q | NONE |
 
 ## PROJECT DEFINITION
 
-- **Name:** Agent Enderun
-- **Version:** v0.5.7
+- **Name:** KENTİM
+- **Version:** v1.0.0
 | Field | Value |
 | :--- | :--- |
-| Project Name | agent-enderun |
-| Platform | Not defined |
+| Project Name | kentim |
+| Platform | Multi-Tenant SaaS |
 | Frontend | React 19 + Vite + Panda CSS |
 | Backend | Node.js 20+ + Fastify |
-| DB | PostgreSQL |
+| DB | PostgreSQL + PostGIS + RLS |
 
 ## DOD STATUS
 
@@ -34,8 +34,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.5 | Inclusion of missing adapter files and installation fix | @manager |
-| 2026-05-09 | Project Initialized | Framework setup via CLI | @manager |
+| 2026-05-20 | Project Initialized | Fresh setup for KENTİM project | @manager |
 
 ## DELIVERABLES
 
@@ -46,98 +45,12 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 | Trace ID | Task | Agent | Priority | Status |
 | :--- | :--- | :--- | :--- | :--- |
-| 01KRRZRSDGFG38RRDPQCSBXE3D | Phase 1: shared-types kontratlarını ve branded types yapısını genişlet | @backend | P1 | IN_PROGRESS |
-| 01KRC3WPMGXW2G3A4B0FVABKX0 | Modular Refactoring and Documentation Overhaul | @analyst | P0 | COMPLETE |
-| 01KR6EJA6GG3RPS849097KS37Q | Framework setup and architecture alignment | @manager | P1 | IN_PROGRESS |
+| 01KR6EJA6GG3RPS849097KS37Q | Framework reset and KENTİM project initialization | @manager | P1 | IN_PROGRESS |
 
 ## HISTORY (Persistent Memory)
 
-### 2026-05-16 — Framework Path Placeholder Fix (v0.5.2)
+### 2026-05-20 — Project Reset & KENTİM Initialization
 
 - **Agent:** @manager
 - **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Fixed critical bug where all agent files (`manager.md`, `analyst.md`, `backend.md`, `frontend.md`, `native.md`, `mobile.md`) contained hardcoded `.enderun/` paths. Replaced with `{{FRAMEWORK_DIR}}/` placeholder. Updated `bin/cli.js` `copyDir` and `initCommand` with fallback `.enderun/` → `frameworkDir` replace at all three content-processing points. Now `init gemini` correctly produces `.gemini/docs/api/`, `init claude` produces `.claude/docs/api/`, etc. Verified: 0 hardcoded references remain, 18/18 health checks pass, 12/12 tests pass.
-
-### 2026-05-16 — Zero-Config & Auto-Wiring Milestone (v0.5.2)
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Bumped version to v0.5.2. Achieved full automation for framework onboarding. Implemented Auto-Wiring for Gemini (auto-patching `gemini-extension.json`), automated MCP build during `init`, and refined directory logic for user-facing documentation. This release marks the transition to a truly "plug-and-play" enterprise framework.
-
-### 2026-05-16 — Dizin Yapısı Düzenlemesi (Düzeltildi)
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Root `docs/` was incorrectly deleted (confused with `.enderun/docs/`). Restored with `docs/README.md` explaining its purpose: agent-written project documentation during PHASE_2. Added `docs/` to `package.json` files array and `cli.js` DIRS_TO_CREATE. Distinction clarified: `/docs` = user project docs (agent-generated), `/.enderun/docs/` = framework config (tech-stack, security, privacy). Updated `STATUS.md` to mark `@mobile`/`@native` as INACTIVE (Full Profile only).
-
-### 2026-05-16 — Proje Gözlem & Durum İncelemesi (Düzeltildi)
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Full project review conducted. PHASE_0 in progress. Confirmed design intent: (1) `apps/` is intentionally empty — this is a framework package, not an app project; (2) `{{ADAPTER}}`/`{{FRAMEWORK_DIR}}` in ENDERUN.md are template variables resolved by `init` command at install time (gemini→.gemini, claude→.claude, cursor→.cursor, codex→.enderun). Fixed `codex.md` source file inconsistency where `{{FRAMEWORK_DIR}}` was not hardcoded like other adapters.
-
-### 2026-05-15 — The Academy Upgrade & v0.5.1 Release
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Major framework upgrade (v0.5.1). Implemented Hermes Messaging Protocol and Obsidian-style LLM Wiki with YAML metadata. Consolidated constitution into root `ENDERUN.md` and removed legacy `jest.config.js`. Enhanced MCP server with new intelligence tools for knowledge graphs and system health.
-
-### 2026-05-15 — Hermes + Obsidian + LLM Wiki & Discovery
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Major upgrade to framework intelligence. Implemented Hermes Messaging Protocol for inter-agent orchestration and Obsidian-style structured Wiki for knowledge management. Unified versioning across all packages to v0.5.0.
-
-### 2026-05-12 — The Installation Fix & v0.4.5 Release
-+
-+- **Agent:** @manager
-+- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-+- **Action:** Bumped version to v0.4.5. Fixed a critical issue where adapter files (gemini.md, cursor.md, claude.md, codex.md) were excluded from the npm package. Verified the fix via local and npx-simulated tests. Cleaned up logs and temporary test files.
-+
-+### 2026-05-12 — The Unified Milestone & v0.4.4 Release
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Full framework synchronization to v0.4.4. 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
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **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.
-
-### 2026-05-12 — Critical Fix & v0.3.4 Release
-
-- **Agent:** @manager
-- **Trace ID:** 01KRES6JRXE82FZPWVR1SSMB4W
-- **Action:** Fixed a critical bug in the `init` command that caused the deletion of `packages/shared-types` and `.enderun` user data during updates. Enhanced metadata across all monorepo packages by explicitly defining README paths and synchronizing repository/homepage links to fix NPM registry display issues. Bumped version to v0.3.4 across all packages and verified build integrity.
-
-### 2026-05-11 — Modular Architecture & Documentation Overhaul
-
-- **Agent:** @analyst
-- **Trace ID:** 01KRC3WPMGXW2G3A4B0FVABKX0
-- **Action:** Refactored the monolithic MCP server (2100+ lines) into a modular structure with dedicated tool categories (codebase, framework, security, memory, contract, academy, messages, git, database, knowledge, repository). Updated root and package READMEs to provide enterprise-grade documentation. Verified build integrity and contract synchronization. Prepared codebase for npm publication.
-
-### 2026-05-11 — Adapter-Specific Onboarding Enabled
-
-- **Agent:** @manager
-- **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-09 — Framework Initialization
-
-- **Agent:** @manager
-- **Trace ID:** 01KR6EJA6GG3RPS849097KS37Q
-- **Action:** Initialized Agent Enderun framework and project structure.
+- **Action:** Reset all logs and memory history to initiate a completely fresh project cycle for the KENTİM platform.

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.7 Master
+# Project Analyst & QA Gate — v0.5.9 Master
 
 **Role:** Maintain project memory, serve as a quality gate, and manage documentation. The following protocols are automatically applied in every task.
 
@@ -90,14 +90,20 @@ In every phase transition and upon request:
 Before approving any task completion, @analyst must verify that the agent followed existing code patterns.
 1. Identify a "Gold Standard" reference file for the current task's domain.
 2. Use the `analyze_procedural_continuity` tool to compare the agent's changes with the reference.
-3. **Surgical Audit:** Check if the agent modified unrelated parts of the file. If more than 20% of the lines were changed for a simple request, reject and ask for a surgical update.
+3. **Architecture & Contract Audit:**
+   - **Modular Types:** Verify that `@backend` and `@frontend` use modular imports from `shared-types` if the project size warrants it.
+   - **Domain Errors:** Ensure `@backend` uses the standardized `DomainError` hierarchy from the project's error directory. Reject any local re-definitions of error classes.
+   - **API Sync:** Confirm that `contract.version.json` was updated if `shared-types` changed.
+4. **Surgical Audit:** Check if the agent modified unrelated parts of the file. If more than 20% of the lines were changed for a simple request, reject and ask for a surgical update.
 - **Responsive Audit:** 
    - Verify usage of Panda CSS responsive tokens (`base`, `md`, `lg`). 
    - Ensure `fontSize` and `gap` use fluid values (e.g., `clamp()`) where appropriate.
    - Reject if a fixed pixel width (e.g., `width: "1200px"`) is used instead of responsive containers or `maxW`.
-- **Shared UI Audit:**
-   - Detect redundant UI definitions. If a Button or Input is defined inline within a page, reject the task and order the agent to move it to a shared UI directory.
-   - Ensure `@/components/ui` (or equivalent) is the primary source for all atoms.
+- **Backend Architecture Audit:**
+   - **Audit Logs:** Verify that every mutation (CREATE/UPDATE/DELETE) has a corresponding audit log implementation linked to a Trace ID. Reject any mutation logic missing an audit trail.
+   - **Code Reuse:** Check for redundant CRUD logic. Mandate the use of Base Repository/Service patterns.
+   - **BaseEntity:** Ensure all new entities include `id`, `createdAt`, and `updatedAt` fields.
+   - **Typed Config:** Reject direct `process.env` usage in services or repositories.
 5. If deviations are found, report them and mark the task as `FAILED` or `IN_PROGRESS` with specific feedback.
 
 
@@ -199,7 +205,7 @@ Use the `log_agent_action` tool to record your activities securely.
 
 ---
 
-**Agent Completion Report** (v0.5.7)
+**Agent Completion Report** (v0.5.8)
 
 - 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.7 Master
+# Backend Architect — v0.5.9 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.
 
@@ -67,45 +67,48 @@ Route (Fastify)
 
 ---
 
-## Domain Error System
+## 🏗️ Base Architecture & Code Reuse (Standard)
 
+To eliminate code repetition, all backend development MUST follow the **Base Pattern**. Agents are not allowed to write redundant CRUD logic.
+
+**Standard Patterns:**
+1. **Base Repository:** Use a centralized repository logic for common Kysely operations (findById, findMany, create, update, softDelete).
+2. **Base Service:** Orchestrate business logic using reusable services.
+3. **Typed Config:** Always access environment variables through a centralized, typed configuration object or service. Never use `process.env` directly in domain logic.
+
+**Mandatory Shared Fields:**
+All entities must implement the `BaseEntity` interface from `@agent-enderun/shared-types`, including `id`, `createdAt`, and `updatedAt`.
+
+---
+
+## 🕵️ Automatic Audit Logging (Mandatory)
+
+Every "mutation" (CREATE, UPDATE, DELETE) MUST trigger an audit log entry.
+- **Traceability:** Link every audit log to the active **Trace ID**.
+- **State Capture:** For updates, capture both `previousState` and `newState`.
+- **User Context:** Identify the `UserID` performing the action.
+
+---
+
+## Domain Error System (Standard)
+
+All backend projects MUST use the standardized `DomainError` hierarchy. Do not define these classes locally.
+Reference the "Gold Standard" blueprints in `{{FRAMEWORK_DIR}}/blueprints/backend/errors/domain-error.ts`.
+
+**Mandatory Classes:**
+- `NotFoundError` (404)
+- `ValidationError` (400)
+- `UnauthorizedError` (401)
+- `ForbiddenError` (403)
+- `ConflictError` (409)
+- `InternalServerError` (500)
+
+**Usage Pattern:**
 ```typescript
-// All domain errors derive from this class
-class DomainError extends Error {
-  constructor(
-    public readonly code: string,
-    public readonly statusCode: number,
-    message: string,
-  ) {
-    super(message);
-    this.name = "DomainError";
-  }
-}
-class NotFoundError extends DomainError {
-  constructor(entity: string) {
-    super("NOT_FOUND", 404, entity + " not found.");
-  }
-}
-class ValidationError extends DomainError {
-  constructor(msg: string) {
-    super("VALIDATION_ERROR", 400, msg);
-  }
-}
-class UnauthorizedError extends DomainError {
-  constructor() {
-    super("UNAUTHORIZED", 401, "Authentication required.");
-  }
-}
-class ForbiddenError extends DomainError {
-  constructor() {
-    super("FORBIDDEN", 403, "Access denied.");
-  }
-}
-class ConflictError extends DomainError {
-  constructor(msg: string) {
-    super("CONFLICT", 409, msg);
-  }
-}
+// Copy from blueprint to project's error directory if missing
+import { NotFoundError } from "@/errors/domain-error";
+
+if (!item) throw new NotFoundError("Item");
 ```
 
 ---
@@ -214,7 +217,7 @@ Frontend works by reading this file. If you don't write it, frontend will work b
 ## Contract Update Procedure
 
 When `shared-types` or API documentation changes:
-1. Update types in `packages/shared-types/src/`.
+1. Update types in modular files under `packages/shared-types/src/`.
 2. Update the contract hash using the `update_contract_hash` tool.
 3. **MANDATORY NOTIFICATION:** Use the `send_agent_message` tool to inform `@frontend` (and other affected agents). Include the updated Trace ID and a brief summary of the changes.
 4. Update `{{FRAMEWORK_DIR}}/docs/api/[domain].md` to reflect the new state.
@@ -242,7 +245,7 @@ When `shared-types` or API documentation changes:
 
 ---
 
-**Agent Completion Report** (v0.5.7)
+**Agent Completion Report** (v0.5.8)
 - Mock used? [ ] No / [ ] Yes
 - shared-types changed? [ ] No / [ ] Yes → contract.version updated
 - **API contract written? [ ] No / [ ] Yes → {{FRAMEWORK_DIR}}/docs/api/[domain].md**
@@ -253,3 +256,7 @@ When `shared-types` or API documentation changes:
 - Blockers: [write if any, otherwise "NONE"]
 ---
 ```
+what needs to be done]
+- Blockers: [write if any, otherwise "NONE"]
+---
+```

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.7 Master
+# Codebase Explorer — v0.5.9 Master
 
 **Role:** Analyze the codebase, map architectures, and understand system-wide dependencies. Your primary duty is to provide context to other agents.
 
@@ -25,8 +25,20 @@ Never suggest a change without understanding the current state of the codebase.
 
 ---
 
-## 🔍 Research Standards
+## 🔄 Legacy Conversion Algorithm (Standard)
+
+When assigned to a legacy project, `@explorer` must guide the team through a gradual standardization process:
+
+1.  **Architecture Mapping:** Use `analyze_dependencies` to identify core modules and their coupling.
+2.  **Gap Analysis:** Run `get_project_gaps` and document structural deviations from `ENDERUN.md`.
+3.  **Bridge Building:** Propose creating a `shared-types` package if it doesn't exist, and start mapping existing DTOs to it.
+4.  **Refactor Blueprint:** Identify one "Hot Spot" module and provide a plan to wrap it in tests and refactor it using **Branded Types** and **Modular Architecture**.
+5.  **Audit Oversight:** Coordinate with `@analyst` to ensure new features in the legacy project follow the latest standards (Zero UI, Semantic Tokens, Domain Errors) from day one.
 
+---
+
+## 🔍 Research Standards
+...
 ### 1. Codebase Search
 
 - Use `search_codebase` (or legacy `codebase_search`) for specific patterns or logic.
@@ -90,7 +102,7 @@ Every research report must include:
 
 ---
 
-**Agent Completion Report** (v0.5.7)
+**Agent Completion Report** (v0.5.8)
 
 - 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.7 Master
+# Frontend Architect — v0.5.9 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.
 
@@ -53,17 +53,51 @@ Do not wait for the user to ask for basic professional standards. You are RESPON
 
 ---
 
-## 📐 THE CONSTITUTION: ZERO UI LIBRARY POLICY (MANDATORY)
+## 🔗 Hook-Based API Architecture (Mandatory)
+
+All API interactions MUST be encapsulated within custom React hooks. Inline `fetch` or `axios` calls within components are FORBIDDEN.
+
+**Requirements:**
+- **Shared-Types:** Always use types imported from `@agent-enderun/shared-types`.
+- **Loading/Error States:** Hooks must return `isLoading` and `error` states.
+- **Consistency:** Use a consistent API client or fetch wrapper defined in the project.
 
-AI-Enderun strictly adheres to the **Zero UI Library Policy**.
-- **FORBIDDEN:** `shadcn/ui`, `MUI`, `Chakra UI`, `Ant Design`, `Bootstrap`, etc.
-- **MANDATORY:** All UI components (Button, Modal, Input, Card, etc.) must be built from scratch using **Panda CSS**, unique to this project.
-- **RATIONALE:** Maximum performance (zero-runtime), full type safety, and unique/original aesthetics.
+**Golden Standard Hook Pattern:**
+```typescript
+import { useState, useEffect } from "react";
+import { UserResponse, ApiError } from "@agent-enderun/shared-types";
+
+export const useUser = (userId: string) => {
+  const [data, setData] = useState<UserResponse | null>(null);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState<ApiError | null>(null);
+
+  useEffect(() => {
+    const fetchData = async () => {
+      try {
+        const response = await fetch(`/api/users/${userId}`);
+        const result = await response.json();
+        setData(result.data);
+      } catch (err) {
+        setError(err as ApiError);
+      } finally {
+        setIsLoading(false);
+      }
+    };
+    fetchData();
+  }, [userId]);
+
+  return { data, isLoading, error };
+};
+```
 
 ---
 
-## Design Philosophy
+## 🎨 Theme & Semantic Design System (Standard)
+...
 
+## 📐 THE CONSTITUTION: ZERO UI LIBRARY POLICY (MANDATORY)
+...
 - **Mobile-First (320px):** All designs start from the smallest screen.
 - **Ultra-Wide Ready (1920px+):** Fluidity with `clamp()` and `aspect-ratio` ensures the design looks perfect on all screens.
 - **Rich Aesthetics:** Avoid generic "AI Slop" designs. Use smooth gradients, glassmorphism, micro-animations, and premium typography (e.g., Inter, Outfit).
@@ -156,7 +190,7 @@ Frontend never creates its own types for backend data.
 
 ---
 
-**Agent Completion Report** (v0.5.7)
+**Agent Completion Report** (v0.5.8)
 - 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.7 Master
+# Version Control Specialist (@git) — v0.5.9 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.7)
+### Agent Completion Report (v0.5.8)
 - 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.7 Master
+# Manager (CTO & Controller) — v0.5.9 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.7 (Mandatory in Every Agent Directive)
+## Briefing Template v0.5.8 (Mandatory in Every Agent Directive)
 
 ```
 ## Agent Directive
@@ -165,7 +165,7 @@ graph TD
 
 ---
 
-**Agent Completion Report** (v0.5.7)
+**Agent Completion Report** (v0.5.8)
 
 - 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.7 Master
+# Mobile Architect — v0.5.9 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.7)
+**Agent Completion Report** (v0.5.8)
 
 - 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.7 Master
+# Native Desktop Architect — v0.5.9 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.7)
+**Agent Completion Report** (v0.5.8)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/.enderun/blueprints/backend/errors/domain-error.ts

@@ -0,0 +1,84 @@
+import { ApiError } from "@agent-enderun/shared-types";
+
+/**
+ * Base Domain Error
+ * All specialized errors should extend this class.
+ */
+export class DomainError extends Error {
+  constructor(
+    public readonly code: string,
+    public readonly statusCode: number,
+    message: string,
+    public readonly details?: unknown
+  ) {
+    super(message);
+    this.name = "DomainError";
+  }
+
+  /**
+   * Converts the error to a standard API response format defined in shared-types
+   */
+  toApiResponse(): ApiError {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        details: this.details,
+      },
+    };
+  }
+}
+
+/**
+ * 404 - Not Found
+ */
+export class NotFoundError extends DomainError {
+  constructor(entity: string, details?: unknown) {
+    super("NOT_FOUND", 404, `${entity} not found.`, details);
+  }
+}
+
+/**
+ * 400 - Validation Error
+ */
+export class ValidationError extends DomainError {
+  constructor(message: string, details?: unknown) {
+    super("VALIDATION_ERROR", 400, message, details);
+  }
+}
+
+/**
+ * 401 - Unauthorized
+ */
+export class UnauthorizedError extends DomainError {
+  constructor(message: string = "Authentication required.", details?: unknown) {
+    super("UNAUTHORIZED", 401, message, details);
+  }
+}
+
+/**
+ * 403 - Forbidden
+ */
+export class ForbiddenError extends DomainError {
+  constructor(message: string = "Access denied.", details?: unknown) {
+    super("FORBIDDEN", 403, message, details);
+  }
+}
+
+/**
+ * 409 - Conflict
+ */
+export class ConflictError extends DomainError {
+  constructor(message: string, details?: unknown) {
+    super("CONFLICT", 409, message, details);
+  }
+}
+
+/**
+ * 500 - Internal Server Error
+ */
+export class InternalServerError extends DomainError {
+  constructor(message: string = "An unexpected error occurred.", details?: unknown) {
+    super("INTERNAL_ERROR", 500, message, details);
+  }
+}

package/.enderun/blueprints/backend/middleware/error-handler.ts

@@ -0,0 +1,24 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { DomainError } from "../errors/domain-error.js";
+
+/**
+ * Global Error Handler for Fastify (Template)
+ * This middleware captures DomainErrors and formats them consistently.
+ */
+export const errorHandler = (error: unknown, request: any, reply: any) => {
+  // Capture custom domain errors
+  if (error instanceof DomainError) {
+    return reply.status(error.statusCode).send(error.toApiResponse());
+  }
+
+  // Fallback for unknown errors
+  request.log.error(error);
+  
+  return reply.status(500).send({
+    error: {
+      code: "INTERNAL_ERROR",
+      message: "An unexpected error occurred.",
+      details: process.env.NODE_ENV === "development" ? error.message : undefined
+    }
+  });
+};