ai-enderun 0.0.12 → 0.1.0

package/.enderun/ENDERUN.md

@@ -1,4 +1,4 @@
-# AI-Enderun Constitution — v0.0.12 Master
+# AI-Enderun Constitution — v0.1.0 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.12-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.1.0-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.12 MASTER_
+_Generated by AI-Enderun Framework v0.1.0 MASTER_

package/.enderun/PROJECT_MEMORY.md

@@ -1,12 +1,14 @@
 # PROJECT MEMORY — AI-Enderun
 
-This file is the Single Source of Truth (SSOT) and the persistent memory of the project.
+This file is the Single Source of Truth (SSOT).
+See [[ARCHIVE]] for completed tasks.
+See [[BRAIN_DASHBOARD]] for visualizations.
 
 ## CURRENT STATUS
 
 | Active Phase | Profile | Last Update | Active Trace ID | Blockers |
 | :----------- | :------ | :---------- | :-------------- | :------- |
-| PHASE_0      | Lightweight | 2026-05-09 | 01KR46D2M3X9V1T8Z4D7Z2L5K1 | NONE |
+| PHASE_1      | Lightweight | 2026-05-09 | 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Backend API contract & Auth Architecture |
 
 ## PROJECT DEFINITION
 
@@ -17,20 +19,20 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 | Frontend | React 19 + Vite + Zustand + Panda CSS |
 | Backend | Node.js 20+ + Fastify + Kysely |
 | DB | PostgreSQL |
-| Auth | Not yet defined |
+| Auth | TBD (Phase 1 Task) |
+
 ## ACTIVE TASKS
 
 | 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 |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Define Auth Architecture | @backend | P1 | PENDING |
+| 01KR46D2M3X9V1T8Z4D7Z2L5K1 | Phase 1 Architecture & Contract | @manager | P2 | IN_PROGRESS |
+
+## MILESTONES
+
+| Milestone | Target Date | Status |
+| :--- | :--- | :--- |
+| PHASE_1 Completion | 2026-05-16 | PENDING |
 
 ## CRITICAL DECISIONS
 
@@ -40,47 +42,14 @@ This file is the Single Source of Truth (SSOT) and the persistent memory of the
 - **Multi-AI Compatibility:** Avoid reserved keywords like `resource` in prompt templates.
 - **Automated Init:** CLI must handle `git init` and scaffolding autonomously.
 
-## HISTORY
+## HISTORY (Recent)
 
-### 2026-05-09 — v0.0.12 Stabilization & Cleanup (FINAL)
+### 2026-05-09 — Build Hardening & Reliability
 
 - **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
-- **Trace ID:** 01KR46D2M3X9V1T8Z4D7Z2L5K1
-- **Action:** Consolidated all stabilization fixes into v0.0.10. Fixed init pathing, linker placement, git automation, and Claude Code template validation. Synchronized all 8 agents and packages.
-- **Decision:** Released v0.0.10 as the definitive stable baseline for the framework.
-- **Next Step:** Ready for production-grade feature development.
-
-### 2026-05-08 — Major Structural & Clean Root Transition (v0.0.9)
-
-- **Agent:** @manager
-- **Trace ID:** 01KR46N2B7V1X9Z4M3D5G7H5L1
-- **Action:** Decoupled framework documentation from user project instructions. Moved assets to hidden folders.
-- **Next Step:** Finalize adapter-specific logic.
-
-### 2026-05-08 — Structural Alignment & Trace ID Correction
-
-- **Agent:** @manager
-- **Trace ID:** 01KR43EZD3BWKX08KHQ6EV7DHC
-- **Action:** Converted legacy UUIDs to ULID standard.
-- **Next Step:** Ready for Phase 1 Architecture.
+- **Action:** Updated package scripts to use `npx tsc -p tsconfig.json`. 
+- **Decision:** v0.1.0 is the stable baseline.
+- **Note:** Archive created in [[ARCHIVE.md]].
 
 ---
-
-_Generated by AI-Enderun Framework v0.0.12 MASTER_
+_Generated by AI-Enderun Framework v0.1.0 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.12 Master
+# Project Analyst & QA Gate — v0.1.0 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.12)
+**Agent Completion Report** (v0.1.0)
 
 - 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.12 Master
+# Backend Architect — v0.1.0 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.
 
@@ -233,7 +233,7 @@ When `shared-types` changes:
 
 ---
 
-**Agent Completion Report** (v0.0.12)
+**Agent Completion Report** (v0.1.0)
 - 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.12 Master
+# Codebase Explorer — v0.1.0 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.12)
+**Agent Completion Report** (v0.1.0)
 
 - 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.12 Master
+# Frontend Architect — v0.1.0 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.12)
+**Agent Completion Report** (v0.1.0)
 - 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.12 Master
+# Version Control Specialist (@git) — v0.1.0 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.12)
+### Agent Completion Report (v0.1.0)
 - 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.12 Master
+# Manager (CTO & Controller) — v0.1.0 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.12 (Mandatory in Every Agent Directive)
+## Briefing Template v0.1.0 (Mandatory in Every Agent Directive)
 
 ```
 ## Agent Directive
@@ -157,7 +157,7 @@ graph TD
 
 ---
 
-**Agent Completion Report** (v0.0.12)
+**Agent Completion Report** (v0.1.0)
 
 - 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.12 Master
+# Mobile Architect — v0.1.0 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.12)
+**Agent Completion Report** (v0.1.0)
 
 - 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.12 Master
+# Native Desktop Architect — v0.1.0 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.12)
+**Agent Completion Report** (v0.1.0)
 
 - Mock used? [ ] No / [ ] Yes
 - shared-types imported? [ ] No / [ ] Yes

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# AI-Enderun — Claude Code Adapter (v0.0.12)
+# AI-Enderun — Claude Code Adapter (v0.1.0)
 
 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.12)
+# AI-Enderun — Codex Adapter (v0.1.0)
 
 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.12)
+# AI-Enderun — Cursor Adapter (v0.1.0)
 
 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.12 Master
+# AI-Enderun Constitution — v0.1.0 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.12-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.1.0-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.12 MASTER_
+_Generated by AI-Enderun Framework v0.1.0 MASTER_

package/GEMINI.md

@@ -1,4 +1,4 @@
-# AI-Enderun — General Agent Adapter (v0.0.12)
+# AI-Enderun — General Agent Adapter (v0.1.0)
 
 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.12 Master)
+# AI-Enderun (v0.1.0 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.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.
+Starting from **v0.1.0 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.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.
+**v0.1.0 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
 
@@ -122,6 +122,8 @@ AI-Enderun, `.<adapter>/agents/` dizininde bulunan 8 uzman rolü yönetir:
 - **`verify_api_contract`:** Kodun paylaşılan API dökümantasyonuyla uyumunu doğrular.
 - **`log_agent_action`:** İzlenebilirlik için yapılandırılmış JSON logları kaydeder.
 
+> 💡 **Akıllı Entegrasyon:** Tüm MCP araçlarına `ai-enderun` CLI üzerinden de erişilebilir (örn: `npm run mcp log_agent_action ...`); bu, kısıtlı ortamlardaki ajanlar için sağlam bir yedek mekanizma sağlar.
+
 ---
 
 ## License

package/bin/cli.js

@@ -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.12";
+  if (!targetPkg.version) targetPkg.version = "0.1.0";
   if (!targetPkg.type) targetPkg.type = "module";
 
   // Add metadata
@@ -616,6 +616,87 @@ function verifyContractCommand() {
   }
 }
 
+function logAgentActionCommand(data) {
+  const frameworkDir = getFrameworkDir();
+  const logsDir = path.join(targetDir, frameworkDir, "logs");
+  if (!fs.existsSync(logsDir)) {
+    fs.mkdirSync(logsDir, { recursive: true });
+  }
+
+  const agent = normalizeAgentName(data.agent);
+  const logPath = path.join(logsDir, `${agent}.json`);
+  let logs = [];
+
+  if (fs.existsSync(logPath)) {
+    try {
+      logs = JSON.parse(fs.readFileSync(logPath, "utf8"));
+      if (!Array.isArray(logs)) logs = [];
+    } catch {
+      logs = [];
+    }
+  }
+
+  const newEntry = {
+    timestamp: new Date().toISOString(),
+    ...data,
+  };
+
+  logs.push(newEntry);
+  fs.writeFileSync(logPath, JSON.stringify(logs, null, 2));
+  console.log(`✅ Logged action to ${frameworkDir}/logs/${agent}.json`);
+}
+
+function updateProjectMemoryCommand(section, content) {
+  const memoryPath = getMemoryPath();
+  if (!fs.existsSync(memoryPath)) {
+    console.error("❌ Error: PROJECT_MEMORY.md not found.");
+    return;
+  }
+
+  const lockPath = `${memoryPath}.lock`;
+  if (!acquireMemoryLock(lockPath)) {
+    console.error("❌ Error: Memory lock timeout.");
+    return;
+  }
+
+  try {
+    let memoryContent = fs.readFileSync(memoryPath, "utf8");
+
+    if (section === "HISTORY") {
+      const headers = ["## HISTORY (Persistent Memory)", "## HISTORY"];
+      let sectionIndex = -1;
+      let headerUsed = "";
+      for (const h of headers) {
+        sectionIndex = memoryContent.indexOf(h);
+        if (sectionIndex !== -1) {
+          headerUsed = h;
+          break;
+        }
+      }
+      
+      if (sectionIndex === -1) {
+        console.error("❌ Error: HISTORY section not found.");
+        return;
+      }
+      const headerEnd = memoryContent.indexOf("\n", sectionIndex) + 1;
+      memoryContent = memoryContent.slice(0, headerEnd) + "\n" + content.trim() + "\n" + memoryContent.slice(headerEnd);
+    } else {
+      const escaped = section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`, "m");
+      if (!sectionRegex.test(memoryContent)) {
+        console.error(`❌ Error: Section not found: ${section}`);
+        return;
+      }
+      memoryContent = memoryContent.replace(sectionRegex, `## ${section}\n\n${content.trim()}\n`);
+    }
+
+    fs.writeFileSync(memoryPath, memoryContent);
+    console.log(`✅ Section ${section} updated in PROJECT_MEMORY.md`);
+  } finally {
+    releaseMemoryLock(lockPath);
+  }
+}
+
 // --- MAIN DISPATCHER ---
 
 async function main() {
@@ -638,6 +719,46 @@ async function main() {
     case "verify-contract":
       verifyContractCommand();
       break;
+    case "log_agent_action": {
+      // Handle both structured JSON and positional args
+      let data = {};
+      try {
+        if (args[0] && args[0].startsWith("{")) {
+          data = JSON.parse(args.join(" "));
+        } else {
+          data = {
+            agent: args[0],
+            action: args[1],
+            requestId: args[2],
+            status: args[3] || "SUCCESS",
+            summary: args[4] || "",
+          };
+        }
+      } catch (e) {
+        console.error("❌ Error parsing arguments for log_agent_action");
+        process.exit(1);
+      }
+      logAgentActionCommand(data);
+      break;
+    }
+    case "update_project_memory": {
+      let section, content;
+      try {
+        if (args[0] && args[0].startsWith("{")) {
+          const data = JSON.parse(args.join(" "));
+          section = data.section;
+          content = data.content;
+        } else {
+          section = args[0];
+          content = args.slice(1).join(" ");
+        }
+      } catch (e) {
+        console.error("❌ Error parsing arguments for update_project_memory");
+        process.exit(1);
+      }
+      updateProjectMemoryCommand(section, content);
+      break;
+    }
     case "check":
       checkCommand();
       break;

package/docs/api/README.md

@@ -0,0 +1,23 @@
+# API Documentation
+
+## Authentication Architecture
+
+**Decision:** Stateless JWT (JSON Web Token) with Short-Lived Access Tokens and Long-Lived Refresh Tokens.
+
+### Reasoning
+- **Scalability:** Stateless authentication is highly scalable and fits well with Fastify.
+- **Security:** Access tokens are short-lived (e.g., 15 minutes) and stored in memory on the frontend. Refresh tokens are HTTP-only, Secure cookies.
+
+### Endpoints (Draft)
+
+- `POST /api/auth/register` (Body: `RegisterDTO`, Response: `AuthResponseDTO`)
+- `POST /api/auth/login` (Body: `LoginDTO`, Response: `AuthResponseDTO`)
+- `POST /api/auth/refresh` (Cookie: `refreshToken`, Response: `AuthResponseDTO`)
+- `POST /api/auth/logout` (Clears cookies)
+- `GET /api/users/me` (Header: `Authorization: Bearer <accessToken>`, Response: `User`)
+
+### Data Contracts
+Defined in `packages/shared-types/src/index.ts`.
+
+---
+*Updated: 2026-05-09*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun",
-  "version": "0.0.12",
+  "version": "0.1.0",
   "description": "Supreme AI Orchestration Framework — Senior Discipline & Ottoman Wisdom",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
@@ -23,6 +23,10 @@
   "bin": {
     "ai-enderun": "bin/cli.js"
   },
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
   "files": [
     "bin",
     "docs",
@@ -42,9 +46,12 @@
   "scripts": {
     "build": "npm run build --prefix packages/shared-types && npm run build --prefix packages/framework-mcp",
     "dev": "npm run mcp:dev",
+    "mcp": "node bin/cli.js",
     "mcp:dev": "npx tsx packages/framework-mcp/src/index.ts",
     "mcp:status": "npx socraticode status",
+    "contract:update": "node -e \"const fs=require('fs');const path=require('path');const crypto=require('crypto');const dir='packages/shared-types/src';const contractPath='packages/shared-types/contract.version.json';const walk=(d)=>fs.readdirSync(d,{withFileTypes:true}).flatMap((e)=>{const p=path.join(d,e.name);return e.isDirectory()?walk(p):(p.endsWith('.ts')?[p]:[])});const files=walk(dir).sort();const h=crypto.createHash('sha256');for(const f of files)h.update(fs.readFileSync(f));const newHash=h.digest('hex');const contractData=JSON.parse(fs.readFileSync(contractPath,'utf8'));contractData.contract_hash=newHash;contractData.updated_at=new Date().toISOString();fs.writeFileSync(contractPath,JSON.stringify(contractData,null,2));console.log('Contract hash updated to:',newHash);\"",
     "verify-contract": "node -e \"const fs=require('fs');const path=require('path');const crypto=require('crypto');const dir='packages/shared-types/src';const contract='packages/shared-types/contract.version.json';const walk=(d)=>fs.readdirSync(d,{withFileTypes:true}).flatMap((e)=>{const p=path.join(d,e.name);return e.isDirectory()?walk(p):(p.endsWith('.ts')?[p]:[])});const files=walk(dir).sort();const h=crypto.createHash('sha256');for(const f of files)h.update(fs.readFileSync(f));const current=h.digest('hex');const stored=JSON.parse(fs.readFileSync(contract,'utf8')).contract_hash;if(current!==stored){console.error('HASH MISMATCH');process.exit(1)}console.log('Contract hash verified');\"",
+    "postinstall": "npm run build",
     "prepublishOnly": "npm run build",
     "version": "npm run build && git add .",
     "postversion": "git push && git push --tags",
@@ -55,10 +62,10 @@
   },
   "devDependencies": {
     "tsx": "^4.19.4",
-    "typescript": "^5.7.3"
+    "typescript": "^5.9.3"
   },
   "enderun": {
-    "version": "0.0.12",
+    "version": "0.1.0",
     "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.12",
+    version: "0.1.0",
 }, {
     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.12";
+const FRAMEWORK_VERSION = "0.1.0";
 function getFrameworkDir(projectRoot) {
     const adapters = [".gemini", ".claude", ".cursor", ".codex", ".enderun"];
     for (const adp of adapters) {
@@ -737,7 +737,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 }));
                 let memoryContent = fs.readFileSync(memoryPath, "utf-8");
                 if (section === "HISTORY") {
-                    memoryContent = prependToSection(memoryContent, "HISTORY (Persistent Memory)", content);
+                    let updated = false;
+                    const headers = ["HISTORY (Persistent Memory)", "HISTORY"];
+                    for (const h of headers) {
+                        try {
+                            memoryContent = prependToSection(memoryContent, h, content);
+                            updated = true;
+                            break;
+                        }
+                        catch (e) {
+                            // try next header
+                        }
+                    }
+                    if (!updated)
+                        throw new Error("HISTORY section not found.");
                 }
                 else if (section === "CURRENT STATUS") {
                     memoryContent = replaceSectionContent(memoryContent, "CURRENT STATUS", content);

package/packages/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-enderun-mcp",
-  "version": "0.0.12",
+  "version": "0.1.0",
   "description": "Enterprise-grade MCP Server for AI Agent Framework — Memory, Security & AST Intelligence",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "npx tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts"

package/packages/shared-types/dist/index.d.ts

@@ -33,4 +33,29 @@ export interface ApiError {
     statusCode: number;
 }
 export type ApiResponse<T> = ApiSuccess<T> | ApiError;
+export interface User {
+    id: UserID;
+    email: string;
+    name: string;
+    role: 'admin' | 'user';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AuthResponseDTO {
+    user: User;
+    accessToken: string;
+    refreshToken: string;
+}
+export interface LoginDTO {
+    email: string;
+    password: string;
+}
+export interface RegisterDTO {
+    email: string;
+    name: string;
+    password: string;
+}
+export interface RefreshTokenDTO {
+    refreshToken: string;
+}
 //# sourceMappingURL=index.d.ts.map

package/packages/shared-types/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAMrD,eAAO,MAAM,UAAU,GAAI,WAAU,MAAmB,KAAG,MAY1D,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAGnD,eAAO,MAAM,YAAY,QAAO,MAAgC,CAAC;AACjE,eAAO,MAAM,eAAe,QAAO,SAAsC,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAMrD,eAAO,MAAM,UAAU,GAAI,WAAU,MAAmB,KAAG,MAY1D,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAGnD,eAAO,MAAM,YAAY,QAAO,MAAgC,CAAC;AACjE,eAAO,MAAM,eAAe,QAAO,SAAsC,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AAItD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/packages/shared-types/dist/index.js

@@ -22,22 +22,4 @@ export const createULID = (seedTime = Date.now()) => {
 // ─── ID Generators (Runtime) ──────────────────────────────────────────────────
 export const createUserID = () => createULID();
 export const createSessionID = () => createULID();
-// ─── Domain Types (Add here when project development starts) ──────────────────
-// Example:
-// export interface User {
-//   id: UserID;
-//   email: string;
-//   name: string;
-//   createdAt: string; // ISO-8601
-// }
-//
-// export interface CreateUserDTO {
-//   email: string;
-//   name: string;
-//   password: string;
-// }
-//
-// export interface UpdateUserDTO {
-//   name?: string;
-// }
 //# sourceMappingURL=index.js.map

package/packages/shared-types/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,kFAAkF;AAClF,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAmB,IAAI,CAAC,GAAG,EAAE,EAAU,EAAE;IAClE,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;QACpD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAKF,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,UAAU,EAAY,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAc,EAAE,CAAC,UAAU,EAAe,CAAC;AAkC1E,iFAAiF;AACjF,WAAW;AACX,0BAA0B;AAC1B,gBAAgB;AAChB,mBAAmB;AACnB,kBAAkB;AAClB,mCAAmC;AACnC,IAAI;AACJ,EAAE;AACF,mCAAmC;AACnC,mBAAmB;AACnB,kBAAkB;AAClB,sBAAsB;AACtB,IAAI;AACJ,EAAE;AACF,mCAAmC;AACnC,mBAAmB;AACnB,IAAI"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,kFAAkF;AAClF,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAmB,IAAI,CAAC,GAAG,EAAE,EAAU,EAAE;IAClE,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;QACpD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAKF,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,UAAU,EAAY,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG,GAAc,EAAE,CAAC,UAAU,EAAe,CAAC"}

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-enderun/shared-types",
-  "version": "0.0.12",
+  "version": "0.1.0",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "author": "Yusuf BEKAR <ybekar@msn.com>",
   "repository": {
@@ -16,9 +16,9 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
-    "typecheck": "tsc --noEmit"
+    "build": "npx tsc -p tsconfig.json",
+    "build:watch": "npx tsc -p tsconfig.json --watch",
+    "typecheck": "npx tsc -p tsconfig.json --noEmit"
   },
   "keywords": [
     "typescript",