agent-enderun 1.1.5 → 1.1.7

package/src/cli/utils/app-types.ts

@@ -0,0 +1,243 @@
+import fs from "fs";
+import path from "path";
+import { ensureDir, writeTextFile, writeJsonFile, computeTypesHash } from "./fs.js";
+import { getConfiguredPaths } from "./memory.js";
+import { UI } from "./ui.js";
+
+const targetDir = process.cwd();
+
+export function buildSharedTypesContent(existingContent: string): string {
+    const marker = "// --- Generated Application Contract ---";
+    const generated = [
+        marker,
+        "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[];",
+        "}",
+    ].join("\n");
+
+    if (existingContent.includes(marker)) return existingContent;
+    return `${existingContent.trim()}\n\n${generated}\n`;
+}
+
+export function updateContractHashFile(): void {
+    const pathsMap = getConfiguredPaths();
+    const sharedDir = path.join(targetDir, pathsMap.backend, "src/types");
+    const contractPath = path.join(targetDir, pathsMap.backend, "contract.version.json");
+    if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) return;
+
+    const currentHash = computeTypesHash(targetDir, sharedDir);
+
+    const contract = JSON.parse(fs.readFileSync(contractPath, "utf8"));
+    contract.contract_hash = currentHash;
+    contract.last_updated = new Date().toISOString();
+    fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2));
+}
+
+export function createBaseTypeFiles(baseDir: string): void {
+    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;
+}
+`);
+    UI.success(`Base types created in ${path.relative(targetDir, typesDir)}`);
+}