@gravito/scaffold 1.0.0-beta.1 → 1.1.0

package/dist/index.js

@@ -1,3 +1,102 @@
+// src/EnvironmentDetector.ts
+var EnvironmentDetector = class {
+  detect() {
+    if (process.env.KUBERNETES_SERVICE_HOST) {
+      return {
+        platform: "k8s",
+        suggestedProfile: "enterprise",
+        confidence: "high",
+        reason: "Kubernetes environment detected (KUBERNETES_SERVICE_HOST)"
+      };
+    }
+    if (process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.AWS_EXECUTION_ENV) {
+      return {
+        platform: "aws",
+        suggestedProfile: "scale",
+        confidence: "high",
+        reason: "AWS Lambda environment detected"
+      };
+    }
+    if (process.env.VERCEL) {
+      return {
+        platform: "vercel",
+        suggestedProfile: "core",
+        confidence: "high",
+        reason: "Vercel environment detected"
+      };
+    }
+    if (process.env.RAILWAY_ENVIRONMENT || process.env.RENDER) {
+      return {
+        platform: "unknown",
+        // Generic cloud
+        suggestedProfile: "scale",
+        confidence: "medium",
+        reason: "Cloud container environment detected"
+      };
+    }
+    return {
+      platform: "unknown",
+      suggestedProfile: "core",
+      confidence: "low",
+      reason: "No specific cloud environment detected, defaulting to Core"
+    };
+  }
+};
+
+// src/utils/deepMerge.ts
+function deepMerge(target, source) {
+  if (typeof target !== "object" || target === null) {
+    return source;
+  }
+  if (typeof source !== "object" || source === null) {
+    return source;
+  }
+  if (Array.isArray(target) && Array.isArray(source)) {
+    return Array.from(/* @__PURE__ */ new Set([...target, ...source]));
+  }
+  const output = { ...target };
+  for (const key of Object.keys(source)) {
+    if (source[key] instanceof Object && key in target) {
+      output[key] = deepMerge(target[key], source[key]);
+    } else {
+      output[key] = source[key];
+    }
+  }
+  return output;
+}
+
+// src/FileMerger.ts
+var FileMerger = class {
+  /**
+   * Merge content of two files based on their type.
+   */
+  merge(fileName, baseContent, overlayContent) {
+    if (fileName.endsWith(".json")) {
+      return this.mergeJson(baseContent, overlayContent);
+    }
+    if (fileName.endsWith(".env") || fileName.endsWith(".env.example")) {
+      return this.mergeEnv(baseContent, overlayContent);
+    }
+    return overlayContent;
+  }
+  mergeJson(base, overlay) {
+    try {
+      const baseJson = JSON.parse(base);
+      const overlayJson = JSON.parse(overlay);
+      const merged = deepMerge(baseJson, overlayJson);
+      return JSON.stringify(merged, null, 2);
+    } catch (e) {
+      console.warn("Failed to merge JSON, returning overlay", e);
+      return overlay;
+    }
+  }
+  mergeEnv(base, overlay) {
+    return `${base}
+# --- Overlay ---
+${overlay}`;
+  }
+};
+
 // src/generators/BaseGenerator.ts
 import fs2 from "fs/promises";
 import path2 from "path";
@@ -155,9 +254,24 @@ var StubGenerator = class {
 };
 
 // src/generators/BaseGenerator.ts
+async function walk(dir) {
+  const files = await fs2.readdir(dir);
+  const paths = [];
+  for (const file of files) {
+    const filePath = path2.join(dir, file);
+    const stat = await fs2.stat(filePath);
+    if (stat.isDirectory()) {
+      paths.push(...await walk(filePath));
+    } else {
+      paths.push(filePath);
+    }
+  }
+  return paths;
+}
 var BaseGenerator = class {
   config;
   stubGenerator;
+  fileMerger;
   filesCreated = [];
   constructor(config) {
     this.config = config;
@@ -166,6 +280,7 @@ var BaseGenerator = class {
       outputDir: ""
       // Set per-generation
     });
+    this.fileMerger = new FileMerger();
   }
   /**
    * Generate the project scaffold.
@@ -178,6 +293,8 @@ var BaseGenerator = class {
     const structure = this.getDirectoryStructure(context);
     await this.createStructure(context.targetDir, structure, context);
     await this.generateCommonFiles(context);
+    await this.applyOverlays(context);
+    await this.applyFeatureOverlays(context);
     return this.filesCreated;
   }
   /**
@@ -222,11 +339,53 @@ var BaseGenerator = class {
     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,
       "ARCHITECTURE.md",
       this.generateArchitectureDoc(context)
     );
+    await this.generateCheckScripts(context);
+  }
+  /**
+   * Apply profile-specific overlays
+   */
+  async applyOverlays(context) {
+    const profile = context.profile;
+    if (!profile) return;
+    const overlayDir = path2.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 = path2.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 fs2.access(sourceDir);
+    } catch {
+      return;
+    }
+    const files = await walk(sourceDir);
+    for (const filePath of files) {
+      const relativePath = path2.relative(sourceDir, filePath);
+      let content = await fs2.readFile(filePath, "utf-8");
+      try {
+        content = this.stubGenerator.render(content, context);
+      } catch {
+      }
+      await this.writeFile(context.targetDir, relativePath, content);
+    }
   }
   /**
    * Write a file and track it.
@@ -234,7 +393,16 @@ var BaseGenerator = class {
   async writeFile(basePath, relativePath, content) {
     const fullPath = path2.resolve(basePath, relativePath);
     await fs2.mkdir(path2.dirname(fullPath), { recursive: true });
-    await fs2.writeFile(fullPath, content, "utf-8");
+    let finalContent = content;
+    try {
+      const existingContent = await fs2.readFile(fullPath, "utf-8");
+      finalContent = this.fileMerger.merge(relativePath, existingContent, content);
+      if (finalContent !== content) {
+        this.log(`\u{1F504} Merged file: ${relativePath}`);
+      }
+    } catch {
+    }
+    await fs2.writeFile(fullPath, finalContent, "utf-8");
     this.filesCreated.push(fullPath);
     this.log(`\u{1F4C4} Created file: ${relativePath}`);
   }
@@ -242,6 +410,20 @@ var BaseGenerator = class {
    * Generate package.json content.
    */
   generatePackageJson(context) {
+    const profile = context.profile || "core";
+    const baseDependencies = {
+      "@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";
+    }
+    if (context.withSpectrum) {
+      baseDependencies["@gravito/spectrum"] = "^1.0.0-beta.1";
+    }
     const pkg = {
       name: context.nameKebabCase,
       version: "0.1.0",
@@ -251,42 +433,197 @@ 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"
-      },
-      dependencies: {
-        "gravito-core": "^1.0.0-beta.5"
+        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: baseDependencies,
       devDependencies: {
-        "@types/bun": "latest",
+        "bun-types": "latest",
         typescript: "^5.0.0"
       }
     };
     return JSON.stringify(pkg, null, 2);
   }
+  /**
+   * Generate Dockerfile content.
+   */
+  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" ]
+`;
+  }
+  /**
+   * Generate .dockerignore content.
+   */
+  generateDockerIgnore() {
+    return `node_modules
+dist
+.git
+.env
+*.log
+.vscode
+.idea
+tests
+`;
+  }
   /**
    * Generate .env.example content.
    */
   generateEnvExample(context) {
-    return `# Application
-APP_NAME="${context.name}"
+    const profile = context.profile || "core";
+    let envContent = `# ============================================================================
+# Application Configuration
+# ============================================================================
+
+APP_NAME=${context.name}
 APP_ENV=development
-APP_KEY=
 APP_DEBUG=true
 APP_URL=http://localhost:3000
+APP_KEY=
 
-# Server
-PORT=3000
+# ============================================================================
+# Database Configuration
+# ============================================================================
 
-# Database
-DB_CONNECTION=sqlite
+# Database Connection (sqlite, postgres, mysql)
+DB_CONNECTION=${profile === "core" ? "sqlite" : "postgres"}
+
+# SQLite Configuration (when DB_CONNECTION=sqlite)
 DB_DATABASE=database/database.sqlite
 
-# Cache
-CACHE_DRIVER=memory
+# 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:
+
+`;
+    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
+
+`;
+    }
+    envContent += `# ============================================================================
+# Logging Configuration
+# ============================================================================
 
-# Logging
 LOG_LEVEL=debug
 `;
+    return envContent;
   }
   /**
    * Generate .gitignore content.
@@ -338,6 +675,9 @@ coverage/
         strict: true,
         skipLibCheck: true,
         declaration: true,
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        types: ["bun-types"],
         outDir: "./dist",
         rootDir: "./src",
         baseUrl: ".",
@@ -350,6 +690,430 @@ coverage/
     };
     return JSON.stringify(config, null, 2);
   }
+  /**
+   * Generate check scripts for project validation.
+   */
+  async generateCheckScripts(context) {
+    const scriptsDir = path2.resolve(context.targetDir, "scripts");
+    await fs2.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));
+  }
+  /**
+   * Generate check-dependencies.ts script content.
+   */
+  generateCheckDependenciesScript() {
+    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
+ */
+
+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
+}
+
+const colors = {
+  reset: '\\x1b[0m',
+  green: '\\x1b[32m',
+  yellow: '\\x1b[33m',
+  red: '\\x1b[31m',
+  blue: '\\x1b[36m',
+}
+
+function log(message: string, color: keyof typeof colors = 'reset') {
+  console.log(\`\${colors[color]}\${message}\${colors.reset}\`)
+}
+
+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
+  }
+}
+
+function parseVersion(version: string): string {
+  // \u79FB\u9664 ^, ~, >= \u7B49\u524D\u7DB4
+  return version.replace(/^[\\^~>=<]/, '')
+}
+
+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
+  }
+
+  const current = parseVersion(currentVersion)
+  const latest = await getLatestVersion(name)
+
+  if (!latest) {
+    return null
+  }
+
+  return {
+    name,
+    current,
+    latest,
+    outdated: current !== latest,
+  }
+}
+
+async function main() {
+  log('\\n=== \u76F8\u4F9D\u5957\u4EF6\u7248\u672C\u6AA2\u67E5 ===\\n', 'blue')
+
+  const packageJsonPath = join(process.cwd(), 'package.json')
+  const packageJson: PackageJson = JSON.parse(
+    readFileSync(packageJsonPath, 'utf-8')
+  )
+
+  const allDependencies = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies,
+  }
+
+  log(\`\u6AA2\u67E5 \${Object.keys(allDependencies).length} \u500B\u5957\u4EF6...\\n\`, 'yellow')
+
+  const results: PackageInfo[] = []
+  const outdated: PackageInfo[] = []
+  const upToDate: PackageInfo[] = []
+
+  // \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)
+      }
+    }
+  }
+
+  // \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')
+    })
+  }
+
+  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')
+    })
+  }
+
+  // \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')
+
+  // \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)
+  }
+}
+
+main().catch((error) => {
+  log(\`\\n\u932F\u8AA4: \${error.message}\`, 'red')
+  process.exit(1)
+})
+`;
+  }
+  /**
+   * Generate check.sh script content.
+   */
+  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}"
+`;
+  }
+  /**
+   * Generate pre-commit.sh script content.
+   */
+  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"
+`;
+  }
+  /**
+   * Generate CHECK_SYSTEM.md documentation.
+   */
+  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
+
+### \u8DF3\u904E\u6AA2\u67E5
+\u53EA\u6709\u5728\u7DCA\u6025\u60C5\u6CC1\u4E0B\u624D\u4F7F\u7528\uFF1A
+\`\`\`bash
+git commit --no-verify
+\`\`\`
+
+### \u79FB\u9664 Pre-commit Hook
+\`\`\`bash
+rm .git/hooks/pre-commit
+\`\`\`
+`;
+  }
   /**
    * Log a message if verbose mode is enabled.
    */
@@ -407,6 +1171,11 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
           { type: "file", name: "logging.ts", content: this.generateLoggingConfig() }
         ]
       },
+      {
+        type: "directory",
+        name: "database",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      },
       {
         type: "directory",
         name: "src",
@@ -419,16 +1188,12 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
               {
                 type: "directory",
                 name: "Entities",
-                children: [
-                  { type: "file", name: "Entity.ts", content: this.generateBaseEntity() },
-                  { type: "file", name: "User.ts", content: this.generateUserEntity() }
-                ]
+                children: [{ type: "file", name: "User.ts", content: this.generateUserEntity() }]
               },
               {
                 type: "directory",
                 name: "ValueObjects",
                 children: [
-                  { type: "file", name: "ValueObject.ts", content: this.generateBaseValueObject() },
                   { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
                 ]
               },
@@ -446,13 +1211,7 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
               {
                 type: "directory",
                 name: "Exceptions",
-                children: [
-                  {
-                    type: "file",
-                    name: "DomainException.ts",
-                    content: this.generateDomainException()
-                  }
-                ]
+                children: [{ type: "file", name: ".gitkeep", content: "" }]
               }
             ]
           },
@@ -535,6 +1294,11 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
                 type: "directory",
                 name: "Providers",
                 children: [
+                  {
+                    type: "file",
+                    name: "index.ts",
+                    content: this.generateProvidersIndex()
+                  },
                   {
                     type: "file",
                     name: "AppServiceProvider.ts",
@@ -544,6 +1308,16 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
                     type: "file",
                     name: "RepositoryServiceProvider.ts",
                     content: this.generateRepositoryServiceProvider()
+                  },
+                  {
+                    type: "file",
+                    name: "MiddlewareProvider.ts",
+                    content: this.generateMiddlewareProvider()
+                  },
+                  {
+                    type: "file",
+                    name: "RouteProvider.ts",
+                    content: this.generateRouteProvider()
                   }
                 ]
               }
@@ -673,42 +1447,6 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
     console: { driver: 'console', level: process.env.LOG_LEVEL ?? 'debug' },
   },
 }
-`;
-  }
-  // ─────────────────────────────────────────────────────────────
-  // Domain Layer
-  // ─────────────────────────────────────────────────────────────
-  generateBaseEntity() {
-    return `/**
- * Base Entity
- *
- * All domain entities extend this base class.
- * Entities have identity and lifecycle.
- *
- * IMPORTANT: This layer must have NO external dependencies.
- */
-
-export abstract class Entity<T> {
-  protected readonly _id: T
-
-  constructor(id: T) {
-    this._id = id
-  }
-
-  get id(): T {
-    return this._id
-  }
-
-  equals(other: Entity<T>): boolean {
-    if (other === null || other === undefined) {
-      return false
-    }
-    if (!(other instanceof Entity)) {
-      return false
-    }
-    return this._id === other._id
-  }
-}
 `;
   }
   generateUserEntity() {
@@ -719,7 +1457,7 @@ export abstract class Entity<T> {
  * Contains business logic related to users.
  */
 
-import { Entity } from './Entity'
+import { Entity } from '@gravito/enterprise'
 import { Email } from '../ValueObjects/Email'
 
 export interface UserProps {
@@ -769,30 +1507,6 @@ export class User extends Entity<string> {
     this.props.updatedAt = new Date()
   }
 }
-`;
-  }
-  generateBaseValueObject() {
-    return `/**
- * Base Value Object
- *
- * Value objects are immutable and compared by value.
- * They have no identity of their own.
- */
-
-export abstract class ValueObject<T> {
-  protected readonly props: T
-
-  constructor(props: T) {
-    this.props = Object.freeze(props)
-  }
-
-  equals(other: ValueObject<T>): boolean {
-    if (other === null || other === undefined) {
-      return false
-    }
-    return JSON.stringify(this.props) === JSON.stringify(other.props)
-  }
-}
 `;
   }
   generateEmailValueObject() {
@@ -802,7 +1516,7 @@ export abstract class ValueObject<T> {
  * Encapsulates email validation and comparison.
  */
 
-import { ValueObject } from './ValueObject'
+import { ValueObject } from '@gravito/enterprise'
 
 interface EmailProps {
   value: string
@@ -843,43 +1557,11 @@ export class Email extends ValueObject<EmailProps> {
  * Implementations are in Infrastructure layer.
  */
 
+import type { Repository } from '@gravito/enterprise'
 import type { User } from '../Entities/User'
 
-export interface IUserRepository {
-  findById(id: string): Promise<User | null>
+export interface IUserRepository extends Repository<User, string> {
   findByEmail(email: string): Promise<User | null>
-  save(user: User): Promise<void>
-  delete(id: string): Promise<void>
-  findAll(): Promise<User[]>
-}
-`;
-  }
-  generateDomainException() {
-    return `/**
- * Domain Exception
- *
- * Base exception for domain-level errors.
- */
-
-export class DomainException extends Error {
-  constructor(message: string) {
-    super(message)
-    this.name = 'DomainException'
-  }
-}
-
-export class EntityNotFoundException extends DomainException {
-  constructor(entity: string, id: string) {
-    super(\`\${entity} with id \${id} not found\`)
-    this.name = 'EntityNotFoundException'
-  }
-}
-
-export class InvalidValueException extends DomainException {
-  constructor(message: string) {
-    super(message)
-    this.name = 'InvalidValueException'
-  }
 }
 `;
   }
@@ -893,6 +1575,7 @@ export class InvalidValueException extends DomainException {
  * Application service for creating new users.
  */
 
+import { UseCase } from '@gravito/enterprise'
 import { User } from '../../../Domain/Entities/User'
 import type { IUserRepository } from '../../../Domain/Interfaces/IUserRepository'
 import type { UserDTO } from '../../DTOs/UserDTO'
@@ -906,8 +1589,10 @@ export interface CreateUserOutput {
   user: UserDTO
 }
 
-export class CreateUserUseCase {
-  constructor(private userRepository: IUserRepository) {}
+export class CreateUserUseCase extends UseCase<CreateUserInput, CreateUserOutput> {
+  constructor(private userRepository: IUserRepository) {
+    super()
+  }
 
   async execute(input: CreateUserInput): Promise<CreateUserOutput> {
     // Check if email already exists
@@ -944,8 +1629,8 @@ export class CreateUserUseCase {
  * Get User Use Case
  */
 
+import { UseCase } from '@gravito/enterprise'
 import type { IUserRepository } from '../../../Domain/Interfaces/IUserRepository'
-import { EntityNotFoundException } from '../../../Domain/Exceptions/DomainException'
 import type { UserDTO } from '../../DTOs/UserDTO'
 
 export interface GetUserInput {
@@ -956,14 +1641,16 @@ export interface GetUserOutput {
   user: UserDTO
 }
 
-export class GetUserUseCase {
-  constructor(private userRepository: IUserRepository) {}
+export class GetUserUseCase extends UseCase<GetUserInput, GetUserOutput> {
+  constructor(private userRepository: IUserRepository) {
+    super()
+  }
 
   async execute(input: GetUserInput): Promise<GetUserOutput> {
     const user = await this.userRepository.findById(input.id)
 
     if (!user) {
-      throw new EntityNotFoundException('User', input.id)
+      throw new Error(\`User with id \${input.id} not found\`)
     }
 
     return {
@@ -1064,6 +1751,10 @@ export class UserRepository implements IUserRepository {
   async findAll(): Promise<User[]> {
     return Array.from(users.values())
   }
+
+  async exists(id: string): Promise<boolean> {
+    return users.has(id)
+  }
 }
 `;
   }
@@ -1087,7 +1778,7 @@ export class MailService implements IMailService {
  * App Service Provider
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
 export class AppServiceProvider extends ServiceProvider {
   register(_container: Container): void {
@@ -1107,7 +1798,7 @@ export class AppServiceProvider extends ServiceProvider {
  * Binds repository interfaces to implementations.
  */
 
-import { ServiceProvider, type Container } from 'gravito-core'
+import { ServiceProvider, type Container } from '@gravito/core'
 import { UserRepository } from '../Persistence/Repositories/UserRepository'
 import { MailService } from '../ExternalServices/MailService'
 
@@ -1120,6 +1811,65 @@ export class RepositoryServiceProvider extends ServiceProvider {
     container.singleton('mailService', () => new MailService())
   }
 }
+`;
+  }
+  generateProvidersIndex() {
+    return `/**
+ * Application Service Providers
+ */
+
+export { AppServiceProvider } from './AppServiceProvider'
+export { RepositoryServiceProvider } from './RepositoryServiceProvider'
+export { MiddlewareProvider } from './MiddlewareProvider'
+export { RouteProvider } from './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')
+  }
+}
+`;
+  }
+  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')
+  }
+}
 `;
   }
   // ─────────────────────────────────────────────────────────────
@@ -1130,7 +1880,7 @@ export class RepositoryServiceProvider extends ServiceProvider {
  * User Controller
  */
 
-import type { GravitoContext } from 'gravito-core'
+import type { GravitoContext } from '@gravito/core'
 import { CreateUserUseCase } from '../../../Application/UseCases/User/CreateUser'
 import { GetUserUseCase } from '../../../Application/UseCases/User/GetUser'
 import { UserRepository } from '../../../Infrastructure/Persistence/Repositories/UserRepository'
@@ -1204,28 +1954,55 @@ export class UserPresenter {
 }
 `;
   }
-  generateBootstrap(context) {
+  generateBootstrap(_context) {
     return `/**
  * Application Bootstrap
+ *
+ * The entry point for your Clean Architecture application.
+ * Uses the ServiceProvider pattern for modular initialization.
+ *
+ * Lifecycle:
+ * 1. Configure: Load app config and orbits
+ * 2. Boot: Initialize PlanetCore
+ * 3. Register Providers: Bind services to container
+ * 4. Bootstrap: Boot all providers
  */
 
-import { PlanetCore } from 'gravito-core'
-import { AppServiceProvider } from './Infrastructure/Providers/AppServiceProvider'
-import { RepositoryServiceProvider } from './Infrastructure/Providers/RepositoryServiceProvider'
-import { registerApiRoutes } from './Interface/Http/Routes/api'
-
-const core = new PlanetCore({
-  config: { APP_NAME: '${context.name}' },
-})
-
-core.register(new RepositoryServiceProvider())
-core.register(new AppServiceProvider())
-
-await core.bootstrap()
-
-// Register routes
-registerApiRoutes(core.router)
+import { defineConfig, PlanetCore } from '@gravito/core'
+import { OrbitAtlas } from '@gravito/atlas'
+import appConfig from '../config/app'
+import {
+  AppServiceProvider,
+  RepositoryServiceProvider,
+  MiddlewareProvider,
+  RouteProvider,
+} from './Infrastructure/Providers'
+
+export async function bootstrap() {
+  // 1. Configure
+  const config = defineConfig({
+    config: appConfig,
+    orbits: [new OrbitAtlas()],
+  })
+
+  // 2. Boot Core
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
+
+  // 3. Register Providers
+  core.register(new RepositoryServiceProvider())
+  core.register(new AppServiceProvider())
+  core.register(new MiddlewareProvider())
+  core.register(new RouteProvider())
+
+  // 4. Bootstrap All Providers
+  await core.bootstrap()
+
+  return core
+}
 
+// Application Entry Point
+const core = await bootstrap()
 export default core.liftoff()
 `;
   }
@@ -1237,6 +2014,15 @@ export default core.liftoff()
 This project follows **Clean Architecture** (by Robert C. Martin).
 The key principle is the **Dependency Rule**: dependencies point inward.
 
+## Service Providers
+
+Service providers are the central place to configure your application. They follow the ServiceProvider pattern with \`register()\` and \`boot()\` lifecycle methods.
+
+### Provider Lifecycle
+
+1. **register()**: Bind services to the container (sync or async).
+2. **boot()**: Called after ALL providers have registered. Safe to use other services.
+
 ## Layer Structure
 
 \`\`\`
@@ -1297,6 +2083,36 @@ src/
 Created with \u2764\uFE0F using Gravito Framework
 `;
   }
+  generatePackageJson(context) {
+    const pkg = {
+      name: context.nameKebabCase,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "bun run --watch src/bootstrap.ts",
+        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}`
+      },
+      dependencies: {
+        "@gravito/core": "workspace:*",
+        "@gravito/enterprise": "workspace:*",
+        ...context.withSpectrum ? { "@gravito/spectrum": "workspace:*" } : {}
+      },
+      devDependencies: {
+        "bun-types": "latest",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
 };
 
 // src/generators/DddGenerator.ts
@@ -1424,22 +2240,6 @@ var DddGenerator = class extends BaseGenerator {
                 { type: "file", name: "Money.ts", content: this.generateMoneyValueObject() },
                 { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
               ]
-            },
-            {
-              type: "directory",
-              name: "Events",
-              children: [
-                { type: "file", name: "DomainEvent.ts", content: this.generateDomainEvent() }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Primitives",
-              children: [
-                { type: "file", name: "AggregateRoot.ts", content: this.generateAggregateRoot() },
-                { type: "file", name: "Entity.ts", content: this.generateEntity() },
-                { type: "file", name: "ValueObject.ts", content: this.generateValueObject() }
-              ]
             }
           ]
         },
@@ -1621,34 +2421,46 @@ var DddGenerator = class extends BaseGenerator {
   // ─────────────────────────────────────────────────────────────
   // Bootstrap File Generators
   // ─────────────────────────────────────────────────────────────
-  generateBootstrapApp(context) {
+  generateBootstrapApp(_context) {
     return `/**
  * Application Bootstrap
  *
- * Central configuration and initialization of the application.
+ * Central configuration and initialization using the ServiceProvider pattern.
+ *
+ * Lifecycle:
+ * 1. Configure: Load app config and orbits
+ * 2. Boot: Initialize PlanetCore
+ * 3. Register Providers: Bind services to container
+ * 4. Bootstrap: Boot all providers
  */
 
-import { PlanetCore } from 'gravito-core'
+import { defineConfig, PlanetCore } from '@gravito/core'
+import { OrbitAtlas } from '@gravito/atlas'
+import appConfig from '../../config/app'
 import { registerProviders } from './providers'
 import { registerRoutes } from './routes'
 
 export async function createApp(): Promise<PlanetCore> {
-    const core = new PlanetCore({
-        config: {
-            APP_NAME: '${context.name}',
-        },
-    })
+  // 1. Configure
+  const config = defineConfig({
+    config: appConfig,
+    orbits: [new OrbitAtlas()],
+  })
 
-    // Register all service providers
-    await registerProviders(core)
+  // 2. Boot Core
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
 
-    // Bootstrap the application
-    await core.bootstrap()
+  // 3. Register Providers
+  await registerProviders(core)
 
-    // Register routes
-    registerRoutes(core.router)
+  // 4. Bootstrap All Providers
+  await core.bootstrap()
+
+  // Register routes after bootstrap
+  registerRoutes(core.router)
 
-    return core
+  return core
 }
 `;
   }
@@ -1656,19 +2468,48 @@ export async function createApp(): Promise<PlanetCore> {
     return `/**
  * Service Providers Registry
  *
- * Register all module service providers here.
+ * Register all service providers here.
+ * Include both global and module-specific providers.
  */
 
-import type { PlanetCore } from 'gravito-core'
+import {
+  ServiceProvider,
+  type Container,
+  type PlanetCore,
+  bodySizeLimit,
+  securityHeaders,
+} from '@gravito/core'
 import { OrderingServiceProvider } from '../Modules/Ordering/Infrastructure/Providers/OrderingServiceProvider'
 import { CatalogServiceProvider } from '../Modules/Catalog/Infrastructure/Providers/CatalogServiceProvider'
 
+/**
+ * Middleware Provider - Global middleware registration
+ */
+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 Global middleware registered')
+  }
+}
+
 export async function registerProviders(core: PlanetCore): Promise<void> {
-    // Register module providers
-    core.register(new OrderingServiceProvider())
-    core.register(new CatalogServiceProvider())
+  // Global Providers
+  core.register(new MiddlewareProvider())
+
+  // Module Providers
+  core.register(new OrderingServiceProvider())
+  core.register(new CatalogServiceProvider())
 
-    // Add more providers as needed
+  // Add more providers as needed
 }
 `;
   }
@@ -1754,7 +2595,7 @@ export default {
  * ${name} Service Provider
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 import { ${name}Repository } from '../Persistence/${name}Repository'
 
 export class ${name}ServiceProvider extends ServiceProvider {
@@ -1781,13 +2622,20 @@ export class ${name}ServiceProvider extends ServiceProvider {
         build: "bun build ./src/main.ts --outdir ./dist --target bun",
         start: "bun run dist/main.js",
         test: "bun test",
-        typecheck: "tsc --noEmit"
+        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/core": "^1.0.0-beta.5",
+        "@gravito/enterprise": "workspace:*"
       },
       devDependencies: {
-        "@types/bun": "latest",
+        "bun-types": "latest",
         typescript: "^5.0.0"
       }
     };
@@ -1838,11 +2686,15 @@ export class ${name}ServiceProvider extends ServiceProvider {
  * Shared identifier across all contexts.
  */
 
-export class Id {
-  private readonly _value: string
+import { ValueObject } from '@gravito/enterprise'
+
+interface IdProps {
+    value: string
+}
 
+export class Id extends ValueObject<IdProps> {
   private constructor(value: string) {
-    this._value = value
+    super({ value })
   }
 
   static create(): Id {
@@ -1855,15 +2707,11 @@ export class Id {
   }
 
   get value(): string {
-    return this._value
-  }
-
-  equals(other: Id): boolean {
-    return this._value === other._value
+    return this.props.value
   }
 
   toString(): string {
-    return this._value
+    return this.props.value
   }
 }
 `;
@@ -1873,12 +2721,25 @@ export class Id {
  * Money Value Object
  */
 
-export class Money {
-  constructor(
-    public readonly amount: number,
-    public readonly currency: string = 'USD'
-  ) {
+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 {
@@ -1896,10 +2757,6 @@ export class Money {
       throw new Error('Cannot operate on different currencies')
     }
   }
-
-  equals(other: Money): boolean {
-    return this.amount === other.amount && this.currency === other.currency
-  }
 }
 `;
   }
@@ -1908,11 +2765,15 @@ export class Money {
  * Email Value Object
  */
 
-export class Email {
-  private readonly _value: string
+import { ValueObject } from '@gravito/enterprise'
+
+interface EmailProps {
+    value: string
+}
 
+export class Email extends ValueObject<EmailProps> {
   private constructor(value: string) {
-    this._value = value.toLowerCase().trim()
+    super({ value: value.toLowerCase().trim() })
   }
 
   static create(email: string): Email {
@@ -1927,97 +2788,7 @@ export class Email {
   }
 
   get value(): string {
-    return this._value
-  }
-}
-`;
-  }
-  generateDomainEvent() {
-    return `/**
- * Domain Event Base
- */
-
-export abstract class DomainEvent {
-  readonly occurredOn: Date
-  readonly eventId: string
-
-  constructor() {
-    this.occurredOn = new Date()
-    this.eventId = crypto.randomUUID()
-  }
-
-  abstract get eventName(): string
-  abstract get aggregateId(): string
-}
-`;
-  }
-  generateAggregateRoot() {
-    return `/**
- * Aggregate Root Base
- */
-
-import type { DomainEvent } from '../Events/DomainEvent'
-import type { Id } from '../ValueObjects/Id'
-
-export abstract class AggregateRoot<T extends Id = Id> {
-  private _domainEvents: DomainEvent[] = []
-
-  protected constructor(protected readonly _id: T) {}
-
-  get id(): T {
-    return this._id
-  }
-
-  get domainEvents(): DomainEvent[] {
-    return [...this._domainEvents]
-  }
-
-  protected addDomainEvent(event: DomainEvent): void {
-    this._domainEvents.push(event)
-  }
-
-  clearDomainEvents(): DomainEvent[] {
-    const events = [...this._domainEvents]
-    this._domainEvents = []
-    return events
-  }
-}
-`;
-  }
-  generateEntity() {
-    return `/**
- * Entity Base
- */
-
-import type { Id } from '../ValueObjects/Id'
-
-export abstract class Entity<T extends Id = Id> {
-  protected constructor(protected readonly _id: T) {}
-
-  get id(): T {
-    return this._id
-  }
-
-  equals(other: Entity<T>): boolean {
-    return this._id.equals(other._id)
-  }
-}
-`;
-  }
-  generateValueObject() {
-    return `/**
- * Value Object Base
- */
-
-export abstract class ValueObject<T> {
-  protected readonly props: T
-
-  constructor(props: T) {
-    this.props = Object.freeze(props)
-  }
-
-  equals(other: ValueObject<T>): boolean {
-    return JSON.stringify(this.props) === JSON.stringify(other.props)
+    return this.props.value
   }
 }
 `;
@@ -2027,7 +2798,7 @@ export abstract class ValueObject<T> {
  * Event Dispatcher
  */
 
-import type { DomainEvent } from '../../Domain/Events/DomainEvent'
+import type { DomainEvent } from '@gravito/enterprise'
 
 type EventHandler = (event: DomainEvent) => void | Promise<void>
 
@@ -2063,7 +2834,7 @@ export class EventDispatcher {
  * ${name} Aggregate Root
  */
 
-import { AggregateRoot } from '../../../../../Shared/Domain/Primitives/AggregateRoot'
+import { AggregateRoot } from '@gravito/enterprise'
 import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 import { ${name}Created } from '../../Events/${name}Created'
 import { ${name}Status } from './${name}Status'
@@ -2074,7 +2845,7 @@ export interface ${name}Props {
   createdAt: Date
 }
 
-export class ${name} extends AggregateRoot {
+export class ${name} extends AggregateRoot<Id> {
   private props: ${name}Props
 
   private constructor(id: Id, props: ${name}Props) {
@@ -2119,14 +2890,14 @@ export enum ${name}Status {
  * ${name} Created Event
  */
 
-import { DomainEvent } from '../../../../Shared/Domain/Events/DomainEvent'
+import { DomainEvent } from '@gravito/enterprise'
 
 export class ${name}Created extends DomainEvent {
   constructor(public readonly ${name.toLowerCase()}Id: string) {
     super()
   }
 
-  get eventName(): string {
+  override get eventName(): string {
     return '${name.toLowerCase()}.created'
   }
 
@@ -2141,12 +2912,12 @@ export class ${name}Created extends DomainEvent {
  * ${name} Repository Interface
  */
 
+import { Repository } from '@gravito/enterprise'
 import type { ${name} } from '../Aggregates/${name}/${name}'
+import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 
-export interface I${name}Repository {
-  findById(id: string): Promise<${name} | null>
-  save(aggregate: ${name}): Promise<void>
-  delete(id: string): Promise<void>
+export interface I${name}Repository extends Repository<${name}, Id> {
+    // Add specific methods for this repository if needed
 }
 `;
   }
@@ -2155,11 +2926,15 @@ export interface I${name}Repository {
  * Create ${name} Command
  */
 
-export class Create${name}Command {
+import { Command } from '@gravito/enterprise'
+
+export class Create${name}Command extends Command {
   constructor(
     // Add command properties
     public readonly id?: string
-  ) {}
+  ) {
+    super()
+  }
 }
 `;
   }
@@ -2168,12 +2943,13 @@ export class Create${name}Command {
  * Create ${name} Handler
  */
 
+import { CommandHandler } from '@gravito/enterprise'
 import type { I${name}Repository } from '../../../Domain/Repositories/I${name}Repository'
 import { ${name} } from '../../../Domain/Aggregates/${name}/${name}'
 import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 import type { Create${name}Command } from './Create${name}Command'
 
-export class Create${name}Handler {
+export class Create${name}Handler implements CommandHandler<Create${name}Command, string> {
   constructor(private repository: I${name}Repository) {}
 
   async handle(command: Create${name}Command): Promise<string> {
@@ -2192,8 +2968,12 @@ export class Create${name}Handler {
  * Get ${name} By Id Query
  */
 
-export class Get${name}ByIdQuery {
-  constructor(public readonly id: string) {}
+import { Query } from '@gravito/enterprise'
+
+export class Get${name}ByIdQuery extends Query {
+  constructor(public readonly id: string) {
+    super()
+  }
 }
 `;
   }
@@ -2202,15 +2982,16 @@ export class Get${name}ByIdQuery {
  * Get ${name} By Id Handler
  */
 
+import { QueryHandler } from '@gravito/enterprise'
 import type { I${name}Repository } from '../../../Domain/Repositories/I${name}Repository'
 import type { ${name}DTO } from '../../DTOs/${name}DTO'
 import type { Get${name}ByIdQuery } from './Get${name}ByIdQuery'
 
-export class Get${name}ByIdHandler {
+export class Get${name}ByIdHandler implements QueryHandler<Get${name}ByIdQuery, ${name}DTO | null> {
   constructor(private repository: I${name}Repository) {}
 
   async handle(query: Get${name}ByIdQuery): Promise<${name}DTO | null> {
-    const aggregate = await this.repository.findById(query.id)
+    const aggregate = await this.repository.findById(query.id as any) // Simplified for demo
     if (!aggregate) return null
 
     return {
@@ -2242,20 +3023,29 @@ export interface ${name}DTO {
 
 import type { ${name} } from '../../Domain/Aggregates/${name}/${name}'
 import type { I${name}Repository } from '../../Domain/Repositories/I${name}Repository'
+import type { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 
 const store = new Map<string, ${name}>()
 
 export class ${name}Repository implements I${name}Repository {
-  async findById(id: string): Promise<${name} | null> {
-    return store.get(id) ?? null
+  async findById(id: Id): Promise<${name} | null> {
+    return store.get(id.value) ?? null
   }
 
   async save(aggregate: ${name}): Promise<void> {
     store.set(aggregate.id.value, aggregate)
   }
 
-  async delete(id: string): Promise<void> {
-    store.delete(id)
+  async delete(id: Id): Promise<void> {
+    store.delete(id.value)
+  }
+
+  async findAll(): Promise<${name}[]> {
+    return Array.from(store.values())
+  }
+
+  async exists(id: Id): Promise<boolean> {
+    return store.has(id.value)
   }
 }
 `;
@@ -2277,6 +3067,16 @@ export function report(error: unknown): void {
 
 This project follows **Domain-Driven Design (DDD)** with strategic and tactical patterns.
 
+## Service Providers
+
+Service providers are the central place to configure your application and modules. They follow the ServiceProvider pattern with \`register()\` and \`boot()\` lifecycle methods.
+
+### Internal Bootstrapping
+
+1. **Bootstrap/app.ts**: Orchestrates the 4-step lifecycle (Configure, Boot, Register, Bootstrap).
+2. **Bootstrap/providers.ts**: Central registry for all global and module-specific providers.
+3. **Infrastructure/Providers/[Module]ServiceProvider.ts**: Module-specific service registration.
+
 ## Bounded Contexts
 
 \`\`\`
@@ -2414,6 +3214,11 @@ var EnterpriseMvcGenerator = class extends BaseGenerator {
             type: "directory",
             name: "Providers",
             children: [
+              {
+                type: "file",
+                name: "index.ts",
+                content: this.generateProvidersIndex()
+              },
               {
                 type: "file",
                 name: "AppServiceProvider.ts",
@@ -2421,8 +3226,18 @@ var EnterpriseMvcGenerator = class extends BaseGenerator {
               },
               {
                 type: "file",
-                name: "RouteServiceProvider.ts",
-                content: this.generateRouteServiceProvider(context)
+                name: "DatabaseProvider.ts",
+                content: this.generateDatabaseProvider()
+              },
+              {
+                type: "file",
+                name: "MiddlewareProvider.ts",
+                content: this.generateMiddlewareProvider()
+              },
+              {
+                type: "file",
+                name: "RouteProvider.ts",
+                content: this.generateRouteProvider()
               }
             ]
           },
@@ -2698,7 +3513,7 @@ export default {
  * can be assigned to specific routes.
  */
 
-import type { GravitoMiddleware } from 'gravito-core'
+import type { GravitoMiddleware } from '@gravito/core'
 
 /**
  * Global middleware stack.
@@ -2787,7 +3602,7 @@ export abstract class Controller {
  * Home Controller
  */
 
-import type { GravitoContext } from 'gravito-core'
+import type { GravitoContext } from '@gravito/core'
 import { Controller } from './Controller'
 
 export class HomeController extends Controller {
@@ -2821,7 +3636,7 @@ export class HomeController extends Controller {
  * Protects routes that require authentication.
  */
 
-import type { GravitoContext, GravitoNext } from 'gravito-core'
+import type { GravitoContext, GravitoNext } from '@gravito/core'
 
 export async function Authenticate(c: GravitoContext, next: GravitoNext) {
   // TODO: Implement authentication check
@@ -2831,6 +3646,7 @@ export async function Authenticate(c: GravitoContext, next: GravitoNext) {
   // }
 
   await next()
+  return undefined
 }
 `;
   }
@@ -2842,7 +3658,7 @@ export async function Authenticate(c: GravitoContext, next: GravitoNext) {
  * Register and bootstrap application services here.
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
 export class AppServiceProvider extends ServiceProvider {
   /**
@@ -2870,7 +3686,7 @@ export class AppServiceProvider extends ServiceProvider {
  * Configures and registers application routes.
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 import { registerRoutes } from '../routes'
 
 export class RouteServiceProvider extends ServiceProvider {
@@ -2890,80 +3706,250 @@ export class RouteServiceProvider extends ServiceProvider {
 }
 `;
   }
-  generateExceptionHandler() {
+  // ─────────────────────────────────────────────────────────────
+  // Modern Provider Generators (ServiceProvider Pattern)
+  // ─────────────────────────────────────────────────────────────
+  generateProvidersIndex() {
     return `/**
- * Exception Handler
+ * Application Service Providers
  *
- * Handles all exceptions thrown by the application.
- * Customize error responses and logging here.
+ * Export all providers for easy importing in bootstrap.
+ * Providers are registered in the order they are listed.
  */
 
-import type { ErrorHandlerContext } from 'gravito-core'
-
-/**
- * Report an exception (logging, monitoring, etc.)
- */
-export function report(error: unknown, context: ErrorHandlerContext): void {
-  // Log to external service (Sentry, etc.)
-  if (!context.isProduction) {
-    console.error('[Exception Handler]', error)
+export { AppServiceProvider } from './AppServiceProvider'
+export { DatabaseProvider } from './DatabaseProvider'
+export { MiddlewareProvider } from './MiddlewareProvider'
+export { RouteProvider } from './RouteProvider'
+`;
   }
-}
-
-/**
- * Determine if the exception should be reported.
+  generateDatabaseProvider() {
+    return `/**
+ * Database Service Provider
+ *
+ * Handles database initialization and migrations.
+ *
+ * Lifecycle:
+ * - register(): Bind database config to container
+ * - boot(): Run migrations and seeders
  */
-export function shouldReport(error: unknown): boolean {
-  // Don't report 4xx errors
-  if (error instanceof Error && 'status' in error) {
-    const status = (error as any).status
-    if (status >= 400 && status < 500) {
-      return false
-    }
+
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import databaseConfig from '../../config/database'
+
+export class DatabaseProvider extends ServiceProvider {
+  /**
+   * Register database configuration.
+   */
+  register(_container: Container): void {
+    this.mergeConfig(this.core!.config, 'database', databaseConfig)
   }
 
-  return true
+  /**
+   * Initialize database connections.
+   */
+  async boot(core: PlanetCore): Promise<void> {
+    // Database initialization will be handled by Atlas orbit
+    core.logger.info('\u{1F4E6} Database provider booted')
+  }
 }
-
-/**
- * A list of exception types that should not be reported.
- */
-export const dontReport: string[] = [
-  'ValidationException',
-  'NotFoundException',
-]
 `;
   }
-  generateBootstrap(context) {
+  generateMiddlewareProvider() {
     return `/**
- * Application Bootstrap
+ * Middleware Service Provider
  *
- * This is the entry point for your application.
- * It initializes the core and registers all providers.
+ * Registers global middleware stack.
+ * Provides a centralized location for middleware configuration.
+ *
+ * Lifecycle:
+ * - register(): N/A (no container bindings)
+ * - boot(): Register global middleware
  */
 
-import { PlanetCore } from 'gravito-core'
-import { AppServiceProvider } from './Providers/AppServiceProvider'
-import { RouteServiceProvider } from './Providers/RouteServiceProvider'
-
-// Load environment variables
-// Bun automatically loads .env
+import {
+  ServiceProvider,
+  type Container,
+  type PlanetCore,
+  bodySizeLimit,
+  securityHeaders,
+} from '@gravito/core'
 
-// Create application core
-const core = new PlanetCore({
-  config: {
-    APP_NAME: '${context.name}',
-  },
-})
+export class MiddlewareProvider extends ServiceProvider {
+  /**
+   * No container bindings needed.
+   */
+  register(_container: Container): void {
+    // Middleware doesn't require container bindings
+  }
 
-// Register service providers
-core.register(new AppServiceProvider())
-core.register(new RouteServiceProvider())
+  /**
+   * Register global middleware stack.
+   */
+  boot(core: PlanetCore): void {
+    const isDev = process.env.NODE_ENV !== 'production'
+
+    // Security Headers
+    core.adapter.use('*', securityHeaders({
+      contentSecurityPolicy: isDev ? false : undefined,
+    }))
+
+    // Body Parser Limits
+    core.adapter.use('*', bodySizeLimit(10 * 1024 * 1024)) // 10MB limit
+
+    core.logger.info('\u{1F6E1}\uFE0F Middleware registered')
+  }
+}
+`;
+  }
+  generateRouteProvider() {
+    return `/**
+ * Route Service Provider
+ *
+ * Registers application routes.
+ * Routes are registered in the boot phase after all services are available.
+ *
+ * Lifecycle:
+ * - register(): N/A
+ * - boot(): Register routes
+ */
+
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import { registerRoutes } from '../routes'
+
+export class RouteProvider extends ServiceProvider {
+  /**
+   * No container bindings needed.
+   */
+  register(_container: Container): void {
+    // Routes don't require container bindings
+  }
+
+  /**
+   * Register application routes.
+   */
+  boot(core: PlanetCore): void {
+    registerRoutes(core.router)
+    core.logger.info('\u{1F6E4}\uFE0F Routes registered')
+  }
+}
+`;
+  }
+  generateExceptionHandler() {
+    return `/**
+ * Exception Handler
+ *
+ * Handles all exceptions thrown by the application.
+ * Customize error responses and logging here.
+ */
+
+import type { ErrorHandlerContext } from '@gravito/core'
+
+/**
+ * Report an exception (logging, monitoring, etc.)
+ */
+export function report(error: unknown, context: ErrorHandlerContext): void {
+  // Log to external service (Sentry, etc.)
+  if (!context.isProduction) {
+    console.error('[Exception Handler]', error)
+  }
+}
+
+/**
+ * Determine if the exception should be reported.
+ */
+export function shouldReport(error: unknown): boolean {
+  // Don't report 4xx errors
+  if (error instanceof Error && 'status' in error) {
+    const status = (error as any).status
+    if (status >= 400 && status < 500) {
+      return false
+    }
+  }
+
+  return true
+}
+
+/**
+ * A list of exception types that should not be reported.
+ */
+export const dontReport: string[] = [
+  'ValidationException',
+  'NotFoundException',
+]
+`;
+  }
+  generateBootstrap(context) {
+    const spectrumImport = context.withSpectrum ? "import { SpectrumOrbit } from '@gravito/spectrum'\n" : "";
+    const spectrumOrbit = context.withSpectrum ? "      new SpectrumOrbit()," : "";
+    return `/**
+ * Application Bootstrap
+ *
+ * The entry point for your Gravito application.
+ * Uses the ServiceProvider pattern for modular, maintainable initialization.
+ *
+ * Lifecycle:
+ * 1. Configure: Load app config and orbits
+ * 2. Boot: Initialize PlanetCore
+ * 3. Register Providers: Bind services to container
+ * 4. Bootstrap: Boot all providers
+ *
+ * @module bootstrap
+ */
 
-// Bootstrap the application
-await core.bootstrap()
+import { defineConfig, PlanetCore } from '@gravito/core'
+import { OrbitAtlas } from '@gravito/atlas'
+import appConfig from '../config/app'
+${spectrumImport}import {
+  AppServiceProvider,
+  DatabaseProvider,
+  MiddlewareProvider,
+  RouteProvider,
+} from './Providers'
+
+/**
+ * Bootstrap the application with service providers.
+ *
+ * @returns The booted PlanetCore instance
+ */
+export async function bootstrap() {
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // 1. Configure
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  const config = defineConfig({
+    config: appConfig,
+    orbits: [
+      new OrbitAtlas(),
+${spectrumOrbit}
+    ],
+  })
+
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // 2. Boot Core
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
+
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // 3. Register Providers
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  core.register(new AppServiceProvider())
+  core.register(new DatabaseProvider())
+  core.register(new MiddlewareProvider())
+  core.register(new RouteProvider())
+
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // 4. Bootstrap All Providers
+  // \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  await core.bootstrap()
+
+  return core
+}
 
-// Export for Bun.serve()
+// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+// Application Entry Point
+// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+const core = await bootstrap()
 export default core.liftoff()
 `;
   }
@@ -3126,51 +4112,1017 @@ Created with \u2764\uFE0F using Gravito Framework
   }
 };
 
-// src/Scaffold.ts
-import path3 from "path";
-var Scaffold = class {
-  templatesDir;
-  verbose;
-  constructor(options = {}) {
-    this.templatesDir = options.templatesDir ?? path3.resolve(__dirname, "../templates");
-    this.verbose = options.verbose ?? false;
+// src/generators/SatelliteGenerator.ts
+var SatelliteGenerator = class extends BaseGenerator {
+  get architectureType() {
+    return "satellite";
   }
-  /**
-   * Get all available architecture types.
-   */
-  getArchitectureTypes() {
+  get displayName() {
+    return "Gravito Satellite";
+  }
+  get description() {
+    return "A modular plugin for Gravito following DDD and Clean Architecture";
+  }
+  getDirectoryStructure(context) {
+    const name = context.namePascalCase;
     return [
       {
-        type: "enterprise-mvc",
-        name: "Enterprise MVC",
-        description: "Laravel-inspired MVC with Services and Repositories"
-      },
-      {
-        type: "clean",
-        name: "Clean Architecture",
-        description: "Uncle Bob's Clean Architecture with strict dependency rules"
+        type: "directory",
+        name: "src",
+        children: [
+          // Domain Layer
+          {
+            type: "directory",
+            name: "Domain",
+            children: [
+              {
+                type: "directory",
+                name: "Entities",
+                children: [
+                  { type: "file", name: `${name}.ts`, content: this.generateEntity(name) }
+                ]
+              },
+              {
+                type: "directory",
+                name: "Contracts",
+                children: [
+                  {
+                    type: "file",
+                    name: `I${name}Repository.ts`,
+                    content: this.generateRepositoryInterface(name)
+                  }
+                ]
+              },
+              { type: "directory", name: "ValueObjects", children: [] },
+              { type: "directory", name: "Events", children: [] }
+            ]
+          },
+          // Application Layer
+          {
+            type: "directory",
+            name: "Application",
+            children: [
+              {
+                type: "directory",
+                name: "UseCases",
+                children: [
+                  {
+                    type: "file",
+                    name: `Create${name}.ts`,
+                    content: this.generateUseCase(name)
+                  }
+                ]
+              },
+              { type: "directory", name: "DTOs", children: [] }
+            ]
+          },
+          // Infrastructure Layer
+          {
+            type: "directory",
+            name: "Infrastructure",
+            children: [
+              {
+                type: "directory",
+                name: "Persistence",
+                children: [
+                  {
+                    type: "file",
+                    name: `Atlas${name}Repository.ts`,
+                    content: this.generateAtlasRepository(name)
+                  },
+                  { type: "directory", name: "Migrations", children: [] }
+                ]
+              }
+            ]
+          },
+          // Entry Point
+          { type: "file", name: "index.ts", content: this.generateEntryPoint(name) },
+          {
+            type: "file",
+            name: "env.d.ts",
+            content: "interface ImportMeta {\n  readonly dir: string\n  readonly path: string\n}\n"
+          },
+          { type: "file", name: "manifest.json", content: this.generateManifest(context) }
+        ]
       },
       {
-        type: "ddd",
-        name: "Domain-Driven Design",
-        description: "Full DDD with Bounded Contexts and CQRS"
+        type: "directory",
+        name: "tests",
+        children: [
+          {
+            type: "file",
+            name: "unit.test.ts",
+            content: `import { describe, it, expect } from "bun:test";
+
+describe("${name}", () => {
+  it("should work", () => {
+    expect(true).toBe(true);
+  });
+});`
+          }
+        ]
       }
     ];
   }
-  /**
-   * Create a new project scaffold.
-   */
-  async create(options) {
-    const generator = this.createGenerator(options.architecture);
-    const context = BaseGenerator.createContext(
-      options.name,
-      options.targetDir,
-      options.architecture,
-      options.packageManager ?? "bun",
-      options.context ?? {}
+  // ─────────────────────────────────────────────────────────────
+  // Domain Templates
+  // ─────────────────────────────────────────────────────────────
+  generateEntity(name) {
+    return `import { Entity } from '@gravito/enterprise'
+
+export interface ${name}Props {
+  name: string
+  createdAt: Date
+}
+
+export class ${name} extends Entity<string> {
+  constructor(id: string, private props: ${name}Props) {
+    super(id)
+  }
+
+  static create(id: string, name: string): ${name} {
+    return new ${name}(id, {
+      name,
+      createdAt: new Date()
+    })
+  }
+
+  get name() { return this.props.name }
+}
+`;
+  }
+  generateRepositoryInterface(name) {
+    return `import { Repository } from '@gravito/enterprise'
+import { ${name} } from '../Entities/${name}'
+
+export interface I${name}Repository extends Repository<${name}, string> {
+  // Add custom methods here
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Application Templates
+  // ─────────────────────────────────────────────────────────────
+  generateUseCase(name) {
+    return `import { UseCase } from '@gravito/enterprise'
+import { I${name}Repository } from '../../Domain/Contracts/I${name}Repository'
+import { ${name} } from '../../Domain/Entities/${name}'
+
+export interface Create${name}Input {
+  name: string
+}
+
+export class Create${name} extends UseCase<Create${name}Input, string> {
+  constructor(private repository: I${name}Repository) {
+    super()
+  }
+
+  async execute(input: Create${name}Input): Promise<string> {
+    const id = crypto.randomUUID()
+    const entity = ${name}.create(id, input.name)
+    
+    await this.repository.save(entity)
+    
+    return id
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Infrastructure Templates (Dogfooding Atlas)
+  // ─────────────────────────────────────────────────────────────
+  generateAtlasRepository(name) {
+    return `import { I${name}Repository } from '../../Domain/Contracts/I${name}Repository'
+import { ${name} } from '../../Domain/Entities/${name}'
+import { DB } from '@gravito/atlas'
+
+export class Atlas${name}Repository implements I${name}Repository {
+  async save(entity: ${name}): Promise<void> {
+    // Dogfooding: Use @gravito/atlas for persistence
+    console.log('[Atlas] Saving entity:', entity.id)
+    // await DB.table('${name.toLowerCase()}s').insert({ ... })
+  }
+
+  async findById(id: string): Promise<${name} | null> {
+    return null
+  }
+
+  async findAll(): Promise<${name}[]> {
+    return []
+  }
+
+  async delete(id: string): Promise<void> {}
+
+  async exists(id: string): Promise<boolean> {
+    return false
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Entry Point & Manifest
+  // ─────────────────────────────────────────────────────────────
+  generateEntryPoint(name) {
+    return `import { ServiceProvider, type Container } from '@gravito/core'
+import { Atlas${name}Repository } from './Infrastructure/Persistence/Atlas${name}Repository'
+
+export class ${name}ServiceProvider extends ServiceProvider {
+  register(container: Container): void {
+    // Bind Repository
+    container.singleton('${name.toLowerCase()}.repo', () => new Atlas${name}Repository())
+    
+    // Bind UseCases
+    container.singleton('${name.toLowerCase()}.create', () => {
+        return new (require('./Application/UseCases/Create${name}').Create${name})(
+            container.make('${name.toLowerCase()}.repo')
+        )
+    })
+  }
+
+  boot(): void {
+    this.core?.logger.info('\u{1F6F0}\uFE0F Satellite ${name} is operational')
+  }
+}
+`;
+  }
+  generateManifest(context) {
+    return JSON.stringify(
+      {
+        name: context.name,
+        id: context.nameKebabCase,
+        version: "0.1.0",
+        description: context.description || "A Gravito Satellite",
+        capabilities: [`create-${context.nameKebabCase}`],
+        requirements: [
+          "cache"
+          // Example requirement
+        ],
+        hooks: [`${context.nameKebabCase}:created`]
+      },
+      null,
+      2
+    );
+  }
+  generatePackageJson(context) {
+    const isInternal = context.isInternal || false;
+    const depVersion = isInternal ? "workspace:*" : "^1.0.0-beta.1";
+    const pkg = {
+      name: isInternal ? `@gravito/satellite-${context.nameKebabCase}` : `gravito-satellite-${context.nameKebabCase}`,
+      version: "0.1.0",
+      type: "module",
+      main: "dist/index.js",
+      module: "dist/index.mjs",
+      types: "dist/index.d.ts",
+      scripts: {
+        build: "tsup src/index.ts --format cjs,esm --dts",
+        test: "bun test",
+        typecheck: "tsc --noEmit",
+        check: "bun run typecheck && bun run test",
+        validate: "bun run check"
+      },
+      dependencies: {
+        "@gravito/core": depVersion,
+        "@gravito/enterprise": depVersion,
+        "@gravito/atlas": depVersion,
+        "@gravito/stasis": depVersion
+      },
+      devDependencies: {
+        tsup: "^8.0.0",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
+  generateArchitectureDoc(context) {
+    return `# ${context.name} Satellite Architecture
+
+This satellite follows the Gravito Satellite Specification v1.0.
+
+## Design
+- **DDD**: Domain logic is separated from framework concerns.
+- **Dogfooding**: Uses official Gravito modules (@gravito/atlas, @gravito/stasis).
+- **Decoupled**: Inter-satellite communication happens via Contracts and Events.
+
+## Layers
+- **Domain**: Pure business rules.
+- **Application**: Orchestration of domain tasks.
+- **Infrastructure**: Implementation of persistence and external services.
+- **Interface**: HTTP and Event entry points.
+`;
+  }
+};
+
+// src/LockGenerator.ts
+var LockGenerator = class {
+  generate(profileName, config, templateName = "basic", templateVersion = "1.0.0") {
+    const lock = {
+      profile: {
+        name: profileName,
+        version: "1.0.0"
+        // This could be dynamic based on profile system version
+      },
+      features: config.features,
+      drivers: config.drivers,
+      manifest: {
+        template: templateName,
+        version: templateVersion
+      },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    return JSON.stringify(lock, null, 2);
+  }
+};
+
+// src/ProfileResolver.ts
+var ProfileResolver = class _ProfileResolver {
+  static DEFAULTS = {
+    core: {
+      drivers: {
+        database: "sqlite",
+        cache: "memory",
+        queue: "sync",
+        storage: "local",
+        session: "file"
+      },
+      features: []
+    },
+    scale: {
+      drivers: {
+        database: "postgresql",
+        cache: "redis",
+        queue: "redis",
+        storage: "s3",
+        session: "redis"
+      },
+      features: ["stream", "nebula"]
+    },
+    enterprise: {
+      drivers: {
+        database: "postgresql",
+        cache: "redis",
+        queue: "redis",
+        storage: "s3",
+        session: "redis"
+      },
+      features: ["stream", "nebula", "monitor", "sentinel", "fortify"]
+    }
+  };
+  resolve(profile = "core", withFeatures = []) {
+    const base = _ProfileResolver.DEFAULTS[profile] || _ProfileResolver.DEFAULTS.core;
+    const config = {
+      drivers: { ...base.drivers },
+      features: [...base.features]
+    };
+    for (const feature of withFeatures) {
+      this.applyFeature(config, feature);
+    }
+    return config;
+  }
+  applyFeature(config, feature) {
+    switch (feature) {
+      case "redis":
+        config.drivers.cache = "redis";
+        config.drivers.queue = "redis";
+        config.drivers.session = "redis";
+        break;
+      case "postgres":
+      case "postgresql":
+        config.drivers.database = "postgresql";
+        break;
+      case "mysql":
+        config.drivers.database = "mysql";
+        break;
+      case "s3":
+        config.drivers.storage = "s3";
+        break;
+      case "r2":
+        config.drivers.storage = "r2";
+        break;
+      case "queue":
+        if (config.drivers.queue === "sync") {
+          config.drivers.queue = "redis";
+        }
+        break;
+      default:
+        if (!config.features.includes(feature)) {
+          config.features.push(feature);
+        }
+    }
+  }
+  /**
+   * Validator for profile names
+   */
+  isValidProfile(profile) {
+    return profile in _ProfileResolver.DEFAULTS;
+  }
+  /**
+   * Validator for feature names
+   */
+  isValidFeature(feature) {
+    const validFeatures = [
+      "redis",
+      "postgres",
+      "postgresql",
+      "mysql",
+      "s3",
+      "r2",
+      "queue",
+      "stream",
+      "nebula",
+      "monitor",
+      "sentinel",
+      "fortify"
+    ];
+    return validFeatures.includes(feature);
+  }
+};
+
+// src/Scaffold.ts
+import path3 from "path";
+
+// src/generators/ActionDomainGenerator.ts
+var ActionDomainGenerator = class extends BaseGenerator {
+  get architectureType() {
+    return "action-domain";
+  }
+  get displayName() {
+    return "Action Domain";
+  }
+  get description() {
+    return "Single-responsibility Action pattern for clear business logic separation";
+  }
+  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: "directory",
+        name: "database",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      },
+      {
+        type: "directory",
+        name: "src",
+        children: [
+          {
+            type: "directory",
+            name: "actions",
+            children: [
+              { type: "file", name: "Action.ts", content: this.generateActionBase() },
+              {
+                type: "directory",
+                name: "server",
+                children: [
+                  {
+                    type: "file",
+                    name: "GetServerStatusAction.ts",
+                    content: this.generateGetServerStatusAction()
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "controllers",
+            children: [
+              {
+                type: "directory",
+                name: "api",
+                children: [
+                  {
+                    type: "directory",
+                    name: "v1",
+                    children: [
+                      {
+                        type: "file",
+                        name: "ServerController.ts",
+                        content: this.generateServerController()
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "types",
+            children: [
+              {
+                type: "directory",
+                name: "requests",
+                children: [
+                  {
+                    type: "directory",
+                    name: "api",
+                    children: [
+                      {
+                        type: "directory",
+                        name: "v1",
+                        children: [{ type: "file", name: ".gitkeep", content: "" }]
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                type: "directory",
+                name: "responses",
+                children: [
+                  {
+                    type: "directory",
+                    name: "api",
+                    children: [
+                      {
+                        type: "directory",
+                        name: "v1",
+                        children: [
+                          {
+                            type: "file",
+                            name: "ServerStatusResponse.ts",
+                            content: this.generateServerStatusResponse()
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "models",
+            children: [{ type: "file", name: "User.ts", content: this.generateUserModel() }]
+          },
+          {
+            type: "directory",
+            name: "repositories",
+            children: [{ type: "file", name: ".gitkeep", content: "" }]
+          },
+          {
+            type: "directory",
+            name: "routes",
+            children: [{ type: "file", name: "api.ts", content: this.generateApiRoutes() }]
+          },
+          {
+            type: "directory",
+            name: "providers",
+            children: [
+              {
+                type: "file",
+                name: "index.ts",
+                content: this.generateProvidersIndex()
+              },
+              {
+                type: "file",
+                name: "AppServiceProvider.ts",
+                content: this.generateAppServiceProvider(context)
+              },
+              {
+                type: "file",
+                name: "MiddlewareProvider.ts",
+                content: this.generateMiddlewareProvider()
+              },
+              {
+                type: "file",
+                name: "RouteProvider.ts",
+                content: this.generateRouteProvider()
+              }
+            ]
+          },
+          { type: "file", name: "bootstrap.ts", content: this.generateBootstrap(context) }
+        ]
+      },
+      {
+        type: "directory",
+        name: "tests",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      }
+    ];
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Config Generators
+  // ─────────────────────────────────────────────────────────────
+  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,
+}
+`;
+  }
+  generateDatabaseConfig() {
+    return `export default {
+  default: process.env.DB_CONNECTION ?? 'sqlite',
+  connections: {
+    sqlite: {
+      driver: 'sqlite',
+      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
+    },
+  },
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Model Generators
+  // ─────────────────────────────────────────────────────────────
+  generateUserModel() {
+    return `/**
+ * User Model
+ */
+
+import { Model, column } from '@gravito/atlas'
+
+export class User extends Model {
+  static table = 'users'
+
+  @column({ isPrimary: true })
+  id!: number
+
+  @column()
+  name!: string
+
+  @column()
+  email!: string
+
+  @column()
+  created_at!: Date
+
+  @column()
+  updated_at!: Date
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Action Generators
+  // ─────────────────────────────────────────────────────────────
+  generateActionBase() {
+    return `/**
+ * Action Base Class
+ *
+ * All business logic actions should extend this class.
+ * It enforces a consistent execution method.
+ */
+
+export abstract class Action<TInput = unknown, TOutput = unknown> {
+  /**
+   * Execute the business logic.
+   */
+  abstract execute(input: TInput): Promise<TOutput> | TOutput
+}
+`;
+  }
+  generateGetServerStatusAction() {
+    return `/**
+ * Get Server Status Action
+ */
+
+import { Action } from '../Action'
+import type { ServerStatusResponse } from '../../types/responses/api/v1/ServerStatusResponse'
+
+export class GetServerStatusAction extends Action<void, ServerStatusResponse> {
+  execute(): Promise<ServerStatusResponse> {
+    return Promise.resolve({
+      status: 'active',
+      timestamp: new Date().toISOString(),
+      service: 'Gravito Hub'
+    })
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Controller Generators
+  // ─────────────────────────────────────────────────────────────
+  generateServerController() {
+    return `/**
+ * Server Controller
+ */
+
+import type { GravitoContext } from '@gravito/core'
+import { GetServerStatusAction } from '../../../actions/server/GetServerStatusAction'
+
+export class ServerController {
+  /**
+   * GET /v1/server/status
+   */
+  async status(c: GravitoContext) {
+    const action = new GetServerStatusAction()
+    const result = await action.execute()
+    
+    return c.json({
+      success: true,
+      data: result
+    })
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Type Generators
+  // ─────────────────────────────────────────────────────────────
+  generateServerStatusResponse() {
+    return `/**
+ * Server Status Response Type
+ */
+
+export interface ServerStatusResponse {
+  status: string
+  timestamp: string
+  service: string
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Routes & Bootstrap
+  // ─────────────────────────────────────────────────────────────
+  generateApiRoutes() {
+    return `/**
+ * API Routes Registration
+ */
+
+import type { Router } from '@gravito/core'
+import { ServerController } from '../controllers/api/v1/ServerController'
+
+export function registerApiRoutes(router: Router) {
+  const server = new ServerController()
+
+  router.prefix('/v1').group((group) => {
+    // Server Domain
+    group.get('/server/status', (c) => server.status(c))
+  })
+}
+`;
+  }
+  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 global services here
+  }
+
+  boot(core: PlanetCore): void {
+    core.logger.info('${context.name} (Action Domain) booted!')
+  }
+}
+`;
+  }
+  generateProvidersIndex() {
+    return `/**
+ * Application Service Providers
+ */
+
+export { AppServiceProvider } from './AppServiceProvider'
+export { MiddlewareProvider } from './MiddlewareProvider'
+export { RouteProvider } from './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 {
+    core.adapter.use('*', securityHeaders())
+    core.adapter.use('*', bodySizeLimit(1024 * 1024))
+    core.logger.info('\u{1F6E1}\uFE0F Middleware registered')
+  }
+}
+`;
+  }
+  generateRouteProvider() {
+    return `/**
+ * Route Service Provider
+ */
+
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import { registerApiRoutes } from '../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')
+  }
+}
+`;
+  }
+  generateBootstrap(_context) {
+    return `/**
+ * Application Bootstrap
+ *
+ * Uses the ServiceProvider pattern for modular initialization.
+ */
+
+import { defineConfig, PlanetCore } from '@gravito/core'
+import { OrbitAtlas } from '@gravito/atlas'
+import appConfig from '../config/app'
+import {
+  AppServiceProvider,
+  MiddlewareProvider,
+  RouteProvider,
+} from './providers'
+
+export async function bootstrap() {
+  const config = defineConfig({
+    config: appConfig,
+    orbits: [new OrbitAtlas()],
+  })
+
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
+
+  core.register(new AppServiceProvider())
+  core.register(new MiddlewareProvider())
+  core.register(new RouteProvider())
+
+  await core.bootstrap()
+
+  return core
+}
+
+const core = await bootstrap()
+export default core.liftoff()
+`;
+  }
+  generateArchitectureDoc(context) {
+    return `# ${context.name} - Action Domain Architecture
+
+## Overview
+
+This project uses the **Action Domain** pattern, designed for high-clarity API implementations.
+
+## Service Providers
+
+Service providers are the central place to configure your application. They follow the ServiceProvider pattern with \`register()\` and \`boot()\` lifecycle methods.
+
+## Directory Structure
+
+\`\`\`
+src/
+\u251C\u2500\u2500 actions/           # Single Responsibility Business Logic
+\u2502   \u251C\u2500\u2500 Action.ts      # Base Action class
+\u2502   \u2514\u2500\u2500 [Domain]/      # Domain-specific actions
+\u251C\u2500\u2500 controllers/       # HTTP Request Handlers
+\u2502   \u2514\u2500\u2500 api/v1/        # API Controllers
+\u251C\u2500\u2500 types/             # TypeScript Definitions
+\u251C\u2500\u2500 repositories/      # Data Access Layer
+\u251C\u2500\u2500 routes/            # Route Definitions
+\u251C\u2500\u2500 providers/         # Service Providers
+\u2514\u2500\u2500 config/            # Configuration
+\`\`\`
+
+## Core Concepts
+
+### Actions
+Every business operation is an "Action". An action:
+- Does ONE thing.
+- Takes specific input.
+- Returns specific output.
+- Is framework-agnostic (ideally).
+
+### Controllers
+Controllers are thin. They:
+1. Parse the request.
+2. Instantiate/Call the Action.
+3. Return the response.
+
+Created with \u2764\uFE0F using Gravito Framework
+`;
+  }
+  generatePackageJson(context) {
+    const pkg = {
+      name: context.nameKebabCase,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "bun run --watch src/bootstrap.ts",
+        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"
+      },
+      dependencies: {
+        "@gravito/core": "workspace:*",
+        "@gravito/enterprise": "workspace:*",
+        "@gravito/atlas": "workspace:*"
+        // Usually needed for repositories
+      },
+      devDependencies: {
+        "bun-types": "latest",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
+};
+
+// src/Scaffold.ts
+var Scaffold = class {
+  templatesDir;
+  verbose;
+  constructor(options = {}) {
+    this.templatesDir = options.templatesDir ?? path3.resolve(__dirname, "../templates");
+    this.verbose = options.verbose ?? false;
+  }
+  /**
+   * Get all available architecture types.
+   */
+  getArchitectureTypes() {
+    return [
+      {
+        type: "enterprise-mvc",
+        name: "Enterprise MVC",
+        description: "Laravel-inspired MVC with Services and Repositories"
+      },
+      {
+        type: "clean",
+        name: "Clean Architecture",
+        description: "Uncle Bob's Clean Architecture with strict dependency rules"
+      },
+      {
+        type: "ddd",
+        name: "Domain-Driven Design",
+        description: "Full DDD with Bounded Contexts and CQRS"
+      },
+      {
+        type: "action-domain",
+        name: "Action Domain",
+        description: "Single Action Controllers pattern for high-clarity APIs"
+      },
+      {
+        type: "satellite",
+        name: "Gravito Satellite",
+        description: "Plug-and-play module for the Gravito ecosystem"
+      }
+    ];
+  }
+  /**
+   * Create a new project scaffold.
+   */
+  async create(options) {
+    const generator = this.createGenerator(options.architecture);
+    const fs3 = await import("fs/promises");
+    const profileResolver = new ProfileResolver();
+    const profileConfig = profileResolver.resolve(options.profile, options.features);
+    const context = BaseGenerator.createContext(
+      options.name,
+      options.targetDir,
+      options.architecture,
+      options.packageManager ?? "bun",
+      {
+        ...options.context,
+        withSpectrum: options.withSpectrum ?? false,
+        isInternal: options.isInternal ?? false,
+        profile: options.profile ?? "core",
+        features: options.features ?? [],
+        profileConfig
+      }
     );
     try {
       const filesCreated = await generator.generate(context);
+      const lockGenerator = new LockGenerator();
+      const lockContent = lockGenerator.generate(
+        options.profile ?? "core",
+        profileConfig,
+        "basic",
+        // Default template for now, should come from options if applicable
+        "1.0.0"
+      );
+      const lockPath = path3.resolve(options.targetDir, "gravito.lock.json");
+      await fs3.writeFile(lockPath, lockContent, "utf-8");
+      filesCreated.push(lockPath);
       return {
         success: true,
         targetDir: options.targetDir,
@@ -3200,6 +5152,10 @@ var Scaffold = class {
         return new CleanArchitectureGenerator(config);
       case "ddd":
         return new DddGenerator(config);
+      case "action-domain":
+        return new ActionDomainGenerator(config);
+      case "satellite":
+        return new SatelliteGenerator(config);
       default:
         throw new Error(`Unknown architecture type: ${type}`);
     }
@@ -3222,6 +5178,11 @@ export {
   CleanArchitectureGenerator,
   DddGenerator,
   EnterpriseMvcGenerator,
+  EnvironmentDetector,
+  FileMerger,
+  LockGenerator,
+  ProfileResolver,
+  SatelliteGenerator,
   Scaffold,
   StubGenerator
 };