agent-enderun 0.8.8 → 0.9.0

package/src/cli/index.ts

@@ -1,2188 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import crypto from "crypto";
-import { execSync } from "child_process";
-import cp from "child_process";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const sourceDir = path.join(__dirname, "..", "..");
-const targetDir = process.cwd();
-
-// --- CONSTANTS ---
-const FRAMEWORK_VERSION = getPackageVersion();
-
-// --- HELPER FUNCTIONS ---
-
-function getPackageVersion() {
-  const pkg = JSON.parse(fs.readFileSync(path.join(sourceDir, "package.json"), "utf8"));
-  return pkg.version;
-}
-
-function getFrameworkDir() {
-  const candidates = [".enderun", ".gemini", ".cursor"];
-  for (const dir of candidates) {
-    if (fs.existsSync(path.join(targetDir, dir))) {
-      return dir;
-    }
-  }
-  return ".gemini";
-}
-
-function getMemoryPath() {
-  return path.join(targetDir, getFrameworkDir(), "PROJECT_MEMORY.md");
-}
-
-export function generateULID(seedTime = Date.now(), seed?: number) {
-    const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-    const ENCODING_LEN = ENCODING.length;
-    let time = seedTime;
-    const timeChars = new Array(10);
-    for (let i = 9; i >= 0; i--) {
-        timeChars[i] = ENCODING.charAt(time % ENCODING_LEN);
-        time = Math.floor(time / ENCODING_LEN);
-    }
-    const randomChars = new Array(16);
-    if (seed) {
-        let pseudoRandom = seed;
-        for (let i = 0; i < 16; i++) {
-            pseudoRandom = (pseudoRandom * 16807) % 2147483647;
-            randomChars[i] = ENCODING.charAt(pseudoRandom % ENCODING_LEN);
-        }
-    } else {
-        for (let i = 0; i < 16; i++) {
-          randomChars[i] = ENCODING.charAt(Math.floor(Math.random() * ENCODING_LEN));
-        }
-    }
-    return timeChars.join("") + randomChars.join("");
-}
-
-function sleep(ms: number): void {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-
-function acquireMemoryLock(lockPath: string, maxRetries = 5): boolean {
-  for (let attempt = 0; attempt < maxRetries; attempt += 1) {
-    try {
-      const fd = fs.openSync(lockPath, "wx");
-      fs.closeSync(fd);
-      return true;
-    } catch (error) {
-      if (error?.code !== "EEXIST") throw error;
-      if (attempt < maxRetries - 1) sleep(1000);
-    }
-  }
-  return false;
-}
-
-function releaseMemoryLock(lockPath: string): void {
-  if (fs.existsSync(lockPath)) fs.unlinkSync(lockPath);
-}
-
-function insertTaskRow(memoryContent: string, row: string): string | null {
-  const sectionHeader = "## ACTIVE TASKS";
-  const tableDivider = "| :--- | :--- | :--- | :--- | :--- |";
-  const sectionIndex = memoryContent.indexOf(sectionHeader);
-  if (sectionIndex === -1) return null;
-  const dividerIndex = memoryContent.indexOf(tableDivider, sectionIndex);
-  if (dividerIndex === -1) return null;
-  const dividerLineEnd = memoryContent.indexOf("\n", dividerIndex);
-  if (dividerLineEnd === -1) return null;
-
-  return (
-    memoryContent.slice(0, dividerLineEnd + 1) +
-    `${row}\n` +
-    memoryContent.slice(dividerLineEnd + 1)
-  );
-}
-
-export function sanitizeTableCell(value: unknown): string {
-  return String(value).replace(/\|/g, "\\|").replace(/\r?\n/g, " ").trim();
-}
-
-export function normalizeAgentName(agent?: unknown): string {
-  return String(agent || "manager").replace(/^@+/, "").trim() || "manager";
-}
-
-export function normalizePriority(priority?: unknown): string {
-  const normalized = String(priority || "P2").toUpperCase().trim();
-  return /^P[0-3]$/.test(normalized) ? normalized : "P2";
-}
-
-function mergePackageJson(targetPath: string, sourcePath: string): void {
-  let targetPkg = {};
-  if (fs.existsSync(targetPath)) {
-    try {
-      targetPkg = JSON.parse(fs.readFileSync(targetPath, "utf8"));
-    } catch {
-      console.warn("⚠️  Could not parse existing package.json, creating a new one.");
-    }
-  }
-
-  const sourcePkg = JSON.parse(fs.readFileSync(sourcePath, "utf8"));
-  
-  type PackageMap = Record<string, string>;
-  const sanitizeDeps = (deps: PackageMap | Record<string, unknown> | undefined): Record<string, string> | undefined => {
-    if (!deps) return deps as undefined;
-    const cleaned: Record<string, string> = {};
-    for (const [name, version] of Object.entries(deps as Record<string, unknown>)) {
-      cleaned[name] = (typeof version === "string" && version.startsWith("workspace:")) ? "*" : String(version || "");
-    }
-    return cleaned;
-  };
-
-  interface PackageJson {
-    name?: string;
-    version?: string;
-    type?: string;
-    workspaces?: string[];
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    peerDependencies?: Record<string, string>;
-    optionalDependencies?: Record<string, string>;
-    scripts?: Record<string, string>;
-    enderun?: Record<string, unknown>;
-  }
-
-  const actualTargetScope = (targetPkg as PackageJson)?.name && (targetPkg as PackageJson).name!.startsWith("@")
-    ? (targetPkg as PackageJson).name!.split("/")[0]
-    : ((targetPkg as PackageJson).name ? `@${(targetPkg as PackageJson).name}` : "");
-
-  // Cleanup potential leftovers from previous bugged runs where agent-enderun was renamed to target name
-  if (actualTargetScope) {
-    const scopeName = actualTargetScope.startsWith("@") ? actualTargetScope.slice(1) : actualTargetScope;
-    const cleanup = (obj: Record<string, unknown> | undefined): void => {
-      if (!obj) return;
-      delete obj[scopeName];
-      delete obj[actualTargetScope];
-      delete obj["agent-enderun"]; // Will be re-added correctly
-    };
-    cleanup((targetPkg as PackageJson).devDependencies);
-    cleanup((targetPkg as PackageJson).dependencies);
-  }
-
-  targetPkg.dependencies = sanitizeDeps({
-    ...targetPkg.dependencies,
-    ...sourcePkg.dependencies
-  });
-
-  // Merge scripts
-  const pkgMgr = getPackageManager();
-  const runCmd = pkgMgr === "yarn" ? "yarn" : (pkgMgr === "pnpm" ? "pnpm" : "npm run");
-  
-  targetPkg.scripts = {
-    ...targetPkg.scripts,
-    "enderun:status": "agent-enderun status",
-    "enderun:trace": "agent-enderun trace:new",
-    "enderun:verify": "agent-enderun verify-contract",
-    "enderun:check": "agent-enderun check",
-    "enderun:test": "vitest run",
-    "enderun:test:watch": "vitest",
-    "enderun:build": `${runCmd} build --prefix framework-mcp`,
-  };
-
-  const sourceDevDeps = sourcePkg.devDependencies || {};
-  targetPkg.devDependencies = sanitizeDeps({
-    ...targetPkg.devDependencies,
-    "agent-enderun": `^${sourcePkg.version}`,
-    ...(sourceDevDeps["@modelcontextprotocol/sdk"] ? {"@modelcontextprotocol/sdk": sourceDevDeps["@modelcontextprotocol/sdk"]} : {}),
-    ...(sourceDevDeps["zod"] ? {"zod": sourceDevDeps["zod"]} : {}),
-    ...(sourceDevDeps["ts-morph"] ? {"ts-morph": sourceDevDeps["ts-morph"]} : {}),
-    ...(sourceDevDeps["typescript"] ? {"typescript": sourceDevDeps["typescript"]} : {}),
-    ...(sourceDevDeps["@types/node"] ? {"@types/node": sourceDevDeps["@types/node"]} : {}),
-    ...(sourceDevDeps["tsx"] ? {"tsx": sourceDevDeps["tsx"]} : {}),
-    ...(sourceDevDeps["vitest"] ? {"vitest": sourceDevDeps["vitest"]} : {}),
-    "@pandacss/dev": sourceDevDeps["@pandacss/dev"] || "^1.11.1"
-  });
-
-  if ((targetPkg as PackageJson).peerDependencies) {
-    (targetPkg as PackageJson).peerDependencies = sanitizeDeps((targetPkg as PackageJson).peerDependencies) as Record<string,string> | undefined;
-  }
-  if ((targetPkg as PackageJson).optionalDependencies) {
-    (targetPkg as PackageJson).optionalDependencies = sanitizeDeps((targetPkg as PackageJson).optionalDependencies) as Record<string,string> | undefined;
-  }
-
-  // Ensure basic fields
-  if (!targetPkg.name) targetPkg.name = path.basename(process.cwd());
-  if (!targetPkg.version) targetPkg.version = "0.1.0";
-  if (!targetPkg.type) targetPkg.type = "module";
-  if (!targetPkg.workspaces) targetPkg.workspaces = ["apps/*", "framework-mcp"];
-
-  // Add metadata
-  targetPkg.enderun = {
-    version: sourcePkg.version,
-    initializedAt: new Date().toISOString(),
-  };
-
-  fs.writeFileSync(targetPath, JSON.stringify(targetPkg, null, 2));
-  console.warn("✅ package.json updated with Enderun scripts and dependencies.");
-}
-
-function updateGitIgnore(targetPath, frameworkDir = ".gemini") {
-  const IGNORE_LINES = [
-    "# AI-Enderun",
-    `${frameworkDir}/logs/*.json`,
-    `${frameworkDir}/*.lock`,
-    ".env",
-    ".DS_Store"
-  ];
-
-  let content = "";
-  if (fs.existsSync(targetPath)) {
-    content = fs.readFileSync(targetPath, "utf8");
-  }
-
-  const lines = content.split("\n").map((l) => l.trim());
-  let added = false;
-
-  for (const line of IGNORE_LINES) {
-    if (!lines.includes(line)) {
-      content += (content.endsWith("\n") || content === "" ? "" : "\n") + line + "\n";
-      added = true;
-    }
-  }
-
-  if (added) {
-    fs.writeFileSync(targetPath, content);
-    console.warn("✅ .gitignore updated.");
-  }
-}
-
-/**
- * Finds the Claude config file path (if it exists).
- */
-function findClaudeConfigPath() {
-  const home = process.env.HOME || process.env.USERPROFILE;
-  if (!home) return null;
-
-  const possiblePaths = [
-    path.join(home, ".config", "claude", "config.json"),
-    path.join(home, ".claude", "config.json"),
-    path.join(home, "Library", "Application Support", "Claude", "config.json"), // macOS Claude Desktop
-    path.join(home, "Library", "Application Support", "Claude Code", "config.json"), // macOS Claude Code
-    path.join(home, ".config", "Claude", "config.json"), // some Linux setups
-  ];
-
-  for (const p of possiblePaths) {
-    if (fs.existsSync(p)) {
-      return p;
-    }
-  }
-  return null;
-}
-
-/**
- * Adds or updates an MCP server entry in Claude's config file.
- */
-function addMcpServerToClaude(configPath, serverName, serverConfig) {
-  try {
-    let config = { mcpServers: {} };
-
-    if (fs.existsSync(configPath)) {
-      const content = fs.readFileSync(configPath, "utf8");
-      config = JSON.parse(content);
-    }
-
-    if (!config.mcpServers) {
-      config.mcpServers = {};
-    }
-
-    config.mcpServers[serverName] = serverConfig;
-
-    // Ensure parent directory exists
-    const dir = path.dirname(configPath);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Create initial PROJECT_MEMORY.md if missing.
- */
-function initializeMemory(memoryPath, targetBase) {
-  if (fs.existsSync(memoryPath)) return;
-
-  const traceId = generateULID();
-  const date = new Date().toISOString().split("T")[0];
-  const template = `# PROJECT MEMORY — Agent Enderun
-
-This file is the Single Source of Truth (SSOT) and the persistent memory of the project.
-
-## CURRENT STATUS
-
-| Active Phase | Profile | Last Update | Active Trace ID | Blockers |
-| :----------- | :------ | :---------- | :-------------- | :------- |
-| PHASE_0      | Lightweight | ${date} | ${traceId} | NONE |
-
-## PROJECT DEFINITION
-
-| Field | Value |
-| :--- | :--- |
-| Project Name | ${path.basename(process.cwd())} |
-| Platform | Not defined |
-| Frontend | React 19 + Vite + Panda CSS |
-| Backend | Node.js 20+ + Fastify |
-| DB | PostgreSQL |
-
-## DOD STATUS
-
-| Phase | Status | Note |
-| :--- | :--- | :--- |
-| PHASE_0 | IN_PROGRESS | Initializing project structure |
-| PHASE_1 | PENDING | |
-| PHASE_2 | PENDING | |
-| PHASE_3 | PENDING | |
-| PHASE_4 | PENDING | |
-
-## CRITICAL DECISIONS
-
-| Date | Decision | Rationale | Agent |
-| :--- | :--- | :--- | :--- |
-| ${date} | Project Initialized | Framework setup via CLI | @manager |
-
-## DELIVERABLES
-
-| Module | Status | Agent | Date |
-| :--- | :--- | :--- | :--- |
-
-## ACTIVE TASKS
-
-| Trace ID | Task | Agent | Priority | Status |
-| :--- | :--- | :--- | :--- | :--- |
-| ${traceId} | Framework setup and architecture alignment | @manager | P1 | IN_PROGRESS |
-
-## HISTORY (Persistent Memory)
-
-### ${date} — Framework Initialization
-
-- **Agent:** @manager
-- **Trace ID:** ${traceId}
-- **Action:** Initialized Agent Enderun framework and project structure.
-`;
-
-  const finalTemplate = template.replace(/\{\{FRAMEWORK_DIR\}\}/g, targetBase);
-  fs.writeFileSync(memoryPath, finalTemplate);
-  console.warn(`✅ PROJECT_MEMORY.md initialized in ${targetBase}`);
-}
-
-// --- COMMANDS ---
-
-function getPackageManager() {
-  const override = process.env.AGENT_ENDERUN_PACKAGE_MANAGER || process.env.AGENT_ENDERUN_PM || process.env.AI_ENDERUN_PACKAGE_MANAGER || process.env.AI_ENDERUN_PM;
-  if (override) return override.toLowerCase();
-
-  const userAgent = process.env.npm_config_user_agent || "";
-  const npmExecPath = process.env.npm_execpath || "";
-
-  if (userAgent.includes("pnpm") || npmExecPath.includes("pnpm")) return "pnpm";
-  if (userAgent.includes("yarn") || npmExecPath.includes("yarn")) return "yarn";
-
-  // Check for lockfiles in target directory
-  if (fs.existsSync(path.join(process.cwd(), "pnpm-lock.yaml")) || fs.existsSync(path.join(process.cwd(), "pnpm-workspace.yaml"))) return "pnpm";
-  if (fs.existsSync(path.join(process.cwd(), "yarn.lock"))) return "yarn";
-  
-  return "npm";
-}
-
-/**
- * Scaffold the framework into the target project.
- */
-async function initCommand(adapter = "gemini") {
-  // Supports gemini, claude, and cursor adapters
-  const selectedAdapter = ["gemini", "claude", "cursor"].includes(adapter.toLowerCase()) ? adapter.toLowerCase() : "gemini";
-  const targetBase = `.${selectedAdapter}`;
-  const targetFrameworkDir = path.join(targetDir, targetBase);
-  // ... (CORE_FILES and DIRS_TO_CREATE remain the same)
-  const CORE_FILES = [
-    ".enderun",   // source template folder (remapped to targetBase: .gemini)
-    
-    "mcp.json",
-    ".env.example",
-    "ENDERUN.md",
-    "package.json",
-    "tsconfig.json",
-    "panda.config.ts",
-    "vitest.config.ts",
-    "framework-mcp",
-    "docs",
-  ];
-
-  const DIRS_TO_CREATE = [
-    targetBase,
-    `${targetBase}/agents`,
-    `${targetBase}/agents/schema`,
-    `${targetBase}/skills`,
-    `${targetBase}/knowledge`,
-    `${targetBase}/benchmarks`,
-    `${targetBase}/monitoring`,
-    `${targetBase}/logs`,
-    `${targetBase}/messages`,
-    `${targetBase}/memory-graph`,
-    `${targetBase}/memory-graph/agent-contexts`,
-    `${targetBase}/queue`,
-    `${targetBase}/queue/pending`,
-    `${targetBase}/queue/processing`,
-    `${targetBase}/queue/completed`,
-    `${targetBase}/queue/failed`,
-    `${targetBase}/queue/pipelines`,
-    "apps/web",
-    "apps/backend",
-    "docs",
-    "framework-mcp",
-    "tests",
-  ];
-
-  console.warn(`🚀 Installing Agent Enderun (Adapter: ${selectedAdapter})...`);
-
-  // Ensure target framework base exists
-  if (!fs.existsSync(targetFrameworkDir)) {
-    fs.mkdirSync(targetFrameworkDir, { recursive: true });
-  }
-
-  // Create subdirectories
-  for (const dir of DIRS_TO_CREATE) {
-    const fullPath = path.join(targetDir, dir);
-    if (!fs.existsSync(fullPath)) {
-      fs.mkdirSync(fullPath, { recursive: true });
-      console.warn(`📂 Created directory: ${dir}`);
-    }
-  }
-
-  // Process core files and the chosen adapter pointer file
-  const filesToProcess = [...CORE_FILES, `${selectedAdapter}.md`].filter(f => fs.existsSync(path.join(sourceDir, f)) || CORE_FILES.includes(f) || f === `${selectedAdapter}.md`);
-
-  // Ensure apps/backend structure for contract file
-  ensureDir(path.join(targetDir, "apps/backend"));
-  const initContractPath = path.join(targetDir, "apps/backend/contract.version.json");
-  if (!fs.existsSync(initContractPath)) {
-    writeJsonFile(initContractPath, {
-      "contract_hash": "initial_hash_placeholder",
-      "last_updated": new Date().toISOString()
-    });
-  }
-
-  // Create MCP config for Gemini adapter
-  const mcpConfigPath = path.join(targetFrameworkDir, "mcp_config.json");
-  if (!fs.existsSync(mcpConfigPath)) {
-    writeJsonFile(mcpConfigPath, {
-      "mcpServers": {}
-    });
-    console.warn(`📄 Created ${targetBase}/mcp_config.json (MCP format)`);
-  }
-
-  // Detect target project scope
-  let targetPkg = {};
-  try {
-    const targetPkgPath = path.join(targetDir, "package.json");
-    if (fs.existsSync(targetPkgPath)) {
-      targetPkg = JSON.parse(fs.readFileSync(targetPkgPath, "utf8"));
-    }
-  } catch {
-    // ignore parse errors when reading existing package.json
-  }
-  
-  const targetScope = (targetPkg && targetPkg.name)
-    ? (targetPkg.name.startsWith("@") ? targetPkg.name.split("/")[0] : `@${targetPkg.name}`)
-    : `@${path.basename(targetDir)}`;
-
-
-  for (const item of filesToProcess) {
-    const src = path.join(sourceDir, item);
-    let dest = path.join(targetDir, item);
-    
-    // FORCED CLEANUP: Delete existing framework engine directory to ensure clean update
-    if (["framework-mcp"].includes(item)) {
-      if (fs.existsSync(dest)) {
-          try {
-            fs.rmSync(dest, { recursive: true, force: true });
-          } catch {
-            // ignore
-          }
-      }
-    }
-
-    // Remap core framework files to targetBase
-    if (item === ".enderun" || item.startsWith(".enderun/")) {
-      dest = path.join(targetDir, item.replace(".enderun", targetBase));
-    }
-    if (item === "ENDERUN.md") dest = path.join(targetFrameworkDir, "ENDERUN.md");
-    
-    // Adapter pointer check
-    const isAdapterPointer = item === `${selectedAdapter}.md` || item === "gemini.md" || item === "claude.md" || item === "cursor.md";
-    if (isAdapterPointer) {
-      dest = path.join(targetDir, item);
-    }
-
-    if (fs.existsSync(src)) {
-      if (fs.lstatSync(src).isDirectory()) {
-        const skipFiles = (item === ".enderun") ? ["logs", "PROJECT_MEMORY.md", "PROJECT_MEMORY.lock"] : [];
-        const nonDestructive = ["docs", ".enderun"].includes(item); // source name during copy
-        copyDir(src, dest, new Set(skipFiles), nonDestructive, targetBase, targetScope);
-      } else {
-        if (item === "package.json") continue; // We merge it later
-        
-        if (fs.existsSync(dest) && !isAdapterPointer) {
-          console.warn(`ℹ️  Skipping existing file: ${item}`);
-          continue;
-        }
-
-        const ext = path.extname(item);
-        const textExtensions = [".md", ".json", ".js", ".ts", ".txt", ""];
-        if (textExtensions.includes(ext)) {
-          let content = fs.readFileSync(src, "utf8");
-          // Use selected adapter for placeholder replacement
-          const currentAdapter = selectedAdapter;
-
-          content = content.replace(/\{\{FRAMEWORK_DIR\}\}/g, targetBase);
-          content = content.replace(/\{\{ADAPTER\}\}/g, currentAdapter);
-          // Fallback: replace any residual hardcoded .enderun/ paths (with or without trailing slash)
-          content = content.replace(/\.enderun\//g, `${targetBase}/`);
-          content = content.replace(/`\.enderun`/g, `\`${targetBase}\``);
-          content = content.replace(/\.enderun(?![\w/-])/g, targetBase); // bare .enderun not followed by word char or / -
-          
-          if (ext === ".json") {
-            try {
-              const json = JSON.parse(content);
-              content = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
-              // Ensure variable replacement even inside JSON strings if any
-              content = content.replace(/\{\{FRAMEWORK_DIR\}\}/g, targetBase);
-              content = content.replace(/\{\{ADAPTER\}\}/g, currentAdapter);
-            } catch {
-              content = content.replace(/workspace:[^"'\s]*/g, "*");
-            }
-          }
-          
-          fs.writeFileSync(dest, content);
-        } else {
-          fs.copyFileSync(src, dest);
-        }
-      }
-      console.warn(`✅ ${item} processed -> ${path.relative(targetDir, dest)}`);
-    }
-  }
-
-  // Merge Package JSON
-  mergePackageJson(path.join(targetDir, "package.json"), path.join(sourceDir, "package.json"));
-  updateGitIgnore(path.join(targetDir, ".gitignore"), targetBase);
-  
-  const finalMemoryPath = path.join(targetDir, targetBase, "PROJECT_MEMORY.md");
-  initializeMemory(finalMemoryPath, targetBase);
-  
-  deepCleanProtocols(targetDir, targetScope);
-
-  // Create initial sample test
-  const sampleTestPath = path.join(targetDir, "tests/initial.test.ts");
-  if (!fs.existsSync(sampleTestPath)) {
-    fs.writeFileSync(sampleTestPath, `import { describe, it, expect } from 'vitest';
-
-describe('Initial Setup', () => {
-  it('should verify the testing environment is active', () => {
-    expect(true).toBe(true);
-  });
-});
-`);
-  }
-
-  if (!fs.existsSync(path.join(targetDir, ".git"))) {
-    try {
-      const { execSync } = await import("child_process");
-      execSync("git init", { cwd: targetDir, stdio: "ignore" });
-      console.warn("✅ Git repository initialized.");
-    } catch { /* ignore */ }
-  }
-
-  console.warn(`\n🛠️  Running ${selectedAdapter} adapter configuration...`);
-
-  console.warn(`♊ ${selectedAdapter.toUpperCase()} CLI: Setup complete in ${targetBase}/ folder.`);
-  console.warn(`   • Root entrypoint: ${selectedAdapter}.md`);
-  console.warn(`   • All framework files and governance live under ${targetBase}/`);
-
-  const pkgMgr = getPackageManager();
-  const installCmd = pkgMgr === "npm" ? "npm install" : `${pkgMgr} install`;
-  const buildCmd = pkgMgr === "npm" ? "npm run enderun:build" : `${pkgMgr} run enderun:build`;
-
-  console.warn(`\n✨ Framework scaffolded! (v${FRAMEWORK_VERSION})`);
-
-  // Allow skipping install in test/CI environments
-  if (process.env.ENDERUN_SKIP_INSTALL === "1") {
-    console.warn("\n⏭️  Skipping install steps (ENDERUN_SKIP_INSTALL=1).");
-    return;
-  }
-  
-  try {
-    const { execSync } = await import("child_process");
-    console.warn(`\n📦 Step 1/3: Running '${installCmd}'...`);
-    execSync(installCmd, { stdio: "inherit" });
-    console.warn(`\n🏗️  Step 2/3: Running '${buildCmd}'...`);
-    execSync(buildCmd, { stdio: "inherit" });
-    console.warn(`\n🔍 Step 3/3: Running 'agent-enderun check'...`);
-    checkCommand();
-    console.warn("\n🚀 Agent Enderun is fully installed and verified!");
-  } catch {
-    console.error("\n❌ Automatic installation failed. Run manually:");
-    console.warn(`👉 ${installCmd} && ${buildCmd}`);
-  }
-}
-
-/**
- * Recursively scans a directory for package.json files and removes workspace: protocols.
- */
-function deepCleanProtocols(dir, targetScope = "") {
-  if (!fs.existsSync(dir)) return;
-  
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name === "node_modules" || entry.name === ".git") continue;
-      deepCleanProtocols(fullPath, targetScope);
-    } else if (entry.name === "package.json") {
-      try {
-        const content = fs.readFileSync(fullPath, "utf8");
-        const json = JSON.parse(content);
-        const cleaned = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
-        fs.writeFileSync(fullPath, cleaned);
-      } catch {
-        // ignore malformed json
-      }
-    } else if (entry.name === "package-lock.json") {
-      fs.unlinkSync(fullPath);
-    }
-  }
-}
-
-/**
- * Check framework health and MCP status.
- */
-function checkCommand() {
-  console.warn(`🔍 Checking Agent Enderun Health (v${FRAMEWORK_VERSION})...`);
-  let issues = 0;
-
-  const frameworkDir = getFrameworkDir();
-  
-  const constitutionPath = fs.existsSync(path.join(process.cwd(), "ENDERUN.md"))
-    ? "ENDERUN.md"
-    : path.join(frameworkDir, "ENDERUN.md");
-
-  const checks = [
-    { name: "Constitution (ENDERUN.md)", path: constitutionPath },
-    { name: "Memory (PROJECT_MEMORY.md)", path: path.join(frameworkDir, "PROJECT_MEMORY.md") },
-    { name: "Command Map (cli-commands.json)", path: path.join(frameworkDir, "cli-commands.json") },
-    { name: "Framework Config (config.json)", path: path.join(frameworkDir, "config.json") },
-    { name: "Agent Status (STATUS.md)", path: path.join(frameworkDir, "STATUS.md") },
-    { name: "MCP Config (mcp.json)", path: "mcp.json" },
-    { name: "Backend Contract", path: "apps/backend/contract.version.json" },
-    { name: "MCP Server", path: "framework-mcp/package.json" },
-    { name: "Panda CSS Config", path: "panda.config.ts" },
-    { name: "Brain Dashboard", path: path.join(frameworkDir, "BRAIN_DASHBOARD.md") },
-    { name: "Project Architectural Portal (docs/README.md)", path: "docs/README.md" },
-    { name: "System Getting Started Guide (docs/getting-started.md)", path: "docs/getting-started.md" },
-    { name: "Enterprise Approval Flows Protocol", path: "docs/architecture/approval-flows.md" },
-    { name: "Professional Error Handling Pattern", path: "docs/backend/error-handling.md" },
-    { name: "Atomic Component Standards", path: "docs/frontend/component-patterns.md" },
-  ];
-
-  for (const check of checks) {
-    if (fs.existsSync(path.join(process.cwd(), check.path))) {
-      console.warn(`✅ ${check.name} found.`);
-    } else {
-      console.warn(`❌ ${check.name} MISSING! (${check.path})`);
-      issues++;
-    }
-  }
-
-  // Dependency Check
-  const mcpNodeModules = path.join(process.cwd(), "framework-mcp/node_modules");
-  const rootNodeModules = path.join(process.cwd(), "node_modules");
-  if (!fs.existsSync(mcpNodeModules) && !fs.existsSync(rootNodeModules)) {
-    console.warn("❌ Dependencies MISSING! (Run 'npm install')");
-    issues++;
-  } else {
-    console.warn("✅ Dependencies found.");
-  }
-
-  // MCP Build Check
-  const mcpPath = path.join(process.cwd(), "framework-mcp/dist/index.js");
-  if (!fs.existsSync(mcpPath)) {
-    console.warn("❌ MCP Build MISSING! (Run 'npm run enderun:build')");
-    issues++;
-  } else {
-    console.warn("✅ MCP Build found.");
-    console.warn("⏳ Testing MCP Server syntax...");
-    try {
-      execSync(`node --check ${mcpPath}`, { stdio: "pipe" });
-      console.warn("✅ MCP Server syntax valid.");
-    } catch {
-      // If --check fails on ESM, we might skip it or use a better check
-      console.warn("⚠️  MCP Syntax check skipped (ESM/Environment).");
-    }
-  }
-
-  if (issues === 0) {
-    console.warn("\n🚀 All systems green! Agent Enderun is ready for orchestration.");
-  } else {
-    console.warn(`\n⚠️  Found ${issues} issues. Please fix them before starting.`);
-    process.exit(1);
-  }
-}
-
-function sanitizeJson(obj, targetScope = "") {
-  if (typeof obj !== "object" || obj === null) return obj;
-  if (Array.isArray(obj)) return obj.map(item => sanitizeJson(item, targetScope));
-  const cleaned = {};
-  for (const [key, value] of Object.entries(obj)) {
-    let finalKey = key;
-    let finalValue = value;
-
-    // Remove UnoCSS related keys or values
-    if (typeof key === "string" && key.includes("unocss")) continue;
-    if (typeof value === "string" && value.includes("unocss")) {
-      continue; // Skip this script/field
-    }
-
-    // Replace scope if needed
-    if (targetScope) {
-      const scopeName = targetScope.startsWith("@") ? targetScope.slice(1) : targetScope;
-
-      // Handle scoped: @ai-enderun/foo -> @target/foo
-      if (typeof key === "string" && key.startsWith("@ai-enderun/")) {
-        finalKey = key.replace("@ai-enderun/", `${targetScope}/`);
-      }
-      if (typeof value === "string" && value.startsWith("@ai-enderun/")) {
-        finalValue = value.replace("@ai-enderun/", `${targetScope}/`);
-      }
-
-      // Handle unscoped: ai-enderun-foo -> target-foo
-      if (typeof key === "string" && key.startsWith("ai-enderun-")) {
-        finalKey = key.replace("ai-enderun-", `${scopeName}-`);
-      }
-      if (typeof value === "string" && value.startsWith("ai-enderun-")) {
-        finalValue = value.replace("ai-enderun-", `${scopeName}-`);
-      }
-      
-      // Handle agent-enderun -> target (ONLY for the package name)
-      if (key === "name" && value === "agent-enderun") {
-        finalValue = scopeName;
-      }
-      
-      // Preserve agent-enderun in dependencies and bin
-      // (No action needed as finalKey/finalValue default to original)
-
-      if (typeof value === "string" && value.startsWith("workspace:")) {
-        finalValue = "*";
-      }
-    } else if (typeof value === "string" && value.startsWith("workspace:")) {
-      finalValue = "*";
-    }
-
-    cleaned[finalKey] = (typeof finalValue === "object") ? sanitizeJson(finalValue, targetScope) : finalValue;
-  }
-  return cleaned;
-}
-
-function copyDir(src, dest, skipSet = new Set(), nonDestructive = false, frameworkDir = ".gemini", targetScope = "") {
-  const DEFAULT_SKIP = new Set(["node_modules", ".git", ".DS_Store", "package-lock.json"]);
-  const actualSkip = new Set([...DEFAULT_SKIP, ...skipSet]);
-
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  fs.readdirSync(src, { withFileTypes: true }).forEach(entry => {
-    if (actualSkip.has(entry.name)) return;
-
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, skipSet, nonDestructive, frameworkDir, targetScope);
-    } else {
-      if (nonDestructive && fs.existsSync(destPath)) {
-        return;
-      }
-      
-      const ext = path.extname(entry.name);
-      const textExtensions = [".md", ".json", ".js", ".ts", ".txt", ""];
-      
-      if (textExtensions.includes(ext)) {
-        let content = fs.readFileSync(srcPath, "utf8");
-        content = content.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
-        // Also replace any residual hardcoded .enderun/ paths left in source files (with or without trailing slash)
-        content = content.replace(/\.enderun\//g, `${frameworkDir}/`);
-        content = content.replace(/`\.enderun`/g, `\`${frameworkDir}\``);
-        content = content.replace(/\.enderun(?![\w/-])/g, frameworkDir);
-        
-        // Sanitize workspace: protocol
-        if (ext === ".json") {
-          try {
-            const json = JSON.parse(content);
-            content = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
-          } catch {
-            content = content.replace(/workspace:[^"'\s]*/g, "*");
-          }
-        } else {
-          content = content.replace(/workspace:[^"'\s]*/g, "*");
-        }
-
-        const frameworkBase = frameworkDir.startsWith(".") ? frameworkDir.slice(1) : frameworkDir;
-        let currentAdapter = frameworkBase;
-        if (entry.name.endsWith(".md") && ["gemini", "claude", "cursor", "codex"].some(a => entry.name.startsWith(a))) {
-          currentAdapter = ["gemini", "claude", "cursor", "codex"].find(a => entry.name.startsWith(a));
-        }
-
-        content = content.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
-        content = content.replace(/\{\{ADAPTER\}\}/g, currentAdapter);
-        // Fallback: replace any residual hardcoded .enderun/ paths (with or without trailing slash)
-        content = content.replace(/\.enderun\//g, `${frameworkDir}/`);
-        content = content.replace(/`\.enderun`/g, `\`${frameworkDir}\``);
-        content = content.replace(/\.enderun(?![\w/-])/g, frameworkDir);
-        
-        fs.writeFileSync(destPath, content);
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
-  });
-}
-
-/**
- * Print the current framework status.
- */
-function statusCommand() {
-  const memoryPath = getMemoryPath();
-  const frameworkDir = getFrameworkDir();
-  if (!fs.existsSync(memoryPath)) {
-    console.error(`❌ Error: ${frameworkDir}/PROJECT_MEMORY.md not found. Please run 'init' first.`);
-    return;
-  }
-
-  const content = fs.readFileSync(memoryPath, "utf8");
-  const statusMatch = content.match(/\| Active Phase \| Profile \| Last Update \| Active Trace ID \| Blockers \|\n\| :----------- \| :------ \| :---------- \| :-------------- \| :------- \|\n\| (.*?) \| (.*?) \| (.*?) \| (.*?) \| (.*?) \|/);
-  
-  console.warn("\n📊 --- PROJECT STATUS ---");
-  if (statusMatch) {
-    console.warn(`🔹 Phase: ${statusMatch[1].trim()}`);
-    console.warn(`🧭 Profile: ${statusMatch[2].trim()}`);
-    console.warn(`📅 Update: ${statusMatch[3].trim()}`);
-    console.warn(`🆔 Trace ID: ${statusMatch[4].trim()}`);
-    console.warn(`⛔ Blockers: ${statusMatch[5].trim()}`);
-  }
-
-  const tasksSection = content.match(/## ACTIVE TASKS\n\n([\s\S]*?)\n\n##/);
-  if (tasksSection) {
-    console.warn("\n📋 Active Tasks:");
-    console.warn(tasksSection[1].trim());
-  }
-
-  console.warn("\n-----------------------\n");
-}
-
-/**
- * Generate a new Trace ID and add it to project memory.
- */
-function traceNewCommand(description, agent = "manager", priority = "P2") {
-  const memoryPath = getMemoryPath();
-  if (!fs.existsSync(memoryPath)) {
-    console.error("❌ Error: PROJECT_MEMORY.md not found.");
-    return;
-  }
-
-  const traceId = generateULID();
-  const safeDescription = sanitizeTableCell(description);
-  const safeAgent = normalizeAgentName(agent);
-  const safePriority = normalizePriority(priority);
-  const newTask = `| ${traceId} | ${safeDescription} | @${safeAgent} | ${safePriority} | IN_PROGRESS |`;
-  const lockPath = `${memoryPath}.lock`;
-
-  if (!acquireMemoryLock(lockPath)) {
-    console.error("❌ Error: Memory lock timeout (5 retries).");
-    return;
-  }
-
-  try {
-    const content = fs.readFileSync(memoryPath, "utf8");
-    const updated = insertTaskRow(content, newTask);
-    if (!updated) {
-      console.error("❌ Error: ACTIVE TASKS table not found, task could not be added.");
-      return;
-    }
-
-    fs.writeFileSync(memoryPath, updated);
-    console.warn(`\n✅ New Trace ID created: ${traceId}`);
-    console.warn(`📝 Added to task list: ${description}\n`);
-    return traceId;
-  } finally {
-    releaseMemoryLock(lockPath);
-  }
-}
-
-/**
- * Verify the shared-types contract hash.
- */
-function verifyContractCommand() {
-  const sharedDir = path.join(targetDir, "apps/backend/src/types");
-  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
-
-  if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) {
-    console.error("❌ Error: Backend types or contract.version.json not found.");
-    return;
-  }
-
-  const walk = (d) => fs.readdirSync(d, { withFileTypes: true }).flatMap((e) => {
-    const p = path.join(d, e.name);
-    return e.isDirectory() ? walk(p) : (p.endsWith(".ts") ? [p] : []);
-  });
-
-  const files = walk(sharedDir).sort();
-  const h = crypto.createHash("sha256");
-  for (const f of files) {
-    h.update(path.relative(targetDir, f));
-    h.update("\0");
-    h.update(fs.readFileSync(f));
-    h.update("\0");
-  }
-  const currentHash = h.digest("hex");
-  
-  try {
-    const stored = JSON.parse(fs.readFileSync(contractPath, "utf8")).contract_hash;
-    if (currentHash === stored) {
-      console.warn("✅ Contract hash verified! (MATCH)");
-    } else {
-      console.error(`❌ HASH MISMATCH!\nExpected: ${stored}\nActual:   ${currentHash}`);
-      process.exit(1);
-    }
-  } catch {
-    console.error("❌ Error reading contract.version.json");
-    process.exit(1);
-  }
-}
-
-function securityAuditCommand(targetPath) {
-  console.warn(`🔍 Running Advanced Security Audit on: ${targetPath}...`);
-  const scanRules = [
-    { pattern: /sql`/, message: "Potential Raw SQL usage detected", severity: "HIGH" },
-    { pattern: /(password|secret|api_?key)\s*[:=]\s*['"][^'"]+['"]/i, message: "Potential hardcoded secret detected", severity: "CRITICAL" },
-    { pattern: /:\s*any(?!\w)/, message: "Usage of 'any' type detected", severity: "MEDIUM" },
-    { pattern: /\.innerHTML\s*=/, message: "Unsafe innerHTML assignment detected", severity: "MEDIUM" },
-  ];
-  const issues = [];
-  const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx", ".js", ".jsx"]);
-  files.forEach(f => {
-    const content = fs.readFileSync(f, "utf8");
-    const lines = content.split("\n");
-    lines.forEach((line, i) => {
-      scanRules.forEach(rule => {
-        if (rule.pattern.test(line)) {
-          issues.push(`[${rule.severity}] ${rule.message} in ${path.relative(targetDir, f)}:${i+1}`);
-        }
-      });
-    });
-  });
-  if (issues.length === 0) {
-    console.warn("✅ No security issues detected.");
-  } else {
-    issues.forEach(issue => console.warn(`⚠️  ${issue}`));
-  }
-}
-
-function complianceCheckCommand(targetPath) {
-  console.warn(`📜 Checking Constitution Compliance: ${targetPath}...`);
-  const violations = [];
-  const forbidden = ["@shadcn", "mui", "@chakra-ui", "tailwindcss"];
-
-  // 1. package.json scan (Blind Spot 5)
-  const pkgJsonPath = path.join(targetDir, "package.json");
-  if (fs.existsSync(pkgJsonPath)) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
-      const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-      forbidden.forEach(lib => {
-        if (allDeps[lib] || Object.keys(allDeps).some(d => d.toLowerCase().includes(lib.toLowerCase()))) {
-          violations.push(`package.json: Forbidden library dependency '${lib}' found in package.json.`);
-        }
-      });
-    } catch {
-      // ignore
-    }
-  }
-
-  // 2. Source files scan
-  const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx", ".js", ".jsx", ".md"]);
-  files.forEach(f => {
-    const isTypesFile = f.includes("brands.ts") || f.includes("brands.js") || f.includes("brands.tsx") || f.includes("src/types/brands");
-
-    const content = fs.readFileSync(f, "utf8");
-    forbidden.forEach(lib => {
-      if (content.includes(lib)) violations.push(`${path.relative(targetDir, f)}: Forbidden library '${lib}' found.`);
-    });
-
-    // Robust Branded Types validation (Blind Spot 4)
-    if ((f.endsWith(".ts") || f.endsWith(".tsx")) && !isTypesFile && content.includes("interface")) {
-      const plainIdMatches = content.match(/\b\w*(?:id|Id|ID)\??\s*:\s*(?:string|number)\b/g);
-      if (plainIdMatches) {
-        plainIdMatches.forEach(match => {
-          violations.push(`${path.relative(targetDir, f)}: Potential Branded Types violation (plain identifier '${match.trim()}' found inside interface).`);
-        });
-      }
-    }
-  });
-
-  if (violations.length === 0) {
-    console.warn("✅ All systems compliant with ENDERUN.md.");
-  } else {
-    violations.forEach(v => console.warn(`❌ ${v}`));
-  }
-}
-
-function gitCommitCommand(traceId) {
-  try {
-    const diff = cp.execSync("git diff --staged", { encoding: "utf8" });
-    if (!diff) {
-      console.warn("ℹ️ No staged changes found. Use 'git add' first.");
-      return;
-    }
-    const files = cp.execSync("git diff --staged --name-only", { encoding: "utf8" }).split("\n").filter(Boolean);
-    let type = "feat"; const scope = "code";
-    if (files.some(f => f.includes(".md"))) type = "docs";
-    else if (files.some(f => f.includes("apps/backend/src/types"))) type = "arch";
-    else if (files.some(f => f.includes("bin/cli.js"))) type = "fix";
-    
-    const summary = files.length === 1 ? `update ${path.basename(files[0])}` : `update ${files.length} files`;
-    console.warn(`\n### SUGGESTED COMMIT MESSAGE ###\n\n[${traceId}] ${type}(${scope}): ${summary}\n`);
-  } catch {
-    console.warn("❌ Git command failed.");
-  }
-}
-
-function explorerGraphCommand(targetPath) {
-  console.warn(`🗺️  Generating Dependency Graph for: ${targetPath}...`);
-  const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
-  const edges = [];
-  files.forEach(f => {
-    const content = fs.readFileSync(f, "utf8");
-    const name = path.basename(f, path.extname(f));
-    const imports = content.match(/from\s+['"]\.\.?\/[^'"]+['"]/g) || [];
-    imports.forEach(imp => {
-      const target = path.basename(imp.split(/['"]/)[1]);
-      edges.push(`${name} --> ${target}`);
-    });
-  });
-  if (edges.length === 0) {
-    console.warn("ℹ️ No internal dependencies found.");
-  } else {
-    console.warn("\n```mermaid\ngraph TD\n" + Array.from(new Set(edges)).join("\n") + "\n```\n");
-  }
-}
-
-function explorerAuditCommand(targetPath) {
-  console.warn(`🧠 Codebase Intelligence Scan: ${targetPath}...`);
-  const files = collectFiles(path.join(targetDir, targetPath), [".ts", ".tsx"]);
-  const complexity = [];
-  files.forEach(f => {
-    const content = fs.readFileSync(f, "utf8");
-    const lines = content.split("\n").length;
-    if (lines > 300) complexity.push(`${path.relative(targetDir, f)} (${lines} lines)`);
-  });
-  if (complexity.length > 0) {
-    console.warn("\n⚠️ Complexity Spikes:");
-    complexity.forEach(c => console.warn(`- ${c}`));
-  } else {
-    console.warn("✅ Codebase structure looks clean.");
-  }
-}
-
-function collectFiles(dir, extensions) {
-  let results = [];
-  if (!fs.existsSync(dir)) return results;
-  const list = fs.readdirSync(dir);
-  list.forEach(file => {
-    file = path.join(dir, file);
-    const stat = fs.statSync(file);
-    if (stat && stat.isDirectory()) {
-      if (!file.includes("node_modules") && !file.includes(".git")) {
-        results = results.concat(collectFiles(file, extensions));
-      }
-    } else {
-      if (extensions.includes(path.extname(file))) {
-        results.push(file);
-      }
-    }
-  });
-  return results;
-}
-
-function runScriptCommand(script, projectPath) {
-  const fullPath = path.join(targetDir, projectPath);
-  if (!fs.existsSync(fullPath)) {
-    console.warn(`❌ Project path not found: ${projectPath}`);
-    return;
-  }
-  console.warn(`🚀 Running 'npm run ${script}' in ${projectPath}...`);
-  try {
-    cp.spawnSync("npm", ["run", script], { cwd: fullPath, stdio: "inherit", shell: true });
-  } catch {
-    console.warn(`❌ Failed to run script: ${e.message}`);
-  }
-}
-
-function gitSyncCommand() {
-  console.warn("🔄 Syncing with remote repository...");
-  try {
-    cp.execSync("git pull origin main --rebase", { stdio: "inherit" });
-    console.warn("✅ Successfully synced and rebased.");
-  } catch {
-    console.warn("❌ Sync failed. Please resolve conflicts manually.");
-  }
-}
-
-function logAgentActionCommand(data) {
-  const frameworkDir = getFrameworkDir();
-  const logsDir = path.join(targetDir, frameworkDir, "logs");
-  if (!fs.existsSync(logsDir)) {
-    fs.mkdirSync(logsDir, { recursive: true });
-  }
-
-  const agent = normalizeAgentName(data.agent);
-  const logPath = path.join(logsDir, `${agent}.json`);
-  let logs = [];
-
-  if (fs.existsSync(logPath)) {
-    try {
-      logs = JSON.parse(fs.readFileSync(logPath, "utf8"));
-      if (!Array.isArray(logs)) logs = [];
-    } catch {
-      logs = [];
-    }
-  }
-
-  const newEntry = {
-    timestamp: new Date().toISOString(),
-    ...data,
-  };
-
-  logs.push(newEntry);
-  fs.writeFileSync(logPath, JSON.stringify(logs, null, 2));
-  console.warn(`✅ Logged action to ${frameworkDir}/logs/${agent}.json`);
-}
-
-function updateProjectMemoryCommand(section, content) {
-  const memoryPath = getMemoryPath();
-  if (!fs.existsSync(memoryPath)) {
-    console.error("❌ Error: PROJECT_MEMORY.md not found.");
-    return;
-  }
-
-  const lockPath = `${memoryPath}.lock`;
-  if (!acquireMemoryLock(lockPath)) {
-    console.error("❌ Error: Memory lock timeout.");
-    return;
-  }
-
-  try {
-    let memoryContent = fs.readFileSync(memoryPath, "utf8");
-
-    if (section === "HISTORY") {
-      const headers = ["## HISTORY (Persistent Memory)", "## HISTORY"];
-      let sectionIndex = -1;
-      for (const h of headers) {
-        sectionIndex = memoryContent.indexOf(h);
-        if (sectionIndex !== -1) {
-          break;
-        }
-      }
-      
-      if (sectionIndex === -1) {
-        console.error("❌ Error: HISTORY section not found.");
-        return;
-      }
-      const headerEnd = memoryContent.indexOf("\n", sectionIndex) + 1;
-      memoryContent = memoryContent.slice(0, headerEnd) + "\n" + content.trim() + "\n" + memoryContent.slice(headerEnd);
-    } else {
-      const escaped = section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      const sectionRegex = new RegExp(`## ${escaped}[\\s\\S]*?(?=\\n## |$)`, "m");
-      if (!sectionRegex.test(memoryContent)) {
-        console.error(`❌ Error: Section not found: ${section}`);
-        return;
-      }
-      memoryContent = memoryContent.replace(sectionRegex, `## ${section}\n\n${content.trim()}\n`);
-    }
-
-    fs.writeFileSync(memoryPath, memoryContent);
-    console.warn(`✅ Section ${section} updated in PROJECT_MEMORY.md`);
-  } finally {
-    releaseMemoryLock(lockPath);
-  }
-}
-
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
-
-function writeTextFile(filePath, content) {
-  ensureDir(path.dirname(filePath));
-  fs.writeFileSync(filePath, content.endsWith("\n") ? content : `${content}\n`);
-}
-
-function writeJsonFile(filePath, value) {
-  writeTextFile(filePath, JSON.stringify(value, null, 2));
-}
-
-function slugifyName(value) {
-  const slug = String(value || "enderun-app")
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "");
-  return slug || "enderun-app";
-}
-
-function titleCase(value) {
-  return String(value || "Enderun App")
-    .replace(/[-_]+/g, " ")
-    .replace(/\s+/g, " ")
-    .trim()
-    .replace(/\b\w/g, (char) => char.toUpperCase());
-}
-
-function inferAppSpec(description) {
-  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,
-    },
-  };
-}
-
-function buildSharedTypesContent(existingContent) {
-  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`;
-}
-
-function updateContractHashFile() {
-  const sharedDir = path.join(targetDir, "apps/backend/src/types");
-  const contractPath = path.join(targetDir, "apps/backend/contract.version.json");
-  if (!fs.existsSync(sharedDir) || !fs.existsSync(contractPath)) return;
-
-  const walk = (dir) => fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
-    const fullPath = path.join(dir, entry.name);
-    return entry.isDirectory() ? walk(fullPath) : (entry.name.endsWith(".ts") ? [fullPath] : []);
-  });
-
-  const hash = crypto.createHash("sha256");
-  for (const filePath of walk(sharedDir).sort()) {
-    hash.update(path.relative(targetDir, filePath));
-    hash.update("\0");
-    hash.update(fs.readFileSync(filePath));
-    hash.update("\0");
-  }
-
-  const contract = JSON.parse(fs.readFileSync(contractPath, "utf8"));
-  contract.contract_hash = hash.digest("hex");
-  contract.last_updated = new Date().toISOString();
-  fs.writeFileSync(contractPath, JSON.stringify(contract, null, 2));
-}
-
-function createBaseTypeFiles(baseDir) {
-  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)}`);
-}
-
-function createBackendFiles(spec) {
-  createBaseTypeFiles(path.join(targetDir, "apps/backend/src"));
-  writeJsonFile(path.join(targetDir, "apps/backend/contract.version.json"), {
-    "contract_hash": "initial_hash_placeholder",
-    "last_updated": new Date().toISOString()
-  });
-  writeJsonFile(path.join(targetDir, "apps/backend/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": "^11.0.0",
-      fastify: "^5.0.0",
-      zod: "^3.24.2",
-    },
-    devDependencies: {
-      "@types/node": "^22.13.4",
-      tsx: "^4.19.4",
-      typescript: "^5.9.3",
-      vitest: "^3.0.5",
-    },
-  });
-
-  writeJsonFile(path.join(targetDir, "apps/backend/tsconfig.json"), {
-    extends: "../../tsconfig.json",
-    compilerOptions: {
-      outDir: "dist",
-      rootDir: "src",
-      module: "NodeNext",
-      moduleResolution: "NodeNext",
-      target: "ES2022",
-      strict: true,
-      skipLibCheck: true,
-    },
-    include: ["src/**/*.ts"],
-  });
-
-  writeTextFile(path.join(targetDir, "apps/backend/src/data.ts"), [
-    'import type { Customer, DashboardSummary, ReportMetric, Role, User } from "./types/index.js";',
-    "",
-    'const now = new Date().toISOString();',
-    "",
-    "export const roles: 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 users: User[] = [",
-    '  { id: "user_1" as User["id"], email: "admin@example.com", fullName: "Admin User", role: "ADMIN", createdAt: now },',
-    '  { id: "user_2" as User["id"], email: "manager@example.com", fullName: "Sales Manager", role: "DEVELOPER", createdAt: now },',
-    "];",
-    "",
-    "export const customers: Customer[] = [",
-    '  { id: "customer_1" as Customer["id"], name: "Northwind", ownerId: users[1].id, status: "ACTIVE", annualValue: 125000, createdAt: now },',
-    '  { id: "customer_2" as Customer["id"], name: "Acme Corp", ownerId: users[1].id, status: "LEAD", annualValue: 82000, createdAt: now },',
-    '  { id: "customer_3" as Customer["id"], name: "Globex", ownerId: users[0].id, status: "AT_RISK", annualValue: 54000, createdAt: now },',
-    "];",
-    "",
-    "export const reports: 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" },',
-    "];",
-    "",
-    "export function getDashboardSummary(): DashboardSummary {",
-    "  return { customers, users, roles, reports };",
-    "}",
-  ].join("\n"));
-
-  writeTextFile(path.join(targetDir, "apps/backend/src/server.ts"), [
-    'import Fastify from "fastify";',
-    'import cors from "@fastify/cors";',
-    'import { z } from "zod";',
-    'import { customers, getDashboardSummary, reports, roles, users } from "./data.js";',
-    "",
-    "const app = Fastify({ logger: true });",
-    "await app.register(cors, { origin: true });",
-    "",
-    'app.get("/health", async () => ({ ok: true, service: "agent-enderun-backend" }));',
-    'app.get("/api/v1/dashboard", async () => ({ data: getDashboardSummary() }));',
-    'app.get("/api/v1/users", async () => ({ data: users }));',
-    'app.get("/api/v1/roles", async () => ({ data: roles }));',
-    'app.get("/api/v1/customers", async () => ({ data: customers }));',
-    'app.get("/api/v1/reports", async () => ({ data: reports }));',
-    "",
-    '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 = users.find((item) => item.email === body.data.email) || users[0];",
-    "  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, "apps/backend/README.md"), [
-    `# ${spec.title} Backend`,
-    "",
-    "Fastify API generated by Agent Enderun.",
-    "",
-    "## Commands",
-    "",
-    "- `npm run dev`",
-    "- `npm run build`",
-    "- `npm run test`",
-  ].join("\n"));
-}
-
-function createWebFiles(spec) {
-  createBaseTypeFiles(path.join(targetDir, "apps/web/src"));
-  writeJsonFile(path.join(targetDir, "apps/web/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": "^5.0.0",
-      vite: "^7.0.0",
-      react: "^19.0.0",
-      "react-dom": "^19.0.0",
-      "lucide-react": "^0.468.0",
-    },
-    devDependencies: {
-      "@types/react": "^19.0.0",
-      "@types/react-dom": "^19.0.0",
-      typescript: "^5.9.3",
-      vitest: "^3.0.5",
-    },
-  });
-
-  writeJsonFile(path.join(targetDir, "apps/web/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, "apps/web/index.html"), [
-    '<div id="root"></div>',
-    '<script type="module" src="/src/main.tsx"></script>',
-  ].join("\n"));
-
-  writeTextFile(path.join(targetDir, "apps/web/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, "apps/web/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, "apps/web/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, "apps/web/README.md"), [
-    `# ${spec.title} Web`,
-    "",
-    "React dashboard generated by Agent Enderun.",
-    "",
-    "## Commands",
-    "",
-    "- `npm run dev`",
-    "- `npm run build`",
-    "- `npm run test`",
-  ].join("\n"));
-}
-
-function updateProjectDocs(spec) {
-  const frameworkDir = getFrameworkDir();
-  const docsDir = path.join(targetDir, frameworkDir, "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",
-    "",
-    "- `apps/backend`: Fastify API",
-    "- `apps/web`: React dashboard",
-    "- `apps/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"));
-}
-
-function updateMemoryForGeneratedApp(spec, traceId) {
-  const memoryPath = getMemoryPath();
-  if (!fs.existsSync(memoryPath)) return;
-
-  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:** apps/backend, apps/web, project docs",
-  ].join("\n");
-
-  updateProjectMemoryCommand("HISTORY", history);
-}
-
-async function collectCreateAppDescription(args) {
-  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();
-  }
-}
-
-async function createAppCommand(args) {
-  const description = await collectCreateAppDescription(args);
-  const spec = inferAppSpec(description);
-  const traceId = generateULID();
-
-  ensureDir(path.join(targetDir, "apps/backend"));
-  ensureDir(path.join(targetDir, "apps/web"));
-
-  createBackendFiles(spec);
-  createWebFiles(spec);
-  updateProjectDocs(spec);
-
-  const backendTypesPath = path.join(targetDir, "apps/backend/src/types/index.ts");
-  if (fs.existsSync(backendTypesPath)) {
-    const existing = fs.readFileSync(backendTypesPath, "utf8");
-    fs.writeFileSync(backendTypesPath, buildSharedTypesContent(existing));
-    updateContractHashFile();
-  }
-
-  const activeTraceId = traceNewCommand(`Generate ${spec.title} from natural language request`, "manager", "P1") || traceId;
-  updateMemoryForGeneratedApp(spec, activeTraceId);
-
-  console.warn(`\n✅ Created ${spec.title}`);
-  console.warn("📁 Generated apps/backend and apps/web");
-  console.warn("📜 Updated project docs and app-local types contract");
-  console.warn("\nNext commands:");
-  console.warn("  npm install");
-  console.warn("  npm run enderun:build");
-  console.warn("  agent-enderun frontend:dev\n");
-}
-
-// --- MAIN DISPATCHER ---
-
-async function main() {
-  const [command, ...args] = process.argv.slice(2);
-
-  // Skip header for version and mcp commands to keep output clean
-  if (command !== "version" && command !== "-v" && command !== "--version" && command !== "mcp") {
-    console.warn("🤖 Agent Enderun CLI — Initializing...");
-  }
-
-  switch (command) {
-    case "init":
-      await initCommand(args[0]);
-      break;
-    case "status":
-      statusCommand();
-      break;
-    case "trace:new":
-      if (!args[0]) {
-        console.error("❌ Usage: agent-enderun trace:new <description> [agent] [priority]");
-      } else {
-        traceNewCommand(args[0], args[1], args[2]);
-      }
-      break;
-    case "create-app":
-    case "new":
-    case "start":
-    case "build-app":
-      await createAppCommand(args);
-      break;
-    case "verify-contract":
-      verifyContractCommand();
-      break;
-    case "mcp": {
-      const mcpServerPath = path.join(sourceDir, "framework-mcp/dist/index.js");
-      if (fs.existsSync(mcpServerPath)) {
-        const { spawn } = await import("child_process");
-        // Use node to execute the built MCP server
-        const child = spawn("node", [mcpServerPath], { stdio: "inherit" });
-        child.on("exit", (code) => process.exit(code || 0));
-      } else {
-        console.error("❌ MCP Server not built. Run 'npm run enderun:build' first.");
-        process.exit(1);
-      }
-      break;
-    }
-    case "log_agent_action": {
-      // Handle both structured JSON and positional args
-      let data = {};
-      try {
-        if (args[0] && args[0].startsWith("{")) {
-          data = JSON.parse(args.join(" "));
-        } else {
-          data = {
-            agent: args[0],
-            action: args[1],
-            requestId: args[2],
-            status: args[3] || "SUCCESS",
-            summary: args[4] || "",
-          };
-        }
-      } catch {
-        console.error("❌ Error parsing arguments for log_agent_action");
-        process.exit(1);
-      }
-      logAgentActionCommand(data);
-      break;
-    }
-    case "update_project_memory": {
-      let section, content;
-      try {
-        if (args[0] && args[0].startsWith("{")) {
-          const data = JSON.parse(args.join(" "));
-          section = data.section;
-          content = data.content;
-        } else {
-          section = args[0];
-          content = args.slice(1).join(" ");
-        }
-      } catch {
-        console.error("❌ Error parsing arguments for update_project_memory");
-        process.exit(1);
-      }
-      updateProjectMemoryCommand(section, content);
-      break;
-    }
-    case "update_knowledge_base": {
-      const topic = args[0];
-      const content = args.slice(1).join(" ");
-      if (!topic || !content) {
-        console.error("❌ Usage: agent-enderun update_knowledge_base <topic> <content>");
-        process.exit(1);
-      }
-      const frameworkDir = getFrameworkDir();
-      const kbDir = path.join(targetDir, frameworkDir, "knowledge");
-      if (!fs.existsSync(kbDir)) fs.mkdirSync(kbDir, { recursive: true });
-      const fileName = topic.replace(/[^a-z0-9]/gi, "_").toLowerCase() + ".md";
-      fs.writeFileSync(path.join(kbDir, fileName), content);
-      console.warn(`✅ Knowledge base updated: ${topic}`);
-      break;
-    }
-    case "search_knowledge_base": {
-      const query = args[0];
-      if (!query) {
-        console.error("❌ Usage: agent-enderun search_knowledge_base <query>");
-        process.exit(1);
-      }
-      const frameworkDir = getFrameworkDir();
-      const kbDir = path.join(targetDir, frameworkDir, "knowledge");
-      if (!fs.existsSync(kbDir)) {
-        console.warn("ℹ️ Knowledge base is empty.");
-        break;
-      }
-      const files = fs.readdirSync(kbDir).filter(f => f.endsWith(".md"));
-      let found = false;
-      for (const file of files) {
-        const content = fs.readFileSync(path.join(kbDir, file), "utf-8");
-        if (content.toLowerCase().includes(query.toLowerCase()) || file.toLowerCase().includes(query.toLowerCase())) {
-          console.warn(`\n### ${file.replace(".md", "")}\n${content.slice(0, 300)}...`);
-          found = true;
-        }
-      }
-      if (!found) console.warn("ℹ️ No matching entries found.");
-      break;
-    }
-    case "check":
-      checkCommand();
-      break;
-    case "check:security":
-      securityAuditCommand(args[0] || ".");
-      break;
-    case "check:compliance":
-      complianceCheckCommand(args[0] || ".");
-      break;
-    case "git:commit":
-      gitCommitCommand(args[0] || "TRACE-ID-MISSING");
-      break;
-    case "explorer:graph":
-      explorerGraphCommand(args[0] || ".");
-      break;
-    case "explorer:audit":
-      explorerAuditCommand(args[0] || ".");
-      break;
-    case "frontend:dev":
-      runScriptCommand("dev", "apps/web");
-      break;
-    case "frontend:build":
-      runScriptCommand("build", "apps/web");
-      break;
-    case "mobile:dev":
-      runScriptCommand("start", "apps/mobile");
-      break;
-    case "git:sync":
-      gitSyncCommand();
-      break;
-    case "version":
-    case "-v":
-    case "--version":
-      console.warn(`v${FRAMEWORK_VERSION}`);
-      break;
-    default:
-      if (command && (command.includes(" ") || args.length > 0)) {
-        await createAppCommand([command, ...args]);
-        break;
-      }
-      console.warn(`
-🤖 Agent Enderun CLI (v${FRAMEWORK_VERSION})
-
-Available Commands:
-  init [adapter]      Initialize (gemini only - installs to .enderun/)
-  create-app <idea>   Generate a full-stack starter from natural language
-  check               Full health check
-  check:security      Run security audit scan
-  check:compliance    Run constitution compliance check
-  status              Show current phase and task status
-  trace:new <desc>    Generate a new Trace ID
-  verify-contract     Check shared types integrity
-  explorer:graph      Generate dependency graph
-  explorer:audit      Codebase intelligence scan
-  git:commit <id>     Suggest semantic commit message
-  mcp                 Start the MCP server
-  version             Show version information
-
-Supported adapter:
-  - gemini       → Creates .enderun/ + gemini.md for Gemini CLI users
-
-Example:
-  agent-enderun init
-  agent-enderun init gemini
-  agent-enderun trace:new "Auth module design" backend P1
-      `);
-      break;
-  }
-}
-
-main().catch(console.error);