ai-enderun 0.0.11 → 0.0.12

package/.enderun/ENDERUN.md

@@ -0,0 +1,72 @@
+# AI-Enderun Constitution — v0.0.12 Master
+
+# Place in project root. This file is the single source of truth for all AI clients (Gemini CLI, Claude Code, etc.).
+
+## 🎖️ I. Git Discipline Protocol (The Law of Origin)
+
+- **Atomic Commits:** Each commit must represent a single, logical unit of change. No "fix" or "wip" commits allowed.
+- **Commit Message Format:** `[Type](Scope): Description` (e.g., `feat(api): add auth header validation`).
+- **Phase Snapshots:** Every transition between `STATE MACHINE` phases must be marked with a git tag corresponding to the phase name (e.g., `git tag -a v0.0.12-phase1`).
+- **Branching:** Use `feature/trace-id-short-description` for all task-based work.
+
+---
+
+## 🧠 II. Procedural Continuity (The Law of Style)
+
+- **Style Inheritance:** Agents MUST read and follow existing code patterns and stylistic standards. NEVER impose a new style (e.g., changing from Arrow Functions to Function Declarations) unless explicitly asked.
+- **Proactive Engineering:** Autonomously implement professional standards (Pagination, Search, Validation, Loading States, Error UI) without waiting for explicit user instructions.
+- **Search-Before-Reading:** Always use `search_codebase` or `analyze_dependencies` before opening files to minimize token usage and maximize context accuracy.
+
+---
+
+## ⚖️ III. State Machine (The Law of Phase)
+
+### PHASE 0: Discovery & Setup
+- **DoD:** `tech-stack.md` defined, `project-docs.md` updated, `shared-types` initialized.
+
+### PHASE 1: Architecture & Contract
+- **DoD:** All API endpoints documented in `docs/api/`, shared-types match the contract hash.
+
+### PHASE 2: Core Implementation
+- **DoD:** Backend logic complete, unit tests passing, mobile/web scaffolded.
+
+### PHASE 3: Integration & UI
+- **DoD:** Frontend linked to backend, E2E tests passing, mobile features verified.
+
+### PHASE 4: Hardening & Launch
+- **DoD:** Security audit passed, performance optimized, project tagged for release.
+
+---
+
+## 👥 IV. The 8 Specialist Protocol
+
+All agent interactions are governed by 8 specialized roles found in `{{FRAMEWORK_DIR}}/agents/`:
+
+1. **@manager:** CTO & Controller. Orchestrates the team and manages memory.
+2. **@analyst:** QA & Memory Gate. Audits DoD and generates walkthroughs.
+3. **@backend:** Backend Architect. Master of Contracts, DB, and Type Safety.
+4. **@frontend:** UI/UX Architect. Enforcer of "Zero UI Library" and Panda CSS.
+5. **@explorer:** Investigator. Scans codebase and maps dependencies.
+6. **@mobile:** App Specialist. Expert in React Native and Expo.
+7. **@native:** Desktop Architect. Expert in Tauri and Electron.
+8. **@git:** Version Control Specialist. Guardian of atomic commits and snapshots.
+
+---
+
+## 💾 V. Memory Management (The Law of Truth)
+
+- **PROJECT_MEMORY.md:** The SINGLE SOURCE OF TRUTH. Agents MUST read this file at the start of every session.
+- **CURRENT STATUS Update:** Update the `Active Phase`, `Last Update`, and `Active Trace ID` fields in the `CURRENT STATUS` table at the end of every session.
+- **Trace ID Protocol:** Generate a ULID for every new task chain. All agents working on the same feature use the same Trace ID.
+
+---
+
+## 🎨 VI. Design Philosophy (The Law of Aesthetics)
+
+- **Zero UI Library Policy:** Forbidden to use `shadcn/ui`, `MUI`, `Tailwind` or other generic libraries.
+- **Panda CSS Standard:** All styling must use Panda CSS tokens and original components.
+- **Premium Aesthetics:** Every interface must feel premium, state-of-the-art, and characterful. Avoid MVP-level simplicity.
+
+---
+
+_Generated by AI-Enderun Framework v0.0.12 MASTER_

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-08 | 01KR46D2M3X9V1T8Z4D7Z2L5K1 | NONE |
+| PHASE_0      | Lightweight | 2026-05-09 | 01KR46D2M3X9V1T8Z4D7Z2L5K1 | NONE |
 
 ## PROJECT DEFINITION
 
@@ -18,17 +18,19 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 | Backend | Node.js 20+ + Fastify + Kysely |
 | DB | PostgreSQL |
 | Auth | Not yet defined |
-
 ## ACTIVE TASKS
 
-- [x] Create core framework structure (.enderun)
-- [x] Implement MCP server with dependency analysis and security tools
-- [x] Define Agent SOPs (Manager, Analyst, Backend, Frontend, Explorer, Mobile, Native, Git)
-- [x] Standardize on ULID and Branded Types
-- [x] Fix initialization pathing and adapter linker placement
-- [x] Implement automated Git initialization and @git SOP
-- [x] Resolve Claude Code template validation conflicts (resource -> entity)
-- [ ] Begin PHASE_1 Architecture & Contract (pending user instruction)
+| Trace ID | Task | Agent | Priority | Status |
+| :--- | :--- | :--- | :--- | :--- |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Framework setup and architecture alignment | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Create core framework structure (.enderun) | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Implement MCP server with dependency analysis | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Define Agent SOPs (8 Specialists) | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Standardize on ULID and Branded Types | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Fix initialization pathing and adapter linker | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Implement automated Git initialization | @manager | P1 | COMPLETE |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Resolve template validation conflicts (entity) | @manager | P1 | COMPLETE |
+| — | Begin PHASE_1 Architecture & Contract | @manager | P2 | PENDING |
 
 ## CRITICAL DECISIONS
 
@@ -40,6 +42,23 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 ## HISTORY
 
+### 2026-05-09 — v0.0.12 Stabilization & Cleanup (FINAL)
+
+- **Agent:** @manager
+- **Trace ID:** 01KR46D2M3X9V1T8Z4D7Z2L5K1
+- **Action:** Performed final structural cleanup of project memory. Fixed corrupted text fragments, merged duplicate headers, and refactored CLI to use dynamic versioning.
+- **Decision:** v0.0.12 is confirmed as the stable baseline.
+- **Next Step:** Proceed to PHASE_1 Architecture & Contract.
+
+
+### 2026-05-08 — v0.0.11 Framework Stabilization (FIX)
+
+- **Agent:** @manager
+- **Trace ID:** 01KR46D2M3X9V1T8Z4D7Z2L5K1
+- **Action:** Fixed a critical template validation error in `@backend` SOP. Replaced `${entity}` template literal with string concatenation to prevent Gemini CLI/Claude Code parameter conflicts. Verified MCP server and package health.
+- **Decision:** v0.0.11 is now the stable baseline.
+- **Next Step:** Proceed to PHASE_1 Architecture & Contract.
+
 ### 2026-05-08 — v0.0.10 Super-Stabilization (MASTER)
 
 - **Agent:** @manager
@@ -64,4 +83,4 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 
 ---
 
-_Generated by AI-Enderun Framework v0.0.10 MASTER_
+_Generated by AI-Enderun Framework v0.0.12 MASTER_

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.0.11 Master
+# Project Analyst & QA Gate — v0.0.12 Master
 
 **Role:** Maintain project memory, serve as a quality gate, and manage documentation. The following protocols are automatically applied in every task.
 
@@ -172,7 +172,7 @@ Use the `log_agent_action` tool to record your activities securely.
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 
 - 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.0.11 Master
+# Backend Architect — v0.0.12 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.
 
@@ -82,7 +82,7 @@ class DomainError extends Error {
 }
 class NotFoundError extends DomainError {
   constructor(entity: string) {
-    super("NOT_FOUND", 404, `${entity} not found.`);
+    super("NOT_FOUND", 404, entity + " not found.");
   }
 }
 class ValidationError extends DomainError {
@@ -233,7 +233,7 @@ When `shared-types` changes:
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 - 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.0.11 Master
+# Codebase Explorer — v0.0.12 Master
 
 **Role:** Analyze the codebase, map architectures, and understand system-wide dependencies. Your primary duty is to provide context to other agents.
 
@@ -79,7 +79,7 @@ Every research report must include:
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 
 - 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.0.11 Master
+# Frontend Architect — v0.0.12 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.
 
@@ -135,7 +135,7 @@ Frontend never creates its own types for backend data.
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 - 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.0.11 Master
+# Version Control Specialist (@git) — v0.0.12 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.
 
@@ -79,7 +79,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.0.10)
+### Agent Completion Report (v0.0.12)
 - 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.0.11 Master
+# Manager (CTO & Controller) — v0.0.12 Master
 
 **Role:** Enforce all framework rules without compromise and direct agents to the correct tasks. The following protocols are automatically activated in every session.
 
@@ -69,7 +69,7 @@ Trace ID: 01H... (26-character ULID)
 
 ---
 
-## Briefing Template v0.0.10 (Mandatory in Every Agent Directive)
+## Briefing Template v0.0.12 (Mandatory in Every Agent Directive)
 
 ```
 ## Agent Directive
@@ -157,7 +157,7 @@ graph TD
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 
 - 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.0.11 Master
+# Mobile Architect — v0.0.12 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.
 
@@ -44,7 +44,7 @@ Never start coding before understanding the current state of the components and
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 
 - 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.0.11 Master
+# Native Desktop Architect — v0.0.12 Master
 
 **Role:** Build secure and efficient desktop applications using Tauri or Electron. Ensure procedural continuity across the native codebase.
 
@@ -43,7 +43,7 @@ Always research the existing codebase and native bridge implementations before a
 
 ---
 
-**Agent Completion Report** (v0.0.10)
+**Agent Completion Report** (v0.0.12)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# AI-Enderun — Claude Code Adapter (v0.0.10)
+# AI-Enderun — Claude Code Adapter (v0.0.12)
 
 This file is the Claude Code adapter layer.
 Core framework rules and agent capabilities are defined in `{{FRAMEWORK_DIR}}/ENDERUN.md`.

package/CODEX.md

@@ -1,4 +1,4 @@
-# AI-Enderun — Codex Adapter (v0.0.10)
+# AI-Enderun — Codex Adapter (v0.0.12)
 
 This file is the Codex adapter layer.
 Core framework rules and agent capabilities are defined in `{{FRAMEWORK_DIR}}/ENDERUN.md`.

package/CURSOR.md

@@ -1,4 +1,4 @@
-# AI-Enderun — Cursor Adapter (v0.0.10)
+# AI-Enderun — Cursor Adapter (v0.0.12)
 
 This file is the Cursor adapter layer.
 Core framework rules and agent capabilities are defined in `{{FRAMEWORK_DIR}}/ENDERUN.md`.

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# AI-Enderun Constitution — v0.0.11 Master
+# AI-Enderun Constitution — v0.0.12 Master
 
 # Place in project root. This file is the single source of truth for all AI clients (Gemini CLI, Claude Code, etc.).
 
@@ -6,7 +6,7 @@
 
 - **Atomic Commits:** Each commit must represent a single, logical unit of change. No "fix" or "wip" commits allowed.
 - **Commit Message Format:** `[Type](Scope): Description` (e.g., `feat(api): add auth header validation`).
-- **Phase Snapshots:** Every transition between `STATE MACHINE` phases must be marked with a git tag corresponding to the phase name (e.g., `git tag -a v0.0.10-phase1`).
+- **Phase Snapshots:** Every transition between `STATE MACHINE` phases must be marked with a git tag corresponding to the phase name (e.g., `git tag -a v0.0.12-phase1`).
 - **Branching:** Use `feature/trace-id-short-description` for all task-based work.
 
 ---
@@ -69,4 +69,4 @@ All agent interactions are governed by 8 specialized roles found in `{{FRAMEWORK
 
 ---
 
-_Generated by AI-Enderun Framework v0.0.10 MASTER_
+_Generated by AI-Enderun Framework v0.0.12 MASTER_

package/GEMINI.md

@@ -1,4 +1,4 @@
-# AI-Enderun — General Agent Adapter (v0.0.10)
+# AI-Enderun — General Agent Adapter (v0.0.12)
 
 This file is the general adapter layer for AI agents (Gemini, GPT-4o, etc.).
 Core framework rules and agent capabilities are defined in `{{FRAMEWORK_DIR}}/ENDERUN.md`.

package/README.md

@@ -1,4 +1,4 @@
-# AI-Enderun (v0.0.11 Master)
+# AI-Enderun (v0.0.12 Master)
 
 [English](#english) | [Türkçe](#türkçe)
 
@@ -8,7 +8,7 @@
 
 AI-Enderun is a **Supreme Performance AI Orchestration Framework** designed to transform AI assistants into disciplined, specialized, and highly efficient engineering collaborators. It bridges the gap between raw AI capabilities and enterprise-grade engineering standards through a **Constitutional System**, **Persistent Project Memory**, and a **Multi-Agent Orchestration Layer**.
 
-Starting from **v0.0.11 Master**, the framework implements a **"Clean Root" Policy**, relocating all AI-specific logic, memory, and specialized instructions into hidden, adapter-specific directories (e.g., `.gemini/`, `.claude/`), preserving your project root for pure production code and requirements.
+Starting from **v0.0.12 Master**, the framework implements a **"Clean Root" Policy**, relocating all AI-specific logic, memory, and specialized instructions into hidden, adapter-specific directories (e.g., `.gemini/`, `.claude/`), preserving your project root for pure production code and requirements.
 
 ## 🎖️ Core Pillars
 
@@ -68,7 +68,7 @@ The **AI-Enderun MCP Server** exposes specialized tools to your AI assistant:
 
 AI-Enderun, yapay zeka yardımcılarını disiplinli, uzmanlaşmış ve yüksek verimli mühendislik ekip arkadaşlarına dönüştürmek için tasarlanmış **Üstün Performanslı AI Orkestrasyon Çerçevesidir**. Ham yapay zeka yetenekleri ile kurumsal düzeydeki mühendislik standartları arasındaki köprüyü; **Anayasal Sistem**, **Kalıcı Proje Hafızası** ve **Çoklu Ajan Orkestrasyon Katmanı** aracılığıyla kurar.
 
-**v0.0.11 Master** sürümünden itibaren, framework **"Temiz Kök Dizin" (Clean Root)** politikasını uygular; tüm AI mantığını, hafızasını ve uzman talimatlarını adaptöre özel gizli dizinlere (örn: `.gemini/`, `.claude/`) taşıyarak proje kök dizininizi sadece üretim kodu ve gereksinimler için korur.
+**v0.0.12 Master** sürümünden itibaren, framework **"Temiz Kök Dizin" (Clean Root)** politikasını uygular; tüm AI mantığını, hafızasını ve uzman talimatlarını adaptöre özel gizli dizinlere (örn: `.gemini/`, `.claude/`) taşıyarak proje kök dizininizi sadece üretim kodu ve gereksinimler için korur.
 
 ## 🎖️ Temel Sütunlar
 

package/bin/cli.js

@@ -11,7 +11,7 @@ const sourceDir = path.join(__dirname, "..");
 const targetDir = process.cwd();
 
 // --- CONSTANTS ---
-const FRAMEWORK_VERSION = "0.0.11";
+const FRAMEWORK_VERSION = getPackageVersion();
 
 // --- HELPER FUNCTIONS ---
 
@@ -126,7 +126,7 @@ function mergePackageJson(targetPath, sourcePath) {
 
   // Ensure basic fields
   if (!targetPkg.name) targetPkg.name = path.basename(process.cwd());
-  if (!targetPkg.version) targetPkg.version = "0.0.10";
+  if (!targetPkg.version) targetPkg.version = "0.0.12";
   if (!targetPkg.type) targetPkg.type = "module";
 
   // Add metadata

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Supreme AI Orchestration Framework — Senior Discipline & Ottoman Wisdom",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
@@ -58,7 +58,7 @@
     "typescript": "^5.7.3"
   },
   "enderun": {
-    "version": "0.0.10",
+    "version": "0.0.12",
     "initializedAt": "2026-05-08T17:50:01.387Z"
   }
 }

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

@@ -8,7 +8,7 @@ import crypto from "crypto";
 import { Project, SyntaxKind } from "ts-morph";
 const server = new Server({
     name: "ai-enderun-mcp",
-    version: "0.0.9",
+    version: "0.0.12",
 }, {
     capabilities: {
         tools: {},
@@ -40,7 +40,7 @@ const LOG_AGENT_ACTION_ARGS_SCHEMA = z.object({
     summary: z.string().min(1),
     details: z.record(z.any()).default({}),
 });
-const FRAMEWORK_VERSION = "0.0.9";
+const FRAMEWORK_VERSION = "0.0.12";
 function getFrameworkDir(projectRoot) {
     const adapters = [".gemini", ".claude", ".cursor", ".codex", ".enderun"];
     for (const adp of adapters) {

package/packages/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Enterprise-grade MCP Server for AI Agent Framework — Memory, Security & AST Intelligence",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "ai-enderun-shared-types",
-  "version": "0.0.10",
+  "name": "@ai-enderun/shared-types",
+  "version": "0.0.12",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {