agent-enderun 0.5.9 → 0.6.1

package/ENDERUN.md

@@ -1,10 +1,10 @@
-# Agent Enderun (v0.5.9)
+# Agent Enderun (v0.6.1)
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## 🎖️ AGENT CHECKLIST (MANDATORY BEFORE RESPONSE)
 > Check this list at the end of every response:
 > - [ ] **Zero Mock:** Did you use fake data or placeholders? (Strictly Forbidden)
-> - [ ] **Contract First:** Are `shared-types` and `contract.version.json` up to date?
+> - [ ] **Contract First:** Are the app's types and apps/backend/contract.version.json up to date?
 > - [ ] **Audit Log:** Did you log this action in `{{FRAMEWORK_DIR}}/logs/[agent].json`?
 > - [ ] **CLI Orchestration:** Does the action comply with `{{ADAPTER}} cli` rules?
 > - [ ] **No "..." allowed:** Did you write the code completely without omitting parts?
@@ -67,7 +67,7 @@ This file (`./{{ADAPTER}}.md`) and the `{{FRAMEWORK_DIR}}/docs/` folder represen
 - **Zero Temporary Storage & Single Source of Truth:** Storing, caching, or writing project details, logs, tasks, files, or agent planning documents (including implementation plans, scratch scripts, or intermediate tasks) in the operating system's temporary directory (`/tmp`, `/var/tmp`, `temp`, etc.) is strictly forbidden. All planning, state, tasks, and memory MUST be stored inside the designated persistent framework directory (`{{FRAMEWORK_DIR}}/` or `.{{ADAPTER}}/` etc.) or the project workspace. This ensures 100% state persistence and context recovery upon session restarts.
 - **Contract-First Agent Evolution:** Tools and SOPs used by agents must be defined via schemas and contracts first.
 - **Zero Mock Policy:** The use of fake (mock) data or placeholders is strictly forbidden. Every line of code must connect to a real endpoint or a typed contract. (Exception: Controlled mock usage is allowed for external 3rd party services like Stripe, Twilio).
-- **Branded Types Law:** All IDs (UserID, ProjectID, etc.) must be in the "Branded Types" format defined under `packages/shared-types`. Using plain strings or numbers is forbidden.
+- **Branded Types Law:** All IDs (UserID, ProjectID, etc.) must be in the "Branded Types" format defined in the app-local types (e.g., `apps/backend/src/types`). Using plain strings or numbers is forbidden.
 - **CLI-First Policy:** Due to the AI CLI Assistant focus, all outputs must be user-friendly (using Chalk, Clack, etc.) and stream-based. All commands must support the `--output json` flag and produce machine-readable output.
 - **Audit Logging Necessity:** Every critical action must be logged traceably under the `{{FRAMEWORK_DIR}}/logs/` folder.
 - **Design Continuity & Response Policy:** All UI changes MUST be responsive (Mobile-First + Fluid) and surgical. Unnecessary overhauls of existing layouts are strictly forbidden.
@@ -182,12 +182,12 @@ This file is the single source of truth for API stability. `@backend-architect`
 The development process follows a strict State Machine. Transition to the next phase is prohibited until the "Success Criteria" of the current phase is met.
 
 - **[STATE: PHASE_0] Discovery & Setup:** Profile selection (Lightweight/Full), requirement analysis, and validating `{{FRAMEWORK_DIR}}/docs/tech-stack.md`.
-- **[STATE: PHASE_1] Architecture & Contracts:** Setup of data models, API schemas, and `packages/shared-types`. Cannot proceed until Frontend and Backend approve these schemas.
+- **[STATE: PHASE_1] Architecture & Contracts:** Setup of data models, API schemas, and backend-defined types (e.g., apps/backend/src/types). Cannot proceed until Frontend and Backend approve these schemas.
 - **[STATE: PHASE_2] Core Development:** Active agents build core features in parallel based on the selected profile. (Under the apps/ folder)
 - **[STATE: PHASE_3] Integration & Testing:** System integration.
 - **[STATE: PHASE_4] Optimization & Deployment:** Performance audit and deployment.
 
-**Rollback Rule:** If a missing field or error is detected in the API schema (`shared-types`) during Phase 2 or later, the system immediately transitions to `[STATE: ROLLBACK_PHASE_1]`. All relevant agents stop their processes, switch to `WAITING` state, and cannot return to Phase 2 until the `backend-architect` resolves the issues.
+**Rollback Rule:** If a missing field or error is detected in the API schema (app types) during Phase 2 or later, the system immediately transitions to `[STATE: ROLLBACK_PHASE_1]`. All relevant agents stop their processes, switch to `WAITING` state, and cannot return to Phase 2 until the `backend-architect` resolves the issues.
 
 ---
 
@@ -217,13 +217,13 @@ CLI behaviors (logLevel, outputFormat, defaultProfile) are managed through this
 
 ## API VERSIONING STRATEGY
 
-All APIs are versioned via the URL path (`/api/v1/...`). The `packages/shared-types/contract.version.json` file uses the MAJOR.MINOR format, and must be updated with every change. The `@backend-architect` is responsible for its accuracy. The MAJOR version is incremented for every breaking change. Old versions continue to be supported for at least 1 MAJOR release.
+All APIs are versioned via the URL path (`/api/v1/...`). The `apps/backend/contract.version.json` file uses the MAJOR.MINOR format, and must be updated with every change. The `@backend-architect` is responsible for its accuracy. The MAJOR version is incremented for every breaking change. Old versions continue to be supported for at least 1 MAJOR release.
 
 ---
 
 ## PARALLEL EXECUTION & COORDINATION RULES
 
-1. **Shared-Types as Source of Truth:** All agents reference `packages/shared-types` and the `contract.version.json` file.
+1. **Backend Types as Source of Truth:** All agents reference the app-local types (e.g., `apps/backend/src/types`) and the `apps/backend/contract.version.json` file.
 2. **Commit-Level Logging:** Every agent must log every atomic change to the `{{FRAMEWORK_DIR}}/logs/[agent-name].json` file.
 3. **Implicit Dependency Lock:** If an agent's required output is not ready, it switches to `WAITING` state.
 4. **Ownership Enforcement:** Changes to files outside an agent's scope cannot be made without `@team-lead` approval.
@@ -236,3 +236,4 @@ All APIs are versioned via the URL path (`/api/v1/...`). The `packages/shared-ty
 7. **Phase Rollback Protocol:** If contracts are insufficient, return to Phase 1. All agents become `WAITING` and write `CONTRACT_CHANGED` to their log.
 8. **Next.js Ownership Rule:** `apps/web/api/` and `server/actions/` -> @backend-architect. `apps/web/(routes)/` and `components/` -> @frontend-specialist.
 9. **Zero Mock Test Policy:** Integration tests must use a real database or service-compatible test backend; do not rely on mocks for persistence behavior.
+.

package/README.md

@@ -1,4 +1,4 @@
-# 🏛️ Agent Enderun (v0.5.9) — The Supreme AI Governance Framework
+# 🏛️ Agent Enderun (v0.6.1) — The Supreme AI Governance Framework
 
 **The Supreme AI Governance & Orchestration Framework for Enterprise Development**
 
@@ -164,12 +164,10 @@ Agent Enderun consists of **4 integrated layers**:
 └── docs/api/               ← API contract specifications
 ```
 
-### Layer 2: Framework Core (bin/ + packages/)
+### Layer 2: Framework Core (bin/ + framework-mcp/)
 ```
 bin/cli.js                 ← CLI bootstrapper
-packages/
-├── framework-mcp/         ← 40+ MCP tools (12 categories)
-└── shared-types/          ← Branded types (single source of truth)
+framework-mcp/             ← 40+ MCP tools (13 categories) including Scaffolding
 ```
 
 ### Layer 3: Documentation (docs/)
@@ -317,28 +315,18 @@ agent-enderun/
 ├── bin/
 │   └── cli.js                         ← CLI entry point
 ├── docs/                              ← Your project docs (agents read these)
-│   ├── tech-stack.md
-│   └── project-docs.md
-├── packages/
-│   ├── shared-types/                  ← Branded types (contract)
-│   │   ├── src/index.ts
-│   │   └── contract.version.json      ← SHA-256 integrity hash
-│   └── framework-mcp/                 ← MCP server (40+ tools)
-│       └── src/tools/
-│           ├── academy.ts
-│           ├── codebase.ts
-│           ├── security.ts
-│           ├── contract.ts
-│           ├── git.ts
-│           ├── knowledge.ts
-│           ├── database.ts
-│           ├── memory.ts
-│           ├── messages.ts
-│           ├── repository.ts
-│           └── framework.ts
+├── framework-mcp/                     ← MCP server (40+ tools)
+│   └── src/tools/
+│       ├── scaffold.ts                ← Blueprint construction
+│       ├── academy.ts
+│       ├── codebase.ts
+│       └── [10 more...]
 ├── apps/                              ← Your applications (start here)
-│   ├── backend/                       ← (you create this)
-│   └── web/                           ← (you create this)
+│   ├── backend/
+│   │   ├── src/types/                 ← App-local contract types
+│   │   └── contract.version.json      ← SHA-256 integrity hash
+│   └── web/
+│       └── src/types/                 ← Frontend mirrors of backend types
 └── {{FRAMEWORK_DIR}}/                          ← Framework governance
     ├── ENDERUN.md                     ← Constitution (MANDATORY READ)
     ├── PROJECT_MEMORY.md              ← State machine
@@ -629,17 +617,9 @@ agent-enderun trace:new "Auth Modülü Uygula" backend P1
 ```
 agent-enderun/
 ├── docs/                 ← Ajanların okuyacağı dokümantasyon
-├── packages/
-│   ├── shared-types/     ← Paylaşılan türler (sözleşme)
-│   └── framework-mcp/    ← MCP sunucusu (40+ araç)
+├── framework-mcp/        ← MCP sunucusu (40+ araç)
 ├── apps/                 ← Uygulamalarınız (siz oluşturun)
 ├── {{FRAMEWORK_DIR}}/             ← Yönetişim dosyaları
-│   ├── ENDERUN.md        ← Anayasa (OKUNMALI)
-│   ├── PROJECT_MEMORY.md ← Proje durumu
-│   ├── agents/           ← 8 ajan tanımı
-│   ├── logs/             ← Denetim kaydı
-│   ├── knowledge/        ← 16+ rehber
-│   └── docs/api/         ← API sözleşmeleri
 └── bin/
     └── cli.js            ← CLI giriş noktası
 ```
@@ -748,3 +728,39 @@ All governance and engineering assets are consolidated under the framework direc
 
 ## 📜 License
 MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+unctional.
+-   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
+-   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
+-   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+
+---
+
+## 📜 License
+MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+/                     # CLI Entry Point
+├── packages/                # Shared Types & MCP Engine
+└── apps/                    # Production Modules (Backend, Web, Mobile)
+```
+
+---
+
+## 🛡️ Engineering Standards
+
+-   **Zero Mock Policy:** Placeholders are forbidden. Every line of code must be functional.
+-   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
+-   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
+-   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+
+---
+
+## 📜 License
+MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**
+lders are forbidden. Every line of code must be functional.
+-   **Branded Types:** IDs must be type-safe (e.g., `UserID` vs `string`).
+-   **Panda CSS Only:** Zero-runtime CSS-in-JS for high-performance UI.
+-   **Contract-First:** Schemas are defined in `shared-types` BEFORE implementation.
+
+---
+
+## 📜 License
+MIT © 2026 Yusuf BEKAR — **Agent Enderun: The Future of AI Governance.**

package/bin/cli.js

@@ -159,7 +159,7 @@ function mergePackageJson(targetPath, sourcePath) {
     "enderun:check": "agent-enderun check",
     "enderun:test": "vitest run",
     "enderun:test:watch": "vitest",
-    "enderun:build": `${runCmd} build --prefix packages/shared-types && ${runCmd} build --prefix packages/framework-mcp`,
+    "enderun:build": `${runCmd} build --prefix framework-mcp`,
   };
 
   const sourceDevDeps = sourcePkg.devDependencies || {};
@@ -183,7 +183,7 @@ function mergePackageJson(targetPath, sourcePath) {
   if (!targetPkg.name) targetPkg.name = path.basename(process.cwd());
   if (!targetPkg.version) targetPkg.version = "0.1.0";
   if (!targetPkg.type) targetPkg.type = "module";
-  if (!targetPkg.workspaces) targetPkg.workspaces = ["packages/*"];
+  if (!targetPkg.workspaces) targetPkg.workspaces = ["apps/*", "framework-mcp"];
 
   // Add metadata
   targetPkg.enderun = {
@@ -337,8 +337,7 @@ async function initCommand(selectedAdapter) {
     "package.json",
     "tsconfig.json",
     "panda.config.ts",
-    "packages/framework-mcp",
-    "packages/shared-types",
+    "framework-mcp",
   ];
 
   const DIRS_TO_CREATE = [
@@ -353,8 +352,7 @@ async function initCommand(selectedAdapter) {
     "apps/web",
     "apps/backend",
     "docs",
-    "packages/shared-types",
-    "packages/framework-mcp",
+    "framework-mcp",
   ];
 
   console.log(`🚀 Installing Agent Enderun (Adapter: ${selectedAdapter || "all"})...`);
@@ -384,6 +382,16 @@ async function initCommand(selectedAdapter) {
     Object.values(ADAPTERS).forEach(list => filesToProcess.push(...list));
   }
 
+  // Ensure apps/backend structure for contract file
+  ensureDir(path.join(targetDir, "apps/backend"));
+  const initContractPath = path.join(targetDir, "apps/backend/contract.version.json");
+  if (!fs.existsSync(initContractPath)) {
+    writeJsonFile(initContractPath, {
+      "contract_hash": "initial_hash_placeholder",
+      "last_updated": new Date().toISOString()
+    });
+  }
+
   // Detect target project scope
   let targetPkg = {};
   try {
@@ -407,7 +415,7 @@ async function initCommand(selectedAdapter) {
     let dest = path.join(targetDir, item);
     
     // FORCED CLEANUP: Delete existing framework engine directory to ensure clean update
-    if (["packages/framework-mcp"].includes(item)) {
+    if (["framework-mcp"].includes(item)) {
       if (fs.existsSync(dest)) {
         try {
           fs.rmSync(dest, { recursive: true, force: true });
@@ -432,7 +440,7 @@ async function initCommand(selectedAdapter) {
     if (fs.existsSync(src)) {
       if (fs.lstatSync(src).isDirectory()) {
         const skipFiles = (item === ".enderun") ? ["logs", "PROJECT_MEMORY.md", "PROJECT_MEMORY.lock"] : [];
-        const nonDestructive = ["packages/shared-types", "docs", ".enderun"].includes(item);
+        const nonDestructive = ["docs", ".enderun"].includes(item);
         copyDir(src, dest, new Set(skipFiles), nonDestructive, targetBase, targetScope);
       } else {
         if (item === "package.json") continue; // We merge it later
@@ -507,7 +515,7 @@ async function initCommand(selectedAdapter) {
       ext.mcpServers = {
         "agent-enderun": {
           command: "node",
-          args: ["packages/framework-mcp/dist/index.js"]
+          args: ["framework-mcp/dist/index.js"]
         }
       };
       fs.writeFileSync(geminiExtPath, JSON.stringify(ext, null, 2) + "\n");
@@ -519,7 +527,7 @@ async function initCommand(selectedAdapter) {
   }
 
   if (selectedAdapter === "claude") {
-    const mcpPath = path.join(targetDir, "packages/framework-mcp/src/index.ts");
+    const mcpPath = path.join(targetDir, "framework-mcp/src/index.ts");
     console.log("\n📝 Claude Code Setup:");
     console.log("To enable Agent Enderun tools in Claude Code, run this command:");
     console.log(`\x1b[36mclaude config add framework-mcp npx tsx ${mcpPath}\x1b[0m`);
@@ -612,8 +620,8 @@ function checkCommand() {
     { name: "Framework Config (config.json)", path: path.join(frameworkDir, "config.json") },
     { name: "Agent Status (STATUS.md)", path: path.join(frameworkDir, "STATUS.md") },
     { name: "MCP Config (mcp.json)", path: "mcp.json" },
-    { name: "Shared Types", path: "packages/shared-types/package.json" },
-    { name: "MCP Server", path: "packages/framework-mcp/package.json" },
+    { name: "Backend Contract", path: "apps/backend/contract.version.json" },
+    { name: "MCP Server", path: "framework-mcp/package.json" },
     { name: "Tech Stack", path: path.join(frameworkDir, "docs/tech-stack.md") },
     { name: "Panda CSS Config", path: "panda.config.ts" },
     { name: "Requirements", path: path.join(frameworkDir, "docs/project-docs.md") },
@@ -633,7 +641,7 @@ function checkCommand() {
   }
 
   // Dependency Check
-  const mcpNodeModules = path.join(process.cwd(), "packages/framework-mcp/node_modules");
+  const mcpNodeModules = path.join(process.cwd(), "framework-mcp/node_modules");
   const rootNodeModules = path.join(process.cwd(), "node_modules");
   if (!fs.existsSync(mcpNodeModules) && !fs.existsSync(rootNodeModules)) {
     console.log("❌ Dependencies MISSING! (Run 'npm install')");
@@ -643,7 +651,7 @@ function checkCommand() {
   }
 
   // MCP Build Check
-  const mcpPath = path.join(process.cwd(), "packages/framework-mcp/dist/index.js");
+  const mcpPath = path.join(process.cwd(), "framework-mcp/dist/index.js");
   if (!fs.existsSync(mcpPath)) {
     console.log("❌ MCP Build MISSING! (Run 'npm run enderun:build')");
     issues++;
@@ -857,11 +865,11 @@ function traceNewCommand(description, agent = "manager", priority = "P2") {
  * Verify the shared-types contract hash.
  */
 function verifyContractCommand() {
-  const sharedDir = path.join(targetDir, "packages/shared-types/src");
-  const contractPath = path.join(targetDir, "packages/shared-types/contract.version.json");
+  const sharedDir = path.join(targetDir, "apps/backend/src/types");
+  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
 
   if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) {
-    console.error("❌ Error: Shared types or contract.version.json not found.");
+    console.error("❌ Error: Backend types or contract.version.json not found.");
     return;
   }
 
@@ -953,7 +961,7 @@ function gitCommitCommand(traceId) {
     const files = cp.execSync("git diff --staged --name-only", { encoding: "utf8" }).split("\n").filter(Boolean);
     let type = "feat", scope = "code";
     if (files.some(f => f.includes(".md"))) type = "docs";
-    else if (files.some(f => f.includes("shared-types"))) type = "arch";
+    else if (files.some(f => f.includes("apps/backend/src/types"))) type = "arch";
     else if (files.some(f => f.includes("bin/cli.js"))) type = "fix";
     
     const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
@@ -1227,8 +1235,8 @@ function buildSharedTypesContent(existingContent) {
 }
 
 function updateContractHashFile() {
-  const sharedDir = path.join(targetDir, "packages/shared-types/src");
-  const contractPath = path.join(targetDir, "packages/shared-types/contract.version.json");
+  const sharedDir = path.join(targetDir, "apps/backend/src/types");
+  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
   if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) return;
 
   const walk = (dir) => fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
@@ -1250,7 +1258,186 @@ function updateContractHashFile() {
   fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2));
 }
 
+function createBaseTypeFiles(baseDir) {
+  const typesDir = path.join(baseDir, "types");
+  ensureDir(typesDir);
+
+  writeTextFile(path.join(typesDir, "api.ts"), `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;
+  };
+}
+`);
+
+  writeTextFile(path.join(typesDir, "brands.ts"), `/**
+ * 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">;
+`);
+
+  writeTextFile(path.join(typesDir, "constants.ts"), `import { TraceID } from "./brands.js";
+
+/**
+ * Project Phases
+ */
+export const PROJECT_PHASES = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"] as const;
+export type ProjectPhase = (typeof PROJECT_PHASES)[number];
+
+/**
+ * Execution Profiles
+ */
+export const EXECUTION_PROFILES = ["Lightweight", "Full"] as const;
+export type ExecutionProfile = (typeof EXECUTION_PROFILES)[number];
+
+/**
+ * Task Priorities
+ */
+export const TASK_PRIORITIES = ["P0", "P1", "P2", "P3"] as const;
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+
+/**
+ * Task Statuses
+ */
+export const TASK_STATUSES = ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"] as const;
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+
+/**
+ * Action Types & Status
+ */
+export const ACTION_TYPES = ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"] as const;
+export type ActionType = (typeof ACTION_TYPES)[number];
+
+export const ACTION_STATUSES = ["SUCCESS", "FAILURE", "WAITING"] as const;
+export type ActionStatus = (typeof ACTION_STATUSES)[number];
+`);
+
+  writeTextFile(path.join(typesDir, "index.ts"), `/**
+ * Agent Enderun — App-Local Types (Modular)
+ */
+
+export * from "./brands.js";
+export * from "./constants.js";
+export * from "./models.js";
+export * from "./api.js";
+export * from "./logs.js";
+`);
+
+  writeTextFile(path.join(typesDir, "logs.ts"), `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>;
+}
+`);
+
+  writeTextFile(path.join(typesDir, "models.ts"), `import { UserID, TraceID, AgentID } from "./brands.js";
+import { ProjectPhase, ExecutionProfile, TaskPriority, TaskStatus } from "./constants.js";
+
+/**
+ * Base Entity Fields
+ */
+export interface BaseEntity {
+  id: string; // Usually ULID
+  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;
+}
+`);
+  console.log(`✅ Base types created in ${path.relative(targetDir, typesDir)}`);
+}
+
 function createBackendFiles(spec) {
+  createBaseTypeFiles(path.join(targetDir, "apps/backend/src"));
+  writeJsonFile(path.join(targetDir, "apps/backend/contract.version.json"), {
+    "contract_hash": "initial_hash_placeholder",
+    "last_updated": new Date().toISOString()
+  });
   writeJsonFile(path.join(targetDir, "apps/backend/package.json"), {
     name: "@agent-enderun/backend",
     version: "0.1.0",
@@ -1290,7 +1477,7 @@ function createBackendFiles(spec) {
   });
 
   writeTextFile(path.join(targetDir, "apps/backend/src/data.ts"), [
-    'import type { Customer, DashboardSummary, ReportMetric, Role, User } from "../../../packages/shared-types/src/index.js";',
+    'import type { Customer, DashboardSummary, ReportMetric, Role, User } from "./types/index.js";',
     "",
     'const now = new Date().toISOString();',
     "",
@@ -1364,6 +1551,7 @@ function createBackendFiles(spec) {
 }
 
 function createWebFiles(spec) {
+  createBaseTypeFiles(path.join(targetDir, "apps/web/src"));
   writeJsonFile(path.join(targetDir, "apps/web/package.json"), {
     name: "@agent-enderun/web",
     version: "0.1.0",
@@ -1632,7 +1820,7 @@ function updateProjectDocs(spec) {
     "",
     "- `apps/backend`: Fastify API",
     "- `apps/web`: React dashboard",
-    "- `packages/shared-types`: Contract-first shared TypeScript types",
+    "- `apps/backend/src/types`: Contract-first backend TypeScript types",
   ].join("\n"));
 
   writeTextFile(path.join(apiDir, "README.md"), [
@@ -1658,7 +1846,7 @@ function updateMemoryForGeneratedApp(spec, traceId) {
     "- **Agent:** @manager",
     `- **Trace ID:** ${traceId}`,
     "- **Action:** Created full-stack starter from natural language request.",
-    "- **Files:** apps/backend, apps/web, shared-types, project docs",
+    "- **Files:** apps/backend, apps/web, project docs",
   ].join("\n");
 
   updateProjectMemoryCommand("HISTORY", history);
@@ -1693,10 +1881,10 @@ async function createAppCommand(args) {
   createWebFiles(spec);
   updateProjectDocs(spec);
 
-  const sharedTypesPath = path.join(targetDir, "packages/shared-types/src/index.ts");
-  if (fs.existsSync(sharedTypesPath)) {
-    const existing = fs.readFileSync(sharedTypesPath, "utf8");
-    fs.writeFileSync(sharedTypesPath, buildSharedTypesContent(existing));
+  const backendTypesPath = path.join(targetDir, "apps/backend/src/types/index.ts");
+  if (fs.existsSync(backendTypesPath)) {
+    const existing = fs.readFileSync(backendTypesPath, "utf8");
+    fs.writeFileSync(backendTypesPath, buildSharedTypesContent(existing));
     updateContractHashFile();
   }
 
@@ -1705,7 +1893,7 @@ async function createAppCommand(args) {
 
   console.log(`\n✅ Created ${spec.title}`);
   console.log("📁 Generated apps/backend and apps/web");
-  console.log("📜 Updated project docs and shared-types contract");
+  console.log("📜 Updated project docs and app-local types contract");
   console.log("\nNext commands:");
   console.log("  npm install");
   console.log("  npm run enderun:build");
@@ -1746,7 +1934,7 @@ async function main() {
       verifyContractCommand();
       break;
     case "mcp": {
-      const mcpServerPath = path.join(sourceDir, "packages/framework-mcp/dist/index.js");
+      const mcpServerPath = path.join(sourceDir, "framework-mcp/dist/index.js");
       if (fs.existsSync(mcpServerPath)) {
         const { spawn } = await import("child_process");
         // Use node to execute the built MCP server

package/bin/update-contract.js

@@ -12,8 +12,8 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.join(__dirname, "..");
 
-const contractPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
-const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+const contractPath = path.join(projectRoot, "apps/backend/contract.version.json");
+const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
 
 function collectTypeFiles(dir) {
   const entries = fs.readdirSync(dir, { withFileTypes: true });

package/{packages/framework-mcp → framework-mcp}/dist/schemas.js

@@ -98,3 +98,15 @@ export const SYNC_CONTRACT_HASH_ARGS_SCHEMA = z.object({
 export const VERIFY_FRAMEWORK_HEALTH_ARGS_SCHEMA = z.object({
     detailed: z.boolean().default(false),
 });
+export const INSTANTIATE_BLUEPRINT_ARGS_SCHEMA = z.object({
+    blueprintPath: z.string().min(1),
+    targetPath: z.string().min(1),
+});
+export const LIST_BLUEPRINTS_ARGS_SCHEMA = z.object({
+    category: z.enum(["backend", "frontend"]).optional(),
+});
+export const SAVE_AS_BLUEPRINT_ARGS_SCHEMA = z.object({
+    blueprintPath: z.string().min(1),
+    content: z.string().min(1),
+    description: z.string().optional(),
+});

package/{packages/framework-mcp → framework-mcp}/dist/tools/contract.js

@@ -44,8 +44,8 @@ export const contractTools = [
 export const contractHandlers = {
     verify_api_contract: async (args, projectRoot) => {
         try {
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
-            const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
+            const contractJsonPath = path.join(projectRoot, "apps/backend/contract.version.json");
             if (!fs.existsSync(sharedTypesDir) || !fs.existsSync(contractJsonPath))
                 return { content: [{ type: "text", text: "Missing shared-types directory or contract.version.json" }] };
             const currentHash = calculateContractHash(sharedTypesDir, projectRoot);
@@ -58,8 +58,8 @@ export const contractHandlers = {
     },
     update_contract_hash: async (args, projectRoot) => {
         try {
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
-            const contractJsonPath = path.join(projectRoot, "packages/shared-types/contract.version.json");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
+            const contractJsonPath = path.join(projectRoot, "apps/backend/contract.version.json");
             if (!fs.existsSync(sharedTypesDir))
                 return { content: [{ type: "text", text: "Missing shared-types directory" }] };
             const files = collectFilesRecursively(sharedTypesDir, new Set(["ts"])).sort();
@@ -83,7 +83,7 @@ export const contractHandlers = {
         try {
             const frameworkDir = getFrameworkDir(projectRoot);
             const apiDocPath = path.join(projectRoot, frameworkDir, "docs/api", `${parsed.data.domain}.md`);
-            const sharedTypesDir = path.join(projectRoot, "packages/shared-types/src");
+            const sharedTypesDir = path.join(projectRoot, "apps/backend/src/types");
             if (!fs.existsSync(apiDocPath))
                 return { content: [{ type: "text", text: `API documentation not found for domain: ${parsed.data.domain}` }] };
             if (!fs.existsSync(sharedTypesDir))

package/{packages/framework-mcp → framework-mcp}/dist/tools/framework.js

@@ -103,8 +103,9 @@ export const frameworkHandlers = {
         const missing = [];
         const frameworkDir = getFrameworkDir(projectRoot);
         const checkPaths = [
-            { path: "apps", type: "folder", optional: true },
-            { path: "packages/shared-types/src", type: "folder" },
+            { path: "apps/backend/src/types", type: "folder" },
+            { path: "apps/web/src/types", type: "folder" },
+            { path: "framework-mcp/src", type: "folder" },
             { path: path.join(frameworkDir, "docs/api"), type: "folder", optional: true },
             { path: ".env", type: "file", optional: true },
             { path: ".env.example", type: "file" },