@gravito/scaffold 3.0.0 → 3.0.1

package/dist/index.cjs

@@ -144,12 +144,52 @@ ${overlay}`;
 };
 
 // src/generators/BaseGenerator.ts
-var import_promises2 = __toESM(require("fs/promises"), 1);
-var import_node_path2 = __toESM(require("path"), 1);
+var import_promises4 = __toESM(require("fs/promises"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
 
-// src/generators/StubGenerator.ts
+// src/utils/FileUtilities.ts
 var import_promises = __toESM(require("fs/promises"), 1);
 var import_node_path = __toESM(require("path"), 1);
+var FileUtilities = class _FileUtilities {
+  static async walk(dir) {
+    const files = await import_promises.default.readdir(dir);
+    const paths = [];
+    for (const file of files) {
+      const filePath = import_node_path.default.join(dir, file);
+      const stat = await import_promises.default.stat(filePath);
+      if (stat.isDirectory()) {
+        paths.push(...await _FileUtilities.walk(filePath));
+      } else {
+        paths.push(filePath);
+      }
+    }
+    return paths;
+  }
+  static async writeFile(basePath, relativePath, content, fileMerger, log) {
+    const fullPath = import_node_path.default.resolve(basePath, relativePath);
+    await import_promises.default.mkdir(import_node_path.default.dirname(fullPath), { recursive: true });
+    let finalContent = content;
+    try {
+      const existingContent = await import_promises.default.readFile(fullPath, "utf-8");
+      finalContent = fileMerger.merge(relativePath, existingContent, content);
+      if (finalContent !== content) {
+        log?.(`\u{1F504} Merged file: ${relativePath}`);
+      }
+    } catch {
+    }
+    await import_promises.default.writeFile(fullPath, finalContent, "utf-8");
+    log?.(`\u{1F4C4} Created file: ${relativePath}`);
+    return fullPath;
+  }
+};
+
+// src/utils/TemplateManager.ts
+var import_promises3 = __toESM(require("fs/promises"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
+
+// src/generators/StubGenerator.ts
+var import_promises2 = __toESM(require("fs/promises"), 1);
+var import_node_path2 = __toESM(require("path"), 1);
 var import_handlebars = __toESM(require("handlebars"), 1);
 var StubGenerator = class {
   config;
@@ -238,16 +278,16 @@ var StubGenerator = class {
    * @returns Path to the generated file
    */
   async generate(stubName, outputPath, variables = {}) {
-    const stubPath = import_node_path.default.resolve(this.config.stubsDir, stubName);
-    const template = await import_promises.default.readFile(stubPath, "utf-8");
+    const stubPath = import_node_path2.default.resolve(this.config.stubsDir, stubName);
+    const template = await import_promises2.default.readFile(stubPath, "utf-8");
     const compiled = this.handlebars.compile(template);
     const content = compiled({
       ...this.config.defaultVariables,
       ...variables
     });
-    const fullOutputPath = import_node_path.default.resolve(this.config.outputDir, outputPath);
-    await import_promises.default.mkdir(import_node_path.default.dirname(fullOutputPath), { recursive: true });
-    await import_promises.default.writeFile(fullOutputPath, content, "utf-8");
+    const fullOutputPath = import_node_path2.default.resolve(this.config.outputDir, outputPath);
+    await import_promises2.default.mkdir(import_node_path2.default.dirname(fullOutputPath), { recursive: true });
+    await import_promises2.default.writeFile(fullOutputPath, content, "utf-8");
     return fullOutputPath;
   }
   /**
@@ -299,41 +339,57 @@ var StubGenerator = class {
   }
 };
 
-// src/generators/BaseGenerator.ts
-async function walk(dir) {
-  const files = await import_promises2.default.readdir(dir);
-  const paths = [];
-  for (const file of files) {
-    const filePath = import_node_path2.default.join(dir, file);
-    const stat = await import_promises2.default.stat(filePath);
-    if (stat.isDirectory()) {
-      paths.push(...await walk(filePath));
-    } else {
-      paths.push(filePath);
+// src/utils/TemplateManager.ts
+var TemplateManager = class {
+  stubGenerator;
+  constructor(templatesDir) {
+    this.stubGenerator = new StubGenerator({
+      stubsDir: templatesDir,
+      outputDir: ""
+    });
+  }
+  render(template, context) {
+    return this.stubGenerator.render(template, context);
+  }
+  async applyOverlay(sourceDir, targetDir, context, fileMerger, log) {
+    const createdFiles = [];
+    try {
+      await import_promises3.default.access(sourceDir);
+    } catch {
+      return [];
+    }
+    const files = await FileUtilities.walk(sourceDir);
+    for (const filePath of files) {
+      const relativePath = import_node_path3.default.relative(sourceDir, filePath);
+      let content = await import_promises3.default.readFile(filePath, "utf-8");
+      try {
+        content = this.render(content, context);
+      } catch {
+      }
+      const fullPath = await FileUtilities.writeFile(
+        targetDir,
+        relativePath,
+        content,
+        fileMerger,
+        log
+      );
+      createdFiles.push(fullPath);
     }
+    return createdFiles;
   }
-  return paths;
-}
+};
+
+// src/generators/BaseGenerator.ts
 var BaseGenerator = class {
   config;
-  stubGenerator;
+  templateManager;
   fileMerger;
   filesCreated = [];
   constructor(config) {
     this.config = config;
-    this.stubGenerator = new StubGenerator({
-      stubsDir: config.templatesDir,
-      outputDir: ""
-      // Set per-generation
-    });
+    this.templateManager = new TemplateManager(config.templatesDir);
     this.fileMerger = new FileMerger();
   }
-  /**
-   * Generate the project scaffold.
-   *
-   * @param context - Generator context
-   * @returns Array of created file paths
-   */
   async generate(context) {
     this.filesCreated = [];
     const structure = this.getDirectoryStructure(context);
@@ -343,50 +399,73 @@ var BaseGenerator = class {
     await this.applyFeatureOverlays(context);
     return this.filesCreated;
   }
-  /**
-   * Create directory structure recursively.
-   */
   async createStructure(basePath, nodes, context) {
     for (const node of nodes) {
-      const fullPath = import_node_path2.default.resolve(basePath, node.name);
+      const fullPath = import_node_path4.default.resolve(basePath, node.name);
       if (node.type === "directory") {
-        await import_promises2.default.mkdir(fullPath, { recursive: true });
+        await import_promises4.default.mkdir(fullPath, { recursive: true });
         this.log(`\u{1F4C1} Created directory: ${node.name}`);
         if (node.children) {
           await this.createStructure(fullPath, node.children, context);
         }
       } else {
-        await import_promises2.default.mkdir(import_node_path2.default.dirname(fullPath), { recursive: true });
+        await import_promises4.default.mkdir(import_node_path4.default.dirname(fullPath), { recursive: true });
+        let content = "";
         if (node.template) {
-          const templatePath = import_node_path2.default.resolve(this.config.templatesDir, node.template);
           try {
-            const template = await import_promises2.default.readFile(templatePath, "utf-8");
-            const content = this.stubGenerator.render(template, context);
-            await import_promises2.default.writeFile(fullPath, content, "utf-8");
+            const templatePath = import_node_path4.default.resolve(this.config.templatesDir, node.template);
+            const template = await import_promises4.default.readFile(templatePath, "utf-8");
+            content = this.templateManager.render(template, context);
           } catch {
-            await import_promises2.default.writeFile(fullPath, node.content ?? "", "utf-8");
+            content = node.content ?? "";
           }
-        } else if (node.content) {
-          await import_promises2.default.writeFile(fullPath, node.content, "utf-8");
         } else {
-          await import_promises2.default.writeFile(fullPath, "", "utf-8");
+          content = node.content ?? "";
         }
-        this.filesCreated.push(fullPath);
-        this.log(`\u{1F4C4} Created file: ${node.name}`);
+        const relativePath = import_node_path4.default.relative(context.targetDir, fullPath);
+        const writtenPath = await FileUtilities.writeFile(
+          context.targetDir,
+          relativePath,
+          content,
+          this.fileMerger,
+          (msg) => this.log(msg)
+        );
+        this.filesCreated.push(writtenPath);
       }
     }
   }
-  /**
-   * Generate common files (package.json, .env, etc.)
-   */
   async generateCommonFiles(context) {
+    const commonDir = import_node_path4.default.resolve(this.config.templatesDir, "common");
+    const extendedContext = {
+      ...context,
+      entrypoint: context.architecture === "ddd" ? "dist/main.js" : "dist/bootstrap.js",
+      dbConnection: context.profile === "core" ? "sqlite" : "postgres"
+    };
+    await this.generateFileFromTemplate(
+      commonDir,
+      "env.example.hbs",
+      ".env.example",
+      extendedContext
+    );
+    await this.generateFileFromTemplate(commonDir, "env.example.hbs", ".env", extendedContext);
+    await this.generateFileFromTemplate(commonDir, "gitignore.hbs", ".gitignore", extendedContext);
+    await this.generateFileFromTemplate(
+      commonDir,
+      "tsconfig.json.hbs",
+      "tsconfig.json",
+      extendedContext
+    );
+    await this.generateFileFromTemplate(commonDir, "Dockerfile.hbs", "Dockerfile", extendedContext);
     await this.writeFile(context.targetDir, "package.json", this.generatePackageJson(context));
-    await this.writeFile(context.targetDir, ".env.example", this.generateEnvExample(context));
-    await this.writeFile(context.targetDir, ".env", this.generateEnvExample(context));
-    await this.writeFile(context.targetDir, ".gitignore", this.generateGitignore());
-    await this.writeFile(context.targetDir, "tsconfig.json", this.generateTsConfig());
-    await this.writeFile(context.targetDir, "Dockerfile", this.generateDockerfile(context));
-    await this.writeFile(context.targetDir, ".dockerignore", this.generateDockerIgnore());
+    await this.writeFile(
+      context.targetDir,
+      ".dockerignore",
+      `node_modules
+dist
+.git
+.env
+`
+    );
     await this.writeFile(
       context.targetDir,
       "ARCHITECTURE.md",
@@ -395,104 +474,74 @@ var BaseGenerator = class {
     await this.generateCheckScripts(context);
     await this.generateSkills(context);
   }
-  /**
-   * Copy AI Skills to the project
-   */
-  async generateSkills(context) {
-    const skillsDir = import_node_path2.default.resolve(this.config.templatesDir, "skills");
-    const targetSkillsDir = import_node_path2.default.join(".skills");
+  async generateFileFromTemplate(tplDir, tplName, targetName, context) {
     try {
-      await import_promises2.default.access(skillsDir);
-    } catch {
-      return;
-    }
-    const files = await walk(skillsDir);
-    for (const filePath of files) {
-      const relativePath = import_node_path2.default.relative(skillsDir, filePath);
-      const targetPath = import_node_path2.default.join(targetSkillsDir, relativePath);
-      let content = await import_promises2.default.readFile(filePath, "utf-8");
-      try {
-        content = this.stubGenerator.render(content, context);
-      } catch {
-      }
-      await this.writeFile(context.targetDir, targetPath, content);
+      const template = await import_promises4.default.readFile(import_node_path4.default.join(tplDir, tplName), "utf-8");
+      const content = this.templateManager.render(template, context);
+      await this.writeFile(context.targetDir, targetName, content);
+    } catch (e) {
+      this.log(`\u26A0\uFE0F Failed to generate ${targetName}: ${e}`);
     }
   }
-  /**
-   * Apply profile-specific overlays
-   */
+  async generateSkills(context) {
+    const skillsDir = import_node_path4.default.resolve(this.config.templatesDir, "skills");
+    const created = await this.templateManager.applyOverlay(
+      skillsDir,
+      import_node_path4.default.join(context.targetDir, ".skills"),
+      context,
+      this.fileMerger,
+      (msg) => this.log(msg)
+    );
+    this.filesCreated.push(...created);
+  }
   async applyOverlays(context) {
     const profile = context.profile;
-    if (!profile) return;
-    const overlayDir = import_node_path2.default.resolve(this.config.templatesDir, "overlays", profile);
-    await this.copyOverlayDirectory(overlayDir, context);
+    if (profile) {
+      const overlayDir = import_node_path4.default.resolve(this.config.templatesDir, "overlays", profile);
+      await this.copyOverlayDirectory(overlayDir, context);
+    }
   }
-  /**
-   * Apply feature-specific overlays
-   */
   async applyFeatureOverlays(context) {
     const features = context.features || [];
     for (const feature of features) {
-      const overlayDir = import_node_path2.default.resolve(this.config.templatesDir, "features", feature);
+      const overlayDir = import_node_path4.default.resolve(this.config.templatesDir, "features", feature);
       await this.copyOverlayDirectory(overlayDir, context);
     }
   }
-  /**
-   * Helper to copy/merge an overlay directory into the target
-   */
   async copyOverlayDirectory(sourceDir, context) {
-    try {
-      await import_promises2.default.access(sourceDir);
-    } catch {
-      return;
-    }
-    const files = await walk(sourceDir);
-    for (const filePath of files) {
-      const relativePath = import_node_path2.default.relative(sourceDir, filePath);
-      let content = await import_promises2.default.readFile(filePath, "utf-8");
-      try {
-        content = this.stubGenerator.render(content, context);
-      } catch {
-      }
-      await this.writeFile(context.targetDir, relativePath, content);
-    }
+    const created = await this.templateManager.applyOverlay(
+      sourceDir,
+      context.targetDir,
+      context,
+      this.fileMerger,
+      (msg) => this.log(msg)
+    );
+    this.filesCreated.push(...created);
   }
-  /**
-   * Write a file and track it.
-   */
   async writeFile(basePath, relativePath, content) {
-    const fullPath = import_node_path2.default.resolve(basePath, relativePath);
-    await import_promises2.default.mkdir(import_node_path2.default.dirname(fullPath), { recursive: true });
-    let finalContent = content;
-    try {
-      const existingContent = await import_promises2.default.readFile(fullPath, "utf-8");
-      finalContent = this.fileMerger.merge(relativePath, existingContent, content);
-      if (finalContent !== content) {
-        this.log(`\u{1F504} Merged file: ${relativePath}`);
-      }
-    } catch {
-    }
-    await import_promises2.default.writeFile(fullPath, finalContent, "utf-8");
-    this.filesCreated.push(fullPath);
-    this.log(`\u{1F4C4} Created file: ${relativePath}`);
+    const writtenPath = await FileUtilities.writeFile(
+      basePath,
+      relativePath,
+      content,
+      this.fileMerger,
+      (msg) => this.log(msg)
+    );
+    this.filesCreated.push(writtenPath);
   }
-  /**
-   * Generate package.json content.
-   */
   generatePackageJson(context) {
     const profile = context.profile || "core";
-    const baseDependencies = {
+    const deps = {
       "@gravito/core": "^1.0.0-beta.5",
       "@gravito/atlas": "^1.0.0-beta.5",
       "@gravito/plasma": "^1.0.0-beta.5",
       "@gravito/stream": "^1.0.0-beta.5"
     };
     if (profile === "enterprise" || profile === "scale") {
-      baseDependencies["@gravito/quasar"] = "^1.0.0-beta.5";
-      baseDependencies["@gravito/horizon"] = "^1.0.0-beta.5";
+      deps["@gravito/quasar"] = "^1.0.0-beta.5";
+      deps["@gravito/horizon"] = "^1.0.0-beta.5";
     }
     if (context.withSpectrum) {
-      baseDependencies["@gravito/spectrum"] = "^1.0.0-beta.1";
+      deps["@gravito/spectrum"] = "^1.0.0-beta.5";
     }
     const pkg = {
       name: context.nameKebabCase,
@@ -503,717 +552,426 @@ var BaseGenerator = class {
         build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
         start: "bun run dist/bootstrap.js",
         test: "bun test",
-        typecheck: "tsc --noEmit",
-        check: "bun run typecheck && bun run test",
-        "check:deps": "bun run scripts/check-dependencies.ts",
-        validate: "bun run check && bun run check:deps",
-        precommit: "bun run validate",
-        "docker:build": `docker build -t ${context.nameKebabCase} .`,
-        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
+        typecheck: "bun tsc --noEmit",
+        validate: "bun run typecheck && bun run test"
       },
-      dependencies: baseDependencies,
-      devDependencies: {
-        "bun-types": "latest",
-        typescript: "^5.0.0"
-      }
+      dependencies: deps,
+      devDependencies: { "bun-types": "latest", typescript: "^5.9.3" }
     };
     return JSON.stringify(pkg, null, 2);
   }
+  async generateCheckScripts(context) {
+    const scriptsDir = import_node_path4.default.resolve(context.targetDir, "scripts");
+    await import_promises4.default.mkdir(scriptsDir, { recursive: true });
+    const templatesDir = import_node_path4.default.resolve(this.config.templatesDir, "scripts");
+    await this.generateFileFromTemplate(
+      templatesDir,
+      "check-dependencies.ts.hbs",
+      "scripts/check-dependencies.ts",
+      context
+    );
+    await this.generateFileFromTemplate(templatesDir, "check.sh.hbs", "scripts/check.sh", context);
+    await this.generateFileFromTemplate(
+      templatesDir,
+      "pre-commit.sh.hbs",
+      "scripts/pre-commit.sh",
+      context
+    );
+    await this.writeFile(
+      context.targetDir,
+      "CHECK_SYSTEM.md",
+      "# Project Check System\n\nRun `bun run validate` to check everything.\n"
+    );
+  }
+  log(message) {
+    if (this.config.verbose) {
+      console.log(message);
+    }
+  }
+  static createContext(name, targetDir, architecture, packageManager = "bun", extra = {}) {
+    const toPascalCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1 $2").split(/[-_ ]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+    const toCamelCase = (str) => {
+      const pascal = toPascalCase(str);
+      return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+    };
+    const toSnakeCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1_$2").split(/[-_ ]+/).map((word) => word.toLowerCase()).join("_");
+    const toKebabCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1-$2").split(/[-_ ]+/).map((word) => word.toLowerCase()).join("-");
+    return {
+      name,
+      namePascalCase: toPascalCase(name),
+      nameCamelCase: toCamelCase(name),
+      nameSnakeCase: toSnakeCase(name),
+      nameKebabCase: toKebabCase(name),
+      targetDir,
+      architecture,
+      packageManager,
+      year: (/* @__PURE__ */ new Date()).getFullYear().toString(),
+      date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+      ...extra
+    };
+  }
+};
+
+// src/utils/ConfigGenerator.ts
+var ConfigGenerator = class {
   /**
-   * Generate Dockerfile content.
+   * Generate app configuration (simple version for Clean Architecture)
    */
-  generateDockerfile(context) {
-    const entrypoint = context.architecture === "ddd" ? "dist/main.js" : "dist/bootstrap.js";
-    return `FROM oven/bun:1.0 AS base
-WORKDIR /usr/src/app
-
-# Install dependencies
-FROM base AS install
-RUN mkdir -p /temp/dev
-COPY package.json bun.lockb /temp/dev/
-RUN cd /temp/dev && bun install --frozen-lockfile
-
-# Build application
-FROM base AS build
-COPY --from=install /temp/dev/node_modules node_modules
-COPY . .
-ENV NODE_ENV=production
-RUN bun run build
-
-# Final production image
-FROM base AS release
-COPY --from=build /usr/src/app/${entrypoint} index.js
-COPY --from=build /usr/src/app/package.json .
-
-# Create a non-root user for security
-USER bun
-EXPOSE 3000/tcp
-ENTRYPOINT [ "bun", "run", "index.js" ]
+  static generateSimpleAppConfig(context) {
+    return `export default {
+  name: process.env.APP_NAME ?? '${context.name}',
+  env: process.env.APP_ENV ?? 'development',
+  debug: process.env.APP_DEBUG === 'true',
+  url: process.env.APP_URL ?? 'http://localhost:3000',
+  key: process.env.APP_KEY,
+}
 `;
   }
   /**
-   * Generate .dockerignore content.
+   * Generate app configuration (detailed version for Enterprise MVC)
    */
-  generateDockerIgnore() {
-    return `node_modules
-dist
-.git
-.env
-*.log
-.vscode
-.idea
-tests
-`;
-  }
+  static generateDetailedAppConfig(context) {
+    return `/**
+ * Application Configuration
+ */
+export default {
   /**
-   * Generate .env.example content.
+   * Application name
    */
-  generateEnvExample(context) {
-    const profile = context.profile || "core";
-    let envContent = `# ============================================================================
-# Application Configuration
-# ============================================================================
-
-APP_NAME=${context.name}
-APP_ENV=development
-APP_DEBUG=true
-APP_URL=http://localhost:3000
-APP_KEY=
-
-# ============================================================================
-# Database Configuration
-# ============================================================================
-
-# Database Connection (sqlite, postgres, mysql)
-DB_CONNECTION=${profile === "core" ? "sqlite" : "postgres"}
-
-# SQLite Configuration (when DB_CONNECTION=sqlite)
-DB_DATABASE=database/database.sqlite
-
-# PostgreSQL Configuration (when DB_CONNECTION=postgres)
-${profile !== "core" ? `DB_HOST=127.0.0.1
-DB_PORT=5432
-DB_DATABASE=${context.name}
-DB_USERNAME=postgres
-DB_PASSWORD=
-DB_SSLMODE=prefer` : `# DB_HOST=127.0.0.1
-# DB_PORT=5432
-# DB_DATABASE=${context.name}
-# DB_USERNAME=postgres
-# DB_PASSWORD=
-# DB_SSLMODE=prefer`}
-
-# MySQL Configuration (when DB_CONNECTION=mysql)
-# DB_HOST=127.0.0.1
-# DB_PORT=3306
-# DB_DATABASE=${context.name}
-# DB_USERNAME=root
-# DB_PASSWORD=
-
-# ============================================================================
-# Redis Configuration (@gravito/plasma)
-# ============================================================================
-
-# Default Redis Connection
-REDIS_CONNECTION=default
-REDIS_HOST=127.0.0.1
-REDIS_PORT=6379
-REDIS_PASSWORD=
-REDIS_DB=0
-
-# Redis Connection Options
-REDIS_CONNECT_TIMEOUT=10000
-REDIS_COMMAND_TIMEOUT=5000
-REDIS_KEY_PREFIX=
-REDIS_MAX_RETRIES=3
-REDIS_RETRY_DELAY=1000
-
-# Cache-specific Redis Connection (optional, falls back to default)
-# REDIS_CACHE_HOST=127.0.0.1
-# REDIS_CACHE_PORT=6379
-# REDIS_CACHE_PASSWORD=
-REDIS_CACHE_DB=1
-
-# Queue-specific Redis Connection (optional, falls back to default)
-# REDIS_QUEUE_HOST=127.0.0.1
-# REDIS_QUEUE_PORT=6379
-# REDIS_QUEUE_PASSWORD=
-REDIS_QUEUE_DB=2
-
-# ============================================================================
-# Cache Configuration (@gravito/stasis)
-# ============================================================================
-
-# Cache Driver (memory, file, redis)
-CACHE_DRIVER=${profile === "core" ? "memory" : "redis"}
-
-# File Cache Path (when CACHE_DRIVER=file)
-CACHE_PATH=storage/framework/cache
-
-# Redis Cache Configuration (when CACHE_DRIVER=redis)
-REDIS_CACHE_CONNECTION=cache
-REDIS_CACHE_PREFIX=cache:
-
-# ============================================================================
-# Queue Configuration (@gravito/stream)
-# ============================================================================
-
-# Queue Connection (sync, memory, database, redis, kafka, sqs, rabbitmq)
-QUEUE_CONNECTION=${profile === "core" ? "sync" : "redis"}
-
-# Database Queue Configuration (when QUEUE_CONNECTION=database)
-QUEUE_TABLE=jobs
-
-# Redis Queue Configuration (when QUEUE_CONNECTION=redis)
-REDIS_PREFIX=queue:
+  name: process.env.APP_NAME ?? '${context.name}',
 
-`;
-    if (profile === "enterprise" || profile === "scale") {
-      envContent += `# Kafka Queue Configuration (when QUEUE_CONNECTION=kafka)
-# KAFKA_BROKERS=localhost:9092
-# KAFKA_CONSUMER_GROUP_ID=gravito-workers
-# KAFKA_CLIENT_ID=${context.name}
-
-# AWS SQS Queue Configuration (when QUEUE_CONNECTION=sqs)
-# AWS_REGION=us-east-1
-# SQS_QUEUE_URL_PREFIX=
-# SQS_VISIBILITY_TIMEOUT=30
-# SQS_WAIT_TIME_SECONDS=20
-
-# RabbitMQ Queue Configuration (when QUEUE_CONNECTION=rabbitmq)
-# RABBITMQ_URL=amqp://localhost
-# RABBITMQ_EXCHANGE=gravito.events
-# RABBITMQ_EXCHANGE_TYPE=fanout
+  /**
+   * Application environment
+   */
+  env: process.env.APP_ENV ?? 'development',
 
-`;
-    }
-    envContent += `# ============================================================================
-# Logging Configuration
-# ============================================================================
+  /**
+   * Application port
+   */
+  port: Number.parseInt(process.env.PORT ?? '3000', 10),
 
-LOG_LEVEL=debug
-`;
-    return envContent;
-  }
   /**
-   * Generate .gitignore content.
+   * View directory
    */
-  generateGitignore() {
-    return `# Dependencies
-node_modules/
+  VIEW_DIR: process.env.VIEW_DIR ?? 'src/views',
 
-# Build output
-dist/
+  /**
+   * Debug mode
+   */
+  debug: process.env.APP_DEBUG === 'true',
 
-# Environment
-.env
-.env.local
-.env.*.local
+  /**
+   * Application URL
+   */
+  url: process.env.APP_URL ?? 'http://localhost:3000',
 
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
+  /**
+   * Timezone
+   */
+  timezone: 'UTC',
 
-# System
-.DS_Store
-Thumbs.db
+  /**
+   * Locale
+   */
+  locale: 'en',
 
-# Logs
-*.log
-logs/
+  /**
+   * Fallback locale
+   */
+  fallbackLocale: 'en',
 
-# Database
-*.sqlite
-*.sqlite-journal
+  /**
+   * Encryption key
+   */
+  key: process.env.APP_KEY,
 
-# Coverage
-coverage/
-`;
-  }
   /**
-   * Generate tsconfig.json content.
+   * Service providers to register
    */
-  generateTsConfig() {
-    const config = {
-      compilerOptions: {
-        target: "ESNext",
-        module: "ESNext",
-        moduleResolution: "bundler",
-        esModuleInterop: true,
-        strict: true,
-        skipLibCheck: true,
-        declaration: true,
-        experimentalDecorators: true,
-        emitDecoratorMetadata: true,
-        types: ["bun-types"],
-        outDir: "./dist",
-        rootDir: "./src",
-        baseUrl: ".",
-        paths: {
-          "@/*": ["./src/*"]
-        }
-      },
-      include: ["src/**/*"],
-      exclude: ["node_modules", "dist"]
-    };
-    return JSON.stringify(config, null, 2);
+  providers: [
+    // Framework providers
+    // 'RouteServiceProvider',
+
+    // Application providers
+    // 'AppServiceProvider',
+  ],
+}
+`;
   }
   /**
-   * Generate check scripts for project validation.
+   * Generate database configuration (simple version)
    */
-  async generateCheckScripts(context) {
-    const scriptsDir = import_node_path2.default.resolve(context.targetDir, "scripts");
-    await import_promises2.default.mkdir(scriptsDir, { recursive: true });
-    await this.writeFile(
-      scriptsDir,
-      "check-dependencies.ts",
-      this.generateCheckDependenciesScript()
-    );
-    await this.writeFile(scriptsDir, "check.sh", this.generateCheckShellScript());
-    await this.writeFile(scriptsDir, "pre-commit.sh", this.generatePreCommitScript());
-    await this.writeFile(context.targetDir, "CHECK_SYSTEM.md", this.generateCheckSystemDoc(context));
+  static generateSimpleDatabaseConfig() {
+    return `export default {
+  default: process.env.DB_CONNECTION ?? 'sqlite',
+  connections: {
+    sqlite: {
+      driver: 'sqlite',
+      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
+    },
+  },
+}
+`;
   }
   /**
-   * Generate check-dependencies.ts script content.
+   * Generate database configuration (detailed version)
    */
-  generateCheckDependenciesScript() {
+  static generateDetailedDatabaseConfig() {
     return `/**
- * \u76F8\u4F9D\u5957\u4EF6\u7248\u672C\u6AA2\u67E5\u8173\u672C
- * 
- * \u6AA2\u67E5 package.json \u4E2D\u7684\u5957\u4EF6\u662F\u5426\u70BA\u6700\u65B0\u7A69\u5B9A\u7248\u672C
- * \u4E26\u63D0\u4F9B\u66F4\u65B0\u5EFA\u8B70
+ * Database Configuration
  */
+export default {
+  /**
+   * Default connection
+   */
+  default: process.env.DB_CONNECTION ?? 'sqlite',
 
-import { readFileSync } from 'fs'
-import { join } from 'path'
-
-interface PackageJson {
-  dependencies?: Record<string, string>
-  devDependencies?: Record<string, string>
-}
-
-interface PackageInfo {
-  name: string
-  current: string
-  latest: string
-  outdated: boolean
-}
+  /**
+   * Database connections
+   */
+  connections: {
+    sqlite: {
+      driver: 'sqlite',
+      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
+    },
 
-const colors = {
-  reset: '\\x1b[0m',
-  green: '\\x1b[32m',
-  yellow: '\\x1b[33m',
-  red: '\\x1b[31m',
-  blue: '\\x1b[36m',
-}
+    mysql: {
+      driver: 'mysql',
+      host: process.env.DB_HOST ?? 'localhost',
+      port: Number(process.env.DB_PORT ?? 3306),
+      database: process.env.DB_DATABASE ?? 'forge',
+      username: process.env.DB_USERNAME ?? 'forge',
+      password: process.env.DB_PASSWORD ?? '',
+    },
 
-function log(message: string, color: keyof typeof colors = 'reset') {
-  console.log(\`\${colors[color]}\${message}\${colors.reset}\`)
-}
+    postgres: {
+      driver: 'postgres',
+      host: process.env.DB_HOST ?? 'localhost',
+      port: Number(process.env.DB_PORT ?? 5432),
+      database: process.env.DB_DATABASE ?? 'forge',
+      username: process.env.DB_USERNAME ?? 'forge',
+      password: process.env.DB_PASSWORD ?? '',
+    },
+  },
 
-async function getLatestVersion(packageName: string): Promise<string | null> {
-  try {
-    const response = await fetch(\`https://registry.npmjs.org/\${packageName}/latest\`)
-    if (!response.ok) return null
-    const data = await response.json()
-    return data.version
-  } catch {
-    return null
+  /**
+   * Migration settings
+   */
+  migrations: {
+    table: 'migrations',
+    path: 'database/migrations',
+  },
+}
+`;
   }
+  /**
+   * Generate auth configuration
+   */
+  static generateAuthConfig() {
+    return `export default {
+  defaults: { guard: 'web' },
+  guards: {
+    web: { driver: 'session', provider: 'users' },
+    api: { driver: 'token', provider: 'users' },
+  },
 }
-
-function parseVersion(version: string): string {
-  // \u79FB\u9664 ^, ~, >= \u7B49\u524D\u7DB4
-  return version.replace(/^[\\^~>=<]/, '')
+`;
+  }
+  /**
+   * Generate cache configuration
+   */
+  static generateCacheConfig() {
+    return `export default {
+  default: process.env.CACHE_DRIVER ?? 'memory',
+  stores: {
+    memory: { driver: 'memory' },
+  },
+}
+`;
+  }
+  /**
+   * Generate logging configuration
+   */
+  static generateLoggingConfig() {
+    return `export default {
+  default: process.env.LOG_CHANNEL ?? 'console',
+  channels: {
+    console: { driver: 'console', level: process.env.LOG_LEVEL ?? 'debug' },
+  },
 }
+`;
+  }
+  /**
+   * Generate view configuration
+   */
+  static generateViewConfig() {
+    return `/**
+ * View Configuration
+ */
+export default {
+  /**
+   * View engine
+   */
+  engine: 'html',
 
-async function checkPackage(
-  name: string,
-  currentVersion: string
-): Promise<PackageInfo | null> {
-  // \u8DF3\u904E\u672C\u5730\u9023\u7D50\u7684\u5957\u4EF6
-  if (currentVersion.startsWith('link:') || currentVersion.startsWith('workspace:')) {
-    return null
+  /**
+   * View directory
+   */
+  path: 'src/views',
+
+  /**
+   * Cache views in production
+   */
+  cache: process.env.NODE_ENV === 'production',
+}
+`;
   }
+};
+
+// src/utils/ServiceProviderGenerator.ts
+var ServiceProviderGenerator = class {
+  /**
+   * Generate App Service Provider
+   */
+  static generateAppServiceProvider(context, architectureName) {
+    return `/**
+ * App Service Provider
+ */
 
-  const current = parseVersion(currentVersion)
-  const latest = await getLatestVersion(name)
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
-  if (!latest) {
-    return null
+export class AppServiceProvider extends ServiceProvider {
+  register(_container: Container): void {
+    // Register application services
   }
 
-  return {
-    name,
-    current,
-    latest,
-    outdated: current !== latest,
+  boot(_core: PlanetCore): void {
+    console.log('${context.name} (${architectureName}) booted!')
   }
 }
+`;
+  }
+  /**
+   * Generate Middleware Provider
+   */
+  static generateMiddlewareProvider() {
+    return `/**
+ * Middleware Service Provider
+ */
 
-async function main() {
-  log('\\n=== \u76F8\u4F9D\u5957\u4EF6\u7248\u672C\u6AA2\u67E5 ===\\n', 'blue')
+import {
+  ServiceProvider,
+  type Container,
+  type PlanetCore,
+  bodySizeLimit,
+  securityHeaders,
+} from '@gravito/core'
 
-  const packageJsonPath = join(process.cwd(), 'package.json')
-  const packageJson: PackageJson = JSON.parse(
-    readFileSync(packageJsonPath, 'utf-8')
-  )
+export class MiddlewareProvider extends ServiceProvider {
+  register(_container: Container): void {}
 
-  const allDependencies = {
-    ...packageJson.dependencies,
-    ...packageJson.devDependencies,
-  }
+  boot(core: PlanetCore): void {
+    const isDev = process.env.NODE_ENV !== 'production'
 
-  log(\`\u6AA2\u67E5 \${Object.keys(allDependencies).length} \u500B\u5957\u4EF6...\\n\`, 'yellow')
+    core.adapter.use('*', securityHeaders({
+      contentSecurityPolicy: isDev ? false : undefined,
+    }))
 
-  const results: PackageInfo[] = []
-  const outdated: PackageInfo[] = []
-  const upToDate: PackageInfo[] = []
+    core.adapter.use('*', bodySizeLimit(10 * 1024 * 1024))
 
-  // \u6AA2\u67E5\u6240\u6709\u5957\u4EF6
-  for (const [name, version] of Object.entries(allDependencies)) {
-    const info = await checkPackage(name, version)
-    if (info) {
-      results.push(info)
-      if (info.outdated) {
-        outdated.push(info)
-      } else {
-        upToDate.push(info)
-      }
-    }
+    core.logger.info('\u{1F6E1}\uFE0F Middleware registered')
   }
-
-  // \u986F\u793A\u7D50\u679C
-  if (upToDate.length > 0) {
-    log(\`\\n\u2713 \u5DF2\u662F\u6700\u65B0\u7248\u672C (\${upToDate.length}):\`, 'green')
-    upToDate.forEach((pkg) => {
-      log(\`  \${pkg.name}: \${pkg.current}\`, 'green')
-    })
+}
+`;
   }
+  /**
+   * Generate Route Provider
+   */
+  static generateRouteProvider(routePath = "../../routes/api", importType = "default") {
+    const importStatement = importType === "default" ? `import routes from '${routePath}'` : `import { registerApiRoutes } from '${routePath}'`;
+    const routeCall = importType === "default" ? "routes(core.router)" : "registerApiRoutes(core.router)";
+    return `/**
+ * Route Service Provider
+ */
 
-  if (outdated.length > 0) {
-    log(\`\\n\u26A0 \u9700\u8981\u66F4\u65B0 (\${outdated.length}):\`, 'yellow')
-    outdated.forEach((pkg) => {
-      log(\`  \${pkg.name}: \${pkg.current} \u2192 \${pkg.latest}\`, 'yellow')
-    })
-  }
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+${importStatement}
 
-  // \u7E3D\u7D50
-  log('\\n=== \u6AA2\u67E5\u7D50\u679C ===', 'blue')
-  log(\`\u7E3D\u8A08: \${results.length} \u500B\u5957\u4EF6\`, 'blue')
-  log(\`\u6700\u65B0: \${upToDate.length} \u500B\`, 'green')
-  log(\`\u9700\u66F4\u65B0: \${outdated.length} \u500B\`, outdated.length > 0 ? 'yellow' : 'green')
+export class RouteProvider extends ServiceProvider {
+  register(_container: Container): void {}
 
-  // \u5982\u679C\u6709\u9700\u8981\u66F4\u65B0\u7684\u5957\u4EF6\uFF0C\u8FD4\u56DE\u975E\u96F6\u9000\u51FA\u78BC
-  if (outdated.length > 0) {
-    log('\\n\u5EFA\u8B70\u57F7\u884C\u4EE5\u4E0B\u547D\u4EE4\u66F4\u65B0\u5957\u4EF6\uFF1A', 'yellow')
-    log('  bun update', 'yellow')
-    process.exit(1)
-  } else {
-    log('\\n\u2713 \u6240\u6709\u5957\u4EF6\u90FD\u662F\u6700\u65B0\u7248\u672C\uFF01', 'green')
-    process.exit(0)
+  boot(core: PlanetCore): void {
+    ${routeCall}
+    core.logger.info('\u{1F6E4}\uFE0F Routes registered')
   }
 }
-
-main().catch((error) => {
-  log(\`\\n\u932F\u8AA4: \${error.message}\`, 'red')
-  process.exit(1)
-})
 `;
   }
   /**
-   * Generate check.sh script content.
+   * Generate Providers Index
    */
-  generateCheckShellScript() {
-    return `#!/bin/bash
-
-# \u5C08\u6848\u6AA2\u67E5\u8173\u672C
-# \u57F7\u884C\u6240\u6709\u5FC5\u8981\u7684\u6AA2\u67E5\uFF1A\u985E\u578B\u6AA2\u67E5\u3001\u6E2C\u8A66\u3001\u4F9D\u8CF4\u6AA2\u67E5\u7B49
-
-set -e
-
-# \u984F\u8272\u5B9A\u7FA9
-GREEN='\\033[0;32m'
-YELLOW='\\033[1;33m'
-RED='\\033[0;31m'
-BLUE='\\033[0;34m'
-NC='\\033[0m' # No Color
-
-echo -e "\${BLUE}=== \u5C08\u6848\u6AA2\u67E5 ===\${NC}\\n"
-
-# \u6AA2\u67E5\u662F\u5426\u5728\u6B63\u78BA\u7684\u76EE\u9304
-if [ ! -f "package.json" ]; then
-  echo -e "\${RED}\u932F\u8AA4: \u8ACB\u5728\u5C08\u6848\u6839\u76EE\u9304\u57F7\u884C\u6B64\u8173\u672C\${NC}"
-  exit 1
-fi
-
-# \u6AA2\u67E5 Bun \u662F\u5426\u5B89\u88DD
-if ! command -v bun &> /dev/null; then
-  echo -e "\${RED}\u932F\u8AA4: \u672A\u627E\u5230 bun\uFF0C\u8ACB\u5148\u5B89\u88DD Bun\${NC}"
-  exit 1
-fi
-
-# 1. \u985E\u578B\u6AA2\u67E5
-echo -e "\${YELLOW}[1/3] \u57F7\u884C\u985E\u578B\u6AA2\u67E5...\${NC}"
-if bun run typecheck; then
-  echo -e "\${GREEN}\u2713 \u985E\u578B\u6AA2\u67E5\u901A\u904E\${NC}\\n"
-else
-  echo -e "\${RED}\u2717 \u985E\u578B\u6AA2\u67E5\u5931\u6557\${NC}"
-  exit 1
-fi
-
-# 2. \u57F7\u884C\u6E2C\u8A66
-echo -e "\${YELLOW}[2/3] \u57F7\u884C\u6E2C\u8A66...\${NC}"
-if bun test; then
-  echo -e "\${GREEN}\u2713 \u6E2C\u8A66\u901A\u904E\${NC}\\n"
-else
-  echo -e "\${RED}\u2717 \u6E2C\u8A66\u5931\u6557\${NC}"
-  exit 1
-fi
-
-# 3. \u6AA2\u67E5\u4F9D\u8CF4\u7248\u672C\uFF08\u53EF\u9078\uFF0C\u56E0\u70BA\u9700\u8981\u7DB2\u8DEF\u9023\u7DDA\uFF09
-echo -e "\${YELLOW}[3/3] \u6AA2\u67E5\u4F9D\u8CF4\u7248\u672C...\${NC}"
-if bun run check:deps; then
-  echo -e "\${GREEN}\u2713 \u4F9D\u8CF4\u6AA2\u67E5\u5B8C\u6210\${NC}\\n"
-else
-  echo -e "\${YELLOW}\u26A0 \u4F9D\u8CF4\u6AA2\u67E5\u6709\u8B66\u544A\uFF08\u67D0\u4E9B\u5957\u4EF6\u53EF\u80FD\u9700\u8981\u66F4\u65B0\uFF09\${NC}\\n"
-fi
-
-echo -e "\${GREEN}=== \u6240\u6709\u6AA2\u67E5\u5B8C\u6210 ===\${NC}"
+  static generateProvidersIndex(providers = ["AppServiceProvider", "MiddlewareProvider", "RouteProvider"]) {
+    const exports2 = providers.map((p) => `export { ${p} } from './${p}'`).join("\n");
+    return `/**
+ * Application Service Providers
+ */
+
+${exports2}
 `;
   }
   /**
-   * Generate pre-commit.sh script content.
+   * Generate Repository Service Provider
    */
-  generatePreCommitScript() {
-    return `#!/bin/bash
-
-# Pre-commit Hook
-# \u5728 git commit \u524D\u81EA\u52D5\u57F7\u884C\u6AA2\u67E5
-# 
-# \u5B89\u88DD\u65B9\u5F0F\uFF1A
-#   ln -s ../../scripts/pre-commit.sh .git/hooks/pre-commit
-#   \u6216
-#   cp scripts/pre-commit.sh .git/hooks/pre-commit
-#   chmod +x .git/hooks/pre-commit
-
-set -e
-
-# \u984F\u8272\u5B9A\u7FA9
-GREEN='\\033[0;32m'
-YELLOW='\\033[1;33m'
-RED='\\033[0;31m'
-BLUE='\\033[0;34m'
-NC='\\033[0m' # No Color
-
-echo -e "\${BLUE}=== Pre-commit \u6AA2\u67E5 ===\${NC}\\n"
-
-# \u5207\u63DB\u5230\u5C08\u6848\u6839\u76EE\u9304
-cd "$(git rev-parse --show-toplevel)"
-
-# \u6AA2\u67E5\u662F\u5426\u5728\u6B63\u78BA\u7684\u76EE\u9304
-if [ ! -f "package.json" ]; then
-  echo -e "\${RED}\u932F\u8AA4: \u627E\u4E0D\u5230 package.json\${NC}"
-  exit 1
-fi
-
-# \u6AA2\u67E5 Bun \u662F\u5426\u5B89\u88DD
-if ! command -v bun &> /dev/null; then
-  echo -e "\${RED}\u932F\u8AA4: \u672A\u627E\u5230 bun\uFF0C\u8ACB\u5148\u5B89\u88DD Bun\${NC}"
-  exit 1
-fi
-
-# 1. \u985E\u578B\u6AA2\u67E5\uFF08\u5FEB\u901F\u6AA2\u67E5\uFF09
-echo -e "\${YELLOW}[1/2] \u57F7\u884C\u985E\u578B\u6AA2\u67E5...\${NC}"
-if bun run typecheck; then
-  echo -e "\${GREEN}\u2713 \u985E\u578B\u6AA2\u67E5\u901A\u904E\${NC}\\n"
-else
-  echo -e "\${RED}\u2717 \u985E\u578B\u6AA2\u67E5\u5931\u6557\${NC}"
-  echo -e "\${YELLOW}\u63D0\u793A: \u8ACB\u4FEE\u6B63\u985E\u578B\u932F\u8AA4\u5F8C\u518D\u63D0\u4EA4\${NC}"
-  exit 1
-fi
-
-# 2. \u57F7\u884C\u6E2C\u8A66\uFF08\u53EF\u9078\uFF0C\u5982\u679C\u6E2C\u8A66\u6642\u9593\u8F03\u9577\u53EF\u4EE5\u8A3B\u89E3\u6389\uFF09
-echo -e "\${YELLOW}[2/2] \u57F7\u884C\u6E2C\u8A66...\${NC}"
-if bun test; then
-  echo -e "\${GREEN}\u2713 \u6E2C\u8A66\u901A\u904E\${NC}\\n"
-else
-  echo -e "\${RED}\u2717 \u6E2C\u8A66\u5931\u6557\${NC}"
-  echo -e "\${YELLOW}\u63D0\u793A: \u8ACB\u4FEE\u6B63\u6E2C\u8A66\u932F\u8AA4\u5F8C\u518D\u63D0\u4EA4\${NC}"
-  exit 1
-fi
-
-echo -e "\${GREEN}=== Pre-commit \u6AA2\u67E5\u901A\u904E ===\${NC}\\n"
+  static generateRepositoryServiceProvider(repositories = [], additionalServices = []) {
+    const repositoryRegistrations = repositories.map((repo) => `    container.singleton('${repo}', () => new ${repo}())`).join("\n");
+    const serviceRegistrations = additionalServices.map((service) => `    container.singleton('${service}', () => new ${service}())`).join("\n");
+    const imports = [
+      ...repositories.map(
+        (repo) => `import { ${repo} } from '../Persistence/Repositories/${repo}'`
+      ),
+      ...additionalServices.map(
+        (service) => `import { ${service} } from '../ExternalServices/${service}'`
+      )
+    ].join("\n");
+    return `/**
+ * Repository Service Provider
+ *
+ * Binds repository interfaces to implementations.
+ */
+
+import { ServiceProvider, type Container } from '@gravito/core'
+${imports}
+
+export class RepositoryServiceProvider extends ServiceProvider {
+  register(container: Container): void {
+${repositoryRegistrations || "    // Bind repositories here"}
+${serviceRegistrations || "    // Bind external services here"}
+  }
+}
 `;
   }
   /**
-   * Generate CHECK_SYSTEM.md documentation.
+   * Generate Database Provider
    */
-  generateCheckSystemDoc(context) {
-    return `# \u5C08\u6848\u6AA2\u67E5\u7CFB\u7D71
-
-\u672C\u5C08\u6848\u5DF2\u5EFA\u7ACB\u5B8C\u6574\u7684\u672C\u5730\u6AA2\u67E5\u6A5F\u5236\uFF0C\u7121\u9700\u4F9D\u8CF4 GitHub CI\u3002
-
-## \u5FEB\u901F\u958B\u59CB
-
-### \u57F7\u884C\u5B8C\u6574\u6AA2\u67E5
-\`\`\`bash
-bun run validate
-\`\`\`
-
-### \u57F7\u884C\u55AE\u9805\u6AA2\u67E5
-\`\`\`bash
-# \u985E\u578B\u6AA2\u67E5
-bun run typecheck
-
-# \u6E2C\u8A66
-bun run test
-
-# \u4F9D\u8CF4\u7248\u672C\u6AA2\u67E5
-bun run check:deps
-\`\`\`
-
-## \u53EF\u7528\u547D\u4EE4
-
-### Package.json \u8173\u672C
-
-| \u547D\u4EE4 | \u8AAA\u660E |
-|------|------|
-| \`bun run typecheck\` | TypeScript \u985E\u578B\u6AA2\u67E5 |
-| \`bun run test\` | \u57F7\u884C\u6240\u6709\u6E2C\u8A66 |
-| \`bun run check\` | \u985E\u578B\u6AA2\u67E5 + \u6E2C\u8A66 |
-| \`bun run check:deps\` | \u6AA2\u67E5\u4F9D\u8CF4\u7248\u672C |
-| \`bun run validate\` | \u5B8C\u6574\u9A57\u8B49\uFF08\u985E\u578B + \u6E2C\u8A66 + \u4F9D\u8CF4\uFF09 |
-| \`bun run precommit\` | \u7B49\u540C\u65BC \`validate\` |
-
-### Shell \u8173\u672C
-
-| \u8173\u672C | \u8AAA\u660E |
-|------|------|
-| \`./scripts/check.sh\` | \u5B8C\u6574\u5C08\u6848\u6AA2\u67E5\uFF08Shell \u7248\u672C\uFF09 |
-| \`./scripts/pre-commit.sh\` | Pre-commit hook \u8173\u672C |
-
-## Pre-commit Hook\uFF08\u63A8\u85A6\uFF09
-
-\u5B89\u88DD pre-commit hook \u5F8C\uFF0C\u6BCF\u6B21 \`git commit\` \u524D\u6703\u81EA\u52D5\u57F7\u884C\u6AA2\u67E5\uFF1A
-
-\`\`\`bash
-# \u5B89\u88DD pre-commit hook
-ln -s ../../scripts/pre-commit.sh .git/hooks/pre-commit
-
-# \u6216\u4F7F\u7528\u8907\u88FD\u65B9\u5F0F
-cp scripts/pre-commit.sh .git/hooks/pre-commit
-chmod +x .git/hooks/pre-commit
-\`\`\`
-
-**\u529F\u80FD\uFF1A**
-- \u2705 \u81EA\u52D5\u57F7\u884C\u985E\u578B\u6AA2\u67E5
-- \u2705 \u81EA\u52D5\u57F7\u884C\u6E2C\u8A66
-- \u274C \u6AA2\u67E5\u5931\u6557\u6642\u963B\u6B62\u63D0\u4EA4
-
-**\u8DF3\u904E\u6AA2\u67E5\uFF08\u4E0D\u63A8\u85A6\uFF09\uFF1A**
-\`\`\`bash
-git commit --no-verify -m "\u7DCA\u6025\u4FEE\u5FA9"
-\`\`\`
-
-## \u6AA2\u67E5\u9805\u76EE
-
-### 1. \u985E\u578B\u6AA2\u67E5
-- \u4F7F\u7528 \`tsc --noEmit\` \u6AA2\u67E5 TypeScript \u985E\u578B
-- \u78BA\u4FDD\u6C92\u6709\u985E\u578B\u932F\u8AA4
-
-### 2. \u6E2C\u8A66
-- \u57F7\u884C\u6240\u6709\u55AE\u5143\u6E2C\u8A66\u548C\u6574\u5408\u6E2C\u8A66
-- \u78BA\u4FDD\u6E2C\u8A66\u901A\u904E
-
-### 3. \u4F9D\u8CF4\u6AA2\u67E5\uFF08\u53EF\u9078\uFF09
-- \u6AA2\u67E5\u5957\u4EF6\u7248\u672C\u662F\u5426\u70BA\u6700\u65B0
-- \u63D0\u4F9B\u66F4\u65B0\u5EFA\u8B70
-- \u9700\u8981\u7DB2\u8DEF\u9023\u7DDA
-
-## \u5DE5\u4F5C\u6D41\u7A0B\u5EFA\u8B70
-
-### \u958B\u767C\u6642
-1. \u958B\u767C\u529F\u80FD
-2. \u63D0\u4EA4\u524D\u57F7\u884C \`bun run validate\`
-3. \u4FEE\u6B63\u554F\u984C
-4. \u63D0\u4EA4\u7A0B\u5F0F\u78BC
-
-### \u4F7F\u7528 Pre-commit Hook\uFF08\u63A8\u85A6\uFF09
-1. \u5B89\u88DD pre-commit hook\uFF08\u53EA\u9700\u4E00\u6B21\uFF09
-2. \u6B63\u5E38\u958B\u767C\u548C\u63D0\u4EA4
-3. \u6AA2\u67E5\u6703\u81EA\u52D5\u57F7\u884C
-4. \u5982\u6709\u554F\u984C\uFF0C\u4FEE\u6B63\u5F8C\u91CD\u65B0\u63D0\u4EA4
-
-## \u6A94\u6848\u7D50\u69CB
-
-\`\`\`
-${context.nameKebabCase}/
-\u251C\u2500\u2500 package.json              # \u6AA2\u67E5\u8173\u672C\u5B9A\u7FA9
-\u251C\u2500\u2500 scripts/
-\u2502   \u251C\u2500\u2500 check.sh              # \u5B8C\u6574\u6AA2\u67E5\u8173\u672C\uFF08Shell\uFF09
-\u2502   \u251C\u2500\u2500 check-dependencies.ts  # \u4F9D\u8CF4\u7248\u672C\u6AA2\u67E5
-\u2502   \u2514\u2500\u2500 pre-commit.sh         # Pre-commit hook
-\u2514\u2500\u2500 CHECK_SYSTEM.md           # \u672C\u6587\u4EF6
-\`\`\`
-
-## \u6CE8\u610F\u4E8B\u9805
-
-1. **\u4F9D\u8CF4\u6AA2\u67E5\u9700\u8981\u7DB2\u8DEF\u9023\u7DDA**\uFF1A\`check:deps\` \u9700\u8981\u9023\u63A5\u5230 npm registry
-2. **\u6E2C\u8A66\u6642\u9593**\uFF1A\u5982\u679C\u6E2C\u8A66\u6642\u9593\u8F03\u9577\uFF0C\u53EF\u4EE5\u7DE8\u8F2F \`pre-commit.sh\` \u8A3B\u89E3\u6389\u6E2C\u8A66\u90E8\u5206
-3. **\u985E\u578B\u932F\u8AA4**\uFF1A\u5C08\u6848\u4E2D\u53EF\u80FD\u9084\u6709\u4E00\u4E9B\u65E2\u6709\u7684\u985E\u578B\u932F\u8AA4\uFF0C\u5EFA\u8B70\u9010\u6B65\u4FEE\u6B63
-
-## \u6545\u969C\u6392\u9664
-
-### \u6AA2\u67E5\u5931\u6557
-1. \u67E5\u770B\u932F\u8AA4\u8A0A\u606F
-2. \u4FEE\u6B63\u554F\u984C
-3. \u91CD\u65B0\u57F7\u884C\u6AA2\u67E5
+  static generateDatabaseProvider() {
+    return `/**
+ * Database Service Provider
+ */
 
-### \u8DF3\u904E\u6AA2\u67E5
-\u53EA\u6709\u5728\u7DCA\u6025\u60C5\u6CC1\u4E0B\u624D\u4F7F\u7528\uFF1A
-\`\`\`bash
-git commit --no-verify
-\`\`\`
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import { OrbitAtlas } from '@gravito/atlas'
 
-### \u79FB\u9664 Pre-commit Hook
-\`\`\`bash
-rm .git/hooks/pre-commit
-\`\`\`
-`;
+export class DatabaseProvider extends ServiceProvider {
+  register(_container: Container): void {
+    // Register database connections
   }
-  /**
-   * Log a message if verbose mode is enabled.
-   */
-  log(message) {
-    if (this.config.verbose) {
-      console.log(message);
-    }
+
+  boot(core: PlanetCore): void {
+    // Initialize database
+    core.logger.info('\u{1F5C4}\uFE0F Database initialized')
   }
-  /**
-   * Create generator context from options.
-   */
-  static createContext(name, targetDir, architecture, packageManager = "bun", extra = {}) {
-    const now = /* @__PURE__ */ new Date();
-    const pascalCase = name.replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : "").replace(/^./, (c) => c.toUpperCase());
-    const camelCase = pascalCase.replace(/^./, (c) => c.toLowerCase());
-    const snakeCase = name.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/^_/, "").replace(/[-\s]+/g, "_");
-    const kebabCase = name.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "").replace(/[_\s]+/g, "-");
-    return {
-      name,
-      namePascalCase: pascalCase,
-      nameCamelCase: camelCase,
-      nameSnakeCase: snakeCase,
-      nameKebabCase: kebabCase,
-      targetDir,
-      architecture,
-      packageManager,
-      year: now.getFullYear().toString(),
-      date: now.toISOString().split("T")[0] ?? now.toISOString().slice(0, 10),
-      ...extra
-    };
+}
+`;
   }
 };
 
@@ -1467,57 +1225,22 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
     ];
   }
   // ─────────────────────────────────────────────────────────────
-  // Config Generators (similar to MVC but simplified)
+  // Config Generators (using shared ConfigGenerator)
   // ─────────────────────────────────────────────────────────────
   generateAppConfig(context) {
-    return `export default {
-  name: process.env.APP_NAME ?? '${context.name}',
-  env: process.env.APP_ENV ?? 'development',
-  debug: process.env.APP_DEBUG === 'true',
-  url: process.env.APP_URL ?? 'http://localhost:3000',
-  key: process.env.APP_KEY,
-}
-`;
+    return ConfigGenerator.generateSimpleAppConfig(context);
   }
   generateDatabaseConfig() {
-    return `export default {
-  default: process.env.DB_CONNECTION ?? 'sqlite',
-  connections: {
-    sqlite: {
-      driver: 'sqlite',
-      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
-    },
-  },
-}
-`;
+    return ConfigGenerator.generateSimpleDatabaseConfig();
   }
   generateAuthConfig() {
-    return `export default {
-  defaults: { guard: 'web' },
-  guards: {
-    web: { driver: 'session', provider: 'users' },
-    api: { driver: 'token', provider: 'users' },
-  },
-}
-`;
+    return ConfigGenerator.generateAuthConfig();
   }
   generateCacheConfig() {
-    return `export default {
-  default: process.env.CACHE_DRIVER ?? 'memory',
-  stores: {
-    memory: { driver: 'memory' },
-  },
-}
-`;
+    return ConfigGenerator.generateCacheConfig();
   }
   generateLoggingConfig() {
-    return `export default {
-  default: process.env.LOG_CHANNEL ?? 'console',
-  channels: {
-    console: { driver: 'console', level: process.env.LOG_LEVEL ?? 'debug' },
-  },
-}
-`;
+    return ConfigGenerator.generateLoggingConfig();
   }
   generateUserEntity() {
     return `/**
@@ -1844,103 +1567,30 @@ export class MailService implements IMailService {
 `;
   }
   generateAppServiceProvider(context) {
-    return `/**
- * App Service Provider
- */
-
-import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
-
-export class AppServiceProvider extends ServiceProvider {
-  register(_container: Container): void {
-    // Register application services
-  }
-
-  boot(_core: PlanetCore): void {
-    console.log('${context.name} (Clean Architecture) booted!')
-  }
-}
-`;
+    return ServiceProviderGenerator.generateAppServiceProvider(context, "Clean Architecture");
   }
   generateRepositoryServiceProvider() {
-    return `/**
- * Repository Service Provider
- *
- * Binds repository interfaces to implementations.
- */
-
-import { ServiceProvider, type Container } from '@gravito/core'
-import { UserRepository } from '../Persistence/Repositories/UserRepository'
-import { MailService } from '../ExternalServices/MailService'
-
-export class RepositoryServiceProvider extends ServiceProvider {
-  register(container: Container): void {
-    // Bind repositories
-    container.singleton('userRepository', () => new UserRepository())
-
-    // Bind external services
-    container.singleton('mailService', () => new MailService())
-  }
-}
-`;
+    return ServiceProviderGenerator.generateRepositoryServiceProvider(
+      ["UserRepository"],
+      ["MailService"]
+    );
   }
   generateProvidersIndex() {
-    return `/**
- * Application Service Providers
- */
-
-export { AppServiceProvider } from './AppServiceProvider'
-export { RepositoryServiceProvider } from './RepositoryServiceProvider'
-export { MiddlewareProvider } from './MiddlewareProvider'
-export { RouteProvider } from './RouteProvider'
-`;
+    return ServiceProviderGenerator.generateProvidersIndex([
+      "AppServiceProvider",
+      "RepositoryServiceProvider",
+      "MiddlewareProvider",
+      "RouteProvider"
+    ]);
   }
   generateMiddlewareProvider() {
-    return `/**
- * Middleware Service Provider
- */
-
-import {
-  ServiceProvider,
-  type Container,
-  type PlanetCore,
-  bodySizeLimit,
-  securityHeaders,
-} from '@gravito/core'
-
-export class MiddlewareProvider extends ServiceProvider {
-  register(_container: Container): void {}
-
-  boot(core: PlanetCore): void {
-    const isDev = process.env.NODE_ENV !== 'production'
-
-    core.adapter.use('*', securityHeaders({
-      contentSecurityPolicy: isDev ? false : undefined,
-    }))
-
-    core.adapter.use('*', bodySizeLimit(10 * 1024 * 1024))
-
-    core.logger.info('\u{1F6E1}\uFE0F Middleware registered')
-  }
-}
-`;
+    return ServiceProviderGenerator.generateMiddlewareProvider();
   }
   generateRouteProvider() {
-    return `/**
- * Route Service Provider
- */
-
-import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
-import { registerApiRoutes } from '../../Interface/Http/Routes/api'
-
-export class RouteProvider extends ServiceProvider {
-  register(_container: Container): void {}
-
-  boot(core: PlanetCore): void {
-    registerApiRoutes(core.router)
-    core.logger.info('\u{1F6E4}\uFE0F Routes registered')
-  }
-}
-`;
+    return ServiceProviderGenerator.generateRouteProvider(
+      "../../Interface/Http/Routes/api",
+      "named"
+    );
   }
   // ─────────────────────────────────────────────────────────────
   // Interface Layer
@@ -2163,7 +1813,7 @@ Created with \u2764\uFE0F using Gravito Framework
         build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
         start: "bun run dist/bootstrap.js",
         test: "bun test",
-        typecheck: "tsc --noEmit",
+        typecheck: "bun tsc --noEmit",
         check: "bun run typecheck && bun run test",
         "check:deps": "bun run scripts/check-dependencies.ts",
         validate: "bun run check && bun run check:deps",
@@ -2178,107 +1828,16 @@ Created with \u2764\uFE0F using Gravito Framework
       },
       devDependencies: {
         "bun-types": "latest",
-        typescript: "^5.0.0"
+        typescript: "^5.9.3"
       }
     };
     return JSON.stringify(pkg, null, 2);
   }
 };
 
-// src/generators/DddGenerator.ts
-var DddGenerator = class extends BaseGenerator {
-  get architectureType() {
-    return "ddd";
-  }
-  get displayName() {
-    return "Domain-Driven Design (DDD)";
-  }
-  get description() {
-    return "Full DDD with Bounded Contexts, Aggregates, and Event-Driven patterns";
-  }
-  getDirectoryStructure(context) {
-    return [
-      {
-        type: "directory",
-        name: "config",
-        children: [
-          { type: "file", name: "app.ts", content: this.generateAppConfig(context) },
-          { type: "file", name: "database.ts", content: this.generateDatabaseConfig() },
-          { type: "file", name: "modules.ts", content: this.generateModulesConfig() },
-          { type: "file", name: "cache.ts", content: this.generateCacheConfig() },
-          { type: "file", name: "logging.ts", content: this.generateLoggingConfig() }
-        ]
-      },
-      {
-        type: "directory",
-        name: "src",
-        children: [
-          // Bootstrap - Application startup and configuration
-          this.generateBootstrapDirectory(context),
-          // Shared - Cross-module shared components
-          this.generateShared(),
-          // Modules - Bounded Contexts
-          {
-            type: "directory",
-            name: "Modules",
-            children: [
-              this.generateModule("Ordering", context),
-              this.generateModule("Catalog", context)
-            ]
-          },
-          { type: "file", name: "main.ts", content: this.generateMainEntry(context) }
-        ]
-      },
-      {
-        type: "directory",
-        name: "tests",
-        children: [
-          {
-            type: "directory",
-            name: "Modules",
-            children: [
-              {
-                type: "directory",
-                name: "Ordering",
-                children: [
-                  {
-                    type: "directory",
-                    name: "Unit",
-                    children: [{ type: "file", name: ".gitkeep", content: "" }]
-                  },
-                  {
-                    type: "directory",
-                    name: "Integration",
-                    children: [{ type: "file", name: ".gitkeep", content: "" }]
-                  }
-                ]
-              },
-              {
-                type: "directory",
-                name: "Catalog",
-                children: [
-                  {
-                    type: "directory",
-                    name: "Unit",
-                    children: [{ type: "file", name: ".gitkeep", content: "" }]
-                  }
-                ]
-              }
-            ]
-          },
-          {
-            type: "directory",
-            name: "Shared",
-            children: [{ type: "file", name: ".gitkeep", content: "" }]
-          }
-        ]
-      }
-    ];
-  }
-  // ─────────────────────────────────────────────────────────────
-  // Bootstrap Directory
-  // ─────────────────────────────────────────────────────────────
-  generateBootstrapDirectory(context) {
+// src/generators/ddd/BootstrapGenerator.ts
+var BootstrapGenerator = class {
+  generate(context) {
     return {
       type: "directory",
       name: "Bootstrap",
@@ -2290,207 +1849,33 @@ var DddGenerator = class extends BaseGenerator {
       ]
     };
   }
-  // ─────────────────────────────────────────────────────────────
-  // Shared Directory (replaces SharedKernel with user's structure)
-  // ─────────────────────────────────────────────────────────────
-  generateShared() {
+  generateConfigDirectory(context) {
     return {
       type: "directory",
-      name: "Shared",
+      name: "config",
       children: [
-        {
-          type: "directory",
-          name: "Domain",
-          children: [
-            {
-              type: "directory",
-              name: "ValueObjects",
-              children: [
-                { type: "file", name: "Id.ts", content: this.generateIdValueObject() },
-                { type: "file", name: "Money.ts", content: this.generateMoneyValueObject() },
-                { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
-              ]
-            }
-          ]
-        },
-        {
-          type: "directory",
-          name: "Infrastructure",
-          children: [
-            {
-              type: "directory",
-              name: "EventBus",
-              children: [
-                {
-                  type: "file",
-                  name: "EventDispatcher.ts",
-                  content: this.generateEventDispatcher()
-                }
-              ]
-            }
-          ]
-        },
-        {
-          type: "directory",
-          name: "Exceptions",
-          children: [
-            { type: "file", name: "Handler.ts", content: this.generateExceptionHandler() }
-          ]
-        }
+        { type: "file", name: "app.ts", content: this.generateAppConfig(context) },
+        { type: "file", name: "database.ts", content: this.generateDatabaseConfig() },
+        { type: "file", name: "modules.ts", content: this.generateModulesConfig() },
+        { type: "file", name: "cache.ts", content: this.generateCacheConfig() },
+        { type: "file", name: "logging.ts", content: this.generateLoggingConfig() }
       ]
     };
   }
-  // ─────────────────────────────────────────────────────────────
-  // Module Generator (replaces Bounded Context)
-  // ─────────────────────────────────────────────────────────────
-  generateModule(name, context) {
-    return {
-      type: "directory",
-      name,
-      children: [
-        // Domain Layer
-        {
-          type: "directory",
-          name: "Domain",
-          children: [
-            {
-              type: "directory",
-              name: "Aggregates",
-              children: [
-                {
-                  type: "directory",
-                  name,
-                  children: [
-                    { type: "file", name: `${name}.ts`, content: this.generateAggregate(name) },
-                    {
-                      type: "file",
-                      name: `${name}Status.ts`,
-                      content: this.generateAggregateStatus(name)
-                    }
-                  ]
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Events",
-              children: [
-                {
-                  type: "file",
-                  name: `${name}Created.ts`,
-                  content: this.generateCreatedEvent(name)
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Repositories",
-              children: [
-                {
-                  type: "file",
-                  name: `I${name}Repository.ts`,
-                  content: this.generateRepositoryInterface(name)
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Services",
-              children: [{ type: "file", name: ".gitkeep", content: "" }]
-            }
-          ]
-        },
-        // Application Layer
-        {
-          type: "directory",
-          name: "Application",
-          children: [
-            {
-              type: "directory",
-              name: "Commands",
-              children: [
-                {
-                  type: "directory",
-                  name: `Create${name}`,
-                  children: [
-                    {
-                      type: "file",
-                      name: `Create${name}Command.ts`,
-                      content: this.generateCommand(name)
-                    },
-                    {
-                      type: "file",
-                      name: `Create${name}Handler.ts`,
-                      content: this.generateCommandHandler(name)
-                    }
-                  ]
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Queries",
-              children: [
-                {
-                  type: "directory",
-                  name: `Get${name}ById`,
-                  children: [
-                    {
-                      type: "file",
-                      name: `Get${name}ByIdQuery.ts`,
-                      content: this.generateQuery(name)
-                    },
-                    {
-                      type: "file",
-                      name: `Get${name}ByIdHandler.ts`,
-                      content: this.generateQueryHandler(name)
-                    }
-                  ]
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "DTOs",
-              children: [{ type: "file", name: `${name}DTO.ts`, content: this.generateDTO(name) }]
-            }
-          ]
-        },
-        // Infrastructure Layer
-        {
-          type: "directory",
-          name: "Infrastructure",
-          children: [
-            {
-              type: "directory",
-              name: "Persistence",
-              children: [
-                {
-                  type: "file",
-                  name: `${name}Repository.ts`,
-                  content: this.generateRepository(name)
-                }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Providers",
-              children: [
-                {
-                  type: "file",
-                  name: `${name}ServiceProvider.ts`,
-                  content: this.generateModuleServiceProvider(name, context)
-                }
-              ]
-            }
-          ]
-        }
-      ]
-    };
+  generateMainEntry(_context) {
+    return `/**
+ * Application Entry Point
+ *
+ * Start the HTTP server.
+ */
+
+import { createApp } from './Bootstrap/app'
+
+const app = await createApp()
+
+export default app.liftoff()
+`;
   }
-  // ─────────────────────────────────────────────────────────────
-  // Bootstrap File Generators
-  // ─────────────────────────────────────────────────────────────
   generateBootstrapApp(_context) {
     return `/**
  * Application Bootstrap
@@ -2616,20 +2001,6 @@ export function registerRoutes(router: any): void {
     // Catalog module
     router.get('/api/products', (c: any) => c.json({ message: 'Product list' }))
 }
-`;
-  }
-  generateMainEntry(_context) {
-    return `/**
- * Application Entry Point
- *
- * Start the HTTP server.
- */
-
-import { createApp } from './Bootstrap/app'
-
-const app = await createApp()
-
-export default app.liftoff()
 `;
   }
   generateModulesConfig() {
@@ -2660,60 +2031,6 @@ export default {
 }
 `;
   }
-  generateModuleServiceProvider(name, _context) {
-    return `/**
- * ${name} Service Provider
- */
-
-import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
-import { ${name}Repository } from '../Persistence/${name}Repository'
-
-export class ${name}ServiceProvider extends ServiceProvider {
-    register(container: Container): void {
-        container.singleton('${name.toLowerCase()}Repository', () => new ${name}Repository())
-    }
-
-    boot(_core: PlanetCore): void {
-        console.log('[${name}] Module loaded')
-    }
-}
-`;
-  }
-  /**
-   * Override package.json for DDD architecture (uses main.ts instead of bootstrap.ts)
-   */
-  generatePackageJson(context) {
-    const pkg = {
-      name: context.nameKebabCase,
-      version: "0.1.0",
-      type: "module",
-      scripts: {
-        dev: "bun run --watch src/main.ts",
-        build: "bun build ./src/main.ts --outdir ./dist --target bun",
-        start: "bun run dist/main.js",
-        test: "bun test",
-        typecheck: "tsc --noEmit",
-        check: "bun run typecheck && bun run test",
-        "check:deps": "bun run scripts/check-dependencies.ts",
-        validate: "bun run check && bun run check:deps",
-        precommit: "bun run validate",
-        "docker:build": `docker build -t ${context.nameKebabCase} .`,
-        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
-      },
-      dependencies: {
-        "@gravito/core": "^1.0.0-beta.5",
-        "@gravito/enterprise": "workspace:*"
-      },
-      devDependencies: {
-        "bun-types": "latest",
-        typescript: "^5.0.0"
-      }
-    };
-    return JSON.stringify(pkg, null, 2);
-  }
-  // ─────────────────────────────────────────────────────────────
-  // Config Generators
-  // ─────────────────────────────────────────────────────────────
   generateAppConfig(context) {
     return `export default {
   name: process.env.APP_NAME ?? '${context.name}',
@@ -2748,159 +2065,155 @@ export class ${name}ServiceProvider extends ServiceProvider {
 }
 `;
   }
-  // ─────────────────────────────────────────────────────────────
-  // Shared Kernel Files
-  // ─────────────────────────────────────────────────────────────
-  generateIdValueObject() {
-    return `/**
- * ID Value Object
- *
- * Shared identifier across all contexts.
- */
-
-import { ValueObject } from '@gravito/enterprise'
-
-interface IdProps {
-    value: string
-}
-
-export class Id extends ValueObject<IdProps> {
-  private constructor(value: string) {
-    super({ value })
-  }
-
-  static create(): Id {
-    return new Id(crypto.randomUUID())
-  }
-
-  static from(value: string): Id {
-    if (!value) throw new Error('Id cannot be empty')
-    return new Id(value)
-  }
-
-  get value(): string {
-    return this.props.value
-  }
-
-  toString(): string {
-    return this.props.value
-  }
-}
-`;
-  }
-  generateMoneyValueObject() {
-    return `/**
- * Money Value Object
- */
-
-import { ValueObject } from '@gravito/enterprise'
-
-interface MoneyProps {
-    amount: number
-    currency: string
-}
-
-export class Money extends ValueObject<MoneyProps> {
-  constructor(amount: number, currency: string = 'USD') {
-    if (amount < 0) throw new Error('Amount cannot be negative')
-    super({ amount, currency })
-  }
-
-  get amount(): number {
-    return this.props.amount
-  }
-
-  get currency(): string {
-    return this.props.currency
-  }
-
-  add(other: Money): Money {
-    this.assertSameCurrency(other)
-    return new Money(this.amount + other.amount, this.currency)
-  }
-
-  subtract(other: Money): Money {
-    this.assertSameCurrency(other)
-    return new Money(this.amount - other.amount, this.currency)
-  }
-
-  private assertSameCurrency(other: Money): void {
-    if (this.currency !== other.currency) {
-      throw new Error('Cannot operate on different currencies')
-    }
-  }
-}
-`;
-  }
-  generateEmailValueObject() {
-    return `/**
- * Email Value Object
- */
-
-import { ValueObject } from '@gravito/enterprise'
-
-interface EmailProps {
-    value: string
-}
-
-export class Email extends ValueObject<EmailProps> {
-  private constructor(value: string) {
-    super({ value: value.toLowerCase().trim() })
-  }
-
-  static create(email: string): Email {
-    if (!Email.isValid(email)) {
-      throw new Error(\`Invalid email: \${email}\`)
-    }
-    return new Email(email)
-  }
-
-  static isValid(email: string): boolean {
-    return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email)
-  }
-
-  get value(): string {
-    return this.props.value
-  }
-}
-`;
-  }
-  generateEventDispatcher() {
-    return `/**
- * Event Dispatcher
- */
-
-import type { DomainEvent } from '@gravito/enterprise'
-
-type EventHandler = (event: DomainEvent) => void | Promise<void>
-
-export class EventDispatcher {
-  private handlers: Map<string, EventHandler[]> = new Map()
-
-  subscribe(eventName: string, handler: EventHandler): void {
-    const handlers = this.handlers.get(eventName) ?? []
-    handlers.push(handler)
-    this.handlers.set(eventName, handlers)
-  }
-
-  async dispatch(event: DomainEvent): Promise<void> {
-    const handlers = this.handlers.get(event.eventName) ?? []
-    for (const handler of handlers) {
-      await handler(event)
-    }
-  }
+};
 
-  async dispatchAll(events: DomainEvent[]): Promise<void> {
-    for (const event of events) {
-      await this.dispatch(event)
-    }
-  }
-}
-`;
+// src/generators/ddd/ModuleGenerator.ts
+var ModuleGenerator = class {
+  generate(name, context) {
+    return {
+      type: "directory",
+      name,
+      children: [
+        // Domain Layer
+        {
+          type: "directory",
+          name: "Domain",
+          children: [
+            {
+              type: "directory",
+              name: "Aggregates",
+              children: [
+                {
+                  type: "directory",
+                  name,
+                  children: [
+                    { type: "file", name: `${name}.ts`, content: this.generateAggregate(name) },
+                    {
+                      type: "file",
+                      name: `${name}Status.ts`,
+                      content: this.generateAggregateStatus(name)
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "Events",
+              children: [
+                {
+                  type: "file",
+                  name: `${name}Created.ts`,
+                  content: this.generateCreatedEvent(name)
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "Repositories",
+              children: [
+                {
+                  type: "file",
+                  name: `I${name}Repository.ts`,
+                  content: this.generateRepositoryInterface(name)
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "Services",
+              children: [{ type: "file", name: ".gitkeep", content: "" }]
+            }
+          ]
+        },
+        // Application Layer
+        {
+          type: "directory",
+          name: "Application",
+          children: [
+            {
+              type: "directory",
+              name: "Commands",
+              children: [
+                {
+                  type: "directory",
+                  name: `Create${name}`,
+                  children: [
+                    {
+                      type: "file",
+                      name: `Create${name}Command.ts`,
+                      content: this.generateCommand(name)
+                    },
+                    {
+                      type: "file",
+                      name: `Create${name}Handler.ts`,
+                      content: this.generateCommandHandler(name)
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "Queries",
+              children: [
+                {
+                  type: "directory",
+                  name: `Get${name}ById`,
+                  children: [
+                    {
+                      type: "file",
+                      name: `Get${name}ByIdQuery.ts`,
+                      content: this.generateQuery(name)
+                    },
+                    {
+                      type: "file",
+                      name: `Get${name}ByIdHandler.ts`,
+                      content: this.generateQueryHandler(name)
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "DTOs",
+              children: [{ type: "file", name: `${name}DTO.ts`, content: this.generateDTO(name) }]
+            }
+          ]
+        },
+        // Infrastructure Layer
+        {
+          type: "directory",
+          name: "Infrastructure",
+          children: [
+            {
+              type: "directory",
+              name: "Persistence",
+              children: [
+                {
+                  type: "file",
+                  name: `${name}Repository.ts`,
+                  content: this.generateRepository(name)
+                }
+              ]
+            },
+            {
+              type: "directory",
+              name: "Providers",
+              children: [
+                {
+                  type: "file",
+                  name: `${name}ServiceProvider.ts`,
+                  content: this.generateModuleServiceProvider(name, context)
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    };
   }
-  // ─────────────────────────────────────────────────────────────
-  // Bounded Context Templates
-  // ─────────────────────────────────────────────────────────────
   generateAggregate(name) {
     return `/**
  * ${name} Aggregate Root
@@ -3122,15 +2435,359 @@ export class ${name}Repository implements I${name}Repository {
 }
 `;
   }
-  generateExceptionHandler() {
-    return `/**
- * Exception Handler
- */
-
-export function report(error: unknown): void {
-  console.error('[Exception]', error)
-}
-`;
+  generateModuleServiceProvider(name, _context) {
+    return `/**
+ * ${name} Service Provider
+ */
+
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import { ${name}Repository } from '../Persistence/${name}Repository'
+
+export class ${name}ServiceProvider extends ServiceProvider {
+    register(container: Container): void {
+        container.singleton('${name.toLowerCase()}Repository', () => new ${name}Repository())
+    }
+
+    boot(_core: PlanetCore): void {
+        console.log('[${name}] Module loaded')
+    }
+}
+`;
+  }
+};
+
+// src/generators/ddd/SharedKernelGenerator.ts
+var SharedKernelGenerator = class {
+  generate() {
+    return {
+      type: "directory",
+      name: "Shared",
+      children: [
+        {
+          type: "directory",
+          name: "Domain",
+          children: [
+            {
+              type: "directory",
+              name: "ValueObjects",
+              children: [
+                { type: "file", name: "Id.ts", content: this.generateIdValueObject() },
+                { type: "file", name: "Money.ts", content: this.generateMoneyValueObject() },
+                { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
+              ]
+            }
+          ]
+        },
+        {
+          type: "directory",
+          name: "Infrastructure",
+          children: [
+            {
+              type: "directory",
+              name: "EventBus",
+              children: [
+                {
+                  type: "file",
+                  name: "EventDispatcher.ts",
+                  content: this.generateEventDispatcher()
+                }
+              ]
+            }
+          ]
+        },
+        {
+          type: "directory",
+          name: "Exceptions",
+          children: [
+            { type: "file", name: "Handler.ts", content: this.generateExceptionHandler() }
+          ]
+        }
+      ]
+    };
+  }
+  generateIdValueObject() {
+    return `/**
+ * ID Value Object
+ *
+ * Shared identifier across all contexts.
+ */
+
+import { ValueObject } from '@gravito/enterprise'
+
+interface IdProps {
+    value: string
+}
+
+export class Id extends ValueObject<IdProps> {
+  private constructor(value: string) {
+    super({ value })
+  }
+
+  static create(): Id {
+    return new Id(crypto.randomUUID())
+  }
+
+  static from(value: string): Id {
+    if (!value) throw new Error('Id cannot be empty')
+    return new Id(value)
+  }
+
+  get value(): string {
+    return this.props.value
+  }
+
+  toString(): string {
+    return this.props.value
+  }
+}
+`;
+  }
+  generateMoneyValueObject() {
+    return `/**
+ * Money Value Object
+ */
+
+import { ValueObject } from '@gravito/enterprise'
+
+interface MoneyProps {
+    amount: number
+    currency: string
+}
+
+export class Money extends ValueObject<MoneyProps> {
+  constructor(amount: number, currency: string = 'USD') {
+    if (amount < 0) throw new Error('Amount cannot be negative')
+    super({ amount, currency })
+  }
+
+  get amount(): number {
+    return this.props.amount
+  }
+
+  get currency(): string {
+    return this.props.currency
+  }
+
+  add(other: Money): Money {
+    this.assertSameCurrency(other)
+    return new Money(this.amount + other.amount, this.currency)
+  }
+
+  subtract(other: Money): Money {
+    this.assertSameCurrency(other)
+    return new Money(this.amount - other.amount, this.currency)
+  }
+
+  private assertSameCurrency(other: Money): void {
+    if (this.currency !== other.currency) {
+      throw new Error('Cannot operate on different currencies')
+    }
+  }
+}
+`;
+  }
+  generateEmailValueObject() {
+    return `/**
+ * Email Value Object
+ */
+
+import { ValueObject } from '@gravito/enterprise'
+
+interface EmailProps {
+    value: string
+}
+
+export class Email extends ValueObject<EmailProps> {
+  private constructor(value: string) {
+    super({ value: value.toLowerCase().trim() })
+  }
+
+  static create(email: string): Email {
+    if (!Email.isValid(email)) {
+      throw new Error(\`Invalid email: \${email}\`)
+    }
+    return new Email(email)
+  }
+
+  static isValid(email: string): boolean {
+    return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email)
+  }
+
+  get value(): string {
+    return this.props.value
+  }
+}
+`;
+  }
+  generateEventDispatcher() {
+    return `/**
+ * Event Dispatcher
+ */
+
+import type { DomainEvent } from '@gravito/enterprise'
+
+type EventHandler = (event: DomainEvent) => void | Promise<void>
+
+export class EventDispatcher {
+  private handlers: Map<string, EventHandler[]> = new Map()
+
+  subscribe(eventName: string, handler: EventHandler): void {
+    const handlers = this.handlers.get(eventName) ?? []
+    handlers.push(handler)
+    this.handlers.set(eventName, handlers)
+  }
+
+  async dispatch(event: DomainEvent): Promise<void> {
+    const handlers = this.handlers.get(event.eventName) ?? []
+    for (const handler of handlers) {
+      await handler(event)
+    }
+  }
+
+  async dispatchAll(events: DomainEvent[]): Promise<void> {
+    for (const event of events) {
+      await this.dispatch(event)
+    }
+  }
+}
+`;
+  }
+  generateExceptionHandler() {
+    return `/**
+ * Exception Handler
+ */
+
+export function report(error: unknown): void {
+  console.error('[Exception]', error)
+}
+`;
+  }
+};
+
+// src/generators/DddGenerator.ts
+var DddGenerator = class extends BaseGenerator {
+  moduleGenerator;
+  sharedKernelGenerator;
+  bootstrapGenerator;
+  constructor(config) {
+    super(config);
+    this.moduleGenerator = new ModuleGenerator();
+    this.sharedKernelGenerator = new SharedKernelGenerator();
+    this.bootstrapGenerator = new BootstrapGenerator();
+  }
+  get architectureType() {
+    return "ddd";
+  }
+  get displayName() {
+    return "Domain-Driven Design (DDD)";
+  }
+  get description() {
+    return "Full DDD with Bounded Contexts, Aggregates, and Event-Driven patterns";
+  }
+  getDirectoryStructure(context) {
+    return [
+      this.bootstrapGenerator.generateConfigDirectory(context),
+      {
+        type: "directory",
+        name: "src",
+        children: [
+          // Bootstrap - Application startup and configuration
+          this.bootstrapGenerator.generate(context),
+          // Shared - Cross-module shared components
+          this.sharedKernelGenerator.generate(),
+          // Modules - Bounded Contexts
+          {
+            type: "directory",
+            name: "Modules",
+            children: [
+              this.moduleGenerator.generate("Ordering", context),
+              this.moduleGenerator.generate("Catalog", context)
+            ]
+          },
+          {
+            type: "file",
+            name: "main.ts",
+            content: this.bootstrapGenerator.generateMainEntry(context)
+          }
+        ]
+      },
+      {
+        type: "directory",
+        name: "tests",
+        children: [
+          {
+            type: "directory",
+            name: "Modules",
+            children: [
+              {
+                type: "directory",
+                name: "Ordering",
+                children: [
+                  {
+                    type: "directory",
+                    name: "Unit",
+                    children: [{ type: "file", name: ".gitkeep", content: "" }]
+                  },
+                  {
+                    type: "directory",
+                    name: "Integration",
+                    children: [{ type: "file", name: ".gitkeep", content: "" }]
+                  }
+                ]
+              },
+              {
+                type: "directory",
+                name: "Catalog",
+                children: [
+                  {
+                    type: "directory",
+                    name: "Unit",
+                    children: [{ type: "file", name: ".gitkeep", content: "" }]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "Shared",
+            children: [{ type: "file", name: ".gitkeep", content: "" }]
+          }
+        ]
+      }
+    ];
+  }
+  /**
+   * Override package.json for DDD architecture (uses main.ts instead of bootstrap.ts)
+   */
+  generatePackageJson(context) {
+    const pkg = {
+      name: context.nameKebabCase,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "bun run --watch src/main.ts",
+        build: "bun build ./src/main.ts --outdir ./dist --target bun",
+        start: "bun run dist/main.js",
+        test: "bun test",
+        typecheck: "bun tsc --noEmit",
+        check: "bun run typecheck && bun run test",
+        "check:deps": "bun run scripts/check-dependencies.ts",
+        validate: "bun run check && bun run check:deps",
+        precommit: "bun run validate",
+        "docker:build": `docker build -t ${context.nameKebabCase} .`,
+        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
+      },
+      dependencies: {
+        "@gravito/core": "^1.0.0-beta.5",
+        "@gravito/enterprise": "workspace:*"
+      },
+      devDependencies: {
+        "bun-types": "latest",
+        typescript: "^5.9.3"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
   }
   generateArchitectureDoc(context) {
     return `# ${context.name} - DDD Architecture Guide
@@ -3359,123 +3016,13 @@ var EnterpriseMvcGenerator = class extends BaseGenerator {
     ];
   }
   // ─────────────────────────────────────────────────────────────
-  // Config Generators
+  // Config Generators (using shared ConfigGenerator)
   // ─────────────────────────────────────────────────────────────
   generateAppConfig(context) {
-    return `/**
- * Application Configuration
- */
-export default {
-  /**
-   * Application name
-   */
-  name: process.env.APP_NAME ?? '${context.name}',
-
-  /**
-   * Application environment
-   */
-  env: process.env.APP_ENV ?? 'development',
-
-  /**
-   * Application port
-   */
-  port: Number.parseInt(process.env.PORT ?? '3000', 10),
-
-  /**
-   * View directory
-   */
-  VIEW_DIR: process.env.VIEW_DIR ?? 'src/views',
-
-  /**
-   * Debug mode
-   */
-  debug: process.env.APP_DEBUG === 'true',
-
-  /**
-   * Application URL
-   */
-  url: process.env.APP_URL ?? 'http://localhost:3000',
-
-  /**
-   * Timezone
-   */
-  timezone: 'UTC',
-
-  /**
-   * Locale
-   */
-  locale: 'en',
-
-  /**
-   * Fallback locale
-   */
-  fallbackLocale: 'en',
-
-  /**
-   * Encryption key
-   */
-  key: process.env.APP_KEY,
-
-  /**
-   * Service providers to register
-   */
-  providers: [
-    // Framework providers
-    // 'RouteServiceProvider',
-
-    // Application providers
-    // 'AppServiceProvider',
-  ],
-}
-`;
+    return ConfigGenerator.generateDetailedAppConfig(context);
   }
   generateDatabaseConfig() {
-    return `/**
- * Database Configuration
- */
-export default {
-  /**
-   * Default connection
-   */
-  default: process.env.DB_CONNECTION ?? 'sqlite',
-
-  /**
-   * Database connections
-   */
-  connections: {
-    sqlite: {
-      driver: 'sqlite',
-      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
-    },
-
-    mysql: {
-      driver: 'mysql',
-      host: process.env.DB_HOST ?? 'localhost',
-      port: Number(process.env.DB_PORT ?? 3306),
-      database: process.env.DB_DATABASE ?? 'forge',
-      username: process.env.DB_USERNAME ?? 'forge',
-      password: process.env.DB_PASSWORD ?? '',
-    },
-
-    postgres: {
-      driver: 'postgres',
-      host: process.env.DB_HOST ?? 'localhost',
-      port: Number(process.env.DB_PORT ?? 5432),
-      database: process.env.DB_DATABASE ?? 'forge',
-      username: process.env.DB_USERNAME ?? 'forge',
-      password: process.env.DB_PASSWORD ?? '',
-    },
-  },
-
-  /**
-   * Migration settings
-   */
-  migrations: {
-    table: 'migrations',
-    path: 'database/migrations',
-  },
-}
-`;
+    return ConfigGenerator.generateDetailedDatabaseConfig();
   }
   generateAuthConfig() {
     return `/**
@@ -3758,33 +3305,6 @@ export class AppServiceProvider extends ServiceProvider {
     console.log('${context.name} application booted!')
   }
 }
-`;
-  }
-  generateRouteServiceProvider(_context) {
-    return `/**
- * Route Service Provider
- *
- * Configures and registers application routes.
- */
-
-import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
-import { registerRoutes } from '../routes'
-
-export class RouteServiceProvider extends ServiceProvider {
-  /**
-   * Register any application services.
-   */
-  register(_container: Container): void {
-    // Routes are registered in boot
-  }
-
-  /**
-   * Bootstrap any application services.
-   */
-  boot(core: PlanetCore): void {
-    registerRoutes(core.router)
-  }
-}
 `;
   }
   // ─────────────────────────────────────────────────────────────
@@ -4455,11 +3975,9 @@ export class ${name}ServiceProvider extends ServiceProvider {
       module: "dist/index.mjs",
       types: "dist/index.d.ts",
       scripts: {
-        build: "tsup src/index.ts --format cjs,esm --dts",
+        build: "tsup src/index.ts --format esm --dts",
         test: "bun test",
-        typecheck: "tsc --noEmit",
-        check: "bun run typecheck && bun run test",
-        validate: "bun run check"
+        typecheck: "bun tsc --noEmit"
       },
       dependencies: {
         "@gravito/core": depVersion,
@@ -4468,8 +3986,12 @@ export class ${name}ServiceProvider extends ServiceProvider {
         "@gravito/stasis": depVersion
       },
       devDependencies: {
-        tsup: "^8.0.0",
-        typescript: "^5.0.0"
+        "bun-types": "latest",
+        typescript: "^5.9.3",
+        tsup: "^8.0.0"
+      },
+      peerDependencies: {
+        "@gravito/core": ">=1.0.0"
       }
     };
     return JSON.stringify(pkg, null, 2);
@@ -4619,7 +4141,7 @@ var ProfileResolver = class _ProfileResolver {
 };
 
 // src/Scaffold.ts
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_path6 = __toESM(require("path"), 1);
 
 // src/generators/ActionDomainGenerator.ts
 var ActionDomainGenerator = class extends BaseGenerator {
@@ -4826,6 +4348,9 @@ var ActionDomainGenerator = class extends BaseGenerator {
 
 import { Model, column } from '@gravito/atlas'
 
+/**
+ * Represents a user in the system.
+ */
 export class User extends Model {
   static table = 'users'
 
@@ -5110,7 +4635,7 @@ Created with \u2764\uFE0F using Gravito Framework
         build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
         start: "bun run dist/bootstrap.js",
         test: "bun test",
-        typecheck: "tsc --noEmit",
+        typecheck: "bun tsc --noEmit",
         check: "bun run typecheck && bun run test",
         "check:deps": "bun run scripts/check-dependencies.ts",
         validate: "bun run check && bun run check:deps",
@@ -5124,7 +4649,7 @@ Created with \u2764\uFE0F using Gravito Framework
       },
       devDependencies: {
         "bun-types": "latest",
-        typescript: "^5.0.0"
+        typescript: "^5.9.3"
       }
     };
     return JSON.stringify(pkg, null, 2);
@@ -5132,6 +4657,7 @@ Created with \u2764\uFE0F using Gravito Framework
 };
 
 // src/generators/StandaloneEngineGenerator.ts
+var import_node_path5 = __toESM(require("path"), 1);
 var StandaloneEngineGenerator = class extends BaseGenerator {
   get architectureType() {
     return "standalone-engine";
@@ -5163,9 +4689,16 @@ var StandaloneEngineGenerator = class extends BaseGenerator {
     ];
   }
   async generateCommonFiles(context) {
+    const commonDir = import_node_path5.default.resolve(this.config.templatesDir, "common");
+    const extendedContext = { ...context };
     await this.writeFile(context.targetDir, "package.json", this.generatePackageJson(context));
-    await this.writeFile(context.targetDir, "tsconfig.json", this.generateTsConfig());
-    await this.writeFile(context.targetDir, ".gitignore", this.generateGitignore());
+    await this.generateFileFromTemplate(
+      commonDir,
+      "tsconfig.json.hbs",
+      "tsconfig.json",
+      extendedContext
+    );
+    await this.generateFileFromTemplate(commonDir, "gitignore.hbs", ".gitignore", extendedContext);
   }
   generatePackageJson(context) {
     const pkg = {
@@ -5220,23 +4753,17 @@ A high-performance web application powered by Gravito Engine.
 
 ### Install Dependencies
 
-\`\`\`bash
-bun install
-\`\`\`
-
+  bun install
+  
 ### Run Development Server
 
-\`\`\`bash
-bun run dev
-\`\`\`
-
+  bun run dev
+  
 ### Production Build
 
-\`\`\`bash
-bun run build
+  bun run build
 bun start
-\`\`\`
-`;
+  `;
   }
 };
 
@@ -5245,11 +4772,14 @@ var Scaffold = class {
   templatesDir;
   verbose;
   constructor(options = {}) {
-    this.templatesDir = options.templatesDir ?? import_node_path3.default.resolve(__dirname, "../templates");
+    this.templatesDir = options.templatesDir ?? import_node_path6.default.resolve(__dirname, "../templates");
     this.verbose = options.verbose ?? false;
   }
   /**
-   * Get all available architecture types.
+   * Returns a list of all architectural patterns supported by the engine,
+   * along with human-readable names and descriptions.
+   *
+   * @returns {Array<{type: ArchitectureType, name: string, description: string}>}
    */
   getArchitectureTypes() {
     return [
@@ -5286,11 +4816,16 @@ var Scaffold = class {
     ];
   }
   /**
-   * Create a new project scaffold.
+   * Orchestrates the complete project generation lifecycle.
+   * This includes directory creation, file layout, profile resolution,
+   * dependency mapping, and optional post-install hooks.
+   *
+   * @param {ScaffoldOptions} options - Detailed configuration for the new project.
+   * @returns {Promise<ScaffoldResult>}
    */
   async create(options) {
     const generator = this.createGenerator(options.architecture);
-    const fs3 = await import("fs/promises");
+    const fs5 = await import("fs/promises");
     const profileResolver = new ProfileResolver();
     const profileConfig = profileResolver.resolve(options.profile, options.features);
     const context = BaseGenerator.createContext(
@@ -5317,8 +4852,8 @@ var Scaffold = class {
         // Default template for now, should come from options if applicable
         "1.0.0"
       );
-      const lockPath = import_node_path3.default.resolve(options.targetDir, "gravito.lock.json");
-      await fs3.writeFile(lockPath, lockContent, "utf-8");
+      const lockPath = import_node_path6.default.resolve(options.targetDir, "gravito.lock.json");
+      await fs5.writeFile(lockPath, lockContent, "utf-8");
       filesCreated.push(lockPath);
       return {
         success: true,