@gravito/scaffold 3.0.1 → 3.1.1

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(index_exports, {
   BaseGenerator: () => BaseGenerator,
   CleanArchitectureGenerator: () => CleanArchitectureGenerator,
   DddGenerator: () => DddGenerator,
+  DependencyValidator: () => DependencyValidator,
   EnterpriseMvcGenerator: () => EnterpriseMvcGenerator,
   EnvironmentDetector: () => EnvironmentDetector,
   FileMerger: () => FileMerger,
@@ -44,6 +45,147 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/DependencyValidator.ts
+var DependencyValidator = class _DependencyValidator {
+  /**
+   * Driver 到 Package 的映射規則
+   */
+  static DRIVER_DEPENDENCIES = [
+    {
+      driver: "redis",
+      requiredPackages: ["@gravito/ion"],
+      description: "Redis cache/queue driver requires @gravito/ion"
+    },
+    {
+      driver: "postgresql",
+      requiredPackages: ["@gravito/atlas", "pg"],
+      description: "PostgreSQL driver requires @gravito/atlas and pg"
+    },
+    {
+      driver: "mysql",
+      requiredPackages: ["@gravito/atlas", "mysql2"],
+      description: "MySQL driver requires @gravito/atlas and mysql2"
+    },
+    {
+      driver: "sqlite",
+      requiredPackages: ["@gravito/atlas", "better-sqlite3"],
+      description: "SQLite driver requires @gravito/atlas and better-sqlite3"
+    },
+    {
+      driver: "s3",
+      requiredPackages: ["@gravito/stasis", "@aws-sdk/client-s3"],
+      description: "S3 storage driver requires @gravito/stasis and AWS SDK"
+    },
+    {
+      driver: "r2",
+      requiredPackages: ["@gravito/stasis", "@aws-sdk/client-s3"],
+      description: "R2 storage driver requires @gravito/stasis and AWS SDK"
+    }
+  ];
+  /**
+   * Feature 衝突規則
+   */
+  static CONFLICTS = [
+    {
+      features: ["postgres", "mysql", "sqlite"],
+      reason: "\u4E0D\u80FD\u540C\u6642\u4F7F\u7528\u591A\u500B\u8CC7\u6599\u5EAB driver (PostgreSQL, MySQL, SQLite)"
+    }
+  ];
+  /**
+   * Feature 依賴映射
+   */
+  static FEATURE_DEPENDENCIES = {
+    stream: ["@gravito/beam"],
+    monitor: ["@gravito/spectrum"],
+    graphql: ["@gravito/constellation"]
+  };
+  /**
+   * 驗證 Profile 配置
+   *
+   * @param config - Profile 配置
+   * @param packageJson - 專案的 package.json 內容
+   * @returns 驗證結果
+   */
+  validate(config, packageJson) {
+    const errors = [];
+    const warnings = [];
+    this.validateDriverDependencies(config, packageJson, errors);
+    this.validateFeatureConflicts(config, errors);
+    this.validateFeatureDependencies(config, packageJson, warnings);
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings
+    };
+  }
+  /**
+   * 驗證 driver 依賴
+   */
+  validateDriverDependencies(config, packageJson, errors) {
+    for (const [service, driver] of Object.entries(config.drivers)) {
+      const rule = _DependencyValidator.DRIVER_DEPENDENCIES.find((r) => r.driver === driver);
+      if (rule) {
+        for (const pkg of rule.requiredPackages) {
+          if (!this.hasPackage(packageJson, pkg)) {
+            errors.push(`\u7F3A\u5C11\u4F9D\u8CF4: ${pkg} (${service} driver '${driver}' \u6240\u9700)`);
+          }
+        }
+      }
+    }
+  }
+  /**
+   * 驗證 feature 衝突
+   */
+  validateFeatureConflicts(config, errors) {
+    for (const conflict of _DependencyValidator.CONFLICTS) {
+      const conflictingFeatures = conflict.features.filter((f) => config.features.includes(f));
+      if (conflictingFeatures.length > 1) {
+        errors.push(`Feature \u885D\u7A81: ${conflictingFeatures.join(", ")} - ${conflict.reason}`);
+      }
+    }
+  }
+  /**
+   * 驗證 feature 依賴
+   */
+  validateFeatureDependencies(config, packageJson, warnings) {
+    for (const feature of config.features) {
+      const requiredPackages = _DependencyValidator.FEATURE_DEPENDENCIES[feature];
+      if (requiredPackages) {
+        for (const pkg of requiredPackages) {
+          if (!this.hasPackage(packageJson, pkg)) {
+            warnings.push(`Feature "${feature}" \u9700\u8981 ${pkg}`);
+          }
+        }
+      }
+    }
+  }
+  /**
+   * 檢查 package.json 是否包含指定 package
+   */
+  hasPackage(packageJson, packageName) {
+    return packageJson.dependencies?.[packageName] !== void 0 || packageJson.devDependencies?.[packageName] !== void 0;
+  }
+  /**
+   * 建議安裝缺失的依賴
+   *
+   * @param result - 驗證結果
+   * @returns 安裝命令建議
+   */
+  static suggestInstallCommand(result) {
+    if (result.errors.length === 0) {
+      return null;
+    }
+    const missingPackages = result.errors.map((err) => {
+      const match = err.match(/缺少依賴: ([@\w/-]+)/);
+      return match ? match[1] : null;
+    }).filter((pkg) => pkg !== null);
+    if (missingPackages.length === 0) {
+      return null;
+    }
+    return `bun add ${missingPackages.join(" ")}`;
+  }
+};
+
 // src/EnvironmentDetector.ts
 var EnvironmentDetector = class {
   detect() {
@@ -471,6 +613,18 @@ dist
       "ARCHITECTURE.md",
       this.generateArchitectureDoc(context)
     );
+    await this.writeFile(
+      context.targetDir,
+      "tests/Example.test.ts",
+      `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+    );
     await this.generateCheckScripts(context);
     await this.generateSkills(context);
   }
@@ -1702,7 +1856,9 @@ export async function bootstrap() {
   // 1. Configure
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
+    ],
   })
 
   // 2. Boot Core
@@ -1899,7 +2055,9 @@ export async function createApp(): Promise<PlanetCore> {
   // 1. Configure
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
+    ],
   })
 
   // 2. Boot Core
@@ -2988,7 +3146,21 @@ var EnterpriseMvcGenerator = class extends BaseGenerator {
           {
             type: "directory",
             name: "Unit",
-            children: [{ type: "file", name: ".gitkeep", content: "" }]
+            children: [
+              { type: "file", name: ".gitkeep", content: "" },
+              {
+                type: "file",
+                name: "Example.test.ts",
+                content: `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+              }
+            ]
           },
           {
             type: "directory",
@@ -3520,7 +3692,7 @@ export async function bootstrap() {
   const config = defineConfig({
     config: appConfig,
     orbits: [
-      new OrbitAtlas(),
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
 ${spectrumOrbit}
     ],
   })
@@ -4307,7 +4479,21 @@ var ActionDomainGenerator = class extends BaseGenerator {
       {
         type: "directory",
         name: "tests",
-        children: [{ type: "file", name: ".gitkeep", content: "" }]
+        children: [
+          { type: "file", name: ".gitkeep", content: "" },
+          {
+            type: "file",
+            name: "Example.test.ts",
+            content: `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+          }
+        ]
       }
     ];
   }
@@ -4374,6 +4560,11 @@ export class User extends Model {
   // ─────────────────────────────────────────────────────────────
   // Action Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the base Action class source code.
+   *
+   * @returns The complete source code for the abstract Action class.
+   */
   generateActionBase() {
     return `/**
  * Action Base Class
@@ -4390,6 +4581,11 @@ export abstract class Action<TInput = unknown, TOutput = unknown> {
 }
 `;
   }
+  /**
+   * Generates the GetServerStatusAction source code.
+   *
+   * @returns The complete source code for the example action.
+   */
   generateGetServerStatusAction() {
     return `/**
  * Get Server Status Action
@@ -4412,6 +4608,11 @@ export class GetServerStatusAction extends Action<void, ServerStatusResponse> {
   // ─────────────────────────────────────────────────────────────
   // Controller Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the Server Controller source code.
+   *
+   * @returns The complete source code for the ServerController class.
+   */
   generateServerController() {
     return `/**
  * Server Controller
@@ -4439,6 +4640,11 @@ export class ServerController {
   // ─────────────────────────────────────────────────────────────
   // Type Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the ServerStatusResponse type definition.
+   *
+   * @returns The complete source code for the response interface.
+   */
   generateServerStatusResponse() {
     return `/**
  * Server Status Response Type
@@ -4454,6 +4660,11 @@ export interface ServerStatusResponse {
   // ─────────────────────────────────────────────────────────────
   // Routes & Bootstrap
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the API routes registration function.
+   *
+   * @returns The complete source code for the api.ts routes file.
+   */
   generateApiRoutes() {
     return `/**
  * API Routes Registration
@@ -4472,6 +4683,12 @@ export function registerApiRoutes(router: Router) {
 }
 `;
   }
+  /**
+   * Generates the App Service Provider source code.
+   *
+   * @param context - The generator context containing project details.
+   * @returns The complete source code for AppServiceProvider.
+   */
   generateAppServiceProvider(context) {
     return `/**
  * App Service Provider
@@ -4500,6 +4717,11 @@ export { MiddlewareProvider } from './MiddlewareProvider'
 export { RouteProvider } from './RouteProvider'
 `;
   }
+  /**
+   * Generates the Middleware Service Provider source code.
+   *
+   * @returns The complete source code for MiddlewareProvider.
+   */
   generateMiddlewareProvider() {
     return `/**
  * Middleware Service Provider
@@ -4524,6 +4746,11 @@ export class MiddlewareProvider extends ServiceProvider {
 }
 `;
   }
+  /**
+   * Generates the Route Service Provider source code.
+   *
+   * @returns The complete source code for RouteProvider.
+   */
   generateRouteProvider() {
     return `/**
  * Route Service Provider
@@ -4561,7 +4788,7 @@ import {
 export async function bootstrap() {
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit],
   })
 
   const core = await PlanetCore.boot(config)
@@ -4912,6 +5139,7 @@ var Scaffold = class {
   BaseGenerator,
   CleanArchitectureGenerator,
   DddGenerator,
+  DependencyValidator,
   EnterpriseMvcGenerator,
   EnvironmentDetector,
   FileMerger,

package/dist/index.d.cts

@@ -49,6 +49,94 @@ declare class ProfileResolver {
     isValidFeature(feature: string): boolean;
 }
 
+/**
+ * package.json 結構
+ */
+interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * 驗證結果
+ */
+interface ValidationResult {
+    /** 是否通過驗證 */
+    valid: boolean;
+    /** 錯誤訊息列表 (阻塞性問題) */
+    errors: string[];
+    /** 警告訊息列表 (非阻塞性問題) */
+    warnings: string[];
+}
+/**
+ * 依賴驗證器
+ *
+ * 負責驗證 Profile 配置的依賴完整性，包括：
+ * - Driver 必需的 packages
+ * - Feature 之間的衝突
+ * - Feature 的依賴關係
+ *
+ * @example
+ * ```typescript
+ * const validator = new DependencyValidator()
+ * const result = validator.validate(profileConfig, packageJson)
+ *
+ * if (!result.valid) {
+ *   console.error('依賴驗證失敗:', result.errors)
+ * }
+ * ```
+ *
+ * @since 3.1.0
+ * @public
+ */
+declare class DependencyValidator {
+    /**
+     * Driver 到 Package 的映射規則
+     */
+    private static readonly DRIVER_DEPENDENCIES;
+    /**
+     * Feature 衝突規則
+     */
+    private static readonly CONFLICTS;
+    /**
+     * Feature 依賴映射
+     */
+    private static readonly FEATURE_DEPENDENCIES;
+    /**
+     * 驗證 Profile 配置
+     *
+     * @param config - Profile 配置
+     * @param packageJson - 專案的 package.json 內容
+     * @returns 驗證結果
+     */
+    validate(config: ProfileConfig, packageJson: PackageJson): ValidationResult;
+    /**
+     * 驗證 driver 依賴
+     */
+    private validateDriverDependencies;
+    /**
+     * 驗證 feature 衝突
+     */
+    private validateFeatureConflicts;
+    /**
+     * 驗證 feature 依賴
+     */
+    private validateFeatureDependencies;
+    /**
+     * 檢查 package.json 是否包含指定 package
+     */
+    private hasPackage;
+    /**
+     * 建議安裝缺失的依賴
+     *
+     * @param result - 驗證結果
+     * @returns 安裝命令建議
+     */
+    static suggestInstallCommand(result: ValidationResult): string | null;
+}
+
 /**
  * Represents the results of an environment detection scan.
  *
@@ -595,4 +683,4 @@ declare class Scaffold {
     generateProvider(_targetDir: string, _providerName: string): Promise<ScaffoldResult>;
 }
 
-export { type ArchitectureType, BaseGenerator, CleanArchitectureGenerator, DddGenerator, type DetectedEnvironment, EnterpriseMvcGenerator, EnvironmentDetector, FileMerger, type GeneratorConfig, type GeneratorContext, type LockFile, LockGenerator, type ProfileConfig, ProfileResolver, type ProfileType, SatelliteGenerator, Scaffold, type ScaffoldOptions, type StubConfig, StubGenerator, type StubVariables };
+export { type ArchitectureType, BaseGenerator, CleanArchitectureGenerator, DddGenerator, DependencyValidator, type DetectedEnvironment, EnterpriseMvcGenerator, EnvironmentDetector, FileMerger, type GeneratorConfig, type GeneratorContext, type LockFile, LockGenerator, type PackageJson, type ProfileConfig, ProfileResolver, type ProfileType, SatelliteGenerator, Scaffold, type ScaffoldOptions, type StubConfig, StubGenerator, type StubVariables, type ValidationResult };

package/dist/index.d.ts

@@ -49,6 +49,94 @@ declare class ProfileResolver {
     isValidFeature(feature: string): boolean;
 }
 
+/**
+ * package.json 結構
+ */
+interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * 驗證結果
+ */
+interface ValidationResult {
+    /** 是否通過驗證 */
+    valid: boolean;
+    /** 錯誤訊息列表 (阻塞性問題) */
+    errors: string[];
+    /** 警告訊息列表 (非阻塞性問題) */
+    warnings: string[];
+}
+/**
+ * 依賴驗證器
+ *
+ * 負責驗證 Profile 配置的依賴完整性，包括：
+ * - Driver 必需的 packages
+ * - Feature 之間的衝突
+ * - Feature 的依賴關係
+ *
+ * @example
+ * ```typescript
+ * const validator = new DependencyValidator()
+ * const result = validator.validate(profileConfig, packageJson)
+ *
+ * if (!result.valid) {
+ *   console.error('依賴驗證失敗:', result.errors)
+ * }
+ * ```
+ *
+ * @since 3.1.0
+ * @public
+ */
+declare class DependencyValidator {
+    /**
+     * Driver 到 Package 的映射規則
+     */
+    private static readonly DRIVER_DEPENDENCIES;
+    /**
+     * Feature 衝突規則
+     */
+    private static readonly CONFLICTS;
+    /**
+     * Feature 依賴映射
+     */
+    private static readonly FEATURE_DEPENDENCIES;
+    /**
+     * 驗證 Profile 配置
+     *
+     * @param config - Profile 配置
+     * @param packageJson - 專案的 package.json 內容
+     * @returns 驗證結果
+     */
+    validate(config: ProfileConfig, packageJson: PackageJson): ValidationResult;
+    /**
+     * 驗證 driver 依賴
+     */
+    private validateDriverDependencies;
+    /**
+     * 驗證 feature 衝突
+     */
+    private validateFeatureConflicts;
+    /**
+     * 驗證 feature 依賴
+     */
+    private validateFeatureDependencies;
+    /**
+     * 檢查 package.json 是否包含指定 package
+     */
+    private hasPackage;
+    /**
+     * 建議安裝缺失的依賴
+     *
+     * @param result - 驗證結果
+     * @returns 安裝命令建議
+     */
+    static suggestInstallCommand(result: ValidationResult): string | null;
+}
+
 /**
  * Represents the results of an environment detection scan.
  *
@@ -595,4 +683,4 @@ declare class Scaffold {
     generateProvider(_targetDir: string, _providerName: string): Promise<ScaffoldResult>;
 }
 
-export { type ArchitectureType, BaseGenerator, CleanArchitectureGenerator, DddGenerator, type DetectedEnvironment, EnterpriseMvcGenerator, EnvironmentDetector, FileMerger, type GeneratorConfig, type GeneratorContext, type LockFile, LockGenerator, type ProfileConfig, ProfileResolver, type ProfileType, SatelliteGenerator, Scaffold, type ScaffoldOptions, type StubConfig, StubGenerator, type StubVariables };
+export { type ArchitectureType, BaseGenerator, CleanArchitectureGenerator, DddGenerator, DependencyValidator, type DetectedEnvironment, EnterpriseMvcGenerator, EnvironmentDetector, FileMerger, type GeneratorConfig, type GeneratorContext, type LockFile, LockGenerator, type PackageJson, type ProfileConfig, ProfileResolver, type ProfileType, SatelliteGenerator, Scaffold, type ScaffoldOptions, type StubConfig, StubGenerator, type StubVariables, type ValidationResult };

package/dist/index.js

@@ -1,3 +1,144 @@
+// src/DependencyValidator.ts
+var DependencyValidator = class _DependencyValidator {
+  /**
+   * Driver 到 Package 的映射規則
+   */
+  static DRIVER_DEPENDENCIES = [
+    {
+      driver: "redis",
+      requiredPackages: ["@gravito/ion"],
+      description: "Redis cache/queue driver requires @gravito/ion"
+    },
+    {
+      driver: "postgresql",
+      requiredPackages: ["@gravito/atlas", "pg"],
+      description: "PostgreSQL driver requires @gravito/atlas and pg"
+    },
+    {
+      driver: "mysql",
+      requiredPackages: ["@gravito/atlas", "mysql2"],
+      description: "MySQL driver requires @gravito/atlas and mysql2"
+    },
+    {
+      driver: "sqlite",
+      requiredPackages: ["@gravito/atlas", "better-sqlite3"],
+      description: "SQLite driver requires @gravito/atlas and better-sqlite3"
+    },
+    {
+      driver: "s3",
+      requiredPackages: ["@gravito/stasis", "@aws-sdk/client-s3"],
+      description: "S3 storage driver requires @gravito/stasis and AWS SDK"
+    },
+    {
+      driver: "r2",
+      requiredPackages: ["@gravito/stasis", "@aws-sdk/client-s3"],
+      description: "R2 storage driver requires @gravito/stasis and AWS SDK"
+    }
+  ];
+  /**
+   * Feature 衝突規則
+   */
+  static CONFLICTS = [
+    {
+      features: ["postgres", "mysql", "sqlite"],
+      reason: "\u4E0D\u80FD\u540C\u6642\u4F7F\u7528\u591A\u500B\u8CC7\u6599\u5EAB driver (PostgreSQL, MySQL, SQLite)"
+    }
+  ];
+  /**
+   * Feature 依賴映射
+   */
+  static FEATURE_DEPENDENCIES = {
+    stream: ["@gravito/beam"],
+    monitor: ["@gravito/spectrum"],
+    graphql: ["@gravito/constellation"]
+  };
+  /**
+   * 驗證 Profile 配置
+   *
+   * @param config - Profile 配置
+   * @param packageJson - 專案的 package.json 內容
+   * @returns 驗證結果
+   */
+  validate(config, packageJson) {
+    const errors = [];
+    const warnings = [];
+    this.validateDriverDependencies(config, packageJson, errors);
+    this.validateFeatureConflicts(config, errors);
+    this.validateFeatureDependencies(config, packageJson, warnings);
+    return {
+      valid: errors.length === 0,
+      errors,
+      warnings
+    };
+  }
+  /**
+   * 驗證 driver 依賴
+   */
+  validateDriverDependencies(config, packageJson, errors) {
+    for (const [service, driver] of Object.entries(config.drivers)) {
+      const rule = _DependencyValidator.DRIVER_DEPENDENCIES.find((r) => r.driver === driver);
+      if (rule) {
+        for (const pkg of rule.requiredPackages) {
+          if (!this.hasPackage(packageJson, pkg)) {
+            errors.push(`\u7F3A\u5C11\u4F9D\u8CF4: ${pkg} (${service} driver '${driver}' \u6240\u9700)`);
+          }
+        }
+      }
+    }
+  }
+  /**
+   * 驗證 feature 衝突
+   */
+  validateFeatureConflicts(config, errors) {
+    for (const conflict of _DependencyValidator.CONFLICTS) {
+      const conflictingFeatures = conflict.features.filter((f) => config.features.includes(f));
+      if (conflictingFeatures.length > 1) {
+        errors.push(`Feature \u885D\u7A81: ${conflictingFeatures.join(", ")} - ${conflict.reason}`);
+      }
+    }
+  }
+  /**
+   * 驗證 feature 依賴
+   */
+  validateFeatureDependencies(config, packageJson, warnings) {
+    for (const feature of config.features) {
+      const requiredPackages = _DependencyValidator.FEATURE_DEPENDENCIES[feature];
+      if (requiredPackages) {
+        for (const pkg of requiredPackages) {
+          if (!this.hasPackage(packageJson, pkg)) {
+            warnings.push(`Feature "${feature}" \u9700\u8981 ${pkg}`);
+          }
+        }
+      }
+    }
+  }
+  /**
+   * 檢查 package.json 是否包含指定 package
+   */
+  hasPackage(packageJson, packageName) {
+    return packageJson.dependencies?.[packageName] !== void 0 || packageJson.devDependencies?.[packageName] !== void 0;
+  }
+  /**
+   * 建議安裝缺失的依賴
+   *
+   * @param result - 驗證結果
+   * @returns 安裝命令建議
+   */
+  static suggestInstallCommand(result) {
+    if (result.errors.length === 0) {
+      return null;
+    }
+    const missingPackages = result.errors.map((err) => {
+      const match = err.match(/缺少依賴: ([@\w/-]+)/);
+      return match ? match[1] : null;
+    }).filter((pkg) => pkg !== null);
+    if (missingPackages.length === 0) {
+      return null;
+    }
+    return `bun add ${missingPackages.join(" ")}`;
+  }
+};
+
 // src/EnvironmentDetector.ts
 var EnvironmentDetector = class {
   detect() {
@@ -425,6 +566,18 @@ dist
       "ARCHITECTURE.md",
       this.generateArchitectureDoc(context)
     );
+    await this.writeFile(
+      context.targetDir,
+      "tests/Example.test.ts",
+      `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+    );
     await this.generateCheckScripts(context);
     await this.generateSkills(context);
   }
@@ -1656,7 +1809,9 @@ export async function bootstrap() {
   // 1. Configure
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
+    ],
   })
 
   // 2. Boot Core
@@ -1853,7 +2008,9 @@ export async function createApp(): Promise<PlanetCore> {
   // 1. Configure
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
+    ],
   })
 
   // 2. Boot Core
@@ -2942,7 +3099,21 @@ var EnterpriseMvcGenerator = class extends BaseGenerator {
           {
             type: "directory",
             name: "Unit",
-            children: [{ type: "file", name: ".gitkeep", content: "" }]
+            children: [
+              { type: "file", name: ".gitkeep", content: "" },
+              {
+                type: "file",
+                name: "Example.test.ts",
+                content: `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+              }
+            ]
           },
           {
             type: "directory",
@@ -3474,7 +3645,7 @@ export async function bootstrap() {
   const config = defineConfig({
     config: appConfig,
     orbits: [
-      new OrbitAtlas(),
+      new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit,
 ${spectrumOrbit}
     ],
   })
@@ -4261,7 +4432,21 @@ var ActionDomainGenerator = class extends BaseGenerator {
       {
         type: "directory",
         name: "tests",
-        children: [{ type: "file", name: ".gitkeep", content: "" }]
+        children: [
+          { type: "file", name: ".gitkeep", content: "" },
+          {
+            type: "file",
+            name: "Example.test.ts",
+            content: `import { describe, it, expect } from 'bun:test'
+
+describe('Example Test', () => {
+  it('should pass', () => {
+    expect(true).toBe(true)
+  })
+})
+`
+          }
+        ]
       }
     ];
   }
@@ -4328,6 +4513,11 @@ export class User extends Model {
   // ─────────────────────────────────────────────────────────────
   // Action Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the base Action class source code.
+   *
+   * @returns The complete source code for the abstract Action class.
+   */
   generateActionBase() {
     return `/**
  * Action Base Class
@@ -4344,6 +4534,11 @@ export abstract class Action<TInput = unknown, TOutput = unknown> {
 }
 `;
   }
+  /**
+   * Generates the GetServerStatusAction source code.
+   *
+   * @returns The complete source code for the example action.
+   */
   generateGetServerStatusAction() {
     return `/**
  * Get Server Status Action
@@ -4366,6 +4561,11 @@ export class GetServerStatusAction extends Action<void, ServerStatusResponse> {
   // ─────────────────────────────────────────────────────────────
   // Controller Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the Server Controller source code.
+   *
+   * @returns The complete source code for the ServerController class.
+   */
   generateServerController() {
     return `/**
  * Server Controller
@@ -4393,6 +4593,11 @@ export class ServerController {
   // ─────────────────────────────────────────────────────────────
   // Type Generators
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the ServerStatusResponse type definition.
+   *
+   * @returns The complete source code for the response interface.
+   */
   generateServerStatusResponse() {
     return `/**
  * Server Status Response Type
@@ -4408,6 +4613,11 @@ export interface ServerStatusResponse {
   // ─────────────────────────────────────────────────────────────
   // Routes & Bootstrap
   // ─────────────────────────────────────────────────────────────
+  /**
+   * Generates the API routes registration function.
+   *
+   * @returns The complete source code for the api.ts routes file.
+   */
   generateApiRoutes() {
     return `/**
  * API Routes Registration
@@ -4426,6 +4636,12 @@ export function registerApiRoutes(router: Router) {
 }
 `;
   }
+  /**
+   * Generates the App Service Provider source code.
+   *
+   * @param context - The generator context containing project details.
+   * @returns The complete source code for AppServiceProvider.
+   */
   generateAppServiceProvider(context) {
     return `/**
  * App Service Provider
@@ -4454,6 +4670,11 @@ export { MiddlewareProvider } from './MiddlewareProvider'
 export { RouteProvider } from './RouteProvider'
 `;
   }
+  /**
+   * Generates the Middleware Service Provider source code.
+   *
+   * @returns The complete source code for MiddlewareProvider.
+   */
   generateMiddlewareProvider() {
     return `/**
  * Middleware Service Provider
@@ -4478,6 +4699,11 @@ export class MiddlewareProvider extends ServiceProvider {
 }
 `;
   }
+  /**
+   * Generates the Route Service Provider source code.
+   *
+   * @returns The complete source code for RouteProvider.
+   */
   generateRouteProvider() {
     return `/**
  * Route Service Provider
@@ -4515,7 +4741,7 @@ import {
 export async function bootstrap() {
   const config = defineConfig({
     config: appConfig,
-    orbits: [new OrbitAtlas()],
+    orbits: [new OrbitAtlas() as unknown as import('@gravito/core').GravitoOrbit],
   })
 
   const core = await PlanetCore.boot(config)
@@ -4865,6 +5091,7 @@ export {
   BaseGenerator,
   CleanArchitectureGenerator,
   DddGenerator,
+  DependencyValidator,
   EnterpriseMvcGenerator,
   EnvironmentDetector,
   FileMerger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/scaffold",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "description": "Project scaffolding engine for Gravito - Generate enterprise-grade architecture templates",
   "type": "module",
   "main": "dist/index.js",
@@ -16,10 +16,12 @@
   "scripts": {
     "build": "bun run build.ts",
     "dev": "bun run --watch src/index.ts",
-    "test": "bun test",
+    "test": "bun test --timeout=10000",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
-    "test:coverage": "bun test --coverage --coverage-threshold=50",
-    "test:ci": "bun test --coverage --coverage-threshold=50"
+    "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "test:ci": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "test:unit": "bun test tests/ --timeout=10000",
+    "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "files": [
     "dist",
@@ -38,7 +40,7 @@
     "bun-types": "latest"
   },
   "peerDependencies": {
-    "@gravito/core": "workspace:*"
+    "@gravito/core": "^1.6.1"
   },
   "author": "Carl Lee <carllee0520@gmail.com>",
   "license": "MIT",
@@ -48,4 +50,4 @@
     "url": "git+https://github.com/gravito-framework/gravito.git",
     "directory": "packages/scaffold"
   }
-}
+}

package/templates/common/tsconfig.json.hbs

@@ -11,12 +11,11 @@
     "emitDecoratorMetadata": true,
     "types": ["bun-types"],
     "outDir": "./dist",
-    "rootDir": "./src",
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"]
     }
   },
-  "include": ["src/**/*"],
+  "include": ["src/**/*", "config/**/*"],
   "exclude": ["node_modules", "dist"]
 }

package/templates/features/otel/package.json

@@ -1,7 +1,7 @@
 {
-    "dependencies": {
-        "@opentelemetry/sdk-node": "^0.45.0",
-        "@opentelemetry/exporter-trace-otlp-http": "^0.45.0",
-        "@gravito/telemetry": "workspace:*"
-    }
-}
+  "dependencies": {
+    "@opentelemetry/sdk-node": "^0.45.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.45.0",
+    "@gravito/telemetry": "workspace:*"
+  }
+}

package/templates/features/redis/package.json

@@ -1,5 +1,5 @@
 {
-    "dependencies": {
-        "ioredis": "^5.3.0"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.3.0"
+  }
+}

package/templates/overlays/core/package.json

@@ -1,5 +1,5 @@
 {
-    "dependencies": {
-        "better-sqlite3": "^9.0.0"
-    }
-}
+  "dependencies": {
+    "better-sqlite3": "^9.0.0"
+  }
+}

package/templates/overlays/enterprise/package.json

@@ -1,7 +1,7 @@
 {
-    "dependencies": {
-        "ioredis": "^5.0.0",
-        "pg": "^8.0.0",
-        "@gravito/spectrum": "workspace:*"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.0.0",
+    "pg": "^8.0.0",
+    "@gravito/spectrum": "workspace:*"
+  }
+}

package/templates/overlays/scale/package.json

@@ -1,6 +1,6 @@
 {
-    "dependencies": {
-        "ioredis": "^5.0.0",
-        "pg": "^8.0.0"
-    }
-}
+  "dependencies": {
+    "ioredis": "^5.0.0",
+    "pg": "^8.0.0"
+  }
+}