agent-enderun 1.1.6 → 1.1.8

package/src/cli/commands/status.ts

@@ -3,6 +3,7 @@ import path from "path";
 import chalk from "chalk";
 
 import { getMemoryPath, getFrameworkDir } from "../utils/memory.js";
+import { logger } from "../../shared/logger.js";
 
 /**
  * Print the current framework status.
@@ -77,8 +78,8 @@ export function statusCommand() {
                     }
                 });
             }
-        } catch {
-            // Ignore status read errors
+        } catch (err) {
+            logger.debug("Failed to read army status file", err);
         }
     }
 

package/src/cli/index.ts

@@ -62,9 +62,10 @@ async function main() {
     switch (command) {
         case "init": {
             const dryRun = args.includes("--dry-run");
-            const isInteractive = args.includes("--interactive");
-            const adapter = args.find(a => !a.startsWith("-") && a !== "init");
-            await initCommand(adapter, dryRun, isInteractive);
+            const isUnified = args.includes("--unified");
+            const forceYes = args.includes("--yes") || args.includes("-y");
+            const adapter = args.find(a => !a.startsWith("-") && a !== "init") || "gemini";
+            await initCommand(adapter, { dryRun, unified: isUnified, yes: forceYes });
             break;
         }
 

package/src/cli/shims.ts

@@ -4,7 +4,7 @@ export const SHIM_TEMPLATES: Record<string, string> = {
 You are the **Gemini Commander** (Strategic Decision Center).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Zero-Request Logging:** Write logs to \`{{FRAMEWORK_DIR}}/logs/\` at the end of every turn.
 `,
@@ -13,7 +13,7 @@ You are the **Gemini Commander** (Strategic Decision Center).
 You are the **Antigravity Specialist** (Preserve Coding Standards).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Standard Check:** Run health checks regularly to preserve framework integrity.
 `,
@@ -22,7 +22,7 @@ You are the **Antigravity Specialist** (Preserve Coding Standards).
 You are the **Claude Field Engineer** (Surgical Operations).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 - **Surgical Precision:** Do not rewrite files. Execute surgical edits.
 `,
@@ -31,7 +31,7 @@ You are the **Claude Field Engineer** (Surgical Operations).
 You are the **Grok Explorer** (Experimental Protocols).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `,
     cursor: `# 🎖️ Enderun Core — CURSOR Strategy
@@ -39,7 +39,7 @@ You are the **Grok Explorer** (Experimental Protocols).
 You are the **Cursor Implementer** (IDE Integration).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `,
     codex: `# 🎖️ Enderun Core — COPILOT Strategy
@@ -47,7 +47,7 @@ You are the **Cursor Implementer** (IDE Integration).
 You are the **Copilot Implementer** (GitHub Copilot Integration).
 
 ## 🏛️ Directives
-- **Constitutional Supremacy:** Read \`ENDERUN.md\` first.
+- **Constitutional Supremacy:** Read \`{{FRAMEWORK_DIR}}/ENDERUN.md\` first.
 - **State Persistence:** Read \`{{FRAMEWORK_DIR}}/memory/PROJECT_MEMORY.md\` to restore session memory.
 `
 };

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

@@ -0,0 +1,249 @@
+import path from "path";
+import type { AppSpec } from "./app-inferrer.js";
+import { createBaseTypeFiles } from "./app-types.js";
+import { ensureDir, writeJsonFile, writeTextFile } from "./fs.js";
+import { getConfiguredPaths } from "./memory.js";
+import { getDependencyVersions } from "./pkg.js";
+
+const targetDir = process.cwd();
+
+export function createBackendFiles(spec: AppSpec): void {
+    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"));
+}

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

@@ -0,0 +1,65 @@
+import fs from "fs";
+import path from "path";
+import { ensureDir, writeTextFile } from "./fs.js";
+import { getConfiguredPaths, getMemoryPath, updateProjectMemory } from "./memory.js";
+import type { AppSpec } from "./app-inferrer.js";
+
+const targetDir = process.cwd();
+
+export function updateProjectDocs(spec: AppSpec): void {
+    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): void {
+    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);
+}

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

@@ -0,0 +1,257 @@
+import path from "path";
+import type { AppSpec } from "./app-inferrer.js";
+import { createBaseTypeFiles } from "./app-types.js";
+import { writeJsonFile, writeTextFile } from "./fs.js";
+import { getConfiguredPaths } from "./memory.js";
+import { getDependencyVersions } from "./pkg.js";
+
+const targetDir = process.cwd();
+
+export function createWebFiles(spec: AppSpec): void {
+    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"));
+}