agent-enderun 0.5.8 → 0.6.0

package/.enderun/agents/manager.md

@@ -3,7 +3,7 @@ name: manager
 description: "CTO & Controller. Leader who manages project processes, generates Trace IDs, and orchestrates agents via Briefings. Responsible for Git Orchestration via the @git specialist. Reads {{FRAMEWORK_DIR}}/ENDERUN.md and {{FRAMEWORK_DIR}}/PROJECT_MEMORY.md in every session, validates the phase, and assigns agents."
 ---
 
-# Manager (CTO & Controller) — v0.5.8 Master
+# Manager (CTO & Controller) — v0.6.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.
 
@@ -168,7 +168,7 @@ graph TD
 **Agent Completion Report** (v0.5.8)
 
 - Mock used? [ ] No / [ ] Yes
-- shared-types changed? [ ] No / [ ] Yes
+- App types changed? [ ] No / [ ] Yes
 - **API contract checked? [ ] No / [ ] Yes → {{FRAMEWORK_DIR}}/docs/api/**
 - Log written? [ ] No / [ ] Yes → via log_agent_action tool
 - **PROJECT_MEMORY HISTORY updated? [ ] No / [ ] Yes**
@@ -177,3 +177,11 @@ graph TD
 - Blockers: [write if any, otherwise "NONE"]
 
 ---
+ise "NONE"]
+
+---
+--
+ needs to be done]
+- Blockers: [write if any, otherwise "NONE"]
+
+---

package/.enderun/agents/mobile.md

@@ -3,7 +3,7 @@ name: mobile
 description: "Mobile Application Expert. Specialist in React Native and Expo. Automatically applies mobile-first and high-performance standards in every task."
 ---
 
-# Mobile Architect — v0.5.8 Master
+# Mobile Architect — v0.6.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.
 

package/.enderun/agents/native.md

@@ -3,7 +3,7 @@ name: native
 description: "Native Application Expert. Specialist in Rust, Tauri, and Electron. Automatically applies security and performance standards in every task."
 ---
 
-# Native Desktop Architect — v0.5.8 Master
+# Native Desktop Architect — v0.6.0 Master
 
 **Role:** Build secure and efficient desktop applications using Tauri or Electron. Ensure procedural continuity across the native codebase.
 

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

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

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

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

package/.enderun/blueprints/backend/types/api.ts

@@ -0,0 +1,20 @@
+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/.enderun/blueprints/backend/types/brands.ts

@@ -0,0 +1,12 @@
+/**
+ * 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/.enderun/blueprints/backend/types/constants.ts

@@ -0,0 +1,34 @@
+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];

package/.enderun/blueprints/backend/types/index.ts

@@ -0,0 +1,49 @@
+/**
+ * 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";
+
+// --- Generated Application Contract ---
+export type RoleID = Brand<string, "RoleID">;
+export type ReportID = Brand<string, "ReportID">;
+export type CustomerID = Brand<string, "CustomerID">;
+
+export interface AuthSession {
+  user: User;
+  token: string;
+  expiresAt: string;
+}
+
+export interface Role {
+  id: RoleID;
+  name: string;
+  permissions: string[];
+}
+
+export interface Customer {
+  id: CustomerID;
+  name: string;
+  ownerId: UserID;
+  status: "LEAD" | "ACTIVE" | "AT_RISK";
+  annualValue: number;
+  createdAt: string;
+}
+
+export interface ReportMetric {
+  id: ReportID;
+  label: string;
+  value: number;
+  trend: "UP" | "DOWN" | "FLAT";
+}
+
+export interface DashboardSummary {
+  customers: Customer[];
+  users: User[];
+  roles: Role[];
+  reports: ReportMetric[];
+}

package/.enderun/blueprints/backend/types/logs.ts

@@ -0,0 +1,16 @@
+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/.enderun/blueprints/backend/types/models.ts

@@ -0,0 +1,65 @@
+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;
+}

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

@@ -0,0 +1,60 @@
+import { css, cx } from "../../../styled-system/css";
+import { type HTMLPandaProps } from "../../../styled-system/types";
+
+/**
+ * GOLDEN STANDARD: Button Component
+ * Uses Semantic Tokens for automatic theme support.
+ */
+export interface ButtonProps extends HTMLPandaProps<"button"> {
+  variant?: "primary" | "secondary" | "outline" | "ghost";
+  size?: "sm" | "md" | "lg";
+}
+
+export const Button = (props: ButtonProps) => {
+  const { variant = "primary", size = "md", className, ...rest } = props;
+
+  const buttonStyles = css({
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    fontWeight: "600",
+    borderRadius: "md",
+    cursor: "pointer",
+    transition: "all 0.2s ease",
+    _disabled: { opacity: 0.5, cursor: "not-allowed" },
+    _active: { transform: "scale(0.98)" },
+
+    // Size variants
+    ...(size === "sm" && { px: "3", py: "1.5", fontSize: "xs" }),
+    ...(size === "md" && { px: "4", py: "2", fontSize: "sm" }),
+    ...(size === "lg" && { px: "6", py: "3", fontSize: "md" }),
+
+    // Theme-aware Semantic Tokens
+    ...(variant === "primary" && {
+      bg: "accent.default",
+      color: "accent.fg",
+      _hover: { bg: "accent.emphasis" },
+    }),
+    ...(variant === "secondary" && {
+      bg: "bg.muted",
+      color: "text.default",
+      _hover: { bg: "border.default" },
+    }),
+    ...(variant === "outline" && {
+      bg: "transparent",
+      border: "1px solid",
+      borderColor: "border.default",
+      color: "text.default",
+      _hover: { bg: "bg.muted" },
+    }),
+    ...(variant === "ghost" && {
+      bg: "transparent",
+      color: "text.default",
+      _hover: { bg: "bg.muted" },
+    }),
+  });
+
+  return (
+    <button className={cx(buttonStyles, className)} {...rest} />
+  );
+};

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/docs/api/README.md

@@ -1,13 +1,8 @@
-# 📜 API Documentation Registry
+# API Registry
 
-This directory serves as the Single Source of Truth for all API endpoints and contracts.
-
-## 📂 Directory Structure
-- `auth.md`: Authentication & Authorization endpoints.
-- `users.md`: User profile and management.
-- `errors.md`: Standard error codes and troubleshooting.
-
-## ⚖️ Rules of Engagement
-1. **Contract-First**: Every document here MUST match the types in `packages/shared-types`.
-2. **Versioning**: Major changes require a version bump in `contract.version.json`.
-3. **Immutability**: Once a version is deployed, endpoints should not be modified without a migration path.
+- `POST /api/v1/auth/login`
+- `GET /api/v1/dashboard`
+- `GET /api/v1/users`
+- `GET /api/v1/roles`
+- `GET /api/v1/customers`
+- `GET /api/v1/reports`

package/.enderun/docs/project-docs.md

@@ -1,9 +1,19 @@
-# PROJECT REQUIREMENTS
+# CRM Dashboard Requirements
 
-| Requirement | Description | Status |
-| :--- | :--- | :--- |
-| Feature A | [Description] | PENDING |
-| Feature B | [Description] | PENDING |
+## Request
 
-## USER FEEDBACK & NOTES
-- Add any specific user requirements here.
+A CRM dashboard
+
+## Generated Scope
+
+- Domain: CRM
+- Auth: yes
+- Users: yes
+- Roles: yes
+- Reports: yes
+
+## Architecture
+
+- `apps/backend`: Fastify API
+- `apps/web`: React dashboard
+- `apps/backend/src/types`: Contract-first backend TypeScript types

package/.enderun/knowledge/blueprint_driven_construction.md

@@ -0,0 +1,22 @@
+# Blueprint-Driven Construction & Evolution
+
+## Overview
+Blueprint-Driven Construction is the primary method for building and expanding the Agent Enderun ecosystem. It ensures that every new application or feature is built upon a "Gold Standard" foundation.
+
+## Core Mechanics
+
+### 1. Discovering Capabilities
+Agents must use the `list_blueprints` tool to find existing architectural patterns, UI components, and logic hooks before writing any code.
+
+### 2. Instantiating Standards
+Once a blueprint is identified, the `instantiate_blueprint` tool is used to clone the template into the target application directory.
+- **Example:** Cloning `backend/errors` into `apps/backend/src/errors`.
+
+### 3. Dynamic Evolution (Capability Growth)
+When an agent develops a high-quality, reusable solution (e.g., a complex data table or a specific auth service), they MUST save it as a new blueprint using the `save_as_blueprint` tool.
+- **Goal:** The `blueprints/` directory is not static; it grows as the project tackles more complex challenges.
+
+## Guidelines for Agents
+- **Consistency first:** Always check for a blueprint before building from scratch.
+- **Refinement:** If an existing blueprint is outdated, update it via `save_as_blueprint` after a successful implementation.
+- **Documentation:** Always provide a description when saving a new blueprint to help other agents understand its purpose.

package/.enderun/knowledge/code_review_checklist.md

@@ -1,7 +1,7 @@
 # Code Review Checklist
 
 - [ ] Does it follow ENDERUN.md?
-- [ ] Are types imported from shared-types?
+- [ ] Are types imported from the app's local types directory?
 - [ ] Is there any Raw SQL usage?
 - [ ] Are unit tests included?
 - [ ] Is the code mobile-first (if UI)?

package/.enderun/knowledge/contract_versioning.md

@@ -1,7 +1,7 @@
-# Contract Versioning (v0.2.0)
+# Contract Versioning (v0.6.0)
 
 ## Workflow
-1. **Change**: Modify `packages/shared-types`.
-2. **Hash**: Generate new SHA-256 hash.
-3. **Sync**: Update `contract.version.json`.
-4. **Audit**: @analyst verifies the sync status.
+1. **Change**: Modify types in `apps/backend/src/types`.
+2. **Hash**: Generate new SHA-256 hash using the `update_contract_hash` tool.
+3. **Sync**: Update `apps/backend/contract.version.json`.
+4. **Audit**: @analyst verifies the sync status via the `verify_api_contract` tool.

package/ENDERUN.md

@@ -1,16 +1,39 @@
-# Agent Enderun (v0.5.8)
+# Agent Enderun (v0.6.0)
 # 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?
 
 ---
 
+## 🧠 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/`.
 
@@ -44,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.
@@ -159,7 +182,7 @@ 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.
@@ -194,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.