agent-enderun 0.5.8 → 0.5.9

package/.enderun/blueprints/frontend/ui/Input.tsx

@@ -0,0 +1,43 @@
+import { css, cx } from "../../../styled-system/css";
+import { type HTMLPandaProps } from "../../../styled-system/types";
+
+/**
+ * GOLDEN STANDARD: Input Component
+ * Fully theme-aware using semantic border and background tokens.
+ */
+export interface InputProps extends HTMLPandaProps<"input"> {
+  label?: string;
+}
+
+export const Input = (props: InputProps) => {
+  const { className, ...rest } = props;
+
+  const inputStyles = css({
+    width: "100%",
+    px: "4",
+    py: "2",
+    borderRadius: "md",
+    border: "1px solid",
+    borderColor: "border.default",
+    bg: "bg.canvas",
+    color: "text.default",
+    fontSize: "sm",
+    outline: "none",
+    transition: "all 0.2s ease",
+    _placeholder: { color: "text.muted" },
+    _focus: {
+      borderColor: "accent.default",
+      ring: "2px",
+      ringColor: "accent.default/20",
+    },
+    _disabled: {
+      opacity: 0.5,
+      cursor: "not-allowed",
+      bg: "bg.muted",
+    },
+  });
+
+  return (
+    <input className={cx(inputStyles, className)} {...rest} />
+  );
+};

package/.enderun/logs/manager.json

@@ -1,18 +1 @@
-[
-  {
-    "timestamp": "2026-05-19T14:14:17.722Z",
-    "agent": "manager",
-    "action": "Fixing framework persistence and configuration",
-    "requestId": "01KR6EJA6GG3RPS849097KS37Q",
-    "status": "SUCCESS",
-    "summary": "Updated gemini-extension.json, gemini.md and resolved ENDERUN.md placeholders."
-  },
-  {
-    "timestamp": "2026-05-19T14:46:49.828Z",
-    "agent": "manager",
-    "action": "Framework Restoration",
-    "requestId": "01KR6EJA6GG3RPS849097KS37Q",
-    "status": "SUCCESS",
-    "summary": "Restored framework-mcp and verified via link test."
-  }
-]
+[]

package/ENDERUN.md

@@ -1,4 +1,4 @@
-# Agent Enderun (v0.5.8)
+# Agent Enderun (v0.5.9)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
@@ -11,6 +11,29 @@
 
 ---
 
+## 🧠 INTELLIGENCE & DISCOVERY PROTOCOLS
+
+### 🔍 Architecture Discovery Protocol (ADP)
+When encountering a project, agents must never assume a specific folder structure. Use the following algorithm:
+1. **Entry Point Hunt:** Identify main entry points (`index.ts`, `main.ts`, `server.ts`) via `search_codebase`.
+2. **Business Logic Mapping:** Search for core domain keywords (e.g. `service`, `repository`, `controller`) to find where logic resides, regardless of directory names.
+3. **Contract Analysis:** Locate type definitions and API schemas to establish the "System Contract".
+4. **Adaptive Scaffolding:** Always propose architectural improvements or scaffolding *before* writing code. Wait for explicit User consent.
+
+---
+
+## 🪙 TOKEN ECONOMY & CONTEXT MANAGEMENT
+
+To minimize AI costs and maximize speed, all agents must adhere to the **Token Economy Protocol**:
+
+1. **Search Before Reading (MANDATORY):** Never `read_file` an entire directory or large file without searching for specific points of interest first.
+2. **Surgical Operations:** When editing, use the `replace` tool for targeted changes instead of overwriting entire files unless the file is very small (<50 lines).
+3. **Output Conciseness:** MCP tools must return the minimum required data. Avoid verbose logs or redundant status messages in tool outputs.
+4. **Context Compaction:** Before starting a new task, use `get_memory_insights` to retrieve only the relevant historical context.
+5. **No Blind Coding:** Stop and ask if a task requires reading more than 5 large files without a clear search result.
+
+---
+
 ## Constitution Status
 This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represent the "Supreme Law" of the project. All agents must read this file first in every session and strictly comply with its rules 100%. All framework-specific documentation is stored within `{{FRAMEWORK_DIR}}/docs/`.
 

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun (v0.5.8) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.5.9) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -12,7 +12,12 @@
 
 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.8: Persistent Memory & Zero-Temp Governance
+### 🚀 v0.5.9: Adaptive Discovery & Token Economy Protocol
+
+- **Architecture Discovery Protocol (ADP):** Seamlessly ingest and adapt to existing (legacy) projects without rigid directory requirements.
+- **Token Economy & Context Management:** Advanced rules to optimize AI context usage, reducing token costs by up to 40%.
+- **Choice-Based Scaffolding:** Empowering users with consent-driven project setup and architectural blueprints.
+- **Modular MCP Ecosystem:** 30+ enterprise-grade intelligence tools for AST-based analysis and security.
 - **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.
 

package/bin/update-contract.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+/* global console, process */
+/* eslint-disable no-console */
+
 import fs from "fs";
 import path from "path";
 import crypto from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-enderun",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "The Supreme AI Governance & Orchestration Framework for Enterprise Development",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -80,7 +80,7 @@
     "@pandacss/dev": "^0.53.0"
   },
   "enderun": {
-    "version": "0.5.8",
+    "version": "0.5.9",
     "initializedAt": "2026-05-19T14:23:38.760Z"
   },
   "dependencies": {}

package/packages/framework-mcp/dist/tools/contract.js

@@ -83,15 +83,21 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesPath = path.join(projectRoot, "packages/shared-types/src/index.ts");
+            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
             if (!fs.existsSync(apiDocPath))
                 return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
-            if (!fs.existsSync(sharedTypesPath))
-                return { content: [{ type: "text", text: "Shared types index.ts not found." }] };
-            const sourceFile = new Project().addSourceFileAtPath(sharedTypesPath);
-            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g)).map(m => m[1]).filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+            if (!fs.existsSync(sharedTypesDir))
+                return { content: [{ type: "text", text: "Shared types directory not found." }] };
+            const project = new Project();
+            project.addSourceFilesAtPaths(path.join(sharedTypesDir, "**/*.ts"));
+            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g))
+                .map(m => m[1])
+                .filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
             const uniqueTypes = Array.from(new Set(mentionedTypes));
-            const missingTypes = uniqueTypes.filter(t => !sourceFile.getInterface(t) && !sourceFile.getTypeAlias(t) && !sourceFile.getEnum(t) && !sourceFile.getClass(t));
+            const missingTypes = uniqueTypes.filter(t => {
+                const found = project.getSourceFiles().some(sf => sf.getInterface(t) || sf.getTypeAlias(t) || sf.getEnum(t) || sf.getClass(t));
+                return !found;
+            });
             return { content: [{ type: "text", text: `### CONTRACT INTEGRITY SHIELD: ${parsed.data.domain.toUpperCase()}\n\n` + `- **Missing/Undefined Types:** ${missingTypes.length > 0 ? `⚠️ ${missingTypes.join(", ")}` : "✅ All types synchronized"}\n\n` + `**Result:** ${missingTypes.length === 0 ? "PASSED" : "FAILED"}` }] };
         }
         catch (error) {

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

@@ -180,7 +180,8 @@ export const frameworkHandlers = {
             return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK\n\n${output}` }] };
         }
         catch (error) {
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${error.stdout || error.message}` }] };
+            const err = error;
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.stdout || err.message}` }] };
         }
     }
 };

package/packages/framework-mcp/dist/tools/knowledge.js

@@ -118,7 +118,7 @@ export const knowledgeHandlers = {
                 const label = metadata.title || id;
                 mermaid += `  ${id}["${label}"]\n`;
                 if (metadata.related) {
-                    const related = metadata.related.replace(/[\[\]]/g, "").split(",");
+                    const related = metadata.related.replace(/[[\]]/g, "").split(",");
                     related.forEach((r) => {
                         mermaid += `  ${id} --> ${r.trim().replace(".md", "")}\n`;
                     });

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.8";
+export const FRAMEWORK_VERSION = "0.5.9";
 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.8",
+  "version": "0.5.9",
   "description": "Enterprise-grade MCP Server for AI Agent Framework",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -25,6 +25,9 @@
     "dist",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "start": "node dist/index.js",

package/packages/framework-mcp/src/tools/contract.ts

@@ -83,13 +83,26 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesPath = path.join(projectRoot, "packages/shared-types/src/index.ts");
+            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+
             if (!fs.existsSync(apiDocPath)) return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
-            if (!fs.existsSync(sharedTypesPath)) return { content: [{ type: "text", text: "Shared types index.ts not found." }] };
-            const sourceFile = new Project().addSourceFileAtPath(sharedTypesPath);
-            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g)).map(m => m[1]).filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+            if (!fs.existsSync(sharedTypesDir)) return { content: [{ type: "text", text: "Shared types directory not found." }] };
+
+            const project = new Project();
+            project.addSourceFilesAtPaths(path.join(sharedTypesDir, "**/*.ts"));
+
+            const mentionedTypes = Array.from(fs.readFileSync(apiDocPath, "utf-8").matchAll(/`([^`]+)`/g))
+                .map(m => m[1])
+                .filter(t => /^[A-Z][a-zA-Z0-9]+(DTO|Response|Request|Status|Type)?$/.test(t));
+
             const uniqueTypes = Array.from(new Set(mentionedTypes));
-            const missingTypes = uniqueTypes.filter(t => !sourceFile.getInterface(t) && !sourceFile.getTypeAlias(t) && !sourceFile.getEnum(t) && !sourceFile.getClass(t));
+            const missingTypes = uniqueTypes.filter(t => {
+                const found = project.getSourceFiles().some(sf => 
+                    sf.getInterface(t) || sf.getTypeAlias(t) || sf.getEnum(t) || sf.getClass(t)
+                );
+                return !found;
+            });
+
             return { content: [{ type: "text", text: `### CONTRACT INTEGRITY SHIELD: ${parsed.data.domain.toUpperCase()}\n\n` + `- **Missing/Undefined Types:** ${missingTypes.length > 0 ? `⚠️ ${missingTypes.join(", ")}` : "✅ All types synchronized"}\n\n` + `**Result:** ${missingTypes.length === 0 ? "PASSED" : "FAILED"}` }] };
         } catch (error) {
             return { content: [{ type: "text", text: "Contract verification failed." }] };

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

@@ -174,8 +174,9 @@ export const frameworkHandlers = {
             const cliPath = path.join(projectRoot, "bin/cli.js");
             const output = execSync(`node ${cliPath} check`, { cwd: projectRoot, encoding: "utf-8", stdio: "pipe" });
             return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK\n\n${output}` }] };
-        } catch (error: any) {
-            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${error.stdout || error.message}` }] };
+        } catch (error: unknown) {
+            const err = error as { stdout?: string; message?: string };
+            return { content: [{ type: "text", text: `### FRAMEWORK HEALTH CHECK (FAILED)\n\n${err.stdout || err.message}` }] };
         }
     }
 };

package/packages/framework-mcp/src/tools/knowledge.ts

@@ -48,15 +48,15 @@ function parseFrontmatter(content: string) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     if (!match) return { metadata: {}, body: content };
     const yaml = match[1];
-    const metadata: Record<string, any> = {};
+    const metadata: Record<string, string | undefined> = {};
     yaml.split("\n").forEach(line => {
         const [key, ...val] = line.split(":");
         if (key && val.length > 0) metadata[key.trim()] = val.join(":").trim();
     });
     return { metadata, body: content.replace(match[0], "").trim() };
-}
+    }
 
-export const knowledgeHandlers = {
+    export const knowledgeHandlers = {
     search_knowledge_base: async (args: unknown, projectRoot: string) => {
         const parsed = SEARCH_KNOWLEDGE_BASE_ARGS_SCHEMA.safeParse(args ?? {});
         if (!parsed.success) return { content: [{ type: "text", text: "Invalid search query." }] };
@@ -64,12 +64,12 @@ export const knowledgeHandlers = {
             const frameworkDir = getFrameworkDir(projectRoot);
             const kbDir = path.join(projectRoot, frameworkDir, "knowledge");
             if (!fs.existsSync(kbDir)) return { content: [{ type: "text", text: "Knowledge base is empty." }] };
-            
+
             const query = parsed.data.query.toLowerCase();
             const results = fs.readdirSync(kbDir).filter(f => f.endsWith(".md")).map(file => {
                 const content = fs.readFileSync(path.join(kbDir, file), "utf-8");
                 const { metadata, body } = parseFrontmatter(content);
-                
+
                 const matchesQuery = body.toLowerCase().includes(query) || 
                                    file.toLowerCase().includes(query) ||
                                    (metadata.tags && metadata.tags.toLowerCase().includes(query)) ||
@@ -127,7 +127,7 @@ export const knowledgeHandlers = {
                 mermaid += `  ${id}["${label}"]\n`;
                 
                 if (metadata.related) {
-                    const related = metadata.related.replace(/[\[\]]/g, "").split(",");
+                    const related = metadata.related.replace(/[[\]]/g, "").split(",");
                     related.forEach((r: string) => {
                         mermaid += `  ${id} --> ${r.trim().replace(".md", "")}\n`;
                     });

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.8";
+export const FRAMEWORK_VERSION = "0.5.9";
 
 export function getFrameworkDir(projectRoot: string): string {
     const adapters = [".gemini", ".claude", ".cursor", ".enderun", ".codex"];

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

@@ -0,0 +1,18 @@
+import { TraceID } from "./brands.js";
+/**
+ * API Response Wrappers
+ */
+export interface ApiResponse<T> {
+    data: T;
+    meta?: {
+        requestId: TraceID;
+        timestamp: string;
+    };
+}
+export interface ApiError {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,13 @@
+/**
+ * Branded Type Utility
+ */
+export type Brand<K, T> = K & {
+    __brand: T;
+};
+/**
+ * Entity IDs (Branded)
+ */
+export type TraceID = Brand<string, "TraceID">;
+export type AgentID = Brand<string, "AgentID">;
+export type ProjectID = Brand<string, "ProjectID">;
+export type UserID = Brand<string, "UserID">;

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=brands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brands.js","sourceRoot":"","sources":["../src/brands.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,27 @@
+/**
+ * Project Phases
+ */
+export declare const PROJECT_PHASES: readonly ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+export type ProjectPhase = (typeof PROJECT_PHASES)[number];
+/**
+ * Execution Profiles
+ */
+export declare const EXECUTION_PROFILES: readonly ["Lightweight", "Full"];
+export type ExecutionProfile = (typeof EXECUTION_PROFILES)[number];
+/**
+ * Task Priorities
+ */
+export declare const TASK_PRIORITIES: readonly ["P0", "P1", "P2", "P3"];
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+/**
+ * Task Statuses
+ */
+export declare const TASK_STATUSES: readonly ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+/**
+ * Action Types & Status
+ */
+export declare const ACTION_TYPES: readonly ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"];
+export type ActionType = (typeof ACTION_TYPES)[number];
+export declare const ACTION_STATUSES: readonly ["SUCCESS", "FAILURE", "WAITING"];
+export type ActionStatus = (typeof ACTION_STATUSES)[number];

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

@@ -0,0 +1,22 @@
+/**
+ * Project Phases
+ */
+export const PROJECT_PHASES = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+/**
+ * Execution Profiles
+ */
+export const EXECUTION_PROFILES = ["Lightweight", "Full"];
+/**
+ * Task Priorities
+ */
+export const TASK_PRIORITIES = ["P0", "P1", "P2", "P3"];
+/**
+ * Task Statuses
+ */
+export const TASK_STATUSES = ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"];
+/**
+ * Action Types & Status
+ */
+export const ACTION_TYPES = ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"];
+export const ACTION_STATUSES = ["SUCCESS", "FAILURE", "WAITING"];
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAG/F;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,MAAM,CAAU,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAGjE;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGnG;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAG/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC"}

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

@@ -1,92 +1,11 @@
 /**
- * Agent Enderun — Shared Types
+ * Agent Enderun — Shared Types (Modular)
  *
  * This file is the Single Source of Truth for all Backend and Frontend communication.
- * All IDs use the Branded Types pattern for type safety.
+ * All modules are exported from here for central access.
  */
-/**
- * Branded Type Utility
- */
-export type Brand<K, T> = K & {
-    __brand: T;
-};
-/**
- * Entity IDs (Branded)
- */
-export type TraceID = Brand<string, "TraceID">;
-export type AgentID = Brand<string, "AgentID">;
-export type ProjectID = Brand<string, "ProjectID">;
-export type UserID = Brand<string, "UserID">;
-/**
- * Domain Models
- */
-export interface User {
-    id: UserID;
-    email: string;
-    fullName: string;
-    role: "ADMIN" | "DEVELOPER" | "VIEWER";
-    createdAt: string;
-}
-export interface UserProfile extends User {
-    avatarUrl?: string;
-    bio?: string;
-    preferences: Record<string, unknown>;
-}
-/**
- * Project Status Types
- */
-export type ProjectPhase = "PHASE_0" | "PHASE_1" | "PHASE_2" | "PHASE_3" | "PHASE_4";
-export type ExecutionProfile = "Lightweight" | "Full";
-export interface ProjectStatus {
-    phase: ProjectPhase;
-    profile: ExecutionProfile;
-    lastUpdate: string;
-    activeTraceId: TraceID | null;
-    blockers: string[];
-}
-/**
- * Task Management Types
- */
-export type TaskPriority = "P0" | "P1" | "P2" | "P3";
-export type TaskStatus = "PENDING" | "IN_PROGRESS" | "BLOCKED" | "COMPLETED" | "FAILED";
-export interface Task {
-    id: TraceID;
-    description: string;
-    agent: AgentID;
-    priority: TaskPriority;
-    status: TaskStatus;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Audit & Agent Logging Types
- */
-export type ActionType = "CREATE" | "MODIFY" | "DELETE" | "RESEARCH" | "ORCHESTRATE";
-export type ActionStatus = "SUCCESS" | "FAILURE" | "WAITING";
-export interface AgentActionLog {
-    timestamp: string;
-    agent: AgentID;
-    action: ActionType;
-    requestId: TraceID | "—";
-    status: ActionStatus;
-    summary: string;
-    files?: string[];
-    details?: Record<string, unknown>;
-}
-/**
- * API Response Wrappers
- */
-export interface ApiResponse<T> {
-    data: T;
-    meta?: {
-        requestId: TraceID;
-        timestamp: string;
-    };
-}
-export interface ApiError {
-    error: {
-        code: string;
-        message: string;
-        details?: unknown;
-    };
-}
+export * from "./brands.js";
+export * from "./constants.js";
+export * from "./models.js";
+export * from "./api.js";
+export * from "./logs.js";

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

@@ -1,8 +1,12 @@
 /**
- * Agent Enderun — Shared Types
+ * Agent Enderun — Shared Types (Modular)
  *
  * This file is the Single Source of Truth for all Backend and Frontend communication.
- * All IDs use the Branded Types pattern for type safety.
+ * All modules are exported from here for central access.
  */
-export {};
+export * from "./brands.js";
+export * from "./constants.js";
+export * from "./models.js";
+export * from "./api.js";
+export * from "./logs.js";
 //# 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;;;;;GAKG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,15 @@
+import { TraceID, AgentID } from "./brands.js";
+import { ActionType, ActionStatus } from "./constants.js";
+/**
+ * Audit & Agent Logging Types
+ */
+export interface AgentActionLog {
+    timestamp: string;
+    agent: AgentID;
+    action: ActionType;
+    requestId: TraceID | "—";
+    status: ActionStatus;
+    summary: string;
+    files?: string[];
+    details?: Record<string, unknown>;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,60 @@
+import { UserID, TraceID, AgentID } from "./brands.js";
+import { ProjectPhase, ExecutionProfile, TaskPriority, TaskStatus } from "./constants.js";
+/**
+ * Base Entity Fields
+ * All domain entities should include these fields.
+ */
+export interface BaseEntity {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * Audit Log Model
+ */
+export interface AuditLog extends BaseEntity {
+    entityName: string;
+    entityId: string;
+    action: "CREATE" | "UPDATE" | "DELETE" | "RESTORE";
+    userId: UserID;
+    previousState?: Record<string, unknown> | null;
+    newState?: Record<string, unknown> | null;
+    traceId: TraceID;
+}
+/**
+ * User Model
+ */
+export interface User extends BaseEntity {
+    id: UserID;
+    email: string;
+    fullName: string;
+    role: "ADMIN" | "DEVELOPER" | "VIEWER";
+}
+export interface UserProfile extends User {
+    avatarUrl?: string;
+    bio?: string;
+    preferences: Record<string, unknown>;
+}
+/**
+ * Project Status
+ */
+export interface ProjectStatus {
+    phase: ProjectPhase;
+    profile: ExecutionProfile;
+    lastUpdate: string;
+    activeTraceId: TraceID | null;
+    blockers: string[];
+}
+/**
+ * Task Model
+ */
+export interface Task {
+    id: TraceID;
+    description: string;
+    agent: AgentID;
+    priority: TaskPriority;
+    status: TaskStatus;
+    createdAt: string;
+    updatedAt: string;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":""}