@gravito/pulse 1.0.0 → 2.0.0

package/dist/index.js

@@ -81110,6 +81110,27 @@ class BaseGenerator {
     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);
+    await this.generateSkills(context);
+  }
+  async generateSkills(context) {
+    const skillsDir = path2.resolve(this.config.templatesDir, "skills");
+    const targetSkillsDir = path2.join(".skills");
+    try {
+      await fs2.access(skillsDir);
+    } catch {
+      return;
+    }
+    const files = await walk(skillsDir);
+    for (const filePath of files) {
+      const relativePath = path2.relative(skillsDir, filePath);
+      const targetPath = path2.join(targetSkillsDir, relativePath);
+      let content = await fs2.readFile(filePath, "utf-8");
+      try {
+        content = this.stubGenerator.render(content, context);
+      } catch {}
+      await this.writeFile(context.targetDir, targetPath, content);
+    }
   }
   async applyOverlays(context) {
     const profile = context.profile;
@@ -81181,6 +81202,10 @@ class BaseGenerator {
         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}`
       },
@@ -81418,6 +81443,411 @@ coverage/
     };
     return JSON.stringify(config, null, 2);
   }
+  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));
+  }
+  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)
+})
+`;
+  }
+  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}"
+`;
+  }
+  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"
+`;
+  }
+  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(message) {
     if (this.config.verbose) {
       console.log(message);
@@ -81588,6 +82018,11 @@ class CleanArchitectureGenerator extends BaseGenerator {
                 type: "directory",
                 name: "Providers",
                 children: [
+                  {
+                    type: "file",
+                    name: "index.ts",
+                    content: this.generateProvidersIndex()
+                  },
                   {
                     type: "file",
                     name: "AppServiceProvider.ts",
@@ -81597,6 +82032,16 @@ class CleanArchitectureGenerator 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()
                   }
                 ]
               }
@@ -82080,6 +82525,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('\uD83D\uDEE1\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('\uD83D\uDEE4\uFE0F Routes registered')
+  }
+}
 `;
   }
   generateUserController() {
@@ -82161,64 +82665,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 { bodySizeLimit, PlanetCore, securityHeaders } from '@gravito/core'
+import { defineConfig, PlanetCore } from '@gravito/core'
 import { OrbitAtlas } from '@gravito/atlas'
-import databaseConfig from '../config/database'
-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}',
-    database: databaseConfig,
-  },
-})
-
-const defaultCsp = [
-  "default-src 'self'",
-  "script-src 'self' 'unsafe-inline'",
-  "style-src 'self' 'unsafe-inline'",
-  "img-src 'self' data:",
-  "object-src 'none'",
-  "base-uri 'self'",
-  "frame-ancestors 'none'",
-].join('; ')
-const cspValue = process.env.APP_CSP
-const csp = cspValue === 'false' ? false : (cspValue ?? defaultCsp)
-const hstsMaxAge = Number.parseInt(process.env.APP_HSTS_MAX_AGE ?? '15552000', 10)
-const bodyLimit = Number.parseInt(process.env.APP_BODY_LIMIT ?? '1048576', 10)
-const requireLength = process.env.APP_BODY_REQUIRE_LENGTH === 'true'
-
-core.adapter.use(
-  '*',
-  securityHeaders({
-    contentSecurityPolicy: csp,
-    hsts:
-      process.env.NODE_ENV === 'production'
-        ? { maxAge: Number.isNaN(hstsMaxAge) ? 15552000 : hstsMaxAge, includeSubDomains: true }
-        : false,
+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()],
   })
-)
-if (!Number.isNaN(bodyLimit) && bodyLimit > 0) {
-  core.adapter.use('*', bodySizeLimit(bodyLimit, { requireContentLength: requireLength }))
-}
 
-await core.orbit(new OrbitAtlas())
+  // 2. Boot Core
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
 
-core.register(new RepositoryServiceProvider())
-core.register(new AppServiceProvider())
+  // 3. Register Providers
+  core.register(new RepositoryServiceProvider())
+  core.register(new AppServiceProvider())
+  core.register(new MiddlewareProvider())
+  core.register(new RouteProvider())
 
-await core.bootstrap()
+  // 4. Bootstrap All Providers
+  await core.bootstrap()
 
-// Register routes
-registerApiRoutes(core.router)
+  return core
+}
 
+// Application Entry Point
+const core = await bootstrap()
 export default core.liftoff()
 `;
   }
@@ -82230,6 +82725,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
 
 \`\`\`
@@ -82301,6 +82805,10 @@ Created with \u2764\uFE0F using Gravito Framework
         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}`
       },
@@ -82605,63 +83113,46 @@ class DddGenerator extends BaseGenerator {
       ]
     };
   }
-  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 { bodySizeLimit, PlanetCore, securityHeaders } 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()],
+  })
 
-    const defaultCsp = [
-        "default-src 'self'",
-        "script-src 'self' 'unsafe-inline'",
-        "style-src 'self' 'unsafe-inline'",
-        "img-src 'self' data:",
-        "object-src 'none'",
-        "base-uri 'self'",
-        "frame-ancestors 'none'",
-    ].join('; ')
-    const cspValue = process.env.APP_CSP
-    const csp = cspValue === 'false' ? false : (cspValue ?? defaultCsp)
-    const hstsMaxAge = Number.parseInt(process.env.APP_HSTS_MAX_AGE ?? '15552000', 10)
-    const bodyLimit = Number.parseInt(process.env.APP_BODY_LIMIT ?? '1048576', 10)
-    const requireLength = process.env.APP_BODY_REQUIRE_LENGTH === 'true'
-
-    core.adapter.use(
-        '*',
-        securityHeaders({
-            contentSecurityPolicy: csp,
-            hsts:
-                process.env.NODE_ENV === 'production'
-                    ? { maxAge: Number.isNaN(hstsMaxAge) ? 15552000 : hstsMaxAge, includeSubDomains: true }
-                    : false,
-        })
-    )
-    if (!Number.isNaN(bodyLimit) && bodyLimit > 0) {
-        core.adapter.use('*', bodySizeLimit(bodyLimit, { requireContentLength: requireLength }))
-    }
+  // 2. Boot Core
+  const core = await PlanetCore.boot(config)
+  core.registerGlobalErrorHandlers()
 
-    // Register all service providers
-    await registerProviders(core)
+  // 3. Register Providers
+  await registerProviders(core)
 
-    // Bootstrap the application
-    await core.bootstrap()
+  // 4. Bootstrap All Providers
+  await core.bootstrap()
 
-    // Register routes
-    registerRoutes(core.router)
+  // Register routes after bootstrap
+  registerRoutes(core.router)
 
-    return core
+  return core
 }
 `;
   }
@@ -82669,19 +83160,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('\uD83D\uDEE1\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())
 
-    // Add more providers as needed
+  // Module Providers
+  core.register(new OrderingServiceProvider())
+  core.register(new CatalogServiceProvider())
+
+  // Add more providers as needed
 }
 `;
   }
@@ -82792,6 +83312,10 @@ export class ${name}ServiceProvider extends ServiceProvider {
         start: "bun run dist/main.js",
         test: "bun test",
         typecheck: "tsc --noEmit",
+        check: "bun run typecheck && bun run test",
+        "check:deps": "bun run scripts/check-dependencies.ts",
+        validate: "bun run check && bun run check:deps",
+        precommit: "bun run validate",
         "docker:build": `docker build -t ${context.nameKebabCase} .`,
         "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
       },
@@ -83223,6 +83747,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
 
 \`\`\`
@@ -83359,6 +83893,11 @@ class EnterpriseMvcGenerator extends BaseGenerator {
             type: "directory",
             name: "Providers",
             children: [
+              {
+                type: "file",
+                name: "index.ts",
+                content: this.generateProvidersIndex()
+              },
               {
                 type: "file",
                 name: "AppServiceProvider.ts",
@@ -83366,8 +83905,18 @@ class EnterpriseMvcGenerator 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()
               }
             ]
           },
@@ -83830,42 +84379,168 @@ export class RouteServiceProvider extends ServiceProvider {
 }
 `;
   }
-  generateExceptionHandler() {
+  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('\uD83D\uDCE6 Database provider booted')
+  }
 }
+`;
+  }
+  generateMiddlewareProvider() {
+    return `/**
+ * Middleware Service Provider
+ *
+ * Registers global middleware stack.
+ * Provides a centralized location for middleware configuration.
+ *
+ * Lifecycle:
+ * - register(): N/A (no container bindings)
+ * - boot(): Register global middleware
+ */
 
-/**
+import {
+  ServiceProvider,
+  type Container,
+  type PlanetCore,
+  bodySizeLimit,
+  securityHeaders,
+} from '@gravito/core'
+
+export class MiddlewareProvider extends ServiceProvider {
+  /**
+   * No container bindings needed.
+   */
+  register(_container: Container): void {
+    // Middleware doesn't require container bindings
+  }
+
+  /**
+   * 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('\uD83D\uDEE1\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('\uD83D\uDEE4\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[] = [
@@ -83877,74 +84552,75 @@ export const dontReport: string[] = [
   generateBootstrap(context) {
     const spectrumImport = context.withSpectrum ? `import { SpectrumOrbit } from '@gravito/spectrum'
 ` : "";
-    const spectrumOrbit = context.withSpectrum ? `
-// Enable Debug Dashboard
-if (process.env.APP_DEBUG === 'true') {
-  await core.orbit(new SpectrumOrbit())
-}
-` : "";
+    const spectrumOrbit = context.withSpectrum ? "      new SpectrumOrbit()," : "";
     return `/**
  * Application Bootstrap
  *
- * This is the entry point for your application.
- * It initializes the core and registers all providers.
+ * 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
  */
 
-import { bodySizeLimit, PlanetCore, securityHeaders } from '@gravito/core'
+import { defineConfig, PlanetCore } from '@gravito/core'
 import { OrbitAtlas } from '@gravito/atlas'
-import databaseConfig from '../config/database'
-${spectrumImport}import { AppServiceProvider } from './Providers/AppServiceProvider'
-import { RouteServiceProvider } from './Providers/RouteServiceProvider'
-
-// Load environment variables
-// Bun automatically loads .env
-
-// Create application core
-const core = new PlanetCore({
-  config: {
-    APP_NAME: process.env.APP_NAME ?? '${context.name}',
-    database: databaseConfig,
-  },
-})
-const defaultCsp = [
-  "default-src 'self'",
-  "script-src 'self' 'unsafe-inline'",
-  "style-src 'self' 'unsafe-inline'",
-  "img-src 'self' data:",
-  "object-src 'none'",
-  "base-uri 'self'",
-  "frame-ancestors 'none'",
-].join('; ')
-const cspValue = process.env.APP_CSP
-const csp = cspValue === 'false' ? false : (cspValue ?? defaultCsp)
-const hstsMaxAge = Number.parseInt(process.env.APP_HSTS_MAX_AGE ?? '15552000', 10)
-const bodyLimit = Number.parseInt(process.env.APP_BODY_LIMIT ?? '1048576', 10)
-const requireLength = process.env.APP_BODY_REQUIRE_LENGTH === 'true'
-
-core.adapter.use(
-  '*',
-  securityHeaders({
-    contentSecurityPolicy: csp,
-    hsts:
-      process.env.NODE_ENV === 'production'
-        ? { maxAge: Number.isNaN(hstsMaxAge) ? 15552000 : hstsMaxAge, includeSubDomains: true }
-        : false,
-  })
-)
-if (!Number.isNaN(bodyLimit) && bodyLimit > 0) {
-  core.adapter.use('*', bodySizeLimit(bodyLimit, { requireContentLength: requireLength }))
-}
+import appConfig from '../config/app'
+${spectrumImport}import {
+  AppServiceProvider,
+  DatabaseProvider,
+  MiddlewareProvider,
+  RouteProvider,
+} from './Providers'
 
-await core.orbit(new OrbitAtlas())
+/**
+ * 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}
-// Register service providers
-core.register(new AppServiceProvider())
-core.register(new RouteServiceProvider())
+    ],
+  })
 
-// Bootstrap the application
-await core.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
+  // 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()
 `;
   }
@@ -84350,7 +85026,9 @@ export class ${name}ServiceProvider extends ServiceProvider {
       scripts: {
         build: "tsup src/index.ts --format cjs,esm --dts",
         test: "bun test",
-        typecheck: "tsc --noEmit"
+        typecheck: "tsc --noEmit",
+        check: "bun run typecheck && bun run test",
+        validate: "bun run check"
       },
       dependencies: {
         "@gravito/core": depVersion,
@@ -84638,10 +85316,25 @@ class ActionDomainGenerator extends BaseGenerator {
             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()
               }
             ]
           },
@@ -84801,7 +85494,7 @@ export function registerApiRoutes(router: Router) {
 import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
 export class AppServiceProvider extends ServiceProvider {
-  register(container: Container): void {
+  register(_container: Container): void {
     // Register global services here
   }
 
@@ -84811,82 +85504,139 @@ export class AppServiceProvider extends ServiceProvider {
 }
 `;
   }
-  generateBootstrap(context) {
+  generateProvidersIndex() {
     return `/**
- * Application Entry Point
+ * Application Service Providers
  */
 
-import { PlanetCore, securityHeaders, bodySizeLimit } from '@gravito/core'
-import { OrbitAtlas } from '@gravito/atlas'
-import databaseConfig from '../config/database'
-import { AppServiceProvider } from './providers/AppServiceProvider'
-import { registerApiRoutes } from './routes/api'
-
-// Initialize Core
-const core = new PlanetCore({
-  config: { 
-    APP_NAME: '${context.name}',
-    database: databaseConfig
-  },
-})
+export { AppServiceProvider } from './AppServiceProvider'
+export { MiddlewareProvider } from './MiddlewareProvider'
+export { RouteProvider } from './RouteProvider'
+`;
+  }
+  generateMiddlewareProvider() {
+    return `/**
+ * Middleware Service Provider
+ */
 
-// Middleware
-core.adapter.use('*', securityHeaders())
-core.adapter.use('*', bodySizeLimit(1024 * 1024)) // 1MB
+import {
+  ServiceProvider,
+  type Container,
+  type PlanetCore,
+  bodySizeLimit,
+  securityHeaders,
+} from '@gravito/core'
 
-// Install Orbits
-await core.orbit(new OrbitAtlas())
+export class MiddlewareProvider extends ServiceProvider {
+  register(_container: Container): void {}
 
-// Service Providers
-core.register(new AppServiceProvider())
+  boot(core: PlanetCore): void {
+    core.adapter.use('*', securityHeaders())
+    core.adapter.use('*', bodySizeLimit(1024 * 1024))
+    core.logger.info('\uD83D\uDEE1\uFE0F Middleware registered')
+  }
+}
+`;
+  }
+  generateRouteProvider() {
+    return `/**
+ * Route Service Provider
+ */
 
-// Bootstrap
-await core.bootstrap()
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+import { registerApiRoutes } from '../routes/api'
 
-// Routes
-registerApiRoutes(core.router)
+export class RouteProvider extends ServiceProvider {
+  register(_container: Container): void {}
 
-// Liftoff
+  boot(core: PlanetCore): void {
+    registerApiRoutes(core.router)
+    core.logger.info('\uD83D\uDEE4\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.
-
-` + `## Directory Structure
-
-` + "```\n" + `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
-` + `\u2502   \u251C\u2500\u2500 requests/      # Request Payloads
-` + `\u2502   \u2514\u2500\u2500 responses/     # Response Structures
-` + `\u251C\u2500\u2500 repositories/      # Data Access Layer
-` + `\u251C\u2500\u2500 routes/            # Route Definitions
-` + `\u2514\u2500\u2500 config/            # Configuration
-` + "```\n\n" + `## 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
+    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) {
@@ -84899,7 +85649,11 @@ export default core.liftoff()
         build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
         start: "bun run dist/bootstrap.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"
       },
       dependencies: {
         "@gravito/core": "workspace:*",
@@ -85027,7 +85781,7 @@ import { confirm, note, spinner } from "@clack/prompts";
 // ../core/package.json
 var package_default = {
   name: "@gravito/core",
-  version: "1.0.0",
+  version: "1.1.0",
   description: "",
   module: "./dist/index.js",
   main: "./dist/index.cjs",
@@ -85043,6 +85797,11 @@ var package_default = {
       types: "./dist/compat.d.ts",
       import: "./dist/compat.js",
       require: "./dist/compat.cjs"
+    },
+    "./engine": {
+      types: "./dist/engine/index.d.ts",
+      import: "./dist/engine/index.js",
+      require: "./dist/engine/index.cjs"
     }
   },
   files: [
@@ -85096,7 +85855,6 @@ var package_default = {
 // ../core/src/adapters/PhotonAdapter.ts
 class PhotonRequestWrapper {
   photonCtx;
-  _cachedJson = null;
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
   }
@@ -87711,6 +88469,661 @@ class ServiceProvider {
     return Array.from(ServiceProvider.publishables.keys());
   }
 }
+// ../core/src/engine/AOTRouter.ts
+class AOTRouter {
+  staticRoutes = new Map;
+  dynamicRouter = new RadixRouter;
+  globalMiddleware = [];
+  pathMiddleware = new Map;
+  add(method, path4, handler, middleware = []) {
+    const normalizedMethod = method.toLowerCase();
+    if (this.isStaticPath(path4)) {
+      const key = `${normalizedMethod}:${path4}`;
+      this.staticRoutes.set(key, { handler, middleware });
+    } else {
+      const wrappedHandler = handler;
+      this.dynamicRouter.add(normalizedMethod, path4, [wrappedHandler]);
+      if (middleware.length > 0) {
+        this.pathMiddleware.set(`${normalizedMethod}:${path4}`, middleware);
+      }
+    }
+  }
+  use(...middleware) {
+    this.globalMiddleware.push(...middleware);
+  }
+  usePattern(pattern, ...middleware) {
+    const existing = this.pathMiddleware.get(pattern) ?? [];
+    this.pathMiddleware.set(pattern, [...existing, ...middleware]);
+  }
+  match(method, path4) {
+    const normalizedMethod = method.toLowerCase();
+    const staticKey = `${normalizedMethod}:${path4}`;
+    const staticRoute = this.staticRoutes.get(staticKey);
+    if (staticRoute) {
+      return {
+        handler: staticRoute.handler,
+        params: {},
+        middleware: this.collectMiddleware(path4, staticRoute.middleware)
+      };
+    }
+    const match2 = this.dynamicRouter.match(normalizedMethod, path4);
+    if (match2 && match2.handlers.length > 0) {
+      const handler = match2.handlers[0];
+      const routeKey = this.findDynamicRouteKey(normalizedMethod, path4);
+      const routeMiddleware = routeKey ? this.pathMiddleware.get(routeKey) ?? [] : [];
+      return {
+        handler,
+        params: match2.params,
+        middleware: this.collectMiddleware(path4, routeMiddleware)
+      };
+    }
+    return {
+      handler: null,
+      params: {},
+      middleware: []
+    };
+  }
+  collectMiddlewarePublic(path4, routeMiddleware) {
+    return this.collectMiddleware(path4, routeMiddleware);
+  }
+  collectMiddleware(path4, routeMiddleware) {
+    if (this.globalMiddleware.length === 0 && this.pathMiddleware.size === 0 && routeMiddleware.length === 0) {
+      return [];
+    }
+    const middleware = [];
+    if (this.globalMiddleware.length > 0) {
+      middleware.push(...this.globalMiddleware);
+    }
+    if (this.pathMiddleware.size > 0) {
+      for (const [pattern, mw] of this.pathMiddleware) {
+        if (pattern.includes(":"))
+          continue;
+        if (this.matchPattern(pattern, path4)) {
+          middleware.push(...mw);
+        }
+      }
+    }
+    if (routeMiddleware.length > 0) {
+      middleware.push(...routeMiddleware);
+    }
+    return middleware;
+  }
+  isStaticPath(path4) {
+    return !path4.includes(":") && !path4.includes("*");
+  }
+  matchPattern(pattern, path4) {
+    if (pattern === "*")
+      return true;
+    if (pattern === path4)
+      return true;
+    if (pattern.endsWith("/*")) {
+      const prefix = pattern.slice(0, -2);
+      return path4.startsWith(prefix);
+    }
+    return false;
+  }
+  findDynamicRouteKey(method, path4) {
+    for (const key of this.pathMiddleware.keys()) {
+      if (key.startsWith(`${method}:`)) {
+        return key;
+      }
+    }
+    return null;
+  }
+  getRoutes() {
+    const routes = [];
+    for (const key of this.staticRoutes.keys()) {
+      const [method, path4] = key.split(":");
+      routes.push({ method, path: path4, type: "static" });
+    }
+    return routes;
+  }
+}
+
+// ../core/src/engine/analyzer.ts
+function analyzeHandler(handler) {
+  const source = handler.toString();
+  return {
+    usesHeaders: source.includes(".header(") || source.includes(".header)") || source.includes(".headers(") || source.includes(".headers)"),
+    usesQuery: source.includes(".query(") || source.includes(".query)") || source.includes(".queries(") || source.includes(".queries)"),
+    usesBody: source.includes(".json()") || source.includes(".text()") || source.includes(".formData()") || source.includes(".body"),
+    usesParams: source.includes(".param(") || source.includes(".param)") || source.includes(".params(") || source.includes(".params)"),
+    isAsync: source.includes("async") || source.includes("await")
+  };
+}
+function getOptimalContextType(analysis) {
+  if (analysis.usesHeaders) {
+    return "fast";
+  }
+  if (!analysis.usesQuery && !analysis.usesBody && !analysis.usesParams) {
+    return "minimal";
+  }
+  if (!analysis.usesQuery && !analysis.usesBody && analysis.usesParams) {
+    return "minimal";
+  }
+  if (analysis.usesBody) {
+    return "full";
+  }
+  return "fast";
+}
+
+// ../core/src/engine/FastContext.ts
+class FastRequestImpl {
+  _request;
+  _params;
+  _url = new URL("http://localhost");
+  _query = null;
+  _headers = null;
+  reset(request, params = {}) {
+    this._request = request;
+    this._params = params;
+    this._url.href = request.url;
+    this._query = null;
+    this._headers = null;
+  }
+  get url() {
+    return this._request.url;
+  }
+  get method() {
+    return this._request.method;
+  }
+  get path() {
+    return this._url.pathname;
+  }
+  param(name) {
+    return this._params[name];
+  }
+  params() {
+    return { ...this._params };
+  }
+  query(name) {
+    if (!this._query) {
+      this._query = this._url.searchParams;
+    }
+    return this._query.get(name) ?? undefined;
+  }
+  queries() {
+    if (!this._query) {
+      this._query = this._url.searchParams;
+    }
+    const result = {};
+    for (const [key, value] of this._query.entries()) {
+      const existing = result[key];
+      if (existing === undefined) {
+        result[key] = value;
+      } else if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        result[key] = [existing, value];
+      }
+    }
+    return result;
+  }
+  header(name) {
+    return this._request.headers.get(name) ?? undefined;
+  }
+  headers() {
+    if (!this._headers) {
+      this._headers = {};
+      for (const [key, value] of this._request.headers.entries()) {
+        this._headers[key] = value;
+      }
+    }
+    return { ...this._headers };
+  }
+  async json() {
+    return this._request.json();
+  }
+  async text() {
+    return this._request.text();
+  }
+  async formData() {
+    return this._request.formData();
+  }
+  get raw() {
+    return this._request;
+  }
+}
+
+class FastContext {
+  _req = new FastRequestImpl;
+  _statusCode = 200;
+  _headers = new Headers;
+  reset(request, params = {}) {
+    this._req.reset(request, params);
+    this._statusCode = 200;
+    this._headers = new Headers;
+    return this;
+  }
+  get req() {
+    return this._req;
+  }
+  json(data2, status = 200) {
+    this._headers.set("Content-Type", "application/json; charset=utf-8");
+    return new Response(JSON.stringify(data2), {
+      status,
+      headers: this._headers
+    });
+  }
+  text(text, status = 200) {
+    this._headers.set("Content-Type", "text/plain; charset=utf-8");
+    return new Response(text, {
+      status,
+      headers: this._headers
+    });
+  }
+  html(html, status = 200) {
+    this._headers.set("Content-Type", "text/html; charset=utf-8");
+    return new Response(html, {
+      status,
+      headers: this._headers
+    });
+  }
+  redirect(url, status = 302) {
+    this._headers.set("Location", url);
+    return new Response(null, {
+      status,
+      headers: this._headers
+    });
+  }
+  body(data2, status = 200) {
+    return new Response(data2, {
+      status,
+      headers: this._headers
+    });
+  }
+  header(name, value) {
+    this._headers.set(name, value);
+  }
+  status(code) {
+    this._statusCode = code;
+  }
+}
+
+// ../core/src/engine/MinimalContext.ts
+class MinimalRequest {
+  _request;
+  _params;
+  _path;
+  constructor(_request, _params, _path) {
+    this._request = _request;
+    this._params = _params;
+    this._path = _path;
+  }
+  get url() {
+    return this._request.url;
+  }
+  get method() {
+    return this._request.method;
+  }
+  get path() {
+    return this._path;
+  }
+  param(name) {
+    return this._params[name];
+  }
+  params() {
+    return { ...this._params };
+  }
+  query(name) {
+    const url = new URL(this._request.url);
+    return url.searchParams.get(name) ?? undefined;
+  }
+  queries() {
+    const url = new URL(this._request.url);
+    const result = {};
+    for (const [key, value] of url.searchParams.entries()) {
+      const existing = result[key];
+      if (existing === undefined) {
+        result[key] = value;
+      } else if (Array.isArray(existing)) {
+        existing.push(value);
+      } else {
+        result[key] = [existing, value];
+      }
+    }
+    return result;
+  }
+  header(name) {
+    return this._request.headers.get(name) ?? undefined;
+  }
+  headers() {
+    const result = {};
+    for (const [key, value] of this._request.headers.entries()) {
+      result[key] = value;
+    }
+    return result;
+  }
+  async json() {
+    return this._request.json();
+  }
+  async text() {
+    return this._request.text();
+  }
+  async formData() {
+    return this._request.formData();
+  }
+  get raw() {
+    return this._request;
+  }
+}
+
+class MinimalContext {
+  _req;
+  constructor(request, params, path4) {
+    this._req = new MinimalRequest(request, params, path4);
+  }
+  get req() {
+    return this._req;
+  }
+  json(data2, status = 200) {
+    return new Response(JSON.stringify(data2), {
+      status,
+      headers: { "Content-Type": "application/json; charset=utf-8" }
+    });
+  }
+  text(text, status = 200) {
+    return new Response(text, {
+      status,
+      headers: { "Content-Type": "text/plain; charset=utf-8" }
+    });
+  }
+  html(html, status = 200) {
+    return new Response(html, {
+      status,
+      headers: { "Content-Type": "text/html; charset=utf-8" }
+    });
+  }
+  redirect(url, status = 302) {
+    return new Response(null, {
+      status,
+      headers: { Location: url }
+    });
+  }
+  body(data2, status = 200) {
+    return new Response(data2, { status });
+  }
+  header(_name, _value) {
+    console.warn("MinimalContext.header() is a no-op. Use FastContext for custom headers.");
+  }
+  status(_code) {}
+  reset(_request, _params) {
+    throw new Error("MinimalContext does not support reset. Create a new instance instead.");
+  }
+}
+
+// ../core/src/engine/path.ts
+function extractPath(url) {
+  const protocolEnd = url.indexOf("://");
+  const searchStart = protocolEnd === -1 ? 0 : protocolEnd + 3;
+  const pathStart = url.indexOf("/", searchStart);
+  if (pathStart === -1) {
+    return "/";
+  }
+  const queryStart = url.indexOf("?", pathStart);
+  if (queryStart === -1) {
+    return url.slice(pathStart);
+  }
+  return url.slice(pathStart, queryStart);
+}
+
+// ../core/src/engine/pool.ts
+class ObjectPool {
+  pool = [];
+  factory;
+  reset;
+  maxSize;
+  constructor(factory, reset, maxSize = 256) {
+    this.factory = factory;
+    this.reset = reset;
+    this.maxSize = maxSize;
+  }
+  acquire() {
+    const obj = this.pool.pop();
+    if (obj !== undefined) {
+      return obj;
+    }
+    return this.factory();
+  }
+  release(obj) {
+    if (this.pool.length < this.maxSize) {
+      this.reset(obj);
+      this.pool.push(obj);
+    }
+  }
+  clear() {
+    this.pool = [];
+  }
+  get size() {
+    return this.pool.length;
+  }
+  get capacity() {
+    return this.maxSize;
+  }
+  prewarm(count) {
+    const targetSize = Math.min(count, this.maxSize);
+    while (this.pool.length < targetSize) {
+      const obj = this.factory();
+      this.reset(obj);
+      this.pool.push(obj);
+    }
+  }
+}
+
+// ../core/src/engine/Gravito.ts
+class Gravito {
+  router = new AOTRouter;
+  contextPool;
+  errorHandler;
+  notFoundHandler;
+  staticRoutes;
+  isPureStaticApp = true;
+  constructor(options = {}) {
+    const poolSize = options.poolSize ?? 256;
+    this.contextPool = new ObjectPool(() => new FastContext, (ctx) => ctx.reset(new Request("http://localhost")), poolSize);
+    this.contextPool.prewarm(Math.min(32, poolSize));
+    if (options.onError) {
+      this.errorHandler = options.onError;
+    }
+    if (options.onNotFound) {
+      this.notFoundHandler = options.onNotFound;
+    }
+    this.compileRoutes();
+  }
+  get(path4, ...handlers) {
+    return this.addRoute("get", path4, handlers);
+  }
+  post(path4, ...handlers) {
+    return this.addRoute("post", path4, handlers);
+  }
+  put(path4, ...handlers) {
+    return this.addRoute("put", path4, handlers);
+  }
+  delete(path4, ...handlers) {
+    return this.addRoute("delete", path4, handlers);
+  }
+  patch(path4, ...handlers) {
+    return this.addRoute("patch", path4, handlers);
+  }
+  options(path4, ...handlers) {
+    return this.addRoute("options", path4, handlers);
+  }
+  head(path4, ...handlers) {
+    return this.addRoute("head", path4, handlers);
+  }
+  all(path4, ...handlers) {
+    const methods = ["get", "post", "put", "delete", "patch", "options", "head"];
+    for (const method of methods) {
+      this.addRoute(method, path4, handlers);
+    }
+    return this;
+  }
+  use(pathOrMiddleware, ...middleware) {
+    this.isPureStaticApp = false;
+    if (typeof pathOrMiddleware === "string") {
+      this.router.usePattern(pathOrMiddleware, ...middleware);
+    } else {
+      this.router.use(pathOrMiddleware, ...middleware);
+    }
+    return this;
+  }
+  route(path4, app2) {
+    console.warn("route() method is not yet fully implemented");
+    return this;
+  }
+  onError(handler) {
+    this.errorHandler = handler;
+    return this;
+  }
+  notFound(handler) {
+    this.notFoundHandler = handler;
+    return this;
+  }
+  fetch = (request) => {
+    const path4 = extractPath(request.url);
+    const method = request.method.toLowerCase();
+    const staticKey = `${method}:${path4}`;
+    const staticRoute = this.staticRoutes.get(staticKey);
+    if (staticRoute) {
+      if (staticRoute.useMinimal) {
+        const ctx = new MinimalContext(request, {}, path4);
+        try {
+          const result = staticRoute.handler(ctx);
+          if (result instanceof Response) {
+            return result;
+          }
+          return result;
+        } catch (error) {
+          return this.handleErrorSync(error, request, path4);
+        }
+      }
+      return this.handleWithMiddleware(request, path4, staticRoute);
+    }
+    return this.handleDynamicRoute(request, method, path4);
+  };
+  async handleWithMiddleware(request, path4, route) {
+    const ctx = this.contextPool.acquire();
+    try {
+      ctx.reset(request, {});
+      const middleware = this.collectMiddlewareForPath(path4, route.middleware);
+      if (middleware.length === 0) {
+        return await route.handler(ctx);
+      }
+      return await this.executeMiddleware(ctx, middleware, route.handler);
+    } catch (error) {
+      return await this.handleError(error, ctx);
+    } finally {
+      this.contextPool.release(ctx);
+    }
+  }
+  handleDynamicRoute(request, method, path4) {
+    const match2 = this.router.match(method.toUpperCase(), path4);
+    if (!match2.handler) {
+      return this.handleNotFoundSync(request, path4);
+    }
+    const ctx = this.contextPool.acquire();
+    const execute = async () => {
+      try {
+        ctx.reset(request, match2.params);
+        if (match2.middleware.length === 0) {
+          return await match2.handler(ctx);
+        }
+        return await this.executeMiddleware(ctx, match2.middleware, match2.handler);
+      } catch (error) {
+        return await this.handleError(error, ctx);
+      } finally {
+        this.contextPool.release(ctx);
+      }
+    };
+    return execute();
+  }
+  handleErrorSync(error, request, path4) {
+    if (this.errorHandler) {
+      const ctx = new MinimalContext(request, {}, path4);
+      const result = this.errorHandler(error, ctx);
+      if (result instanceof Response) {
+        return result;
+      }
+      return result;
+    }
+    console.error("Unhandled error:", error);
+    return new Response(JSON.stringify({
+      error: "Internal Server Error",
+      message: error.message
+    }), {
+      status: 500,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
+  handleNotFoundSync(request, path4) {
+    if (this.notFoundHandler) {
+      const ctx = new MinimalContext(request, {}, path4);
+      const result = this.notFoundHandler(ctx);
+      if (result instanceof Response) {
+        return result;
+      }
+      return result;
+    }
+    return new Response(JSON.stringify({ error: "Not Found" }), {
+      status: 404,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
+  collectMiddlewareForPath(path4, routeMiddleware) {
+    if (this.router.globalMiddleware.length === 0 && this.router.pathMiddleware.size === 0) {
+      return routeMiddleware;
+    }
+    return this.router.collectMiddlewarePublic(path4, routeMiddleware);
+  }
+  compileRoutes() {
+    this.staticRoutes = this.router.staticRoutes;
+    const hasGlobalMiddleware = this.router.globalMiddleware.length > 0;
+    const hasPathMiddleware = this.router.pathMiddleware.size > 0;
+    this.isPureStaticApp = !hasGlobalMiddleware && !hasPathMiddleware;
+    for (const [_key, route] of this.staticRoutes) {
+      const analysis = analyzeHandler(route.handler);
+      const optimalType = getOptimalContextType(analysis);
+      route.useMinimal = this.isPureStaticApp && route.middleware.length === 0 && optimalType === "minimal";
+    }
+  }
+  addRoute(method, path4, handlers) {
+    if (handlers.length === 0) {
+      throw new Error(`No handler provided for ${method.toUpperCase()} ${path4}`);
+    }
+    const handler = handlers[handlers.length - 1];
+    const middleware = handlers.slice(0, -1);
+    this.router.add(method, path4, handler, middleware);
+    this.compileRoutes();
+    return this;
+  }
+  async executeMiddleware(ctx, middleware, handler) {
+    let index = 0;
+    const next = async () => {
+      if (index < middleware.length) {
+        const mw = middleware[index++];
+        await mw(ctx, next);
+      }
+    };
+    await next();
+    return await handler(ctx);
+  }
+  async handleNotFound(ctx) {
+    if (this.notFoundHandler) {
+      return await this.notFoundHandler(ctx);
+    }
+    return ctx.json({ error: "Not Found" }, 404);
+  }
+  async handleError(error, ctx) {
+    if (this.errorHandler) {
+      return await this.errorHandler(error, ctx);
+    }
+    console.error("Unhandled error:", error);
+    return ctx.json({
+      error: "Internal Server Error",
+      message: error.message
+    }, 500);
+  }
+}
 // ../core/src/index.ts
 var VERSION = package_default.version;
 
@@ -88259,6 +89672,11 @@ async function initCommand(options = {}) {
           value: "ddd",
           label: "\uD83C\uDFDB\uFE0F Domain-Driven Design (DDD)",
           hint: "\u5B8C\u6574\u7684 DDD \u67B6\u69CB\uFF0C\u5305\u542B Modules\u3001Bounded Contexts"
+        },
+        {
+          value: "action-domain",
+          label: "\u26A1 Action-Domain-Responder (ADR)",
+          hint: "Web \u7279\u5316\u7684\u8A2D\u8A08\u6A21\u5F0F\uFF0C\u95DC\u6CE8 Actions \u8207 Domain \u908F\u8F2F\u7684\u5206\u96E2"
         }
       ]
     });
@@ -88367,7 +89785,8 @@ async function initCommand(options = {}) {
       "enterprise-mvc": "\uD83D\uDCE6 Enterprise MVC",
       clean: "\uD83E\uDDC5 Clean Architecture",
       ddd: "\uD83C\uDFDB\uFE0F Domain-Driven Design",
-      satellite: "\uD83D\uDEF0\uFE0F Satellite Service"
+      satellite: "\uD83D\uDEF0\uFE0F Satellite Service",
+      "action-domain": "\u26A1 Action-Domain-Responder"
     };
     note2(`\u5C08\u6848\u540D\u7A31: ${pc3.cyan(projectName)}
 \u67B6\u69CB\u6A21\u5F0F: ${pc3.green(archLabels[architecture])}
@@ -89922,7 +91341,7 @@ cli.command("schedule:list", "List scheduled tasks").option("--entry <file>", "E
 });
 cli.command("create [name]", "Create a new Gravito project").option("--template <template>", "Template to use (basic, inertia-react)").option("--profile <profile>", "Profile preset (core, scale, enterprise)", { default: "core" }).option("--with <features>", "Feature add-ons (comma-separated, e.g. redis,queue)", {
   default: ""
-}).option("--recommend", "Auto-detect profile based on environment").action(async (name, options) => {
+}).option("--recommend", "Auto-detect profile based on environment").option("--framework <framework>", "Frontend framework (react, vue) for static-site template").action(async (name, options) => {
   console.clear();
   intro2(pc11.bgBlack(pc11.white(" \uD83C\uDF0C Gravito CLI ")));
   if (options.recommend) {
@@ -90016,26 +91435,30 @@ Confidence: ${detection.confidence}`, "Environment Detection");
   }
   let framework = null;
   if (project.template === "static-site") {
-    const frameworkResult = await select2({
-      message: "Choose your frontend framework:",
-      options: [
-        {
-          value: "react",
-          label: "\u269B\uFE0F React",
-          hint: "Recommended for most projects"
-        },
-        {
-          value: "vue",
-          label: "\uD83D\uDFE2 Vue 3",
-          hint: "Composition API with TypeScript"
-        }
-      ]
-    });
-    if (isCancel2(frameworkResult)) {
-      cancel2("Operation cancelled.");
-      process.exit(0);
+    if (options.framework) {
+      framework = options.framework;
+    } else {
+      const frameworkResult = await select2({
+        message: "Choose your frontend framework:",
+        options: [
+          {
+            value: "react",
+            label: "\u269B\uFE0F React",
+            hint: "Recommended for most projects"
+          },
+          {
+            value: "vue",
+            label: "\uD83D\uDFE2 Vue 3",
+            hint: "Composition API with TypeScript"
+          }
+        ]
+      });
+      if (isCancel2(frameworkResult)) {
+        cancel2("Operation cancelled.");
+        process.exit(0);
+      }
+      framework = frameworkResult;
     }
-    framework = frameworkResult;
   }
   const s = spinner5();
   s.start("Scaffolding your universe...");