@gravito/pulse 1.0.0 → 1.0.1

package/dist/index.js

@@ -81110,6 +81110,7 @@ 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);
   }
   async applyOverlays(context) {
     const profile = context.profile;
@@ -81181,6 +81182,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 +81423,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 +81998,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 +82012,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 +82505,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 +82645,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 +82705,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 +82785,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 +83093,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 +83140,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())
+
+  // Module Providers
+  core.register(new OrderingServiceProvider())
+  core.register(new CatalogServiceProvider())
 
-    // Add more providers as needed
+  // Add more providers as needed
 }
 `;
   }
@@ -82792,6 +83292,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 +83727,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 +83873,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 +83885,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()
               }
             ]
           },
@@ -83828,6 +84357,132 @@ export class RouteServiceProvider extends ServiceProvider {
     registerRoutes(core.router)
   }
 }
+`;
+  }
+  generateProvidersIndex() {
+    return `/**
+ * Application Service Providers
+ *
+ * Export all providers for easy importing in bootstrap.
+ * Providers are registered in the order they are listed.
+ */
+
+export { AppServiceProvider } from './AppServiceProvider'
+export { DatabaseProvider } from './DatabaseProvider'
+export { MiddlewareProvider } from './MiddlewareProvider'
+export { RouteProvider } from './RouteProvider'
+`;
+  }
+  generateDatabaseProvider() {
+    return `/**
+ * Database Service Provider
+ *
+ * Handles database initialization and migrations.
+ *
+ * Lifecycle:
+ * - register(): Bind database config to container
+ * - boot(): Run migrations and seeders
+ */
+
+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)
+  }
+
+  /**
+   * 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() {
@@ -83877,74 +84532,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 +85006,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 +85296,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 +85474,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 +85484,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'
+
+export class RouteProvider extends ServiceProvider {
+  register(_container: Container): void {}
 
-// Routes
-registerApiRoutes(core.router)
+  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()],
+  })
 
-// Liftoff
+  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 +85629,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:*",
@@ -85096,7 +85830,6 @@ var package_default = {
 // ../core/src/adapters/PhotonAdapter.ts
 class PhotonRequestWrapper {
   photonCtx;
-  _cachedJson = null;
   constructor(photonCtx) {
     this.photonCtx = photonCtx;
   }
@@ -88259,6 +88992,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 +89105,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 +90661,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 +90755,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...");