agent-enderun 1.1.5 → 1.1.7

package/src/cli/utils/app.ts

@@ -1,849 +1,5 @@
-import fs from "fs";
-import path from "path";
-import { ensureDir, writeTextFile, writeJsonFile, computeTypesHash } from "../utils/fs.js";
-import { updateProjectMemory } from "./memory.js"; 
-import { slugifyName, titleCase } from "../utils/string.js";
-import { getConfiguredPaths, getMemoryPath } from "./memory.js";
-import { getDependencyVersions } from "./pkg.js";
-
-
-const targetDir = process.cwd(); // Assuming targetDir is process.cwd() in the CLI context
-
-export function inferAppSpec(description: string) {
-    const normalized = String(description || "").toLowerCase();
-    const isCrm = /\bcrm\b|customer|musteri|müşteri/.test(normalized);
-    const hasAuth = /auth|login|giris|giriş|signin|sign in|user|kullanici|kullanıcı|role|rol/.test(normalized);
-    const hasRoles = /role|rol|permission|yetki|admin/.test(normalized);
-    const hasReports = /report|rapor|analytics|dashboard|chart|metric/.test(normalized);
-    const appName = isCrm ? "crm-dashboard" : slugifyName(description).split("-").slice(0, 4).join("-");
-
-    return {
-        rawDescription: description,
-        appName,
-        title: isCrm ? "CRM Dashboard" : titleCase(appName),
-        domain: isCrm ? "CRM" : "Business",
-        modules: {
-            auth: hasAuth || isCrm,
-            users: hasAuth || hasRoles || isCrm,
-            roles: hasRoles || isCrm,
-            reports: hasReports || isCrm,
-        },
-    };
-}
-
-export function buildSharedTypesContent(existingContent: 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\";", // Using backticks for inner double quotes
-        "  annualValue: number;",
-        "  createdAt: string;",
-        "}",
-        "",
-        "export interface ReportMetric {",
-        "  id: ReportID;",
-        "  label: string;",
-        "  value: number;",
-        "  trend: \"UP\" | \"DOWN\" | \"FLAT\";", // Using backticks for inner double quotes
-        "}",
-        "",
-        "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() {
-    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) {
-    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.warn(`✅ Base types created in ${path.relative(targetDir, typesDir)}`);
-}
-
-export interface AppSpec {
-    rawDescription: string;
-    appName: string;
-    title: string;
-    domain: string;
-    modules: {
-        auth: boolean;
-        users: boolean;
-        roles: boolean;
-        reports: boolean;
-    };
-}
-
-export function createBackendFiles(spec: AppSpec) {
-    const pathsMap = getConfiguredPaths();
-    const backendDir = pathsMap.backend;
-    const { fastify, "@fastify/cors": fastifyCors, zod, "@types/node": typesNode, tsx, typescript, "vitest-backend": vitest } = getDependencyVersions();
-
-    createBaseTypeFiles(path.join(targetDir, backendDir, "src"));
-    writeJsonFile(path.join(targetDir, backendDir, "contract.version.json"), {
-        "contract_hash": "initial_hash_placeholder",
-        "last_updated": new Date().toISOString()
-    });
-    writeJsonFile(path.join(targetDir, backendDir, "package.json"), {
-        name: "@agent-enderun/backend",
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: {
-            dev: "tsx src/server.ts",
-            build: "tsc -p tsconfig.json",
-            start: "node dist/server.js",
-            test: "vitest run",
-        },
-        dependencies: {
-            "@fastify/cors": fastifyCors,
-            fastify: fastify,
-            zod: zod,
-        },
-        devDependencies: {
-            "@types/node": typesNode,
-            tsx: tsx,
-            typescript: typescript,
-            vitest: vitest,
-        },
-    });
-
-    writeJsonFile(path.join(targetDir, backendDir, "tsconfig.json"), {
-        extends: "../../tsconfig.json",
-        compilerOptions: {
-            outDir: "dist",
-            rootDir: "src",
-            module: "NodeNext",
-            moduleResolution: "NodeNext",
-            target: "ES2022",
-            strict: true,
-            skipLibCheck: true,
-        },
-        include: ["src/**/*.ts"],
-    });
-
-    const srcDir = path.join(targetDir, backendDir, "src");
-    ensureDir(path.join(srcDir, "database"));
-    ensureDir(path.join(srcDir, "repositories"));
-    ensureDir(path.join(srcDir, "services"));
-
-    writeTextFile(path.join(srcDir, "database/memoryDb.ts"), [
-        "import type { Customer, ReportMetric, Role, User } from \"../types/index.js\";",
-        "",
-        "const now = new Date().toISOString();",
-        "",
-        "export const rolesDb: Role[] = [",
-        "  { id: \"role_admin\" as Role[\"id\"], name: \"Admin\", permissions: [\"users:manage\", \"reports:view\", \"customers:manage\"] },",
-        "  { id: \"role_manager\" as Role[\"id\"], name: \"Manager\", permissions: [\"reports:view\", \"customers:manage\"] },",
-        "  { id: \"role_viewer\" as Role[\"id\"], name: \"Viewer\", permissions: [\"reports:view\"] },",
-        "];",
-        "",
-        "export const usersDb: User[] = [",
-        "  { id: \"user_1\" as User[\"id\"], email: \"admin@example.com\", fullName: \"Admin User\", role: \"ADMIN\", createdAt: now, updatedAt: now },",
-        "  { id: \"user_2\" as User[\"id\"], email: \"manager@example.com\", fullName: \"Sales Manager\", role: \"DEVELOPER\", createdAt: now, updatedAt: now },",
-        "];",
-        "",
-        "export const customersDb: Customer[] = [",
-        "  { id: \"customer_1\" as Customer[\"id\"], name: \"Northwind\", ownerId: usersDb[1].id, status: \"ACTIVE\", annualValue: 125000, createdAt: now, updatedAt: now },",
-        "  { id: \"customer_2\" as Customer[\"id\"], name: \"Acme Corp\", ownerId: usersDb[1].id, status: \"LEAD\", annualValue: 82000, createdAt: now, updatedAt: now },",
-        "  { id: \"customer_3\" as Customer[\"id\"], name: \"Globex\", ownerId: usersDb[0].id, status: \"AT_RISK\", annualValue: 54000, createdAt: now, updatedAt: now },",
-        "];",
-        "",
-        "export const reportsDb: ReportMetric[] = [",
-        "  { id: \"report_pipeline\" as ReportMetric[\"id\"], label: \"Pipeline\", value: 261000, trend: \"UP\" },",
-        "  { id: \"report_active_customers\" as ReportMetric[\"id\"], label: \"Active Customers\", value: 1, trend: \"FLAT\" },",
-        "  { id: \"report_risk\" as ReportMetric[\"id\"], label: \"At Risk\", value: 1, trend: \"DOWN\" },",
-        "];",
-    ].join("\n"));
-
-    writeTextFile(path.join(srcDir, "repositories/user.repository.ts"), [
-        "import { usersDb } from \"../database/memoryDb.js\";",
-        "import type { User } from \"../types/index.js\";",
-        "",
-        "export class UserRepository {",
-        "  async findAll(): Promise<User[]> {",
-        "    return usersDb.filter(u => !u.deletedAt);",
-        "  }",
-        "",
-        "  async findByEmail(email: string): Promise<User | null> {",
-        "    return usersDb.find(u => u.email === email && !u.deletedAt) || null;",
-        "  }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(srcDir, "repositories/customer.repository.ts"), [
-        "import { customersDb } from \"../database/memoryDb.js\";",
-        "import type { Customer } from \"../types/index.js\";",
-        "",
-        "export class CustomerRepository {",
-        "  async findAll(): Promise<Customer[]> {",
-        "    return customersDb.filter(c => !c.deletedAt);",
-        "  }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(srcDir, "repositories/role.repository.ts"), [
-        "import { rolesDb } from \"../database/memoryDb.js\";",
-        "import type { Role } from \"../types/index.js\";",
-        "",
-        "export class RoleRepository {",
-        "  async findAll(): Promise<Role[]> {",
-        "    return rolesDb;",
-        "  }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(srcDir, "repositories/report.repository.ts"), [
-        "import { reportsDb } from \"../database/memoryDb.js\";",
-        "import type { ReportMetric } from \"../types/index.js\";",
-        "",
-        "export class ReportRepository {",
-        "  async findAll(): Promise<ReportMetric[]> {",
-        "    return reportsDb;",
-        "  }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(srcDir, "services/dashboard.service.ts"), [
-        "import { UserRepository } from \"../repositories/user.repository.js\";",
-        "import { CustomerRepository } from \"../repositories/customer.repository.js\";",
-        "import { RoleRepository } from \"../repositories/role.repository.js\";",
-        "import { ReportRepository } from \"../repositories/report.repository.js\";",
-        "import type { DashboardSummary } from \"../types/index.js\";",
-        "",
-        "export class DashboardService {",
-        "  private userRepo = new UserRepository();",
-        "  private customerRepo = new CustomerRepository();",
-        "  private roleRepo = new RoleRepository();",
-        "  private reportRepo = new ReportRepository();",
-        "",
-        "  async getSummary(): Promise<DashboardSummary> {",
-        "    const [users, customers, roles, reports] = await Promise.all([",
-        "      this.userRepo.findAll(),",
-        "      this.customerRepo.findAll(),",
-        "      this.roleRepo.findAll(),",
-        "      this.reportRepo.findAll(),",
-        "    ]);",
-        "",
-        "    return { users, customers, roles, reports };",
-        "  }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, backendDir, "src/server.ts"), [
-        "import Fastify from \"fastify\";",
-        "import cors from \"@fastify/cors\";",
-        "import { z } from \"zod\";",
-        "import { UserRepository } from \"./repositories/user.repository.js\";",
-        "import { CustomerRepository } from \"./repositories/customer.repository.js\";",
-        "import { RoleRepository } from \"./repositories/role.repository.js\";",
-        "import { ReportRepository } from \"./repositories/report.repository.js\";",
-        "import { DashboardService } from \"./services/dashboard.service.js\";",
-        "",
-        "const app = Fastify({ logger: true });",
-        "await app.register(cors, { origin: true });",
-        "",
-        "const userRepo = new UserRepository();",
-        "const customerRepo = new CustomerRepository();",
-        "const roleRepo = new RoleRepository();",
-        "const reportRepo = new ReportRepository();",
-        "const dashboardService = new DashboardService();",
-        "",
-        "app.get(\"/health\", async () => ({ ok: true, service: \"agent-enderun-backend\" }));",
-        "app.get(\"/api/v1/dashboard\", async () => {",
-        "  const summary = await dashboardService.getSummary();",
-        "  return { data: summary };",
-        "});",
-        "app.get(\"/api/v1/users\", async () => {",
-        "  const users = await userRepo.findAll();",
-        "  return { data: users };",
-        "});",
-        "app.get(\"/api/v1/roles\", async () => {",
-        "  const roles = await roleRepo.findAll();",
-        "  return { data: roles };",
-        "});",
-        "app.get(\"/api/v1/customers\", async () => {",
-        "  const customers = await customerRepo.findAll();",
-        "  return { data: customers };",
-        "});",
-        "app.get(\"/api/v1/reports\", async (request, reply) => {",
-        "  interface QueryParams {",
-        "    page?: number;",
-        "    limit?: number;",
-        "  }",
-        "  const { page = 1, limit = 10 } = request.query as QueryParams;",
-        "  const reports = await reportRepo.findAll();",
-        "  const startIndex = (Number(page) - 1) * Number(limit);",
-        "  const endIndex = startIndex + Number(limit);",
-        "  const paginatedReports = reports.slice(startIndex, endIndex);",
-        "  reply.send({",
-        "    data: paginatedReports,",
-        "    meta: {",
-        "      total: reports.length,",
-        "      page: Number(page),",
-        "      limit: Number(limit),",
-        "    },",
-        "  });",
-        "});",
-        "",
-        "app.post(\"/api/v1/auth/login\", async (request, reply) => {",
-        "  const body = z.object({ email: z.string().email(), password: z.string().min(1) }).safeParse(request.body);",
-        "  if (!body.success) return reply.code(400).send({ error: { code: \"VALIDATION_ERROR\", message: \"Invalid login payload\" } });",
-        "",
-        "  const user = await userRepo.findByEmail(body.data.email);",
-        "  if (!user) {",
-        "    const allUsers = await userRepo.findAll();",
-        "    return { data: { user: allUsers[0], token: \"demo-token\", expiresAt: new Date(Date.now() + 3600000).toISOString() } };",
-        "  }",
-        "  return { data: { user, token: \"demo-token\", expiresAt: new Date(Date.now() + 3600000).toISOString() } };",
-        "});",
-        "",
-        "const port = Number(process.env.PORT || 4000);",
-        "await app.listen({ port, host: \"0.0.0.0\" });",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, backendDir, "README.md"), [
-        `# ${spec.title} Backend`,
-        "",
-        "Fastify API generated by Agent Enderun.",
-        "",
-        "## Commands",
-        "",
-        "- `npm run dev` strings",
-        "- `npm run build` strings",
-        "- `npm run test` strings",
-    ].join("\n"));
-}
-
-export function createWebFiles(spec: AppSpec) {
-    const pathsMap = getConfiguredPaths();
-    const frontendDir = pathsMap.frontend;
-    const { "@vitejs/plugin-react": vitePluginReact, vite, react, "react-dom": reactDom, "lucide-react": lucideReact, "@types/react": typesReact, "@types/react-dom": typesReactDom, typescript, "vitest-frontend": vitest } = getDependencyVersions();
-
-    createBaseTypeFiles(path.join(targetDir, frontendDir, "src"));
-    writeJsonFile(path.join(targetDir, frontendDir, "package.json"), {
-        name: "@agent-enderun/web",
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: {
-            dev: "vite --host 0.0.0.0",
-            build: "tsc -p tsconfig.json && vite build",
-            preview: "vite preview",
-            test: "vitest run",
-        },
-        dependencies: {
-            "@vitejs/plugin-react": vitePluginReact,
-            vite: vite,
-            react: react,
-            "react-dom": reactDom,
-            "lucide-react": lucideReact,
-        },
-        devDependencies: {
-            "@types/react": typesReact,
-            "@types/react-dom": typesReactDom,
-            typescript: typescript,
-            vitest: vitest,
-        },
-    });
-
-    writeJsonFile(path.join(targetDir, frontendDir, "tsconfig.json"), {
-        extends: "../../tsconfig.json",
-        compilerOptions: {
-            jsx: "react-jsx",
-            module: "NodeNext",
-            moduleResolution: "NodeNext",
-            target: "ES2022",
-            strict: true,
-            skipLibCheck: true,
-        },
-        include: ["src/**/*.ts", "src/**/*.tsx"],
-    });
-
-    writeTextFile(path.join(targetDir, frontendDir, "index.html"), [
-        "<div id=\"root\"></div>",
-        "<script type=\"module\" src=\"/src/main.tsx\"></script>",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, frontendDir, "src/main.tsx"), [
-        "import React from \"react\";",
-        "import { createRoot } from \"react-dom/client\";",
-        "import { App } from \"./App.js\";",
-        "import \"./styles.css\";",
-        "",
-        "createRoot(document.getElementById(\"root\") as HTMLElement).render(",
-        "  <React.StrictMode>",
-        "    <App />",
-        "  </React.StrictMode>,",
-        ");",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, frontendDir, "src/App.tsx"), [
-        "import { BarChart3, ShieldCheck, UsersRound } from \"lucide-react\";",
-        "",
-        "const metrics = [",
-        "  { label: \"Pipeline\", value: \"$261K\", tone: \"green\" },",
-        "  { label: \"Active customers\", value: \"18\", tone: \"blue\" },",
-        "  { label: \"At risk\", value: \"3\", tone: \"red\" },",
-        "];",
-        "",
-        "const customers = [",
-        "  { name: \"Northwind\", status: \"Active\", owner: \"Sales Manager\", value: \"$125K\" },",
-        "  { name: \"Acme Corp\", status: \"Lead\", owner: \"Sales Manager\", value: \"$82K\" },",
-        "  { name: \"Globex\", status: \"At risk\", owner: \"Admin User\", value: \"$54K\" },",
-        "];",
-        "",
-        "export function App() {",
-        "  return (",
-        "    <main className=\"shell\">",
-        "      <aside className=\"sidebar\" aria-label=\"Primary navigation\">",
-        "        <div className=\"brand\">AE</div>",
-        "        <nav>",
-        "          <a className=\"active\" href=\"#dashboard\"><BarChart3 size={18} /> Dashboard</a>",
-        "          <a href=\"#users\"><UsersRound size={18} /> Users</a>",
-        "          <a href=\"#roles\"><ShieldCheck size={18} /> Roles</a>",
-        "        </nav>",
-        "      </aside>",
-        "",
-        "      <section className=\"workspace\">",
-        "        <header className=\"topbar\">",
-        "          <div>",
-        `            <p>${spec.domain}</p>`,
-        `            <h1>${spec.title}</h1>`,
-        "          </div>",
-        "          <button type=\"button\">New customer</button>",
-        "        </header>",
-        "",
-        "        <section className=\"metrics\" aria-label=\"Report metrics\">",
-        "          {metrics.map((metric) => (",
-        "            <article className={`metric ${metric.tone}`} key={metric.label}>",
-        "              <span>{metric.label}</span>",
-        "              <strong>{metric.value}</strong>",
-        "            </article>",
-        "          ))}",
-        "        </section>",
-        "",
-        "        <section className=\"panel\">",
-        "          <div>",
-        "            <h2>Customers</h2>",
-        "            <p>Ownership, value and status at a glance.</p>",
-        "          </div>",
-        "          <div className=\"table\">",
-        "            {customers.map((customer) => (",
-        "              <div className=\"row\" key={customer.name}>",
-        "                <strong>{customer.name}</strong>",
-        "                <span>{customer.status}</span>",
-        "                <span>{customer.owner}</span>",
-        "                <b>{customer.value}</b>",
-        "              </div>",
-        "            ))}",
-        "          </div>",
-        "        </section>",
-        "      </section>",
-        "    </main>",
-        "  );",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, frontendDir, "src/styles.css"), [
-        ":root {",
-        "  color: #172026;",
-        "  background: #f4f7f6;",
-        "  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;",
-        "}",
-        "",
-        "* { box-sizing: border-box; }",
-        "body { margin: 0; }",
-        "button { font: inherit; }",
-        "",
-        ".shell {",
-        "  min-height: 100vh;",
-        "  display: grid;",
-        "  grid-template-columns: 240px 1fr;",
-        "}",
-        "",
-        ".sidebar {",
-        "  background: #102022;",
-        "  color: #eef6f2;",
-        "  padding: 24px;",
-        "}",
-        "",
-        ".brand {",
-        "  width: 40px;",
-        "  height: 40px;",
-        "  display: grid;",
-        "  place-items: center;",
-        "  background: #d8f36a;",
-        "  color: #102022;",
-        "  font-weight: 800;",
-        "  border-radius: 8px;",
-        "  margin-bottom: 32px;",
-        "}",
-        "",
-        "nav { display: grid; gap: 8px; }",
-        "nav a {",
-        "  color: inherit;",
-        "  text-decoration: none;",
-        "  display: flex;",
-        "  gap: 10px;",
-        "  align-items: center;",
-        "  padding: 10px 12px;",
-        "  border-radius: 8px;",
-        "}",
-        "nav a.active, nav a:hover { background: rgba(255,255,255,0.12); }",
-        "",
-        ".workspace { padding: 32px; }",
-        ".topbar {",
-        "  display: flex;",
-        "  justify-content: space-between;",
-        "  align-items: center;",
-        "  gap: 24px;",
-        "  margin-bottom: 24px;",
-        "}",
-        ".topbar p { margin: 0 0 4px; color: #58666a; font-size: 14px; }",
-        ".topbar h1 { margin: 0; font-size: 32px; letter-spacing: 0; }",
-        ".topbar button {",
-        "  border: 0;",
-        "  border-radius: 8px;",
-        "  background: #176b5d;",
-        "  color: white;",
-        "  padding: 10px 14px;",
-        "}",
-        "",
-        ".metrics {",
-        "  display: grid;",
-        "  grid-template-columns: repeat(3, minmax(0, 1fr));",
-        "  gap: 16px;",
-        "  margin-bottom: 24px;",
-        "}",
-        ".metric, .panel {",
-        "  background: white;",
-        "  border: 1px solid #d9e3e0;",
-        "  border-radius: 8px;",
-        "}",
-        ".metric { padding: 18px; }",
-        ".metric span { display: block; color: #58666a; margin-bottom: 8px; }",
-        ".metric strong { font-size: 28px; }",
-        ".metric.green { border-top: 4px solid #49a078; }",
-        ".metric.blue { border-top: 4px solid #3f7cac; }",
-        ".metric.red { border-top: 4px solid #d95d39; }",
-        "",
-        ".panel { padding: 20px; }",
-        ".panel h2 { margin: 0 0 4px; font-size: 20px; }",
-        ".panel p { margin: 0 0 18px; color: #58666a; }",
-        ".table { display: grid; gap: 8px; }",
-        ".row {",
-        "  display: grid;",
-        "  grid-template-columns: 1.4fr 0.8fr 1fr 0.6fr;",
-        "  gap: 16px;",
-        "  align-items: center;",
-        "  padding: 12px;",
-        "  border-radius: 8px;",
-        "  background: #f7faf9;",
-        "}",
-        "",
-        "@media (max-width: 760px) {",
-        "  .shell { grid-template-columns: 1fr; }",
-        "  .sidebar { position: static; }",
-        "  .metrics { grid-template-columns: 1fr; }",
-        "  .topbar { align-items: flex-start; flex-direction: column; }",
-        "  .row { grid-template-columns: 1fr; }",
-        "}",
-    ].join("\n"));
-
-    writeTextFile(path.join(targetDir, frontendDir, "README.md"), [
-        `# ${spec.title} Web`,
-        "",
-        "React dashboard generated by Agent Enderun.",
-        "",
-        "## Commands",
-        "",
-        "- `npm run dev` strings",
-        "- `npm run build` strings",
-        "- `npm run test` strings",
-
-    ].join("\n"));
-}
-
-export function updateProjectDocs(spec: AppSpec) {
-    const pathsMap = getConfiguredPaths();
-    const docsDir = path.join(targetDir, pathsMap.docs);
-    const apiDir = path.join(docsDir, "api");
-    ensureDir(apiDir);
-
-    writeTextFile(path.join(docsDir, "project-docs.md"), [
-        `# ${spec.title} Requirements`,
-        "",
-        "## Request",
-        "",
-        spec.rawDescription,
-        "",
-        "## Generated Scope",
-        "",
-        `- Domain: ${spec.domain}`,
-        `- Auth: ${spec.modules.auth ? "yes" : "no"}`,
-        `- Users: ${spec.modules.users ? "yes" : "no"}`,
-        `- Roles: ${spec.modules.roles ? "yes" : "no"}`,
-        `- Reports: ${spec.modules.reports ? "yes" : "no"}`,
-        "",
-        "## Architecture",
-        "",
-        `- \`${pathsMap.backend}\`: Fastify API`,
-        `- \`${pathsMap.frontend}\`: React dashboard`,
-        `- \`${pathsMap.backend}/src/types\`: Contract-first backend TypeScript types`,
-    ].join("\n"));
-
-    writeTextFile(path.join(apiDir, "README.md"), [
-        "# API Registry",
-        "",
-        "- `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`",
-    ].join("\n"));
-}
-
-export function updateMemoryForGeneratedApp(spec: AppSpec, traceId: string) {
-    const memoryPath = getMemoryPath();
-    if (!fs.existsSync(memoryPath)) return;
-
-    const pathsMap = getConfiguredPaths();
-    const today = new Date().toISOString().split("T")[0];
-    const history = [
-        `### ${today} — Generated ${spec.title}`,
-        "",
-        "- **Agent:** @manager",
-        `- **Trace ID:** ${traceId}`,
-        "- **Action:** Created full-stack starter from natural language request.",
-        `- **Files:** ${pathsMap.backend}, ${pathsMap.frontend}, project docs`,
-    ].join("\n");
-
-    updateProjectMemory("HISTORY", history);
-}
-
-export async function collectCreateAppDescription(args: string[]) {
-    const initial = args.join(" ").trim();
-    if (initial) return initial;
-
-    const readline = await import("readline/promises");
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const idea = await rl.question("What do you want to build? ");
-        const platform = await rl.question("Platform? (full-stack/web/backend) ");
-        const auth = await rl.question("Auth and roles? (yes/no) ");
-        const reports = await rl.question("Reports/dashboard? (yes/no) ");
-        return [idea, platform, auth.includes("y") ? "with auth and roles" : "", reports.includes("y") ? "with reports dashboard" : ""].filter(Boolean).join(" ");
-    } finally {
-        rl.close();
-    }
-}
-
-
+export * from "./app-inferrer.js";
+export * from "./app-types.js";
+export * from "./app-backend.js";
+export * from "./app-frontend.js";
+export * from "./app-docs.js";