@gravito/scaffold 1.0.0-beta.1 → 1.0.0

package/dist/index.js

@@ -1,3 +1,102 @@
+// src/EnvironmentDetector.ts
+var EnvironmentDetector = class {
+  detect() {
+    if (process.env.KUBERNETES_SERVICE_HOST) {
+      return {
+        platform: "k8s",
+        suggestedProfile: "enterprise",
+        confidence: "high",
+        reason: "Kubernetes environment detected (KUBERNETES_SERVICE_HOST)"
+      };
+    }
+    if (process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.AWS_EXECUTION_ENV) {
+      return {
+        platform: "aws",
+        suggestedProfile: "scale",
+        confidence: "high",
+        reason: "AWS Lambda environment detected"
+      };
+    }
+    if (process.env.VERCEL) {
+      return {
+        platform: "vercel",
+        suggestedProfile: "core",
+        confidence: "high",
+        reason: "Vercel environment detected"
+      };
+    }
+    if (process.env.RAILWAY_ENVIRONMENT || process.env.RENDER) {
+      return {
+        platform: "unknown",
+        // Generic cloud
+        suggestedProfile: "scale",
+        confidence: "medium",
+        reason: "Cloud container environment detected"
+      };
+    }
+    return {
+      platform: "unknown",
+      suggestedProfile: "core",
+      confidence: "low",
+      reason: "No specific cloud environment detected, defaulting to Core"
+    };
+  }
+};
+
+// src/utils/deepMerge.ts
+function deepMerge(target, source) {
+  if (typeof target !== "object" || target === null) {
+    return source;
+  }
+  if (typeof source !== "object" || source === null) {
+    return source;
+  }
+  if (Array.isArray(target) && Array.isArray(source)) {
+    return Array.from(/* @__PURE__ */ new Set([...target, ...source]));
+  }
+  const output = { ...target };
+  for (const key of Object.keys(source)) {
+    if (source[key] instanceof Object && key in target) {
+      output[key] = deepMerge(target[key], source[key]);
+    } else {
+      output[key] = source[key];
+    }
+  }
+  return output;
+}
+
+// src/FileMerger.ts
+var FileMerger = class {
+  /**
+   * Merge content of two files based on their type.
+   */
+  merge(fileName, baseContent, overlayContent) {
+    if (fileName.endsWith(".json")) {
+      return this.mergeJson(baseContent, overlayContent);
+    }
+    if (fileName.endsWith(".env") || fileName.endsWith(".env.example")) {
+      return this.mergeEnv(baseContent, overlayContent);
+    }
+    return overlayContent;
+  }
+  mergeJson(base, overlay) {
+    try {
+      const baseJson = JSON.parse(base);
+      const overlayJson = JSON.parse(overlay);
+      const merged = deepMerge(baseJson, overlayJson);
+      return JSON.stringify(merged, null, 2);
+    } catch (e) {
+      console.warn("Failed to merge JSON, returning overlay", e);
+      return overlay;
+    }
+  }
+  mergeEnv(base, overlay) {
+    return `${base}
+# --- Overlay ---
+${overlay}`;
+  }
+};
+
 // src/generators/BaseGenerator.ts
 import fs2 from "fs/promises";
 import path2 from "path";
@@ -155,9 +254,24 @@ var StubGenerator = class {
 };
 
 // src/generators/BaseGenerator.ts
+async function walk(dir) {
+  const files = await fs2.readdir(dir);
+  const paths = [];
+  for (const file of files) {
+    const filePath = path2.join(dir, file);
+    const stat = await fs2.stat(filePath);
+    if (stat.isDirectory()) {
+      paths.push(...await walk(filePath));
+    } else {
+      paths.push(filePath);
+    }
+  }
+  return paths;
+}
 var BaseGenerator = class {
   config;
   stubGenerator;
+  fileMerger;
   filesCreated = [];
   constructor(config) {
     this.config = config;
@@ -166,6 +280,7 @@ var BaseGenerator = class {
       outputDir: ""
       // Set per-generation
     });
+    this.fileMerger = new FileMerger();
   }
   /**
    * Generate the project scaffold.
@@ -178,6 +293,8 @@ var BaseGenerator = class {
     const structure = this.getDirectoryStructure(context);
     await this.createStructure(context.targetDir, structure, context);
     await this.generateCommonFiles(context);
+    await this.applyOverlays(context);
+    await this.applyFeatureOverlays(context);
     return this.filesCreated;
   }
   /**
@@ -222,19 +339,69 @@ var BaseGenerator = class {
     await this.writeFile(context.targetDir, ".env", this.generateEnvExample(context));
     await this.writeFile(context.targetDir, ".gitignore", this.generateGitignore());
     await this.writeFile(context.targetDir, "tsconfig.json", this.generateTsConfig());
+    await this.writeFile(context.targetDir, "Dockerfile", this.generateDockerfile(context));
+    await this.writeFile(context.targetDir, ".dockerignore", this.generateDockerIgnore());
     await this.writeFile(
       context.targetDir,
       "ARCHITECTURE.md",
       this.generateArchitectureDoc(context)
     );
   }
+  /**
+   * Apply profile-specific overlays
+   */
+  async applyOverlays(context) {
+    const profile = context.profile;
+    if (!profile) return;
+    const overlayDir = path2.resolve(this.config.templatesDir, "overlays", profile);
+    await this.copyOverlayDirectory(overlayDir, context);
+  }
+  /**
+   * Apply feature-specific overlays
+   */
+  async applyFeatureOverlays(context) {
+    const features = context.features || [];
+    for (const feature of features) {
+      const overlayDir = path2.resolve(this.config.templatesDir, "features", feature);
+      await this.copyOverlayDirectory(overlayDir, context);
+    }
+  }
+  /**
+   * Helper to copy/merge an overlay directory into the target
+   */
+  async copyOverlayDirectory(sourceDir, context) {
+    try {
+      await fs2.access(sourceDir);
+    } catch {
+      return;
+    }
+    const files = await walk(sourceDir);
+    for (const filePath of files) {
+      const relativePath = path2.relative(sourceDir, filePath);
+      let content = await fs2.readFile(filePath, "utf-8");
+      try {
+        content = this.stubGenerator.render(content, context);
+      } catch {
+      }
+      await this.writeFile(context.targetDir, relativePath, content);
+    }
+  }
   /**
    * Write a file and track it.
    */
   async writeFile(basePath, relativePath, content) {
     const fullPath = path2.resolve(basePath, relativePath);
     await fs2.mkdir(path2.dirname(fullPath), { recursive: true });
-    await fs2.writeFile(fullPath, content, "utf-8");
+    let finalContent = content;
+    try {
+      const existingContent = await fs2.readFile(fullPath, "utf-8");
+      finalContent = this.fileMerger.merge(relativePath, existingContent, content);
+      if (finalContent !== content) {
+        this.log(`\u{1F504} Merged file: ${relativePath}`);
+      }
+    } catch {
+    }
+    await fs2.writeFile(fullPath, finalContent, "utf-8");
     this.filesCreated.push(fullPath);
     this.log(`\u{1F4C4} Created file: ${relativePath}`);
   }
@@ -242,6 +409,20 @@ var BaseGenerator = class {
    * Generate package.json content.
    */
   generatePackageJson(context) {
+    const profile = context.profile || "core";
+    const baseDependencies = {
+      "@gravito/core": "^1.0.0-beta.5",
+      "@gravito/atlas": "^1.0.0-beta.5",
+      "@gravito/plasma": "^1.0.0-beta.5",
+      "@gravito/stream": "^1.0.0-beta.5"
+    };
+    if (profile === "enterprise" || profile === "scale") {
+      baseDependencies["@gravito/quasar"] = "^1.0.0-beta.5";
+      baseDependencies["@gravito/horizon"] = "^1.0.0-beta.5";
+    }
+    if (context.withSpectrum) {
+      baseDependencies["@gravito/spectrum"] = "^1.0.0-beta.1";
+    }
     const pkg = {
       name: context.nameKebabCase,
       version: "0.1.0",
@@ -251,42 +432,193 @@ var BaseGenerator = class {
         build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
         start: "bun run dist/bootstrap.js",
         test: "bun test",
-        typecheck: "tsc --noEmit"
-      },
-      dependencies: {
-        "gravito-core": "^1.0.0-beta.5"
+        typecheck: "tsc --noEmit",
+        "docker:build": `docker build -t ${context.nameKebabCase} .`,
+        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
       },
+      dependencies: baseDependencies,
       devDependencies: {
-        "@types/bun": "latest",
+        "bun-types": "latest",
         typescript: "^5.0.0"
       }
     };
     return JSON.stringify(pkg, null, 2);
   }
+  /**
+   * Generate Dockerfile content.
+   */
+  generateDockerfile(context) {
+    const entrypoint = context.architecture === "ddd" ? "dist/main.js" : "dist/bootstrap.js";
+    return `FROM oven/bun:1.0 AS base
+WORKDIR /usr/src/app
+
+# Install dependencies
+FROM base AS install
+RUN mkdir -p /temp/dev
+COPY package.json bun.lockb /temp/dev/
+RUN cd /temp/dev && bun install --frozen-lockfile
+
+# Build application
+FROM base AS build
+COPY --from=install /temp/dev/node_modules node_modules
+COPY . .
+ENV NODE_ENV=production
+RUN bun run build
+
+# Final production image
+FROM base AS release
+COPY --from=build /usr/src/app/${entrypoint} index.js
+COPY --from=build /usr/src/app/package.json .
+
+# Create a non-root user for security
+USER bun
+EXPOSE 3000/tcp
+ENTRYPOINT [ "bun", "run", "index.js" ]
+`;
+  }
+  /**
+   * Generate .dockerignore content.
+   */
+  generateDockerIgnore() {
+    return `node_modules
+dist
+.git
+.env
+*.log
+.vscode
+.idea
+tests
+`;
+  }
   /**
    * Generate .env.example content.
    */
   generateEnvExample(context) {
-    return `# Application
-APP_NAME="${context.name}"
+    const profile = context.profile || "core";
+    let envContent = `# ============================================================================
+# Application Configuration
+# ============================================================================
+
+APP_NAME=${context.name}
 APP_ENV=development
-APP_KEY=
 APP_DEBUG=true
 APP_URL=http://localhost:3000
+APP_KEY=
 
-# Server
-PORT=3000
+# ============================================================================
+# Database Configuration
+# ============================================================================
 
-# Database
-DB_CONNECTION=sqlite
+# Database Connection (sqlite, postgres, mysql)
+DB_CONNECTION=${profile === "core" ? "sqlite" : "postgres"}
+
+# SQLite Configuration (when DB_CONNECTION=sqlite)
 DB_DATABASE=database/database.sqlite
 
-# Cache
-CACHE_DRIVER=memory
+# PostgreSQL Configuration (when DB_CONNECTION=postgres)
+${profile !== "core" ? `DB_HOST=127.0.0.1
+DB_PORT=5432
+DB_DATABASE=${context.name}
+DB_USERNAME=postgres
+DB_PASSWORD=
+DB_SSLMODE=prefer` : `# DB_HOST=127.0.0.1
+# DB_PORT=5432
+# DB_DATABASE=${context.name}
+# DB_USERNAME=postgres
+# DB_PASSWORD=
+# DB_SSLMODE=prefer`}
+
+# MySQL Configuration (when DB_CONNECTION=mysql)
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=${context.name}
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+# ============================================================================
+# Redis Configuration (@gravito/plasma)
+# ============================================================================
+
+# Default Redis Connection
+REDIS_CONNECTION=default
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_DB=0
+
+# Redis Connection Options
+REDIS_CONNECT_TIMEOUT=10000
+REDIS_COMMAND_TIMEOUT=5000
+REDIS_KEY_PREFIX=
+REDIS_MAX_RETRIES=3
+REDIS_RETRY_DELAY=1000
+
+# Cache-specific Redis Connection (optional, falls back to default)
+# REDIS_CACHE_HOST=127.0.0.1
+# REDIS_CACHE_PORT=6379
+# REDIS_CACHE_PASSWORD=
+REDIS_CACHE_DB=1
+
+# Queue-specific Redis Connection (optional, falls back to default)
+# REDIS_QUEUE_HOST=127.0.0.1
+# REDIS_QUEUE_PORT=6379
+# REDIS_QUEUE_PASSWORD=
+REDIS_QUEUE_DB=2
+
+# ============================================================================
+# Cache Configuration (@gravito/stasis)
+# ============================================================================
+
+# Cache Driver (memory, file, redis)
+CACHE_DRIVER=${profile === "core" ? "memory" : "redis"}
+
+# File Cache Path (when CACHE_DRIVER=file)
+CACHE_PATH=storage/framework/cache
+
+# Redis Cache Configuration (when CACHE_DRIVER=redis)
+REDIS_CACHE_CONNECTION=cache
+REDIS_CACHE_PREFIX=cache:
+
+# ============================================================================
+# Queue Configuration (@gravito/stream)
+# ============================================================================
+
+# Queue Connection (sync, memory, database, redis, kafka, sqs, rabbitmq)
+QUEUE_CONNECTION=${profile === "core" ? "sync" : "redis"}
+
+# Database Queue Configuration (when QUEUE_CONNECTION=database)
+QUEUE_TABLE=jobs
+
+# Redis Queue Configuration (when QUEUE_CONNECTION=redis)
+REDIS_PREFIX=queue:
+
+`;
+    if (profile === "enterprise" || profile === "scale") {
+      envContent += `# Kafka Queue Configuration (when QUEUE_CONNECTION=kafka)
+# KAFKA_BROKERS=localhost:9092
+# KAFKA_CONSUMER_GROUP_ID=gravito-workers
+# KAFKA_CLIENT_ID=${context.name}
+
+# AWS SQS Queue Configuration (when QUEUE_CONNECTION=sqs)
+# AWS_REGION=us-east-1
+# SQS_QUEUE_URL_PREFIX=
+# SQS_VISIBILITY_TIMEOUT=30
+# SQS_WAIT_TIME_SECONDS=20
+
+# RabbitMQ Queue Configuration (when QUEUE_CONNECTION=rabbitmq)
+# RABBITMQ_URL=amqp://localhost
+# RABBITMQ_EXCHANGE=gravito.events
+# RABBITMQ_EXCHANGE_TYPE=fanout
+
+`;
+    }
+    envContent += `# ============================================================================
+# Logging Configuration
+# ============================================================================
 
-# Logging
 LOG_LEVEL=debug
 `;
+    return envContent;
   }
   /**
    * Generate .gitignore content.
@@ -338,6 +670,9 @@ coverage/
         strict: true,
         skipLibCheck: true,
         declaration: true,
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        types: ["bun-types"],
         outDir: "./dist",
         rootDir: "./src",
         baseUrl: ".",
@@ -407,6 +742,11 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
           { type: "file", name: "logging.ts", content: this.generateLoggingConfig() }
         ]
       },
+      {
+        type: "directory",
+        name: "database",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      },
       {
         type: "directory",
         name: "src",
@@ -419,16 +759,12 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
               {
                 type: "directory",
                 name: "Entities",
-                children: [
-                  { type: "file", name: "Entity.ts", content: this.generateBaseEntity() },
-                  { type: "file", name: "User.ts", content: this.generateUserEntity() }
-                ]
+                children: [{ type: "file", name: "User.ts", content: this.generateUserEntity() }]
               },
               {
                 type: "directory",
                 name: "ValueObjects",
                 children: [
-                  { type: "file", name: "ValueObject.ts", content: this.generateBaseValueObject() },
                   { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
                 ]
               },
@@ -446,13 +782,7 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
               {
                 type: "directory",
                 name: "Exceptions",
-                children: [
-                  {
-                    type: "file",
-                    name: "DomainException.ts",
-                    content: this.generateDomainException()
-                  }
-                ]
+                children: [{ type: "file", name: ".gitkeep", content: "" }]
               }
             ]
           },
@@ -673,42 +1003,6 @@ var CleanArchitectureGenerator = class extends BaseGenerator {
     console: { driver: 'console', level: process.env.LOG_LEVEL ?? 'debug' },
   },
 }
-`;
-  }
-  // ─────────────────────────────────────────────────────────────
-  // Domain Layer
-  // ─────────────────────────────────────────────────────────────
-  generateBaseEntity() {
-    return `/**
- * Base Entity
- *
- * All domain entities extend this base class.
- * Entities have identity and lifecycle.
- *
- * IMPORTANT: This layer must have NO external dependencies.
- */
-
-export abstract class Entity<T> {
-  protected readonly _id: T
-
-  constructor(id: T) {
-    this._id = id
-  }
-
-  get id(): T {
-    return this._id
-  }
-
-  equals(other: Entity<T>): boolean {
-    if (other === null || other === undefined) {
-      return false
-    }
-    if (!(other instanceof Entity)) {
-      return false
-    }
-    return this._id === other._id
-  }
-}
 `;
   }
   generateUserEntity() {
@@ -719,7 +1013,7 @@ export abstract class Entity<T> {
  * Contains business logic related to users.
  */
 
-import { Entity } from './Entity'
+import { Entity } from '@gravito/enterprise'
 import { Email } from '../ValueObjects/Email'
 
 export interface UserProps {
@@ -769,30 +1063,6 @@ export class User extends Entity<string> {
     this.props.updatedAt = new Date()
   }
 }
-`;
-  }
-  generateBaseValueObject() {
-    return `/**
- * Base Value Object
- *
- * Value objects are immutable and compared by value.
- * They have no identity of their own.
- */
-
-export abstract class ValueObject<T> {
-  protected readonly props: T
-
-  constructor(props: T) {
-    this.props = Object.freeze(props)
-  }
-
-  equals(other: ValueObject<T>): boolean {
-    if (other === null || other === undefined) {
-      return false
-    }
-    return JSON.stringify(this.props) === JSON.stringify(other.props)
-  }
-}
 `;
   }
   generateEmailValueObject() {
@@ -802,7 +1072,7 @@ export abstract class ValueObject<T> {
  * Encapsulates email validation and comparison.
  */
 
-import { ValueObject } from './ValueObject'
+import { ValueObject } from '@gravito/enterprise'
 
 interface EmailProps {
   value: string
@@ -843,43 +1113,11 @@ export class Email extends ValueObject<EmailProps> {
  * Implementations are in Infrastructure layer.
  */
 
+import type { Repository } from '@gravito/enterprise'
 import type { User } from '../Entities/User'
 
-export interface IUserRepository {
-  findById(id: string): Promise<User | null>
+export interface IUserRepository extends Repository<User, string> {
   findByEmail(email: string): Promise<User | null>
-  save(user: User): Promise<void>
-  delete(id: string): Promise<void>
-  findAll(): Promise<User[]>
-}
-`;
-  }
-  generateDomainException() {
-    return `/**
- * Domain Exception
- *
- * Base exception for domain-level errors.
- */
-
-export class DomainException extends Error {
-  constructor(message: string) {
-    super(message)
-    this.name = 'DomainException'
-  }
-}
-
-export class EntityNotFoundException extends DomainException {
-  constructor(entity: string, id: string) {
-    super(\`\${entity} with id \${id} not found\`)
-    this.name = 'EntityNotFoundException'
-  }
-}
-
-export class InvalidValueException extends DomainException {
-  constructor(message: string) {
-    super(message)
-    this.name = 'InvalidValueException'
-  }
 }
 `;
   }
@@ -893,6 +1131,7 @@ export class InvalidValueException extends DomainException {
  * Application service for creating new users.
  */
 
+import { UseCase } from '@gravito/enterprise'
 import { User } from '../../../Domain/Entities/User'
 import type { IUserRepository } from '../../../Domain/Interfaces/IUserRepository'
 import type { UserDTO } from '../../DTOs/UserDTO'
@@ -906,8 +1145,10 @@ export interface CreateUserOutput {
   user: UserDTO
 }
 
-export class CreateUserUseCase {
-  constructor(private userRepository: IUserRepository) {}
+export class CreateUserUseCase extends UseCase<CreateUserInput, CreateUserOutput> {
+  constructor(private userRepository: IUserRepository) {
+    super()
+  }
 
   async execute(input: CreateUserInput): Promise<CreateUserOutput> {
     // Check if email already exists
@@ -944,8 +1185,8 @@ export class CreateUserUseCase {
  * Get User Use Case
  */
 
+import { UseCase } from '@gravito/enterprise'
 import type { IUserRepository } from '../../../Domain/Interfaces/IUserRepository'
-import { EntityNotFoundException } from '../../../Domain/Exceptions/DomainException'
 import type { UserDTO } from '../../DTOs/UserDTO'
 
 export interface GetUserInput {
@@ -956,14 +1197,16 @@ export interface GetUserOutput {
   user: UserDTO
 }
 
-export class GetUserUseCase {
-  constructor(private userRepository: IUserRepository) {}
+export class GetUserUseCase extends UseCase<GetUserInput, GetUserOutput> {
+  constructor(private userRepository: IUserRepository) {
+    super()
+  }
 
   async execute(input: GetUserInput): Promise<GetUserOutput> {
     const user = await this.userRepository.findById(input.id)
 
     if (!user) {
-      throw new EntityNotFoundException('User', input.id)
+      throw new Error(\`User with id \${input.id} not found\`)
     }
 
     return {
@@ -1064,6 +1307,10 @@ export class UserRepository implements IUserRepository {
   async findAll(): Promise<User[]> {
     return Array.from(users.values())
   }
+
+  async exists(id: string): Promise<boolean> {
+    return users.has(id)
+  }
 }
 `;
   }
@@ -1087,7 +1334,7 @@ export class MailService implements IMailService {
  * App Service Provider
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
 export class AppServiceProvider extends ServiceProvider {
   register(_container: Container): void {
@@ -1107,7 +1354,7 @@ export class AppServiceProvider extends ServiceProvider {
  * Binds repository interfaces to implementations.
  */
 
-import { ServiceProvider, type Container } from 'gravito-core'
+import { ServiceProvider, type Container } from '@gravito/core'
 import { UserRepository } from '../Persistence/Repositories/UserRepository'
 import { MailService } from '../ExternalServices/MailService'
 
@@ -1130,7 +1377,7 @@ export class RepositoryServiceProvider extends ServiceProvider {
  * User Controller
  */
 
-import type { GravitoContext } from 'gravito-core'
+import type { GravitoContext } from '@gravito/core'
 import { CreateUserUseCase } from '../../../Application/UseCases/User/CreateUser'
 import { GetUserUseCase } from '../../../Application/UseCases/User/GetUser'
 import { UserRepository } from '../../../Infrastructure/Persistence/Repositories/UserRepository'
@@ -1209,15 +1456,51 @@ export class UserPresenter {
  * Application Bootstrap
  */
 
-import { PlanetCore } from 'gravito-core'
+import { bodySizeLimit, PlanetCore, securityHeaders } 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}' },
+  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,
+  })
+)
+if (!Number.isNaN(bodyLimit) && bodyLimit > 0) {
+  core.adapter.use('*', bodySizeLimit(bodyLimit, { requireContentLength: requireLength }))
+}
+
+await core.orbit(new OrbitAtlas())
+
 core.register(new RepositoryServiceProvider())
 core.register(new AppServiceProvider())
 
@@ -1297,6 +1580,32 @@ src/
 Created with \u2764\uFE0F using Gravito Framework
 `;
   }
+  generatePackageJson(context) {
+    const pkg = {
+      name: context.nameKebabCase,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "bun run --watch src/bootstrap.ts",
+        build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
+        start: "bun run dist/bootstrap.js",
+        test: "bun test",
+        typecheck: "tsc --noEmit",
+        "docker:build": `docker build -t ${context.nameKebabCase} .`,
+        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
+      },
+      dependencies: {
+        "@gravito/core": "workspace:*",
+        "@gravito/enterprise": "workspace:*",
+        ...context.withSpectrum ? { "@gravito/spectrum": "workspace:*" } : {}
+      },
+      devDependencies: {
+        "bun-types": "latest",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
 };
 
 // src/generators/DddGenerator.ts
@@ -1424,22 +1733,6 @@ var DddGenerator = class extends BaseGenerator {
                 { type: "file", name: "Money.ts", content: this.generateMoneyValueObject() },
                 { type: "file", name: "Email.ts", content: this.generateEmailValueObject() }
               ]
-            },
-            {
-              type: "directory",
-              name: "Events",
-              children: [
-                { type: "file", name: "DomainEvent.ts", content: this.generateDomainEvent() }
-              ]
-            },
-            {
-              type: "directory",
-              name: "Primitives",
-              children: [
-                { type: "file", name: "AggregateRoot.ts", content: this.generateAggregateRoot() },
-                { type: "file", name: "Entity.ts", content: this.generateEntity() },
-                { type: "file", name: "ValueObject.ts", content: this.generateValueObject() }
-              ]
             }
           ]
         },
@@ -1628,7 +1921,7 @@ var DddGenerator = class extends BaseGenerator {
  * Central configuration and initialization of the application.
  */
 
-import { PlanetCore } from 'gravito-core'
+import { bodySizeLimit, PlanetCore, securityHeaders } from '@gravito/core'
 import { registerProviders } from './providers'
 import { registerRoutes } from './routes'
 
@@ -1639,6 +1932,35 @@ export async function createApp(): Promise<PlanetCore> {
         },
     })
 
+    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 }))
+    }
+
     // Register all service providers
     await registerProviders(core)
 
@@ -1659,7 +1981,7 @@ export async function createApp(): Promise<PlanetCore> {
  * Register all module service providers here.
  */
 
-import type { PlanetCore } from 'gravito-core'
+import type { PlanetCore } from '@gravito/core'
 import { OrderingServiceProvider } from '../Modules/Ordering/Infrastructure/Providers/OrderingServiceProvider'
 import { CatalogServiceProvider } from '../Modules/Catalog/Infrastructure/Providers/CatalogServiceProvider'
 
@@ -1754,7 +2076,7 @@ export default {
  * ${name} Service Provider
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 import { ${name}Repository } from '../Persistence/${name}Repository'
 
 export class ${name}ServiceProvider extends ServiceProvider {
@@ -1781,13 +2103,16 @@ export class ${name}ServiceProvider extends ServiceProvider {
         build: "bun build ./src/main.ts --outdir ./dist --target bun",
         start: "bun run dist/main.js",
         test: "bun test",
-        typecheck: "tsc --noEmit"
+        typecheck: "tsc --noEmit",
+        "docker:build": `docker build -t ${context.nameKebabCase} .`,
+        "docker:run": `docker run -it -p 3000:3000 ${context.nameKebabCase}`
       },
       dependencies: {
-        "gravito-core": "^1.0.0-beta.5"
+        "@gravito/core": "^1.0.0-beta.5",
+        "@gravito/enterprise": "workspace:*"
       },
       devDependencies: {
-        "@types/bun": "latest",
+        "bun-types": "latest",
         typescript: "^5.0.0"
       }
     };
@@ -1838,11 +2163,15 @@ export class ${name}ServiceProvider extends ServiceProvider {
  * Shared identifier across all contexts.
  */
 
-export class Id {
-  private readonly _value: string
+import { ValueObject } from '@gravito/enterprise'
 
+interface IdProps {
+    value: string
+}
+
+export class Id extends ValueObject<IdProps> {
   private constructor(value: string) {
-    this._value = value
+    super({ value })
   }
 
   static create(): Id {
@@ -1855,15 +2184,11 @@ export class Id {
   }
 
   get value(): string {
-    return this._value
-  }
-
-  equals(other: Id): boolean {
-    return this._value === other._value
+    return this.props.value
   }
 
   toString(): string {
-    return this._value
+    return this.props.value
   }
 }
 `;
@@ -1873,12 +2198,25 @@ export class Id {
  * Money Value Object
  */
 
-export class Money {
-  constructor(
-    public readonly amount: number,
-    public readonly currency: string = 'USD'
-  ) {
+import { ValueObject } from '@gravito/enterprise'
+
+interface MoneyProps {
+    amount: number
+    currency: string
+}
+
+export class Money extends ValueObject<MoneyProps> {
+  constructor(amount: number, currency: string = 'USD') {
     if (amount < 0) throw new Error('Amount cannot be negative')
+    super({ amount, currency })
+  }
+
+  get amount(): number {
+    return this.props.amount
+  }
+
+  get currency(): string {
+    return this.props.currency
   }
 
   add(other: Money): Money {
@@ -1896,10 +2234,6 @@ export class Money {
       throw new Error('Cannot operate on different currencies')
     }
   }
-
-  equals(other: Money): boolean {
-    return this.amount === other.amount && this.currency === other.currency
-  }
 }
 `;
   }
@@ -1908,11 +2242,15 @@ export class Money {
  * Email Value Object
  */
 
-export class Email {
-  private readonly _value: string
+import { ValueObject } from '@gravito/enterprise'
+
+interface EmailProps {
+    value: string
+}
 
+export class Email extends ValueObject<EmailProps> {
   private constructor(value: string) {
-    this._value = value.toLowerCase().trim()
+    super({ value: value.toLowerCase().trim() })
   }
 
   static create(email: string): Email {
@@ -1927,97 +2265,7 @@ export class Email {
   }
 
   get value(): string {
-    return this._value
-  }
-}
-`;
-  }
-  generateDomainEvent() {
-    return `/**
- * Domain Event Base
- */
-
-export abstract class DomainEvent {
-  readonly occurredOn: Date
-  readonly eventId: string
-
-  constructor() {
-    this.occurredOn = new Date()
-    this.eventId = crypto.randomUUID()
-  }
-
-  abstract get eventName(): string
-  abstract get aggregateId(): string
-}
-`;
-  }
-  generateAggregateRoot() {
-    return `/**
- * Aggregate Root Base
- */
-
-import type { DomainEvent } from '../Events/DomainEvent'
-import type { Id } from '../ValueObjects/Id'
-
-export abstract class AggregateRoot<T extends Id = Id> {
-  private _domainEvents: DomainEvent[] = []
-
-  protected constructor(protected readonly _id: T) {}
-
-  get id(): T {
-    return this._id
-  }
-
-  get domainEvents(): DomainEvent[] {
-    return [...this._domainEvents]
-  }
-
-  protected addDomainEvent(event: DomainEvent): void {
-    this._domainEvents.push(event)
-  }
-
-  clearDomainEvents(): DomainEvent[] {
-    const events = [...this._domainEvents]
-    this._domainEvents = []
-    return events
-  }
-}
-`;
-  }
-  generateEntity() {
-    return `/**
- * Entity Base
- */
-
-import type { Id } from '../ValueObjects/Id'
-
-export abstract class Entity<T extends Id = Id> {
-  protected constructor(protected readonly _id: T) {}
-
-  get id(): T {
-    return this._id
-  }
-
-  equals(other: Entity<T>): boolean {
-    return this._id.equals(other._id)
-  }
-}
-`;
-  }
-  generateValueObject() {
-    return `/**
- * Value Object Base
- */
-
-export abstract class ValueObject<T> {
-  protected readonly props: T
-
-  constructor(props: T) {
-    this.props = Object.freeze(props)
-  }
-
-  equals(other: ValueObject<T>): boolean {
-    return JSON.stringify(this.props) === JSON.stringify(other.props)
+    return this.props.value
   }
 }
 `;
@@ -2027,7 +2275,7 @@ export abstract class ValueObject<T> {
  * Event Dispatcher
  */
 
-import type { DomainEvent } from '../../Domain/Events/DomainEvent'
+import type { DomainEvent } from '@gravito/enterprise'
 
 type EventHandler = (event: DomainEvent) => void | Promise<void>
 
@@ -2063,7 +2311,7 @@ export class EventDispatcher {
  * ${name} Aggregate Root
  */
 
-import { AggregateRoot } from '../../../../../Shared/Domain/Primitives/AggregateRoot'
+import { AggregateRoot } from '@gravito/enterprise'
 import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 import { ${name}Created } from '../../Events/${name}Created'
 import { ${name}Status } from './${name}Status'
@@ -2074,7 +2322,7 @@ export interface ${name}Props {
   createdAt: Date
 }
 
-export class ${name} extends AggregateRoot {
+export class ${name} extends AggregateRoot<Id> {
   private props: ${name}Props
 
   private constructor(id: Id, props: ${name}Props) {
@@ -2119,14 +2367,14 @@ export enum ${name}Status {
  * ${name} Created Event
  */
 
-import { DomainEvent } from '../../../../Shared/Domain/Events/DomainEvent'
+import { DomainEvent } from '@gravito/enterprise'
 
 export class ${name}Created extends DomainEvent {
   constructor(public readonly ${name.toLowerCase()}Id: string) {
     super()
   }
 
-  get eventName(): string {
+  override get eventName(): string {
     return '${name.toLowerCase()}.created'
   }
 
@@ -2141,12 +2389,12 @@ export class ${name}Created extends DomainEvent {
  * ${name} Repository Interface
  */
 
+import { Repository } from '@gravito/enterprise'
 import type { ${name} } from '../Aggregates/${name}/${name}'
+import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 
-export interface I${name}Repository {
-  findById(id: string): Promise<${name} | null>
-  save(aggregate: ${name}): Promise<void>
-  delete(id: string): Promise<void>
+export interface I${name}Repository extends Repository<${name}, Id> {
+    // Add specific methods for this repository if needed
 }
 `;
   }
@@ -2155,11 +2403,15 @@ export interface I${name}Repository {
  * Create ${name} Command
  */
 
-export class Create${name}Command {
+import { Command } from '@gravito/enterprise'
+
+export class Create${name}Command extends Command {
   constructor(
     // Add command properties
     public readonly id?: string
-  ) {}
+  ) {
+    super()
+  }
 }
 `;
   }
@@ -2168,12 +2420,13 @@ export class Create${name}Command {
  * Create ${name} Handler
  */
 
+import { CommandHandler } from '@gravito/enterprise'
 import type { I${name}Repository } from '../../../Domain/Repositories/I${name}Repository'
 import { ${name} } from '../../../Domain/Aggregates/${name}/${name}'
 import { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 import type { Create${name}Command } from './Create${name}Command'
 
-export class Create${name}Handler {
+export class Create${name}Handler implements CommandHandler<Create${name}Command, string> {
   constructor(private repository: I${name}Repository) {}
 
   async handle(command: Create${name}Command): Promise<string> {
@@ -2192,8 +2445,12 @@ export class Create${name}Handler {
  * Get ${name} By Id Query
  */
 
-export class Get${name}ByIdQuery {
-  constructor(public readonly id: string) {}
+import { Query } from '@gravito/enterprise'
+
+export class Get${name}ByIdQuery extends Query {
+  constructor(public readonly id: string) {
+    super()
+  }
 }
 `;
   }
@@ -2202,15 +2459,16 @@ export class Get${name}ByIdQuery {
  * Get ${name} By Id Handler
  */
 
+import { QueryHandler } from '@gravito/enterprise'
 import type { I${name}Repository } from '../../../Domain/Repositories/I${name}Repository'
 import type { ${name}DTO } from '../../DTOs/${name}DTO'
 import type { Get${name}ByIdQuery } from './Get${name}ByIdQuery'
 
-export class Get${name}ByIdHandler {
+export class Get${name}ByIdHandler implements QueryHandler<Get${name}ByIdQuery, ${name}DTO | null> {
   constructor(private repository: I${name}Repository) {}
 
   async handle(query: Get${name}ByIdQuery): Promise<${name}DTO | null> {
-    const aggregate = await this.repository.findById(query.id)
+    const aggregate = await this.repository.findById(query.id as any) // Simplified for demo
     if (!aggregate) return null
 
     return {
@@ -2242,20 +2500,29 @@ export interface ${name}DTO {
 
 import type { ${name} } from '../../Domain/Aggregates/${name}/${name}'
 import type { I${name}Repository } from '../../Domain/Repositories/I${name}Repository'
+import type { Id } from '../../../../../Shared/Domain/ValueObjects/Id'
 
 const store = new Map<string, ${name}>()
 
 export class ${name}Repository implements I${name}Repository {
-  async findById(id: string): Promise<${name} | null> {
-    return store.get(id) ?? null
+  async findById(id: Id): Promise<${name} | null> {
+    return store.get(id.value) ?? null
   }
 
   async save(aggregate: ${name}): Promise<void> {
     store.set(aggregate.id.value, aggregate)
   }
 
-  async delete(id: string): Promise<void> {
-    store.delete(id)
+  async delete(id: Id): Promise<void> {
+    store.delete(id.value)
+  }
+
+  async findAll(): Promise<${name}[]> {
+    return Array.from(store.values())
+  }
+
+  async exists(id: Id): Promise<boolean> {
+    return store.has(id.value)
   }
 }
 `;
@@ -2698,7 +2965,7 @@ export default {
  * can be assigned to specific routes.
  */
 
-import type { GravitoMiddleware } from 'gravito-core'
+import type { GravitoMiddleware } from '@gravito/core'
 
 /**
  * Global middleware stack.
@@ -2787,7 +3054,7 @@ export abstract class Controller {
  * Home Controller
  */
 
-import type { GravitoContext } from 'gravito-core'
+import type { GravitoContext } from '@gravito/core'
 import { Controller } from './Controller'
 
 export class HomeController extends Controller {
@@ -2821,7 +3088,7 @@ export class HomeController extends Controller {
  * Protects routes that require authentication.
  */
 
-import type { GravitoContext, GravitoNext } from 'gravito-core'
+import type { GravitoContext, GravitoNext } from '@gravito/core'
 
 export async function Authenticate(c: GravitoContext, next: GravitoNext) {
   // TODO: Implement authentication check
@@ -2831,6 +3098,7 @@ export async function Authenticate(c: GravitoContext, next: GravitoNext) {
   // }
 
   await next()
+  return undefined
 }
 `;
   }
@@ -2842,7 +3110,7 @@ export async function Authenticate(c: GravitoContext, next: GravitoNext) {
  * Register and bootstrap application services here.
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 
 export class AppServiceProvider extends ServiceProvider {
   /**
@@ -2870,7 +3138,7 @@ export class AppServiceProvider extends ServiceProvider {
  * Configures and registers application routes.
  */
 
-import { ServiceProvider, type Container, type PlanetCore } from 'gravito-core'
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
 import { registerRoutes } from '../routes'
 
 export class RouteServiceProvider extends ServiceProvider {
@@ -2898,7 +3166,7 @@ export class RouteServiceProvider extends ServiceProvider {
  * Customize error responses and logging here.
  */
 
-import type { ErrorHandlerContext } from 'gravito-core'
+import type { ErrorHandlerContext } from '@gravito/core'
 
 /**
  * Report an exception (logging, monitoring, etc.)
@@ -2935,6 +3203,13 @@ export const dontReport: string[] = [
 `;
   }
   generateBootstrap(context) {
+    const spectrumImport = context.withSpectrum ? "import { SpectrumOrbit } from '@gravito/spectrum'\n" : "";
+    const spectrumOrbit = context.withSpectrum ? `
+// Enable Debug Dashboard
+if (process.env.APP_DEBUG === 'true') {
+  await core.orbit(new SpectrumOrbit())
+}
+` : "";
     return `/**
  * Application Bootstrap
  *
@@ -2942,8 +3217,10 @@ export const dontReport: string[] = [
  * It initializes the core and registers all providers.
  */
 
-import { PlanetCore } from 'gravito-core'
-import { AppServiceProvider } from './Providers/AppServiceProvider'
+import { bodySizeLimit, PlanetCore, securityHeaders } 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
@@ -2952,10 +3229,41 @@ import { RouteServiceProvider } from './Providers/RouteServiceProvider'
 // Create application core
 const core = new PlanetCore({
   config: {
-    APP_NAME: '${context.name}',
+    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 }))
+}
 
+await core.orbit(new OrbitAtlas())
+${spectrumOrbit}
 // Register service providers
 core.register(new AppServiceProvider())
 core.register(new RouteServiceProvider())
@@ -3126,8 +3434,829 @@ Created with \u2764\uFE0F using Gravito Framework
   }
 };
 
+// src/generators/SatelliteGenerator.ts
+var SatelliteGenerator = class extends BaseGenerator {
+  get architectureType() {
+    return "satellite";
+  }
+  get displayName() {
+    return "Gravito Satellite";
+  }
+  get description() {
+    return "A modular plugin for Gravito following DDD and Clean Architecture";
+  }
+  getDirectoryStructure(context) {
+    const name = context.namePascalCase;
+    return [
+      {
+        type: "directory",
+        name: "src",
+        children: [
+          // Domain Layer
+          {
+            type: "directory",
+            name: "Domain",
+            children: [
+              {
+                type: "directory",
+                name: "Entities",
+                children: [
+                  { type: "file", name: `${name}.ts`, content: this.generateEntity(name) }
+                ]
+              },
+              {
+                type: "directory",
+                name: "Contracts",
+                children: [
+                  {
+                    type: "file",
+                    name: `I${name}Repository.ts`,
+                    content: this.generateRepositoryInterface(name)
+                  }
+                ]
+              },
+              { type: "directory", name: "ValueObjects", children: [] },
+              { type: "directory", name: "Events", children: [] }
+            ]
+          },
+          // Application Layer
+          {
+            type: "directory",
+            name: "Application",
+            children: [
+              {
+                type: "directory",
+                name: "UseCases",
+                children: [
+                  {
+                    type: "file",
+                    name: `Create${name}.ts`,
+                    content: this.generateUseCase(name)
+                  }
+                ]
+              },
+              { type: "directory", name: "DTOs", children: [] }
+            ]
+          },
+          // Infrastructure Layer
+          {
+            type: "directory",
+            name: "Infrastructure",
+            children: [
+              {
+                type: "directory",
+                name: "Persistence",
+                children: [
+                  {
+                    type: "file",
+                    name: `Atlas${name}Repository.ts`,
+                    content: this.generateAtlasRepository(name)
+                  },
+                  { type: "directory", name: "Migrations", children: [] }
+                ]
+              }
+            ]
+          },
+          // Entry Point
+          { type: "file", name: "index.ts", content: this.generateEntryPoint(name) },
+          {
+            type: "file",
+            name: "env.d.ts",
+            content: "interface ImportMeta {\n  readonly dir: string\n  readonly path: string\n}\n"
+          },
+          { type: "file", name: "manifest.json", content: this.generateManifest(context) }
+        ]
+      },
+      {
+        type: "directory",
+        name: "tests",
+        children: [
+          {
+            type: "file",
+            name: "unit.test.ts",
+            content: `import { describe, it, expect } from "bun:test";
+
+describe("${name}", () => {
+  it("should work", () => {
+    expect(true).toBe(true);
+  });
+});`
+          }
+        ]
+      }
+    ];
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Domain Templates
+  // ─────────────────────────────────────────────────────────────
+  generateEntity(name) {
+    return `import { Entity } from '@gravito/enterprise'
+
+export interface ${name}Props {
+  name: string
+  createdAt: Date
+}
+
+export class ${name} extends Entity<string> {
+  constructor(id: string, private props: ${name}Props) {
+    super(id)
+  }
+
+  static create(id: string, name: string): ${name} {
+    return new ${name}(id, {
+      name,
+      createdAt: new Date()
+    })
+  }
+
+  get name() { return this.props.name }
+}
+`;
+  }
+  generateRepositoryInterface(name) {
+    return `import { Repository } from '@gravito/enterprise'
+import { ${name} } from '../Entities/${name}'
+
+export interface I${name}Repository extends Repository<${name}, string> {
+  // Add custom methods here
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Application Templates
+  // ─────────────────────────────────────────────────────────────
+  generateUseCase(name) {
+    return `import { UseCase } from '@gravito/enterprise'
+import { I${name}Repository } from '../../Domain/Contracts/I${name}Repository'
+import { ${name} } from '../../Domain/Entities/${name}'
+
+export interface Create${name}Input {
+  name: string
+}
+
+export class Create${name} extends UseCase<Create${name}Input, string> {
+  constructor(private repository: I${name}Repository) {
+    super()
+  }
+
+  async execute(input: Create${name}Input): Promise<string> {
+    const id = crypto.randomUUID()
+    const entity = ${name}.create(id, input.name)
+    
+    await this.repository.save(entity)
+    
+    return id
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Infrastructure Templates (Dogfooding Atlas)
+  // ─────────────────────────────────────────────────────────────
+  generateAtlasRepository(name) {
+    return `import { I${name}Repository } from '../../Domain/Contracts/I${name}Repository'
+import { ${name} } from '../../Domain/Entities/${name}'
+import { DB } from '@gravito/atlas'
+
+export class Atlas${name}Repository implements I${name}Repository {
+  async save(entity: ${name}): Promise<void> {
+    // Dogfooding: Use @gravito/atlas for persistence
+    console.log('[Atlas] Saving entity:', entity.id)
+    // await DB.table('${name.toLowerCase()}s').insert({ ... })
+  }
+
+  async findById(id: string): Promise<${name} | null> {
+    return null
+  }
+
+  async findAll(): Promise<${name}[]> {
+    return []
+  }
+
+  async delete(id: string): Promise<void> {}
+
+  async exists(id: string): Promise<boolean> {
+    return false
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Entry Point & Manifest
+  // ─────────────────────────────────────────────────────────────
+  generateEntryPoint(name) {
+    return `import { ServiceProvider, type Container } from '@gravito/core'
+import { Atlas${name}Repository } from './Infrastructure/Persistence/Atlas${name}Repository'
+
+export class ${name}ServiceProvider extends ServiceProvider {
+  register(container: Container): void {
+    // Bind Repository
+    container.singleton('${name.toLowerCase()}.repo', () => new Atlas${name}Repository())
+    
+    // Bind UseCases
+    container.singleton('${name.toLowerCase()}.create', () => {
+        return new (require('./Application/UseCases/Create${name}').Create${name})(
+            container.make('${name.toLowerCase()}.repo')
+        )
+    })
+  }
+
+  boot(): void {
+    this.core?.logger.info('\u{1F6F0}\uFE0F Satellite ${name} is operational')
+  }
+}
+`;
+  }
+  generateManifest(context) {
+    return JSON.stringify(
+      {
+        name: context.name,
+        id: context.nameKebabCase,
+        version: "0.1.0",
+        description: context.description || "A Gravito Satellite",
+        capabilities: [`create-${context.nameKebabCase}`],
+        requirements: [
+          "cache"
+          // Example requirement
+        ],
+        hooks: [`${context.nameKebabCase}:created`]
+      },
+      null,
+      2
+    );
+  }
+  generatePackageJson(context) {
+    const isInternal = context.isInternal || false;
+    const depVersion = isInternal ? "workspace:*" : "^1.0.0-beta.1";
+    const pkg = {
+      name: isInternal ? `@gravito/satellite-${context.nameKebabCase}` : `gravito-satellite-${context.nameKebabCase}`,
+      version: "0.1.0",
+      type: "module",
+      main: "dist/index.js",
+      module: "dist/index.mjs",
+      types: "dist/index.d.ts",
+      scripts: {
+        build: "tsup src/index.ts --format cjs,esm --dts",
+        test: "bun test",
+        typecheck: "tsc --noEmit"
+      },
+      dependencies: {
+        "@gravito/core": depVersion,
+        "@gravito/enterprise": depVersion,
+        "@gravito/atlas": depVersion,
+        "@gravito/stasis": depVersion
+      },
+      devDependencies: {
+        tsup: "^8.0.0",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
+  generateArchitectureDoc(context) {
+    return `# ${context.name} Satellite Architecture
+
+This satellite follows the Gravito Satellite Specification v1.0.
+
+## Design
+- **DDD**: Domain logic is separated from framework concerns.
+- **Dogfooding**: Uses official Gravito modules (@gravito/atlas, @gravito/stasis).
+- **Decoupled**: Inter-satellite communication happens via Contracts and Events.
+
+## Layers
+- **Domain**: Pure business rules.
+- **Application**: Orchestration of domain tasks.
+- **Infrastructure**: Implementation of persistence and external services.
+- **Interface**: HTTP and Event entry points.
+`;
+  }
+};
+
+// src/LockGenerator.ts
+var LockGenerator = class {
+  generate(profileName, config, templateName = "basic", templateVersion = "1.0.0") {
+    const lock = {
+      profile: {
+        name: profileName,
+        version: "1.0.0"
+        // This could be dynamic based on profile system version
+      },
+      features: config.features,
+      drivers: config.drivers,
+      manifest: {
+        template: templateName,
+        version: templateVersion
+      },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    return JSON.stringify(lock, null, 2);
+  }
+};
+
+// src/ProfileResolver.ts
+var ProfileResolver = class _ProfileResolver {
+  static DEFAULTS = {
+    core: {
+      drivers: {
+        database: "sqlite",
+        cache: "memory",
+        queue: "sync",
+        storage: "local",
+        session: "file"
+      },
+      features: []
+    },
+    scale: {
+      drivers: {
+        database: "postgresql",
+        cache: "redis",
+        queue: "redis",
+        storage: "s3",
+        session: "redis"
+      },
+      features: ["stream", "nebula"]
+    },
+    enterprise: {
+      drivers: {
+        database: "postgresql",
+        cache: "redis",
+        queue: "redis",
+        storage: "s3",
+        session: "redis"
+      },
+      features: ["stream", "nebula", "monitor", "sentinel", "fortify"]
+    }
+  };
+  resolve(profile = "core", withFeatures = []) {
+    const base = _ProfileResolver.DEFAULTS[profile] || _ProfileResolver.DEFAULTS.core;
+    const config = {
+      drivers: { ...base.drivers },
+      features: [...base.features]
+    };
+    for (const feature of withFeatures) {
+      this.applyFeature(config, feature);
+    }
+    return config;
+  }
+  applyFeature(config, feature) {
+    switch (feature) {
+      case "redis":
+        config.drivers.cache = "redis";
+        config.drivers.queue = "redis";
+        config.drivers.session = "redis";
+        break;
+      case "postgres":
+      case "postgresql":
+        config.drivers.database = "postgresql";
+        break;
+      case "mysql":
+        config.drivers.database = "mysql";
+        break;
+      case "s3":
+        config.drivers.storage = "s3";
+        break;
+      case "r2":
+        config.drivers.storage = "r2";
+        break;
+      case "queue":
+        if (config.drivers.queue === "sync") {
+          config.drivers.queue = "redis";
+        }
+        break;
+      default:
+        if (!config.features.includes(feature)) {
+          config.features.push(feature);
+        }
+    }
+  }
+  /**
+   * Validator for profile names
+   */
+  isValidProfile(profile) {
+    return profile in _ProfileResolver.DEFAULTS;
+  }
+  /**
+   * Validator for feature names
+   */
+  isValidFeature(feature) {
+    const validFeatures = [
+      "redis",
+      "postgres",
+      "postgresql",
+      "mysql",
+      "s3",
+      "r2",
+      "queue",
+      "stream",
+      "nebula",
+      "monitor",
+      "sentinel",
+      "fortify"
+    ];
+    return validFeatures.includes(feature);
+  }
+};
+
 // src/Scaffold.ts
 import path3 from "path";
+
+// src/generators/ActionDomainGenerator.ts
+var ActionDomainGenerator = class extends BaseGenerator {
+  get architectureType() {
+    return "action-domain";
+  }
+  get displayName() {
+    return "Action Domain";
+  }
+  get description() {
+    return "Single-responsibility Action pattern for clear business logic separation";
+  }
+  getDirectoryStructure(context) {
+    return [
+      {
+        type: "directory",
+        name: "config",
+        children: [
+          { type: "file", name: "app.ts", content: this.generateAppConfig(context) },
+          { type: "file", name: "database.ts", content: this.generateDatabaseConfig() }
+        ]
+      },
+      {
+        type: "directory",
+        name: "database",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      },
+      {
+        type: "directory",
+        name: "src",
+        children: [
+          {
+            type: "directory",
+            name: "actions",
+            children: [
+              { type: "file", name: "Action.ts", content: this.generateActionBase() },
+              {
+                type: "directory",
+                name: "server",
+                children: [
+                  {
+                    type: "file",
+                    name: "GetServerStatusAction.ts",
+                    content: this.generateGetServerStatusAction()
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "controllers",
+            children: [
+              {
+                type: "directory",
+                name: "api",
+                children: [
+                  {
+                    type: "directory",
+                    name: "v1",
+                    children: [
+                      {
+                        type: "file",
+                        name: "ServerController.ts",
+                        content: this.generateServerController()
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "types",
+            children: [
+              {
+                type: "directory",
+                name: "requests",
+                children: [
+                  {
+                    type: "directory",
+                    name: "api",
+                    children: [
+                      {
+                        type: "directory",
+                        name: "v1",
+                        children: [{ type: "file", name: ".gitkeep", content: "" }]
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                type: "directory",
+                name: "responses",
+                children: [
+                  {
+                    type: "directory",
+                    name: "api",
+                    children: [
+                      {
+                        type: "directory",
+                        name: "v1",
+                        children: [
+                          {
+                            type: "file",
+                            name: "ServerStatusResponse.ts",
+                            content: this.generateServerStatusResponse()
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            type: "directory",
+            name: "models",
+            children: [{ type: "file", name: "User.ts", content: this.generateUserModel() }]
+          },
+          {
+            type: "directory",
+            name: "repositories",
+            children: [{ type: "file", name: ".gitkeep", content: "" }]
+          },
+          {
+            type: "directory",
+            name: "routes",
+            children: [{ type: "file", name: "api.ts", content: this.generateApiRoutes() }]
+          },
+          {
+            type: "directory",
+            name: "providers",
+            children: [
+              {
+                type: "file",
+                name: "AppServiceProvider.ts",
+                content: this.generateAppServiceProvider(context)
+              }
+            ]
+          },
+          { type: "file", name: "bootstrap.ts", content: this.generateBootstrap(context) }
+        ]
+      },
+      {
+        type: "directory",
+        name: "tests",
+        children: [{ type: "file", name: ".gitkeep", content: "" }]
+      }
+    ];
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Config Generators
+  // ─────────────────────────────────────────────────────────────
+  generateAppConfig(context) {
+    return `export default {
+  name: process.env.APP_NAME ?? '${context.name}',
+  env: process.env.APP_ENV ?? 'development',
+  debug: process.env.APP_DEBUG === 'true',
+  url: process.env.APP_URL ?? 'http://localhost:3000',
+  key: process.env.APP_KEY,
+}
+`;
+  }
+  generateDatabaseConfig() {
+    return `export default {
+  default: process.env.DB_CONNECTION ?? 'sqlite',
+  connections: {
+    sqlite: {
+      driver: 'sqlite',
+      database: process.env.DB_DATABASE ?? 'database/database.sqlite',
+    },
+  },
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Model Generators
+  // ─────────────────────────────────────────────────────────────
+  generateUserModel() {
+    return `/**
+ * User Model
+ */
+
+import { Model, column } from '@gravito/atlas'
+
+export class User extends Model {
+  static table = 'users'
+
+  @column({ isPrimary: true })
+  id!: number
+
+  @column()
+  name!: string
+
+  @column()
+  email!: string
+
+  @column()
+  created_at!: Date
+
+  @column()
+  updated_at!: Date
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Action Generators
+  // ─────────────────────────────────────────────────────────────
+  generateActionBase() {
+    return `/**
+ * Action Base Class
+ *
+ * All business logic actions should extend this class.
+ * It enforces a consistent execution method.
+ */
+
+export abstract class Action<TInput = unknown, TOutput = unknown> {
+  /**
+   * Execute the business logic.
+   */
+  abstract execute(input: TInput): Promise<TOutput> | TOutput
+}
+`;
+  }
+  generateGetServerStatusAction() {
+    return `/**
+ * Get Server Status Action
+ */
+
+import { Action } from '../Action'
+import type { ServerStatusResponse } from '../../types/responses/api/v1/ServerStatusResponse'
+
+export class GetServerStatusAction extends Action<void, ServerStatusResponse> {
+  execute(): Promise<ServerStatusResponse> {
+    return Promise.resolve({
+      status: 'active',
+      timestamp: new Date().toISOString(),
+      service: 'Gravito Hub'
+    })
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Controller Generators
+  // ─────────────────────────────────────────────────────────────
+  generateServerController() {
+    return `/**
+ * Server Controller
+ */
+
+import type { GravitoContext } from '@gravito/core'
+import { GetServerStatusAction } from '../../../actions/server/GetServerStatusAction'
+
+export class ServerController {
+  /**
+   * GET /v1/server/status
+   */
+  async status(c: GravitoContext) {
+    const action = new GetServerStatusAction()
+    const result = await action.execute()
+    
+    return c.json({
+      success: true,
+      data: result
+    })
+  }
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Type Generators
+  // ─────────────────────────────────────────────────────────────
+  generateServerStatusResponse() {
+    return `/**
+ * Server Status Response Type
+ */
+
+export interface ServerStatusResponse {
+  status: string
+  timestamp: string
+  service: string
+}
+`;
+  }
+  // ─────────────────────────────────────────────────────────────
+  // Routes & Bootstrap
+  // ─────────────────────────────────────────────────────────────
+  generateApiRoutes() {
+    return `/**
+ * API Routes Registration
+ */
+
+import type { Router } from '@gravito/core'
+import { ServerController } from '../controllers/api/v1/ServerController'
+
+export function registerApiRoutes(router: Router) {
+  const server = new ServerController()
+
+  router.prefix('/v1').group((group) => {
+    // Server Domain
+    group.get('/server/status', (c) => server.status(c))
+  })
+}
+`;
+  }
+  generateAppServiceProvider(context) {
+    return `/**
+ * App Service Provider
+ */
+
+import { ServiceProvider, type Container, type PlanetCore } from '@gravito/core'
+
+export class AppServiceProvider extends ServiceProvider {
+  register(container: Container): void {
+    // Register global services here
+  }
+
+  boot(core: PlanetCore): void {
+    core.logger.info('${context.name} (Action Domain) booted!')
+  }
+}
+`;
+  }
+  generateBootstrap(context) {
+    return `/**
+ * Application Entry Point
+ */
+
+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
+  },
+})
+
+// Middleware
+core.adapter.use('*', securityHeaders())
+core.adapter.use('*', bodySizeLimit(1024 * 1024)) // 1MB
+
+// Install Orbits
+await core.orbit(new OrbitAtlas())
+
+// Service Providers
+core.register(new AppServiceProvider())
+
+// Bootstrap
+await core.bootstrap()
+
+// Routes
+registerApiRoutes(core.router)
+
+// Liftoff
+export default core.liftoff()
+`;
+  }
+  generateArchitectureDoc(context) {
+    return "# " + context.name + ' - Action Domain Architecture\n\n## Overview\n\nThis project uses the **Action Domain** pattern, designed for high-clarity API implementations.\n\n## Directory Structure\n\n```\nsrc/\n\u251C\u2500\u2500 actions/           # Single Responsibility Business Logic\n\u2502   \u251C\u2500\u2500 Action.ts      # Base Action class\n\u2502   \u2514\u2500\u2500 [Domain]/      # Domain-specific actions\n\u251C\u2500\u2500 controllers/       # HTTP Request Handlers\n\u2502   \u2514\u2500\u2500 api/v1/        # API Controllers\n\u251C\u2500\u2500 types/             # TypeScript Definitions\n\u2502   \u251C\u2500\u2500 requests/      # Request Payloads\n\u2502   \u2514\u2500\u2500 responses/     # Response Structures\n\u251C\u2500\u2500 repositories/      # Data Access Layer\n\u251C\u2500\u2500 routes/            # Route Definitions\n\u2514\u2500\u2500 config/            # Configuration\n```\n\n## Core Concepts\n\n### Actions\nEvery business operation is an "Action". An action:\n- Does ONE thing.\n- Takes specific input.\n- Returns specific output.\n- Is framework-agnostic (ideally).\n\n### Controllers\nControllers are thin. They:\n1. Parse the request.\n2. Instantiate/Call the Action.\n3. Return the response.\n\nCreated with \u2764\uFE0F using Gravito Framework\n';
+  }
+  generatePackageJson(context) {
+    const pkg = {
+      name: context.nameKebabCase,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "bun run --watch src/bootstrap.ts",
+        build: "bun build ./src/bootstrap.ts --outdir ./dist --target bun",
+        start: "bun run dist/bootstrap.js",
+        test: "bun test",
+        typecheck: "tsc --noEmit"
+      },
+      dependencies: {
+        "@gravito/core": "workspace:*",
+        "@gravito/enterprise": "workspace:*",
+        "@gravito/atlas": "workspace:*"
+        // Usually needed for repositories
+      },
+      devDependencies: {
+        "bun-types": "latest",
+        typescript: "^5.0.0"
+      }
+    };
+    return JSON.stringify(pkg, null, 2);
+  }
+};
+
+// src/Scaffold.ts
 var Scaffold = class {
   templatesDir;
   verbose;
@@ -3154,6 +4283,16 @@ var Scaffold = class {
         type: "ddd",
         name: "Domain-Driven Design",
         description: "Full DDD with Bounded Contexts and CQRS"
+      },
+      {
+        type: "action-domain",
+        name: "Action Domain",
+        description: "Single Action Controllers pattern for high-clarity APIs"
+      },
+      {
+        type: "satellite",
+        name: "Gravito Satellite",
+        description: "Plug-and-play module for the Gravito ecosystem"
       }
     ];
   }
@@ -3162,15 +4301,36 @@ var Scaffold = class {
    */
   async create(options) {
     const generator = this.createGenerator(options.architecture);
+    const fs3 = await import("fs/promises");
+    const profileResolver = new ProfileResolver();
+    const profileConfig = profileResolver.resolve(options.profile, options.features);
     const context = BaseGenerator.createContext(
       options.name,
       options.targetDir,
       options.architecture,
       options.packageManager ?? "bun",
-      options.context ?? {}
+      {
+        ...options.context,
+        withSpectrum: options.withSpectrum ?? false,
+        isInternal: options.isInternal ?? false,
+        profile: options.profile ?? "core",
+        features: options.features ?? [],
+        profileConfig
+      }
     );
     try {
       const filesCreated = await generator.generate(context);
+      const lockGenerator = new LockGenerator();
+      const lockContent = lockGenerator.generate(
+        options.profile ?? "core",
+        profileConfig,
+        "basic",
+        // Default template for now, should come from options if applicable
+        "1.0.0"
+      );
+      const lockPath = path3.resolve(options.targetDir, "gravito.lock.json");
+      await fs3.writeFile(lockPath, lockContent, "utf-8");
+      filesCreated.push(lockPath);
       return {
         success: true,
         targetDir: options.targetDir,
@@ -3200,6 +4360,10 @@ var Scaffold = class {
         return new CleanArchitectureGenerator(config);
       case "ddd":
         return new DddGenerator(config);
+      case "action-domain":
+        return new ActionDomainGenerator(config);
+      case "satellite":
+        return new SatelliteGenerator(config);
       default:
         throw new Error(`Unknown architecture type: ${type}`);
     }
@@ -3222,6 +4386,11 @@ export {
   CleanArchitectureGenerator,
   DddGenerator,
   EnterpriseMvcGenerator,
+  EnvironmentDetector,
+  FileMerger,
+  LockGenerator,
+  ProfileResolver,
+  SatelliteGenerator,
   Scaffold,
   StubGenerator
 };