agent-enderun 0.1.10 → 0.2.0

package/packages/shared-types/src/index.ts

@@ -1,74 +1,102 @@
 /**
- * Shared Types — AI-Enderun
- * All types in this package define the contract between backend and frontend.
- * Only @backend modifies this file; @frontend only reads/imports.
+ * Agent Enderun — Shared Types
+ * 
+ * This file is the Single Source of Truth for all Backend and Frontend communication.
+ * All IDs use the Branded Types pattern for type safety.
  */
 
-export type Brand<T, B> = T & { readonly _brand: B };
-
-export const createULID = (seedTime: number = Date.now()): string => {
-  return seedTime.toString(36) + Math.random().toString(36).substring(2, 10);
-};
-
-export type UserID = Brand<string, 'UserID'>;
-export type SessionID = Brand<string, 'SessionID'>;
+/**
+ * Branded Type Utility
+ */
+export type Brand<K, T> = K & { __brand: T };
 
-export const createUserID = (): UserID => `usr_${createULID()}` as UserID;
-export const createSessionID = (): SessionID => `sess_${createULID()}` as SessionID;
+/**
+ * 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">;
 
-export interface PaginationQuery {
-  page: number;
-  limit: number;
+/**
+ * Domain Models
+ */
+export interface User {
+  id: UserID;
+  email: string;
+  fullName: string;
+  role: "ADMIN" | "DEVELOPER" | "VIEWER";
+  createdAt: string;
 }
 
-export interface PaginatedResponse<T> {
-  data: T[];
-  total: number;
-  page: number;
-  limit: number;
-  hasMore: boolean;
+export interface UserProfile extends User {
+  avatarUrl?: string;
+  bio?: string;
+  preferences: Record<string, unknown>;
 }
 
-export interface ApiSuccess<T> {
-  success: true;
-  data: T;
-}
+/**
+ * Project Status Types
+ */
+export type ProjectPhase = "PHASE_0" | "PHASE_1" | "PHASE_2" | "PHASE_3" | "PHASE_4";
+export type ExecutionProfile = "Lightweight" | "Full";
 
-export interface ApiError {
-  success: false;
-  code: string;
-  message: string;
-  statusCode: number;
+export interface ProjectStatus {
+  phase: ProjectPhase;
+  profile: ExecutionProfile;
+  lastUpdate: string;
+  activeTraceId: TraceID | null;
+  blockers: string[];
 }
 
-export type ApiResponse<T> = ApiSuccess<T> | ApiError;
+/**
+ * Task Management Types
+ */
+export type TaskPriority = "P0" | "P1" | "P2" | "P3";
+export type TaskStatus = "PENDING" | "IN_PROGRESS" | "BLOCKED" | "COMPLETED" | "FAILED";
 
-export interface User {
-  id: UserID;
-  email: string;
-  name: string;
-  role: 'admin' | 'user';
+export interface Task {
+  id: TraceID;
+  description: string;
+  agent: AgentID;
+  priority: TaskPriority;
+  status: TaskStatus;
   createdAt: string;
   updatedAt: string;
 }
 
-export interface AuthResponseDTO {
-  user: User;
-  accessToken: string;
-  refreshToken: string;
-}
+/**
+ * Audit & Agent Logging Types
+ */
+export type ActionType = "CREATE" | "MODIFY" | "DELETE" | "RESEARCH" | "ORCHESTRATE";
+export type ActionStatus = "SUCCESS" | "FAILURE" | "WAITING";
 
-export interface LoginDTO {
-  email: string;
-  password: string;
+export interface AgentActionLog {
+  timestamp: string;
+  agent: AgentID;
+  action: ActionType;
+  requestId: TraceID | "—";
+  status: ActionStatus;
+  summary: string;
+  files?: string[];
+  details?: Record<string, unknown>;
 }
 
-export interface RegisterDTO {
-  email: string;
-  name: string;
-  password: string;
+/**
+ * API Response Wrappers
+ */
+export interface ApiResponse<T> {
+  data: T;
+  meta?: {
+    requestId: TraceID;
+    timestamp: string;
+  };
 }
 
-export interface RefreshTokenDTO {
-  refreshToken: string;
+export interface ApiError {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
 }

package/CHANGELOG.md

@@ -1,97 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [0.1.10] - 2026-05-09
-
-### Added
-- **Panda CSS Integration:** Transitioned from UnoCSS to Panda CSS for frontend styling.
-- **Auto-Scaffolding:** The `init` command now automatically adds Panda CSS dependencies and a `panda.config.ts` configuration to new projects.
-- **Atomic CSS support:** Enabled Attributify and Icons presets by default in the generated projects.
-
-
-## [0.1.0] - 2026-05-09
-
-### Fixed
-- **Clean Slate Initialization:** The `init` command now automatically detects and removes existing `package-lock.json` files in target directories before installation. This prevents `EUNSUPPORTEDPROTOCOL` errors caused by stale lockfiles from previous versions.
-- **Robust Protocol Sanitization:** Refined the regex for `workspace:` protocol removal to be more comprehensive across all configuration files.
-
-
-## [0.0.9] - 2026-05-09
-
-### Fixed
-- **NPM Bin Fix:** Corrected the `bin` field in `package.json` to ensure the `agent-enderun` command is correctly linked by NPM during installation. Removed the redundant `./` prefix that was causing validation warnings.
-
-
-## [0.0.8] - 2026-05-09
-
-### Fixed
-- **EUNSUPPORTEDPROTOCOL Final Fix:** Added global sanitization for the `workspace:` protocol in all text files (not just root package.json). This ensures cross-package dependencies work correctly after being copied.
-- **Lockfile Conflict Resolution:** The `init` command now explicitly skips `package-lock.json` files from the template to prevent registry conflicts during first install.
-
-
-## [0.0.7] - 2026-05-09
-
-### Added
-- **NPM Workspaces Support:** The `init` command now automatically adds the `workspaces` field to the target `package.json`. This ensures that a single `npm install` in the project root correctly installs all dependencies for `shared-types` and `framework-mcp`.
-
-### Fixed
-- **Build Path Issues:** Updated build scripts to use `npx tsc`, allowing them to find the TypeScript compiler even when dependencies are hoisted to the root `node_modules` in a workspace environment.
-
-
-## [0.0.6] - 2026-05-09
-
-### Fixed
-- **CLI Init Bug:** Fixed `ENOENT` error during `init` when remapping `.enderun` sub-files to adapter-specific directories (e.g., `.gemini`). Now correctly handles all nested framework files.
-
-
-## [0.0.5] - 2026-05-09
-
-### Fixed
-- **MCP SDK v1.29.0 Compatibility:** Updated import paths in `framework-mcp` to support latest SDK versions (ESM resolution fixes).
-- **Source Code Restoration:** Reconstructed missing `src/` directories and `tsconfig.json` for both `shared-types` and `framework-mcp` from compiled assets.
-- **Contract Synchronization:** Generated real SHA-256 hash for shared types in `contract.version.json`.
-- **EUNSUPPORTEDPROTOCOL Solved:** Added recursive `workspace:` protocol sanitization for all copied `package.json` files.
-- **Dynamic Build Scripts:** `enderun:build` script now uses the detected package manager dynamically.
-
-### Added
-- **Multi-Agent Adapters:** Added `GEMINI.md`, `CLAUDE.md`, `CURSOR.md`, and `CODEX.md` bridge files.
-- **Project Structure:** Added automatic creation of `.enderun/` core files (`STATUS.md`, `cli-commands.json`, `config.json`).
-- **NPM Package Discipline:** Added `files` field to root `package.json` to ensure clean distribution.
-
-
-### Changed
-- **Smart Package Manager Detection:** Added native `pnpm` detection (via `pnpm-lock.yaml` and `pnpm-workspace.yaml`).
-- **Standardized Execution:** Preferring `npm run` but respecting local lockfiles and environment overrides.
-- Simplified package manager detection to prefer local context and respect explicit overrides.
-
-## [0.0.3] - 2026-05-09
-
-### Fixed
-- Updated the package to `0.0.3` for npm republish and workspace-compatible CLI install behavior.
-
-## [0.0.2] - 2026-05-09
-
-### Fixed
-- Resolved CLI initialization crash in `npx agent-enderun init` when published package metadata omitted `devDependencies`.
-
-## [0.0.1] - 2026-05-09
-
-### Added
-- **Fresh Baseline:** Initial beta release of the Supreme AI Orchestration Framework.
-- **Optimized Distribution:** Lightweight package structure with pre-built assets.
-- **Multi-Adapter Support:** Full readiness for Gemini, Claude, Cursor, and Codex.
-
-### Fixed & Improved
-- **Module Resolution:** Switched to `bundler` resolution mode in all packages to solve ESM resolution issues in monorepos.
-- **Import Paths:** Removed explicit `.js` extensions from TypeScript source files to align with modern build standards.
-- **Package Management:** Professionalized `package.json` files; `main`, `module`, and `types` now point to `dist/` for better consumer compatibility.
-- **CLI Intelligence:** Enhanced `ai-enderun check` to correctly detect hoisted `node_modules` in monorepos.
-- **TypeScript Alignment:** Synchronized core dependencies (Zod, ts-morph, MCP SDK) to prevent type conflicts.
-- **Stability:** Removed deprecated `baseUrl` options causing warnings in newer TypeScript versions.
-- **Documentation Standards:** Fixed `ENDERUN.md` to point API contracts to `{{FRAMEWORK_DIR}}/docs/api/` for better agent alignment and cleaner project root.
-- **CLI Health:** Added API Registry verification to `ai-enderun check` command.
-- **NPM Compatibility:** Added automatic `workspace:` protocol sanitization during `init` to prevent `EUNSUPPORTEDPROTOCOL` errors.
-- **Documentation Update:** Expanded root README with a comprehensive project overview, architecture explanation, onboarding workflow, and package manager guidance.
-- **CLI Improvement:** Added robust package manager detection and explicit `AI_ENDERUN_PACKAGE_MANAGER` / `AI_ENDERUN_PM` override support.
-

package/CLAUDE.md

@@ -1,7 +0,0 @@
-# Agent Enderun — Claude Adapter
-
-This file is the entry point for Claude. The project's "Supreme Law" and all instructions are located in the following file:
-
-👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
-
-Please read that file thoroughly before taking any action.

package/CODEX.md

@@ -1,7 +0,0 @@
-# Agent Enderun — Codex Adapter
-
-This file is the entry point for Codex. The project's "Supreme Law" and all instructions are located in the following file:
-
-👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
-
-Please read that file thoroughly before taking any action.

package/CURSOR.md

@@ -1,7 +0,0 @@
-# Agent Enderun — Cursor Adapter
-
-This file is the entry point for Cursor. The project's "Supreme Law" and all instructions are located in the following file:
-
-👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
-
-Please read that file thoroughly before taking any action.

package/GEMINI.md

@@ -1,7 +0,0 @@
-# Agent Enderun — Gemini Adapter
-
-This file is the entry point for Gemini. The project's "Supreme Law" and all instructions are located in the following file:
-
-👉 **[{{FRAMEWORK_DIR}}/ENDERUN.md]({{FRAMEWORK_DIR}}/ENDERUN.md)**
-
-Please read that file thoroughly before taking any action.

package/docs/tech-stack.md

@@ -1,10 +0,0 @@
-# TECH STACK
-
-| Layer | Technology |
-| :--- | :--- |
-| Frontend | React 19 + Vite (SPA) |
-| Styling | Panda CSS |
-| Backend | Node.js (Fastify/Hono) |
-| Database | PostgreSQL (Kysely) |
-| Architecture | Contract-First (Shared Types) |
-| AI Adapter | Gemini / Claude / Cursor |

package/gemini-extension.json

@@ -1,5 +0,0 @@
-{
-  "name": "Agent Enderun",
-  "description": "Enterprise-grade AI orchestration framework for software teams.",
-  "instructions": "{{FRAMEWORK_DIR}}/ENDERUN.md"
-}

package/panda.config.ts

@@ -1,20 +0,0 @@
-import { defineConfig } from "@pandacss/dev"
-
-export default defineConfig({
-  // Whether to use css reset
-  preflight: true,
-  
-  // Where to look for your css declarations
-  include: ["./src/**/*.{js,jsx,ts,tsx}", "./pages/**/*.{js,jsx,ts,tsx}"],
-
-  // Files to exclude
-  exclude: [],
-
-  // Useful for theme customization
-  theme: {
-    extend: {}
-  },
-
-  // The output directory for your css system
-  outdir: "styled-system",
-})