servcraft 0.1.7 → 0.3.1

package/dist/cli/index.cjs

@@ -28,21 +28,104 @@ var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${_
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/cli/index.ts
-var import_commander6 = require("commander");
+var import_commander11 = require("commander");
 
 // src/cli/commands/init.ts
 var import_commander = require("commander");
-var import_path2 = __toESM(require("path"), 1);
+var import_path3 = __toESM(require("path"), 1);
 var import_promises2 = __toESM(require("fs/promises"), 1);
 var import_ora = __toESM(require("ora"), 1);
 var import_inquirer = __toESM(require("inquirer"), 1);
-var import_chalk2 = __toESM(require("chalk"), 1);
+var import_chalk3 = __toESM(require("chalk"), 1);
 var import_child_process = require("child_process");
 
 // src/cli/utils/helpers.ts
 var import_promises = __toESM(require("fs/promises"), 1);
-var import_path = __toESM(require("path"), 1);
+var import_path2 = __toESM(require("path"), 1);
+var import_chalk2 = __toESM(require("chalk"), 1);
+
+// src/cli/utils/dry-run.ts
 var import_chalk = __toESM(require("chalk"), 1);
+var import_path = __toESM(require("path"), 1);
+var DryRunManager = class _DryRunManager {
+  static instance;
+  enabled = false;
+  operations = [];
+  constructor() {
+  }
+  static getInstance() {
+    if (!_DryRunManager.instance) {
+      _DryRunManager.instance = new _DryRunManager();
+    }
+    return _DryRunManager.instance;
+  }
+  enable() {
+    this.enabled = true;
+    this.operations = [];
+  }
+  disable() {
+    this.enabled = false;
+    this.operations = [];
+  }
+  isEnabled() {
+    return this.enabled;
+  }
+  addOperation(operation) {
+    if (this.enabled) {
+      this.operations.push(operation);
+    }
+  }
+  getOperations() {
+    return [...this.operations];
+  }
+  printSummary() {
+    if (!this.enabled || this.operations.length === 0) {
+      return;
+    }
+    console.log(import_chalk.default.bold.yellow("\n\u{1F4CB} Dry Run - Preview of changes:\n"));
+    console.log(import_chalk.default.gray("No files will be written. Remove --dry-run to apply changes.\n"));
+    const createOps = this.operations.filter((op) => op.type === "create");
+    const modifyOps = this.operations.filter((op) => op.type === "modify");
+    const deleteOps = this.operations.filter((op) => op.type === "delete");
+    if (createOps.length > 0) {
+      console.log(import_chalk.default.green.bold(`
+\u2713 Files to be created (${createOps.length}):`));
+      createOps.forEach((op) => {
+        const size = op.content ? `${op.content.length} bytes` : "unknown size";
+        console.log(`  ${import_chalk.default.green("+")} ${import_chalk.default.cyan(op.path)} ${import_chalk.default.gray(`(${size})`)}`);
+      });
+    }
+    if (modifyOps.length > 0) {
+      console.log(import_chalk.default.yellow.bold(`
+~ Files to be modified (${modifyOps.length}):`));
+      modifyOps.forEach((op) => {
+        console.log(`  ${import_chalk.default.yellow("~")} ${import_chalk.default.cyan(op.path)}`);
+      });
+    }
+    if (deleteOps.length > 0) {
+      console.log(import_chalk.default.red.bold(`
+- Files to be deleted (${deleteOps.length}):`));
+      deleteOps.forEach((op) => {
+        console.log(`  ${import_chalk.default.red("-")} ${import_chalk.default.cyan(op.path)}`);
+      });
+    }
+    console.log(import_chalk.default.gray("\n" + "\u2500".repeat(60)));
+    console.log(
+      import_chalk.default.bold(`  Total operations: ${this.operations.length}`) + import_chalk.default.gray(
+        ` (${createOps.length} create, ${modifyOps.length} modify, ${deleteOps.length} delete)`
+      )
+    );
+    console.log(import_chalk.default.gray("\u2500".repeat(60)));
+    console.log(import_chalk.default.yellow("\n\u26A0 This was a dry run. No files were created or modified."));
+    console.log(import_chalk.default.gray("  Remove --dry-run to apply these changes.\n"));
+  }
+  // Helper to format file path relative to cwd
+  relativePath(filePath) {
+    return import_path.default.relative(process.cwd(), filePath);
+  }
+};
+
+// src/cli/utils/helpers.ts
 function toPascalCase(str) {
   return str.split(/[-_\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
 }
@@ -74,39 +157,54 @@ async function ensureDir(dirPath) {
   await import_promises.default.mkdir(dirPath, { recursive: true });
 }
 async function writeFile(filePath, content) {
-  await ensureDir(import_path.default.dirname(filePath));
+  const dryRun = DryRunManager.getInstance();
+  if (dryRun.isEnabled()) {
+    dryRun.addOperation({
+      type: "create",
+      path: dryRun.relativePath(filePath),
+      content,
+      size: content.length
+    });
+    return;
+  }
+  await ensureDir(import_path2.default.dirname(filePath));
   await import_promises.default.writeFile(filePath, content, "utf-8");
 }
 function success(message) {
-  console.log(import_chalk.default.green("\u2713"), message);
+  console.log(import_chalk2.default.green("\u2713"), message);
 }
 function error(message) {
-  console.error(import_chalk.default.red("\u2717"), message);
+  console.error(import_chalk2.default.red("\u2717"), message);
 }
 function warn(message) {
-  console.log(import_chalk.default.yellow("\u26A0"), message);
+  console.log(import_chalk2.default.yellow("\u26A0"), message);
 }
 function info(message) {
-  console.log(import_chalk.default.blue("\u2139"), message);
+  console.log(import_chalk2.default.blue("\u2139"), message);
 }
 function getProjectRoot() {
   return process.cwd();
 }
 function getSourceDir() {
-  return import_path.default.join(getProjectRoot(), "src");
+  return import_path2.default.join(getProjectRoot(), "src");
 }
 function getModulesDir() {
-  return import_path.default.join(getSourceDir(), "modules");
+  return import_path2.default.join(getSourceDir(), "modules");
 }
 
 // src/cli/commands/init.ts
-var initCommand = new import_commander.Command("init").alias("new").description("Initialize a new Servcraft project").argument("[name]", "Project name").option("-y, --yes", "Skip prompts and use defaults").option("--ts, --typescript", "Use TypeScript (default)").option("--js, --javascript", "Use JavaScript").option("--esm", "Use ES Modules (import/export) - default").option("--cjs, --commonjs", "Use CommonJS (require/module.exports)").option("--db <database>", "Database type (postgresql, mysql, sqlite, mongodb, none)").action(
+var initCommand = new import_commander.Command("init").alias("new").description("Initialize a new Servcraft project").argument("[name]", "Project name").option("-y, --yes", "Skip prompts and use defaults").option("--ts, --typescript", "Use TypeScript (default)").option("--js, --javascript", "Use JavaScript").option("--esm", "Use ES Modules (import/export) - default").option("--cjs, --commonjs", "Use CommonJS (require/module.exports)").option("--db <database>", "Database type (postgresql, mysql, sqlite, mongodb, none)").option("--dry-run", "Preview changes without writing files").action(
   async (name, cmdOptions) => {
+    const dryRun = DryRunManager.getInstance();
+    if (cmdOptions?.dryRun) {
+      dryRun.enable();
+      console.log(import_chalk3.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+    }
     console.log(
-      import_chalk2.default.blue(`
+      import_chalk3.default.blue(`
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551                                           \u2551
-\u2551   ${import_chalk2.default.bold("\u{1F680} Servcraft Project Generator")}          \u2551
+\u2551   ${import_chalk3.default.bold("\u{1F680} Servcraft Project Generator")}          \u2551
 \u2551                                           \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
 `)
@@ -201,7 +299,7 @@ var initCommand = new import_commander.Command("init").alias("new").description(
         orm: db === "mongodb" ? "mongoose" : db === "none" ? "none" : "prisma"
       };
     }
-    const projectDir = import_path2.default.resolve(process.cwd(), options.name);
+    const projectDir = import_path3.default.resolve(process.cwd(), options.name);
     const spinner = (0, import_ora.default)("Creating project...").start();
     try {
       try {
@@ -215,21 +313,21 @@ var initCommand = new import_commander.Command("init").alias("new").description(
       spinner.text = "Generating project files...";
       const packageJson = generatePackageJson(options);
       await writeFile(
-        import_path2.default.join(projectDir, "package.json"),
+        import_path3.default.join(projectDir, "package.json"),
         JSON.stringify(packageJson, null, 2)
       );
       if (options.language === "typescript") {
-        await writeFile(import_path2.default.join(projectDir, "tsconfig.json"), generateTsConfig(options));
-        await writeFile(import_path2.default.join(projectDir, "tsup.config.ts"), generateTsupConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "tsconfig.json"), generateTsConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "tsup.config.ts"), generateTsupConfig(options));
       } else {
-        await writeFile(import_path2.default.join(projectDir, "jsconfig.json"), generateJsConfig(options));
+        await writeFile(import_path3.default.join(projectDir, "jsconfig.json"), generateJsConfig(options));
       }
-      await writeFile(import_path2.default.join(projectDir, ".env.example"), generateEnvExample(options));
-      await writeFile(import_path2.default.join(projectDir, ".env"), generateEnvExample(options));
-      await writeFile(import_path2.default.join(projectDir, ".gitignore"), generateGitignore());
-      await writeFile(import_path2.default.join(projectDir, "Dockerfile"), generateDockerfile(options));
+      await writeFile(import_path3.default.join(projectDir, ".env.example"), generateEnvExample(options));
+      await writeFile(import_path3.default.join(projectDir, ".env"), generateEnvExample(options));
+      await writeFile(import_path3.default.join(projectDir, ".gitignore"), generateGitignore());
+      await writeFile(import_path3.default.join(projectDir, "Dockerfile"), generateDockerfile(options));
       await writeFile(
-        import_path2.default.join(projectDir, "docker-compose.yml"),
+        import_path3.default.join(projectDir, "docker-compose.yml"),
         generateDockerCompose(options)
       );
       const ext = options.language === "typescript" ? "ts" : options.moduleSystem === "esm" ? "js" : "cjs";
@@ -250,59 +348,63 @@ var initCommand = new import_commander.Command("init").alias("new").description(
         dirs.push("src/database/models");
       }
       for (const dir of dirs) {
-        await ensureDir(import_path2.default.join(projectDir, dir));
+        await ensureDir(import_path3.default.join(projectDir, dir));
       }
-      await writeFile(import_path2.default.join(projectDir, `src/index.${ext}`), generateEntryFile(options));
+      await writeFile(import_path3.default.join(projectDir, `src/index.${ext}`), generateEntryFile(options));
       await writeFile(
-        import_path2.default.join(projectDir, `src/core/server.${ext}`),
+        import_path3.default.join(projectDir, `src/core/server.${ext}`),
         generateServerFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/core/logger.${ext}`),
+        import_path3.default.join(projectDir, `src/core/logger.${ext}`),
         generateLoggerFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/config/index.${ext}`),
+        import_path3.default.join(projectDir, `src/config/index.${ext}`),
         generateConfigFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/middleware/index.${ext}`),
+        import_path3.default.join(projectDir, `src/middleware/index.${ext}`),
         generateMiddlewareFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/utils/index.${ext}`),
+        import_path3.default.join(projectDir, `src/utils/index.${ext}`),
         generateUtilsFile(options)
       );
       await writeFile(
-        import_path2.default.join(projectDir, `src/types/index.${ext}`),
+        import_path3.default.join(projectDir, `src/types/index.${ext}`),
         generateTypesFile(options)
       );
       if (options.orm === "prisma") {
         await writeFile(
-          import_path2.default.join(projectDir, "prisma/schema.prisma"),
+          import_path3.default.join(projectDir, "prisma/schema.prisma"),
           generatePrismaSchema(options)
         );
       } else if (options.orm === "mongoose") {
         await writeFile(
-          import_path2.default.join(projectDir, `src/database/connection.${ext}`),
+          import_path3.default.join(projectDir, `src/database/connection.${ext}`),
           generateMongooseConnection(options)
         );
         await writeFile(
-          import_path2.default.join(projectDir, `src/database/models/user.model.${ext}`),
+          import_path3.default.join(projectDir, `src/database/models/user.model.${ext}`),
           generateMongooseUserModel(options)
         );
       }
       spinner.succeed("Project files generated!");
-      const installSpinner = (0, import_ora.default)("Installing dependencies...").start();
-      try {
-        (0, import_child_process.execSync)("npm install", { cwd: projectDir, stdio: "pipe" });
-        installSpinner.succeed("Dependencies installed!");
-      } catch {
-        installSpinner.warn("Failed to install dependencies automatically");
-        warn('  Run "npm install" manually in the project directory');
+      if (!cmdOptions?.dryRun) {
+        const installSpinner = (0, import_ora.default)("Installing dependencies...").start();
+        try {
+          (0, import_child_process.execSync)("npm install", { cwd: projectDir, stdio: "pipe" });
+          installSpinner.succeed("Dependencies installed!");
+        } catch {
+          installSpinner.warn("Failed to install dependencies automatically");
+          warn('  Run "npm install" manually in the project directory');
+        }
+      }
+      if (!cmdOptions?.dryRun) {
+        console.log("\n" + import_chalk3.default.green("\u2728 Project created successfully!"));
       }
-      console.log("\n" + import_chalk2.default.green("\u2728 Project created successfully!"));
-      console.log("\n" + import_chalk2.default.bold("\u{1F4C1} Project structure:"));
+      console.log("\n" + import_chalk3.default.bold("\u{1F4C1} Project structure:"));
       console.log(`
   ${options.name}/
   \u251C\u2500\u2500 src/
@@ -317,19 +419,22 @@ var initCommand = new import_commander.Command("init").alias("new").description(
   \u251C\u2500\u2500 docker-compose.yml
   \u2514\u2500\u2500 package.json
 `);
-      console.log(import_chalk2.default.bold("\u{1F680} Get started:"));
+      console.log(import_chalk3.default.bold("\u{1F680} Get started:"));
       console.log(`
-  ${import_chalk2.default.cyan(`cd ${options.name}`)}
-  ${options.database !== "none" ? import_chalk2.default.cyan("npm run db:push        # Setup database") : ""}
-  ${import_chalk2.default.cyan("npm run dev            # Start development server")}
+  ${import_chalk3.default.cyan(`cd ${options.name}`)}
+  ${options.database !== "none" ? import_chalk3.default.cyan("npm run db:push        # Setup database") : ""}
+  ${import_chalk3.default.cyan("npm run dev            # Start development server")}
 `);
-      console.log(import_chalk2.default.bold("\u{1F4DA} Available commands:"));
+      console.log(import_chalk3.default.bold("\u{1F4DA} Available commands:"));
       console.log(`
-  ${import_chalk2.default.yellow("servcraft generate module <name>")}    Generate a new module
-  ${import_chalk2.default.yellow("servcraft generate controller <name>")} Generate a controller
-  ${import_chalk2.default.yellow("servcraft generate service <name>")}    Generate a service
-  ${import_chalk2.default.yellow("servcraft add auth")}                   Add authentication module
+  ${import_chalk3.default.yellow("servcraft generate module <name>")}    Generate a new module
+  ${import_chalk3.default.yellow("servcraft generate controller <name>")} Generate a controller
+  ${import_chalk3.default.yellow("servcraft generate service <name>")}    Generate a service
+  ${import_chalk3.default.yellow("servcraft add auth")}                   Add authentication module
 `);
+      if (cmdOptions?.dryRun) {
+        dryRun.printSummary();
+      }
     } catch (err) {
       spinner.fail("Failed to create project");
       error(err instanceof Error ? err.message : String(err));
@@ -1121,9 +1226,10 @@ declare module 'fastify' {
 
 // src/cli/commands/generate.ts
 var import_commander2 = require("commander");
-var import_path3 = __toESM(require("path"), 1);
+var import_path4 = __toESM(require("path"), 1);
 var import_ora2 = __toESM(require("ora"), 1);
 var import_inquirer2 = __toESM(require("inquirer"), 1);
+var import_chalk5 = __toESM(require("chalk"), 1);
 
 // src/cli/utils/field-parser.ts
 var tsTypeMap = {
@@ -1267,6 +1373,108 @@ function parseFields(fieldsStr) {
   return fieldsStr.split(/\s+/).filter(Boolean).map(parseField);
 }
 
+// src/cli/utils/error-handler.ts
+var import_chalk4 = __toESM(require("chalk"), 1);
+var ServCraftError = class extends Error {
+  suggestions;
+  docsLink;
+  constructor(message, suggestions = [], docsLink) {
+    super(message);
+    this.name = "ServCraftError";
+    this.suggestions = suggestions;
+    this.docsLink = docsLink;
+  }
+};
+var ErrorTypes = {
+  MODULE_NOT_FOUND: (moduleName) => new ServCraftError(
+    `Module "${moduleName}" not found`,
+    [
+      `Run ${import_chalk4.default.cyan("servcraft list")} to see available modules`,
+      `Check the spelling of the module name`,
+      `Visit ${import_chalk4.default.blue("https://github.com/Le-Sourcier/servcraft#modules")} for module list`
+    ],
+    "https://github.com/Le-Sourcier/servcraft#add-pre-built-modules"
+  ),
+  MODULE_ALREADY_EXISTS: (moduleName) => new ServCraftError(`Module "${moduleName}" already exists`, [
+    `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --force")} to overwrite`,
+    `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --update")} to update`,
+    `Use ${import_chalk4.default.cyan("servcraft add " + moduleName + " --skip-existing")} to skip`
+  ]),
+  NOT_IN_PROJECT: () => new ServCraftError(
+    "Not in a ServCraft project directory",
+    [
+      `Run ${import_chalk4.default.cyan("servcraft init")} to create a new project`,
+      `Navigate to your ServCraft project directory`,
+      `Check if ${import_chalk4.default.yellow("package.json")} exists`
+    ],
+    "https://github.com/Le-Sourcier/servcraft#initialize-project"
+  ),
+  FILE_ALREADY_EXISTS: (fileName) => new ServCraftError(`File "${fileName}" already exists`, [
+    `Use ${import_chalk4.default.cyan("--force")} flag to overwrite`,
+    `Choose a different name`,
+    `Delete the existing file first`
+  ]),
+  INVALID_DATABASE: (database) => new ServCraftError(`Invalid database type: "${database}"`, [
+    `Valid options: ${import_chalk4.default.cyan("postgresql, mysql, sqlite, mongodb, none")}`,
+    `Use ${import_chalk4.default.cyan("servcraft init --db postgresql")} for PostgreSQL`
+  ]),
+  INVALID_VALIDATOR: (validator) => new ServCraftError(`Invalid validator type: "${validator}"`, [
+    `Valid options: ${import_chalk4.default.cyan("zod, joi, yup")}`,
+    `Default is ${import_chalk4.default.cyan("zod")}`
+  ]),
+  MISSING_DEPENDENCY: (dependency, command) => new ServCraftError(`Missing dependency: "${dependency}"`, [
+    `Run ${import_chalk4.default.cyan(command)} to install`,
+    `Check your ${import_chalk4.default.yellow("package.json")}`
+  ]),
+  INVALID_FIELD_FORMAT: (field) => new ServCraftError(`Invalid field format: "${field}"`, [
+    `Expected format: ${import_chalk4.default.cyan("name:type")}`,
+    `Example: ${import_chalk4.default.cyan("name:string age:number isActive:boolean")}`,
+    `Supported types: string, number, boolean, date`
+  ]),
+  GIT_NOT_INITIALIZED: () => new ServCraftError("Git repository not initialized", [
+    `Run ${import_chalk4.default.cyan("git init")} to initialize git`,
+    `This is required for some ServCraft features`
+  ])
+};
+function displayError(error2) {
+  console.error("\n" + import_chalk4.default.red.bold("\u2717 Error: ") + import_chalk4.default.red(error2.message));
+  if (error2 instanceof ServCraftError) {
+    if (error2.suggestions.length > 0) {
+      console.log("\n" + import_chalk4.default.yellow.bold("\u{1F4A1} Suggestions:"));
+      error2.suggestions.forEach((suggestion) => {
+        console.log(import_chalk4.default.yellow("  \u2022 ") + suggestion);
+      });
+    }
+    if (error2.docsLink) {
+      console.log(
+        "\n" + import_chalk4.default.blue.bold("\u{1F4DA} Documentation: ") + import_chalk4.default.blue.underline(error2.docsLink)
+      );
+    }
+  }
+  console.log();
+}
+function validateProject() {
+  try {
+    const fs12 = require("fs");
+    if (!fs12.existsSync("package.json")) {
+      return ErrorTypes.NOT_IN_PROJECT();
+    }
+    const packageJson = JSON.parse(fs12.readFileSync("package.json", "utf-8"));
+    if (!packageJson.dependencies?.fastify) {
+      return new ServCraftError("This does not appear to be a ServCraft project", [
+        `ServCraft projects require Fastify`,
+        `Run ${import_chalk4.default.cyan("servcraft init")} to create a new project`
+      ]);
+    }
+    return null;
+  } catch {
+    return new ServCraftError("Failed to validate project", [
+      `Ensure you are in the project root directory`,
+      `Check if ${import_chalk4.default.yellow("package.json")} is valid`
+    ]);
+  }
+}
+
 // src/cli/templates/controller.ts
 function controllerTemplate(name, pascalName, camelName) {
   return `import type { FastifyRequest, FastifyReply } from 'fastify';
@@ -1955,11 +2163,371 @@ ${indexLines.join("\n")}
 `;
 }
 
+// src/cli/templates/controller-test.ts
+function controllerTestTemplate(name, pascalName, camelName) {
+  return `import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { build } from '../../app.js';
+import { FastifyInstance } from 'fastify';
+
+describe('${pascalName}Controller', () => {
+  let app: FastifyInstance;
+
+  beforeAll(async () => {
+    app = await build();
+    await app.ready();
+  });
+
+  afterAll(async () => {
+    await app.close();
+  });
+
+  describe('GET /${name}', () => {
+    it('should return list of ${name}', async () => {
+      const response = await app.inject({
+        method: 'GET',
+        url: '/${name}',
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(response.json()).toHaveProperty('data');
+    });
+  });
+
+  describe('GET /${name}/:id', () => {
+    it('should return a single ${camelName}', async () => {
+      // TODO: Create test ${camelName} first
+      const response = await app.inject({
+        method: 'GET',
+        url: '/${name}/1',
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(response.json()).toHaveProperty('data');
+    });
+
+    it('should return 404 for non-existent ${camelName}', async () => {
+      const response = await app.inject({
+        method: 'GET',
+        url: '/${name}/999999',
+      });
+
+      expect(response.statusCode).toBe(404);
+    });
+  });
+
+  describe('POST /${name}', () => {
+    it('should create a new ${camelName}', async () => {
+      const response = await app.inject({
+        method: 'POST',
+        url: '/${name}',
+        payload: {
+          // TODO: Add required fields
+        },
+      });
+
+      expect(response.statusCode).toBe(201);
+      expect(response.json()).toHaveProperty('data');
+    });
+
+    it('should return 400 for invalid data', async () => {
+      const response = await app.inject({
+        method: 'POST',
+        url: '/${name}',
+        payload: {},
+      });
+
+      expect(response.statusCode).toBe(400);
+    });
+  });
+
+  describe('PUT /${name}/:id', () => {
+    it('should update a ${camelName}', async () => {
+      // TODO: Create test ${camelName} first
+      const response = await app.inject({
+        method: 'PUT',
+        url: '/${name}/1',
+        payload: {
+          // TODO: Add fields to update
+        },
+      });
+
+      expect(response.statusCode).toBe(200);
+      expect(response.json()).toHaveProperty('data');
+    });
+  });
+
+  describe('DELETE /${name}/:id', () => {
+    it('should delete a ${camelName}', async () => {
+      // TODO: Create test ${camelName} first
+      const response = await app.inject({
+        method: 'DELETE',
+        url: '/${name}/1',
+      });
+
+      expect(response.statusCode).toBe(204);
+    });
+  });
+});
+`;
+}
+
+// src/cli/templates/service-test.ts
+function serviceTestTemplate(name, pascalName, camelName) {
+  return `import { describe, it, expect, beforeEach } from 'vitest';
+import { ${pascalName}Service } from '../${name}.service.js';
+
+describe('${pascalName}Service', () => {
+  let service: ${pascalName}Service;
+
+  beforeEach(() => {
+    service = new ${pascalName}Service();
+  });
+
+  describe('getAll', () => {
+    it('should return all ${name}', async () => {
+      const result = await service.getAll();
+
+      expect(result).toBeDefined();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should apply pagination', async () => {
+      const result = await service.getAll({ page: 1, limit: 10 });
+
+      expect(result).toBeDefined();
+      expect(result.length).toBeLessThanOrEqual(10);
+    });
+  });
+
+  describe('getById', () => {
+    it('should return a ${camelName} by id', async () => {
+      // TODO: Create test ${camelName} first
+      const id = '1';
+      const result = await service.getById(id);
+
+      expect(result).toBeDefined();
+      expect(result.id).toBe(id);
+    });
+
+    it('should return null for non-existent id', async () => {
+      const result = await service.getById('999999');
+
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('create', () => {
+    it('should create a new ${camelName}', async () => {
+      const data = {
+        // TODO: Add required fields
+      };
+
+      const result = await service.create(data);
+
+      expect(result).toBeDefined();
+      expect(result.id).toBeDefined();
+    });
+
+    it('should throw error for invalid data', async () => {
+      await expect(service.create({} as any)).rejects.toThrow();
+    });
+  });
+
+  describe('update', () => {
+    it('should update a ${camelName}', async () => {
+      // TODO: Create test ${camelName} first
+      const id = '1';
+      const updates = {
+        // TODO: Add fields to update
+      };
+
+      const result = await service.update(id, updates);
+
+      expect(result).toBeDefined();
+      expect(result.id).toBe(id);
+    });
+
+    it('should return null for non-existent id', async () => {
+      const result = await service.update('999999', {});
+
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('delete', () => {
+    it('should delete a ${camelName}', async () => {
+      // TODO: Create test ${camelName} first
+      const id = '1';
+      const result = await service.delete(id);
+
+      expect(result).toBe(true);
+    });
+
+    it('should return false for non-existent id', async () => {
+      const result = await service.delete('999999');
+
+      expect(result).toBe(false);
+    });
+  });
+});
+`;
+}
+
+// src/cli/templates/integration-test.ts
+function integrationTestTemplate(name, pascalName, camelName) {
+  return `import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
+import { build } from '../../app.js';
+import { FastifyInstance } from 'fastify';
+import { prisma } from '../../lib/prisma.js';
+
+describe('${pascalName} Integration Tests', () => {
+  let app: FastifyInstance;
+
+  beforeAll(async () => {
+    app = await build();
+    await app.ready();
+  });
+
+  afterAll(async () => {
+    await app.close();
+    await prisma.$disconnect();
+  });
+
+  beforeEach(async () => {
+    // Clean up test data
+    // await prisma.${camelName}.deleteMany();
+  });
+
+  describe('Full CRUD workflow', () => {
+    it('should create, read, update, and delete a ${camelName}', async () => {
+      // Create
+      const createResponse = await app.inject({
+        method: 'POST',
+        url: '/${name}',
+        payload: {
+          // TODO: Add required fields
+        },
+      });
+
+      expect(createResponse.statusCode).toBe(201);
+      const created = createResponse.json().data;
+      expect(created.id).toBeDefined();
+
+      // Read
+      const readResponse = await app.inject({
+        method: 'GET',
+        url: \`/${name}/\${created.id}\`,
+      });
+
+      expect(readResponse.statusCode).toBe(200);
+      const read = readResponse.json().data;
+      expect(read.id).toBe(created.id);
+
+      // Update
+      const updateResponse = await app.inject({
+        method: 'PUT',
+        url: \`/${name}/\${created.id}\`,
+        payload: {
+          // TODO: Add fields to update
+        },
+      });
+
+      expect(updateResponse.statusCode).toBe(200);
+      const updated = updateResponse.json().data;
+      expect(updated.id).toBe(created.id);
+
+      // Delete
+      const deleteResponse = await app.inject({
+        method: 'DELETE',
+        url: \`/${name}/\${created.id}\`,
+      });
+
+      expect(deleteResponse.statusCode).toBe(204);
+
+      // Verify deletion
+      const verifyResponse = await app.inject({
+        method: 'GET',
+        url: \`/${name}/\${created.id}\`,
+      });
+
+      expect(verifyResponse.statusCode).toBe(404);
+    });
+  });
+
+  describe('List and pagination', () => {
+    it('should list ${name} with pagination', async () => {
+      // Create multiple ${name}
+      const count = 5;
+      for (let i = 0; i < count; i++) {
+        await app.inject({
+          method: 'POST',
+          url: '/${name}',
+          payload: {
+            // TODO: Add required fields
+          },
+        });
+      }
+
+      // Test pagination
+      const response = await app.inject({
+        method: 'GET',
+        url: '/${name}?page=1&limit=3',
+      });
+
+      expect(response.statusCode).toBe(200);
+      const result = response.json();
+      expect(result.data).toBeDefined();
+      expect(result.data.length).toBeLessThanOrEqual(3);
+      expect(result.total).toBeGreaterThanOrEqual(count);
+    });
+  });
+
+  describe('Validation', () => {
+    it('should validate required fields on create', async () => {
+      const response = await app.inject({
+        method: 'POST',
+        url: '/${name}',
+        payload: {},
+      });
+
+      expect(response.statusCode).toBe(400);
+      expect(response.json()).toHaveProperty('error');
+    });
+
+    it('should validate data types', async () => {
+      const response = await app.inject({
+        method: 'POST',
+        url: '/${name}',
+        payload: {
+          // TODO: Add invalid field types
+        },
+      });
+
+      expect(response.statusCode).toBe(400);
+    });
+  });
+});
+`;
+}
+
 // src/cli/commands/generate.ts
+function enableDryRunIfNeeded(options) {
+  const dryRun = DryRunManager.getInstance();
+  if (options.dryRun) {
+    dryRun.enable();
+    console.log(import_chalk5.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+  }
+}
+function showDryRunSummary(options) {
+  if (options.dryRun) {
+    DryRunManager.getInstance().printSummary();
+  }
+}
 var generateCommand = new import_commander2.Command("generate").alias("g").description("Generate resources (module, controller, service, etc.)");
 generateCommand.command("module <name> [fields...]").alias("m").description(
   "Generate a complete module with controller, service, repository, types, schemas, and routes"
-).option("--no-routes", "Skip routes generation").option("--no-repository", "Skip repository generation").option("--prisma", "Generate Prisma model suggestion").option("--validator <type>", "Validator type: zod, joi, yup", "zod").option("-i, --interactive", "Interactive mode to define fields").action(async (name, fieldsArgs, options) => {
+).option("--no-routes", "Skip routes generation").option("--no-repository", "Skip repository generation").option("--prisma", "Generate Prisma model suggestion").option("--validator <type>", "Validator type: zod, joi, yup", "zod").option("-i, --interactive", "Interactive mode to define fields").option("--with-tests", "Generate test files (__tests__ directory)").option("--dry-run", "Preview changes without writing files").action(async (name, fieldsArgs, options) => {
+  enableDryRunIfNeeded(options);
   let fields = [];
   if (options.interactive) {
     fields = await promptForFields();
@@ -1974,7 +2542,7 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
     const pluralName = pluralize(kebabName);
     const tableName = pluralize(kebabName.replace(/-/g, "_"));
     const validatorType = options.validator || "zod";
-    const moduleDir = import_path3.default.join(getModulesDir(), kebabName);
+    const moduleDir = import_path4.default.join(getModulesDir(), kebabName);
     if (await fileExists(moduleDir)) {
       spinner.stop();
       error(`Module "${kebabName}" already exists`);
@@ -2013,7 +2581,22 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
       });
     }
     for (const file of files) {
-      await writeFile(import_path3.default.join(moduleDir, file.name), file.content);
+      await writeFile(import_path4.default.join(moduleDir, file.name), file.content);
+    }
+    if (options.withTests) {
+      const testDir = import_path4.default.join(moduleDir, "__tests__");
+      await writeFile(
+        import_path4.default.join(testDir, `${kebabName}.controller.test.ts`),
+        controllerTestTemplate(kebabName, pascalName, camelName)
+      );
+      await writeFile(
+        import_path4.default.join(testDir, `${kebabName}.service.test.ts`),
+        serviceTestTemplate(kebabName, pascalName, camelName)
+      );
+      await writeFile(
+        import_path4.default.join(testDir, `${kebabName}.integration.test.ts`),
+        integrationTestTemplate(kebabName, pascalName, camelName)
+      );
     }
     spinner.succeed(`Module "${pascalName}" generated successfully!`);
     if (options.prisma || hasFields) {
@@ -2038,6 +2621,11 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
     }
     console.log("\n\u{1F4C1} Files created:");
     files.forEach((f) => success(`  src/modules/${kebabName}/${f.name}`));
+    if (options.withTests) {
+      success(`  src/modules/${kebabName}/__tests__/${kebabName}.controller.test.ts`);
+      success(`  src/modules/${kebabName}/__tests__/${kebabName}.service.test.ts`);
+      success(`  src/modules/${kebabName}/__tests__/${kebabName}.integration.test.ts`);
+    }
     console.log("\n\u{1F4CC} Next steps:");
     if (!hasFields) {
       info(`  1. Update the types in ${kebabName}.types.ts`);
@@ -2051,42 +2639,46 @@ generateCommand.command("module <name> [fields...]").alias("m").description(
       info(`  ${hasFields ? "3" : "4"}. Add the Prisma model to schema.prisma`);
       info(`  ${hasFields ? "4" : "5"}. Run: npm run db:migrate`);
     }
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate module");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("controller <name>").alias("c").description("Generate a controller").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("controller <name>").alias("c").description("Generate a controller").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating controller...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.controller.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.controller.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
-      error(`Controller "${kebabName}" already exists`);
+      displayError(ErrorTypes.FILE_ALREADY_EXISTS(`${kebabName}.controller.ts`));
       return;
     }
     await writeFile(filePath, controllerTemplate(kebabName, pascalName, camelName));
     spinner.succeed(`Controller "${pascalName}Controller" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.controller.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate controller");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("service <name>").alias("s").description("Generate a service").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("service <name>").alias("s").description("Generate a service").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating service...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.service.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.service.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Service "${kebabName}" already exists`);
@@ -2095,12 +2687,14 @@ generateCommand.command("service <name>").alias("s").description("Generate a ser
     await writeFile(filePath, serviceTemplate(kebabName, pascalName, camelName));
     spinner.succeed(`Service "${pascalName}Service" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.service.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate service");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("repository <name>").alias("r").description("Generate a repository").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("repository <name>").alias("r").description("Generate a repository").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating repository...").start();
   try {
     const kebabName = toKebabCase(name);
@@ -2108,8 +2702,8 @@ generateCommand.command("repository <name>").alias("r").description("Generate a
     const camelName = toCamelCase(name);
     const pluralName = pluralize(kebabName);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.repository.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.repository.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Repository "${kebabName}" already exists`);
@@ -2118,19 +2712,21 @@ generateCommand.command("repository <name>").alias("r").description("Generate a
     await writeFile(filePath, repositoryTemplate(kebabName, pascalName, camelName, pluralName));
     spinner.succeed(`Repository "${pascalName}Repository" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.repository.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate repository");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("types <name>").alias("t").description("Generate types/interfaces").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("types <name>").alias("t").description("Generate types/interfaces").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating types...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.types.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.types.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Types file "${kebabName}.types.ts" already exists`);
@@ -2139,20 +2735,22 @@ generateCommand.command("types <name>").alias("t").description("Generate types/i
     await writeFile(filePath, typesTemplate(kebabName, pascalName));
     spinner.succeed(`Types for "${pascalName}" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.types.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate types");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("schema <name>").alias("v").description("Generate validation schemas").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("schema <name>").alias("v").description("Generate validation schemas").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating schemas...").start();
   try {
     const kebabName = toKebabCase(name);
     const pascalName = toPascalCase(name);
     const camelName = toCamelCase(name);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.schemas.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.schemas.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Schemas file "${kebabName}.schemas.ts" already exists`);
@@ -2161,12 +2759,14 @@ generateCommand.command("schema <name>").alias("v").description("Generate valida
     await writeFile(filePath, schemasTemplate(kebabName, pascalName, camelName));
     spinner.succeed(`Schemas for "${pascalName}" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.schemas.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate schemas");
     error(err instanceof Error ? err.message : String(err));
   }
 });
-generateCommand.command("routes <name>").description("Generate routes").option("-m, --module <module>", "Target module name").action(async (name, options) => {
+generateCommand.command("routes <name>").description("Generate routes").option("-m, --module <module>", "Target module name").option("--dry-run", "Preview changes without writing files").action(async (name, options) => {
+  enableDryRunIfNeeded(options);
   const spinner = (0, import_ora2.default)("Generating routes...").start();
   try {
     const kebabName = toKebabCase(name);
@@ -2174,8 +2774,8 @@ generateCommand.command("routes <name>").description("Generate routes").option("
     const camelName = toCamelCase(name);
     const pluralName = pluralize(kebabName);
     const moduleName = options.module ? toKebabCase(options.module) : kebabName;
-    const moduleDir = import_path3.default.join(getModulesDir(), moduleName);
-    const filePath = import_path3.default.join(moduleDir, `${kebabName}.routes.ts`);
+    const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+    const filePath = import_path4.default.join(moduleDir, `${kebabName}.routes.ts`);
     if (await fileExists(filePath)) {
       spinner.stop();
       error(`Routes file "${kebabName}.routes.ts" already exists`);
@@ -2184,6 +2784,7 @@ generateCommand.command("routes <name>").description("Generate routes").option("
     await writeFile(filePath, routesTemplate(kebabName, pascalName, camelName, pluralName));
     spinner.succeed(`Routes for "${pascalName}" generated!`);
     success(`  src/modules/${moduleName}/${kebabName}.routes.ts`);
+    showDryRunSummary(options);
   } catch (err) {
     spinner.fail("Failed to generate routes");
     error(err instanceof Error ? err.message : String(err));
@@ -2262,21 +2863,21 @@ async function promptForFields() {
 
 // src/cli/commands/add-module.ts
 var import_commander3 = require("commander");
-var import_path4 = __toESM(require("path"), 1);
+var import_path5 = __toESM(require("path"), 1);
 var import_ora3 = __toESM(require("ora"), 1);
-var import_chalk4 = __toESM(require("chalk"), 1);
+var import_chalk7 = __toESM(require("chalk"), 1);
 var fs5 = __toESM(require("fs/promises"), 1);
 
 // src/cli/utils/env-manager.ts
 var fs3 = __toESM(require("fs/promises"), 1);
-var path4 = __toESM(require("path"), 1);
+var path5 = __toESM(require("path"), 1);
 var import_fs = require("fs");
 var EnvManager = class {
   envPath;
   envExamplePath;
   constructor(projectRoot) {
-    this.envPath = path4.join(projectRoot, ".env");
-    this.envExamplePath = path4.join(projectRoot, ".env.example");
+    this.envPath = path5.join(projectRoot, ".env");
+    this.envExamplePath = path5.join(projectRoot, ".env.example");
   }
   /**
    * Add environment variables to .env file
@@ -2927,15 +3528,15 @@ var EnvManager = class {
 
 // src/cli/utils/template-manager.ts
 var fs4 = __toESM(require("fs/promises"), 1);
-var path5 = __toESM(require("path"), 1);
+var path6 = __toESM(require("path"), 1);
 var import_crypto = require("crypto");
 var import_fs2 = require("fs");
 var TemplateManager = class {
   templatesDir;
   manifestsDir;
   constructor(projectRoot) {
-    this.templatesDir = path5.join(projectRoot, ".servcraft", "templates");
-    this.manifestsDir = path5.join(projectRoot, ".servcraft", "manifests");
+    this.templatesDir = path6.join(projectRoot, ".servcraft", "templates");
+    this.manifestsDir = path6.join(projectRoot, ".servcraft", "manifests");
   }
   /**
    * Initialize template system
@@ -2949,10 +3550,10 @@ var TemplateManager = class {
    */
   async saveTemplate(moduleName, files) {
     await this.initialize();
-    const moduleTemplateDir = path5.join(this.templatesDir, moduleName);
+    const moduleTemplateDir = path6.join(this.templatesDir, moduleName);
     await fs4.mkdir(moduleTemplateDir, { recursive: true });
     for (const [fileName, content] of Object.entries(files)) {
-      const filePath = path5.join(moduleTemplateDir, fileName);
+      const filePath = path6.join(moduleTemplateDir, fileName);
       await fs4.writeFile(filePath, content, "utf-8");
     }
   }
@@ -2961,7 +3562,7 @@ var TemplateManager = class {
    */
   async getTemplate(moduleName, fileName) {
     try {
-      const filePath = path5.join(this.templatesDir, moduleName, fileName);
+      const filePath = path6.join(this.templatesDir, moduleName, fileName);
       return await fs4.readFile(filePath, "utf-8");
     } catch {
       return null;
@@ -2986,7 +3587,7 @@ var TemplateManager = class {
       installedAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
     };
-    const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+    const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
     await fs4.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
   /**
@@ -2994,7 +3595,7 @@ var TemplateManager = class {
    */
   async getManifest(moduleName) {
     try {
-      const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+      const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
       const content = await fs4.readFile(manifestPath, "utf-8");
       return JSON.parse(content);
     } catch {
@@ -3023,7 +3624,7 @@ var TemplateManager = class {
     }
     const results = [];
     for (const [fileName, fileInfo] of Object.entries(manifest.files)) {
-      const filePath = path5.join(moduleDir, fileName);
+      const filePath = path6.join(moduleDir, fileName);
       if (!(0, import_fs2.existsSync)(filePath)) {
         results.push({
           fileName,
@@ -3049,7 +3650,7 @@ var TemplateManager = class {
    */
   async createBackup(moduleName, moduleDir) {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").substring(0, 19);
-    const backupDir = path5.join(path5.dirname(moduleDir), `${moduleName}.backup-${timestamp}`);
+    const backupDir = path6.join(path6.dirname(moduleDir), `${moduleName}.backup-${timestamp}`);
     await this.copyDirectory(moduleDir, backupDir);
     return backupDir;
   }
@@ -3060,8 +3661,8 @@ var TemplateManager = class {
     await fs4.mkdir(dest, { recursive: true });
     const entries = await fs4.readdir(src, { withFileTypes: true });
     for (const entry of entries) {
-      const srcPath = path5.join(src, entry.name);
-      const destPath = path5.join(dest, entry.name);
+      const srcPath = path6.join(src, entry.name);
+      const destPath = path6.join(dest, entry.name);
       if (entry.isDirectory()) {
         await this.copyDirectory(srcPath, destPath);
       } else {
@@ -3162,23 +3763,23 @@ var TemplateManager = class {
     }
     manifest.files = fileHashes;
     manifest.updatedAt = /* @__PURE__ */ new Date();
-    const manifestPath = path5.join(this.manifestsDir, `${moduleName}.json`);
+    const manifestPath = path6.join(this.manifestsDir, `${moduleName}.json`);
     await fs4.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
   }
 };
 
 // src/cli/utils/interactive-prompt.ts
 var import_inquirer3 = __toESM(require("inquirer"), 1);
-var import_chalk3 = __toESM(require("chalk"), 1);
+var import_chalk6 = __toESM(require("chalk"), 1);
 var InteractivePrompt = class {
   /**
    * Ask what to do when module already exists
    */
   static async askModuleExists(moduleName, hasModifications) {
-    console.log(import_chalk3.default.yellow(`
+    console.log(import_chalk6.default.yellow(`
 \u26A0\uFE0F  Module "${moduleName}" already exists`));
     if (hasModifications) {
-      console.log(import_chalk3.default.yellow("   Some files have been modified by you.\n"));
+      console.log(import_chalk6.default.yellow("   Some files have been modified by you.\n"));
     }
     const { action } = await import_inquirer3.default.prompt([
       {
@@ -3216,12 +3817,12 @@ var InteractivePrompt = class {
    * Ask what to do with a specific file
    */
   static async askFileAction(fileName, isModified, yourLines, newLines) {
-    console.log(import_chalk3.default.cyan(`
+    console.log(import_chalk6.default.cyan(`
 \u{1F4C1} ${fileName}`));
     console.log(
-      import_chalk3.default.gray(`   Your version: ${yourLines} lines${isModified ? " (modified)" : ""}`)
+      import_chalk6.default.gray(`   Your version: ${yourLines} lines${isModified ? " (modified)" : ""}`)
     );
-    console.log(import_chalk3.default.gray(`   New version: ${newLines} lines
+    console.log(import_chalk6.default.gray(`   New version: ${newLines} lines
 `));
     const { action } = await import_inquirer3.default.prompt([
       {
@@ -3273,7 +3874,7 @@ var InteractivePrompt = class {
    * Display diff and ask to continue
    */
   static async showDiffAndAsk(diff) {
-    console.log(import_chalk3.default.cyan("\n\u{1F4CA} Differences:\n"));
+    console.log(import_chalk6.default.cyan("\n\u{1F4CA} Differences:\n"));
     console.log(diff);
     return await this.confirm("\nDo you want to proceed with this change?", true);
   }
@@ -3281,41 +3882,41 @@ var InteractivePrompt = class {
    * Display merge conflicts
    */
   static displayConflicts(conflicts) {
-    console.log(import_chalk3.default.red("\n\u26A0\uFE0F  Merge Conflicts Detected:\n"));
+    console.log(import_chalk6.default.red("\n\u26A0\uFE0F  Merge Conflicts Detected:\n"));
     conflicts.forEach((conflict, i) => {
-      console.log(import_chalk3.default.yellow(`   ${i + 1}. ${conflict}`));
+      console.log(import_chalk6.default.yellow(`   ${i + 1}. ${conflict}`));
     });
-    console.log(import_chalk3.default.gray("\n   Conflict markers have been added to the file:"));
-    console.log(import_chalk3.default.gray("   <<<<<<< YOUR VERSION"));
-    console.log(import_chalk3.default.gray("   ... your code ..."));
-    console.log(import_chalk3.default.gray("   ======="));
-    console.log(import_chalk3.default.gray("   ... new code ..."));
-    console.log(import_chalk3.default.gray("   >>>>>>> NEW VERSION\n"));
+    console.log(import_chalk6.default.gray("\n   Conflict markers have been added to the file:"));
+    console.log(import_chalk6.default.gray("   <<<<<<< YOUR VERSION"));
+    console.log(import_chalk6.default.gray("   ... your code ..."));
+    console.log(import_chalk6.default.gray("   ======="));
+    console.log(import_chalk6.default.gray("   ... new code ..."));
+    console.log(import_chalk6.default.gray("   >>>>>>> NEW VERSION\n"));
   }
   /**
    * Show backup location
    */
   static showBackupCreated(backupPath) {
-    console.log(import_chalk3.default.green(`
-\u2713 Backup created: ${import_chalk3.default.cyan(backupPath)}`));
+    console.log(import_chalk6.default.green(`
+\u2713 Backup created: ${import_chalk6.default.cyan(backupPath)}`));
   }
   /**
    * Show merge summary
    */
   static showMergeSummary(stats) {
-    console.log(import_chalk3.default.bold("\n\u{1F4CA} Merge Summary:\n"));
+    console.log(import_chalk6.default.bold("\n\u{1F4CA} Merge Summary:\n"));
     if (stats.merged > 0) {
-      console.log(import_chalk3.default.green(`   \u2713 Merged: ${stats.merged} file(s)`));
+      console.log(import_chalk6.default.green(`   \u2713 Merged: ${stats.merged} file(s)`));
     }
     if (stats.kept > 0) {
-      console.log(import_chalk3.default.blue(`   \u2192 Kept: ${stats.kept} file(s)`));
+      console.log(import_chalk6.default.blue(`   \u2192 Kept: ${stats.kept} file(s)`));
     }
     if (stats.overwritten > 0) {
-      console.log(import_chalk3.default.yellow(`   \u26A0 Overwritten: ${stats.overwritten} file(s)`));
+      console.log(import_chalk6.default.yellow(`   \u26A0 Overwritten: ${stats.overwritten} file(s)`));
     }
     if (stats.conflicts > 0) {
-      console.log(import_chalk3.default.red(`   \u26A0 Conflicts: ${stats.conflicts} file(s)`));
-      console.log(import_chalk3.default.gray("\n   Please resolve conflicts manually before committing.\n"));
+      console.log(import_chalk6.default.red(`   \u26A0 Conflicts: ${stats.conflicts} file(s)`));
+      console.log(import_chalk6.default.gray("\n   Please resolve conflicts manually before committing.\n"));
     }
   }
   /**
@@ -3487,31 +4088,40 @@ var AVAILABLE_MODULES = {
 var addModuleCommand = new import_commander3.Command("add").description("Add a pre-built module to your project").argument(
   "[module]",
   "Module to add (auth, users, email, audit, upload, cache, notifications, settings)"
-).option("-l, --list", "List available modules").option("-f, --force", "Force overwrite existing module").option("-u, --update", "Update existing module (smart merge)").option("--skip-existing", "Skip if module already exists").action(
+).option("-l, --list", "List available modules").option("-f, --force", "Force overwrite existing module").option("-u, --update", "Update existing module (smart merge)").option("--skip-existing", "Skip if module already exists").option("--dry-run", "Preview changes without writing files").action(
   async (moduleName, options) => {
     if (options?.list || !moduleName) {
-      console.log(import_chalk4.default.bold("\n\u{1F4E6} Available Modules:\n"));
+      console.log(import_chalk7.default.bold("\n\u{1F4E6} Available Modules:\n"));
       for (const [key, mod] of Object.entries(AVAILABLE_MODULES)) {
-        console.log(`  ${import_chalk4.default.cyan(key.padEnd(15))} ${mod.name}`);
-        console.log(`  ${" ".repeat(15)} ${import_chalk4.default.gray(mod.description)}
+        console.log(`  ${import_chalk7.default.cyan(key.padEnd(15))} ${mod.name}`);
+        console.log(`  ${" ".repeat(15)} ${import_chalk7.default.gray(mod.description)}
 `);
       }
-      console.log(import_chalk4.default.bold("Usage:"));
-      console.log(`  ${import_chalk4.default.yellow("servcraft add auth")}      Add authentication module`);
-      console.log(`  ${import_chalk4.default.yellow("servcraft add users")}     Add user management module`);
-      console.log(`  ${import_chalk4.default.yellow("servcraft add email")}     Add email service module
+      console.log(import_chalk7.default.bold("Usage:"));
+      console.log(`  ${import_chalk7.default.yellow("servcraft add auth")}      Add authentication module`);
+      console.log(`  ${import_chalk7.default.yellow("servcraft add users")}     Add user management module`);
+      console.log(`  ${import_chalk7.default.yellow("servcraft add email")}     Add email service module
 `);
       return;
     }
+    const dryRun = DryRunManager.getInstance();
+    if (options?.dryRun) {
+      dryRun.enable();
+      console.log(import_chalk7.default.yellow("\n\u26A0 DRY RUN MODE - No files will be written\n"));
+    }
     const module2 = AVAILABLE_MODULES[moduleName];
     if (!module2) {
-      error(`Unknown module: ${moduleName}`);
-      info('Run "servcraft add --list" to see available modules');
+      displayError(ErrorTypes.MODULE_NOT_FOUND(moduleName));
+      return;
+    }
+    const projectError = validateProject();
+    if (projectError) {
+      displayError(projectError);
       return;
     }
     const spinner = (0, import_ora3.default)(`Adding ${module2.name} module...`).start();
     try {
-      const moduleDir = import_path4.default.join(getModulesDir(), moduleName);
+      const moduleDir = import_path5.default.join(getModulesDir(), moduleName);
       const templateManager = new TemplateManager(process.cwd());
       const moduleExists = await fileExists(moduleDir);
       if (moduleExists) {
@@ -3579,16 +4189,16 @@ var addModuleCommand = new import_commander3.Command("add").description("Add a p
             info("\n\u{1F4DD} Created new .env file");
           }
           if (result.added.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u2705 Added to .env:"));
+            console.log(import_chalk7.default.bold("\n\u2705 Added to .env:"));
             result.added.forEach((key) => success(`  ${key}`));
           }
           if (result.skipped.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u23ED\uFE0F  Already in .env (skipped):"));
+            console.log(import_chalk7.default.bold("\n\u23ED\uFE0F  Already in .env (skipped):"));
             result.skipped.forEach((key) => info(`  ${key}`));
           }
           const requiredVars = envSections.flatMap((section) => section.variables).filter((v) => v.required && !v.value).map((v) => v.key);
           if (requiredVars.length > 0) {
-            console.log(import_chalk4.default.bold("\n\u26A0\uFE0F  Required configuration:"));
+            console.log(import_chalk7.default.bold("\n\u26A0\uFE0F  Required configuration:"));
             requiredVars.forEach((key) => warn(`  ${key} - Please configure this variable`));
           }
         } catch (err) {
@@ -3596,10 +4206,15 @@ var addModuleCommand = new import_commander3.Command("add").description("Add a p
           error(err instanceof Error ? err.message : String(err));
         }
       }
-      console.log("\n\u{1F4CC} Next steps:");
-      info("  1. Configure environment variables in .env (if needed)");
-      info("  2. Register the module in your main app file");
-      info("  3. Run database migrations if needed");
+      if (!options?.dryRun) {
+        console.log("\n\u{1F4CC} Next steps:");
+        info("  1. Configure environment variables in .env (if needed)");
+        info("  2. Register the module in your main app file");
+        info("  3. Run database migrations if needed");
+      }
+      if (options?.dryRun) {
+        dryRun.printSummary();
+      }
     } catch (err) {
       spinner.fail("Failed to add module");
       error(err instanceof Error ? err.message : String(err));
@@ -3650,7 +4265,7 @@ export * from './auth.schemas.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateUsersModule(dir) {
@@ -3690,7 +4305,7 @@ export * from './user.schemas.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateEmailModule(dir) {
@@ -3747,7 +4362,7 @@ export { EmailService, emailService } from './email.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateAuditModule(dir) {
@@ -3791,7 +4406,7 @@ export { AuditService, auditService } from './audit.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateUploadModule(dir) {
@@ -3817,7 +4432,7 @@ export interface UploadOptions {
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateCacheModule(dir) {
@@ -3863,7 +4478,7 @@ export { CacheService, cacheService } from './cache.service.js';
 `
   };
   for (const [name, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, name), content);
+    await writeFile(import_path5.default.join(dir, name), content);
   }
 }
 async function generateGenericModule(dir, name) {
@@ -3877,18 +4492,18 @@ export interface ${name.charAt(0).toUpperCase() + name.slice(1)}Data {
 `
   };
   for (const [fileName, content] of Object.entries(files)) {
-    await writeFile(import_path4.default.join(dir, fileName), content);
+    await writeFile(import_path5.default.join(dir, fileName), content);
   }
 }
 async function findServercraftModules() {
-  const scriptDir = import_path4.default.dirname(new URL(importMetaUrl).pathname);
+  const scriptDir = import_path5.default.dirname(new URL(importMetaUrl).pathname);
   const possiblePaths = [
     // Local node_modules (when servcraft is a dependency)
-    import_path4.default.join(process.cwd(), "node_modules", "servcraft", "src", "modules"),
+    import_path5.default.join(process.cwd(), "node_modules", "servcraft", "src", "modules"),
     // From dist/cli/index.js -> src/modules (npx or global install)
-    import_path4.default.resolve(scriptDir, "..", "..", "src", "modules"),
+    import_path5.default.resolve(scriptDir, "..", "..", "src", "modules"),
     // From src/cli/commands/add-module.ts -> src/modules (development)
-    import_path4.default.resolve(scriptDir, "..", "..", "modules")
+    import_path5.default.resolve(scriptDir, "..", "..", "modules")
   ];
   for (const p of possiblePaths) {
     try {
@@ -3912,7 +4527,7 @@ async function generateModuleFiles(moduleName, moduleDir) {
   const sourceDirName = moduleNameMap[moduleName] || moduleName;
   const servercraftModulesDir = await findServercraftModules();
   if (servercraftModulesDir) {
-    const sourceModuleDir = import_path4.default.join(servercraftModulesDir, sourceDirName);
+    const sourceModuleDir = import_path5.default.join(servercraftModulesDir, sourceDirName);
     if (await fileExists(sourceModuleDir)) {
       await copyModuleFromSource(sourceModuleDir, moduleDir);
       return;
@@ -3944,8 +4559,8 @@ async function generateModuleFiles(moduleName, moduleDir) {
 async function copyModuleFromSource(sourceDir, targetDir) {
   const entries = await fs5.readdir(sourceDir, { withFileTypes: true });
   for (const entry of entries) {
-    const sourcePath = import_path4.default.join(sourceDir, entry.name);
-    const targetPath = import_path4.default.join(targetDir, entry.name);
+    const sourcePath = import_path5.default.join(sourceDir, entry.name);
+    const targetPath = import_path5.default.join(targetDir, entry.name);
     if (entry.isDirectory()) {
       await fs5.mkdir(targetPath, { recursive: true });
       await copyModuleFromSource(sourcePath, targetPath);
@@ -3958,7 +4573,7 @@ async function getModuleFiles(moduleName, moduleDir) {
   const files = {};
   const entries = await fs5.readdir(moduleDir);
   for (const entry of entries) {
-    const filePath = import_path4.default.join(moduleDir, entry);
+    const filePath = import_path5.default.join(moduleDir, entry);
     const stat2 = await fs5.stat(filePath);
     if (stat2.isFile() && entry.endsWith(".ts")) {
       const content = await fs5.readFile(filePath, "utf-8");
@@ -3969,14 +4584,14 @@ async function getModuleFiles(moduleName, moduleDir) {
 }
 async function showDiffForModule(templateManager, moduleName, moduleDir) {
   const modifiedFiles = await templateManager.getModifiedFiles(moduleName, moduleDir);
-  console.log(import_chalk4.default.cyan(`
+  console.log(import_chalk7.default.cyan(`
 \u{1F4CA} Changes in module "${moduleName}":
 `));
   for (const file of modifiedFiles) {
     if (file.isModified) {
-      console.log(import_chalk4.default.yellow(`
+      console.log(import_chalk7.default.yellow(`
 \u{1F4C4} ${file.fileName}:`));
-      const currentPath = import_path4.default.join(moduleDir, file.fileName);
+      const currentPath = import_path5.default.join(moduleDir, file.fileName);
       const currentContent = await fs5.readFile(currentPath, "utf-8");
       const originalContent = await templateManager.getTemplate(moduleName, file.fileName);
       if (originalContent) {
@@ -3989,11 +4604,11 @@ async function showDiffForModule(templateManager, moduleName, moduleDir) {
 async function performSmartMerge(templateManager, moduleName, moduleDir, _displayName) {
   const spinner = (0, import_ora3.default)("Analyzing files for merge...").start();
   const newFiles = {};
-  const templateDir = import_path4.default.join(templateManager["templatesDir"], moduleName);
+  const templateDir = import_path5.default.join(templateManager["templatesDir"], moduleName);
   try {
     const entries = await fs5.readdir(templateDir);
     for (const entry of entries) {
-      const content = await fs5.readFile(import_path4.default.join(templateDir, entry), "utf-8");
+      const content = await fs5.readFile(import_path5.default.join(templateDir, entry), "utf-8");
       newFiles[entry] = content;
     }
   } catch {
@@ -4011,7 +4626,7 @@ async function performSmartMerge(templateManager, moduleName, moduleDir, _displa
   };
   for (const fileInfo of modifiedFiles) {
     const fileName = fileInfo.fileName;
-    const filePath = import_path4.default.join(moduleDir, fileName);
+    const filePath = import_path5.default.join(moduleDir, fileName);
     const newContent = newFiles[fileName];
     if (!newContent) {
       continue;
@@ -4083,7 +4698,7 @@ async function performSmartMerge(templateManager, moduleName, moduleDir, _displa
 var import_commander4 = require("commander");
 var import_child_process2 = require("child_process");
 var import_ora4 = __toESM(require("ora"), 1);
-var import_chalk5 = __toESM(require("chalk"), 1);
+var import_chalk8 = __toESM(require("chalk"), 1);
 var dbCommand = new import_commander4.Command("db").description("Database management commands");
 dbCommand.command("migrate").description("Run database migrations").option("-n, --name <name>", "Migration name").action(async (options) => {
   const spinner = (0, import_ora4.default)("Running migrations...").start();
@@ -4140,7 +4755,7 @@ dbCommand.command("seed").description("Run database seed").action(async () => {
 });
 dbCommand.command("reset").description("Reset database (drop all data and re-run migrations)").option("-f, --force", "Skip confirmation").action(async (options) => {
   if (!options.force) {
-    console.log(import_chalk5.default.yellow("\n\u26A0\uFE0F  WARNING: This will delete all data in your database!\n"));
+    console.log(import_chalk8.default.yellow("\n\u26A0\uFE0F  WARNING: This will delete all data in your database!\n"));
     const readline = await import("readline");
     const rl = readline.createInterface({
       input: process.stdin,
@@ -4174,14 +4789,14 @@ dbCommand.command("status").description("Show migration status").action(async ()
 
 // src/cli/commands/docs.ts
 var import_commander5 = require("commander");
-var import_path6 = __toESM(require("path"), 1);
+var import_path7 = __toESM(require("path"), 1);
 var import_promises4 = __toESM(require("fs/promises"), 1);
 var import_ora6 = __toESM(require("ora"), 1);
-var import_chalk6 = __toESM(require("chalk"), 1);
+var import_chalk9 = __toESM(require("chalk"), 1);
 
 // src/cli/utils/docs-generator.ts
 var import_promises3 = __toESM(require("fs/promises"), 1);
-var import_path5 = __toESM(require("path"), 1);
+var import_path6 = __toESM(require("path"), 1);
 var import_ora5 = __toESM(require("ora"), 1);
 
 // src/core/server.ts
@@ -4902,11 +5517,11 @@ function validateQuery(schema, data) {
 function formatZodErrors(error2) {
   const errors = {};
   for (const issue of error2.issues) {
-    const path9 = issue.path.join(".") || "root";
-    if (!errors[path9]) {
-      errors[path9] = [];
+    const path12 = issue.path.join(".") || "root";
+    if (!errors[path12]) {
+      errors[path12] = [];
     }
-    errors[path9].push(issue.message);
+    errors[path12].push(issue.message);
   }
   return errors;
 }
@@ -5739,8 +6354,8 @@ async function generateDocs(outputPath = "openapi.json", silent = false) {
     await registerUserModule(app, authService);
     await app.ready();
     const spec = app.swagger();
-    const absoluteOutput = import_path5.default.resolve(outputPath);
-    await import_promises3.default.mkdir(import_path5.default.dirname(absoluteOutput), { recursive: true });
+    const absoluteOutput = import_path6.default.resolve(outputPath);
+    await import_promises3.default.mkdir(import_path6.default.dirname(absoluteOutput), { recursive: true });
     await import_promises3.default.writeFile(absoluteOutput, JSON.stringify(spec, null, 2), "utf8");
     spinner?.succeed(`OpenAPI spec generated at ${absoluteOutput}`);
     await app.close();
@@ -5785,7 +6400,7 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
   const spinner = (0, import_ora6.default)("Exporting documentation...").start();
   try {
     const projectRoot = getProjectRoot();
-    const specPath = import_path6.default.join(projectRoot, "openapi.json");
+    const specPath = import_path7.default.join(projectRoot, "openapi.json");
     try {
       await import_promises4.default.access(specPath);
     } catch {
@@ -5812,7 +6427,7 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
       default:
         throw new Error(`Unknown format: ${options.format}`);
     }
-    const outPath = import_path6.default.join(projectRoot, options.output || defaultName);
+    const outPath = import_path7.default.join(projectRoot, options.output || defaultName);
     await import_promises4.default.writeFile(outPath, output);
     spinner.succeed(`Exported to: ${options.output || defaultName}`);
     if (options.format === "postman") {
@@ -5825,8 +6440,8 @@ docsCommand.command("export").description("Export documentation to Postman, Inso
 });
 docsCommand.command("status").description("Show documentation status").action(async () => {
   const projectRoot = getProjectRoot();
-  console.log(import_chalk6.default.bold("\n\u{1F4CA} Documentation Status\n"));
-  const specPath = import_path6.default.join(projectRoot, "openapi.json");
+  console.log(import_chalk9.default.bold("\n\u{1F4CA} Documentation Status\n"));
+  const specPath = import_path7.default.join(projectRoot, "openapi.json");
   try {
     const stat2 = await import_promises4.default.stat(specPath);
     success(
@@ -5941,13 +6556,736 @@ function formatDate(date) {
   });
 }
 
+// src/cli/commands/list.ts
+var import_commander6 = require("commander");
+var import_chalk10 = __toESM(require("chalk"), 1);
+var import_promises5 = __toESM(require("fs/promises"), 1);
+var AVAILABLE_MODULES2 = {
+  // Core
+  auth: {
+    name: "Authentication",
+    description: "JWT authentication with access/refresh tokens",
+    category: "Core"
+  },
+  users: {
+    name: "User Management",
+    description: "User CRUD with RBAC (roles & permissions)",
+    category: "Core"
+  },
+  email: {
+    name: "Email Service",
+    description: "SMTP email with templates (Handlebars)",
+    category: "Core"
+  },
+  // Security
+  mfa: {
+    name: "MFA/TOTP",
+    description: "Two-factor authentication with QR codes",
+    category: "Security"
+  },
+  oauth: {
+    name: "OAuth",
+    description: "Social login (Google, GitHub, Facebook, Twitter, Apple)",
+    category: "Security"
+  },
+  "rate-limit": {
+    name: "Rate Limiting",
+    description: "Advanced rate limiting with multiple algorithms",
+    category: "Security"
+  },
+  // Data & Storage
+  cache: {
+    name: "Redis Cache",
+    description: "Redis caching with TTL & invalidation",
+    category: "Data & Storage"
+  },
+  upload: {
+    name: "File Upload",
+    description: "File upload with local/S3/Cloudinary storage",
+    category: "Data & Storage"
+  },
+  search: {
+    name: "Search",
+    description: "Full-text search with Elasticsearch/Meilisearch",
+    category: "Data & Storage"
+  },
+  // Communication
+  notification: {
+    name: "Notifications",
+    description: "Email, SMS, Push notifications",
+    category: "Communication"
+  },
+  webhook: {
+    name: "Webhooks",
+    description: "Outgoing webhooks with HMAC signatures & retry",
+    category: "Communication"
+  },
+  websocket: {
+    name: "WebSockets",
+    description: "Real-time communication with Socket.io",
+    category: "Communication"
+  },
+  // Background Processing
+  queue: {
+    name: "Queue/Jobs",
+    description: "Background jobs with Bull/BullMQ & cron scheduling",
+    category: "Background Processing"
+  },
+  "media-processing": {
+    name: "Media Processing",
+    description: "Image/video processing with FFmpeg",
+    category: "Background Processing"
+  },
+  // Monitoring & Analytics
+  audit: {
+    name: "Audit Logs",
+    description: "Activity logging and audit trail",
+    category: "Monitoring & Analytics"
+  },
+  analytics: {
+    name: "Analytics/Metrics",
+    description: "Prometheus metrics & event tracking",
+    category: "Monitoring & Analytics"
+  },
+  // Internationalization
+  i18n: {
+    name: "i18n/Localization",
+    description: "Multi-language support with 7+ locales",
+    category: "Internationalization"
+  },
+  // API Management
+  "feature-flag": {
+    name: "Feature Flags",
+    description: "A/B testing & progressive rollout",
+    category: "API Management"
+  },
+  "api-versioning": {
+    name: "API Versioning",
+    description: "Multiple API versions support",
+    category: "API Management"
+  },
+  // Payments
+  payment: {
+    name: "Payments",
+    description: "Payment processing (Stripe, PayPal, Mobile Money)",
+    category: "Payments"
+  }
+};
+async function getInstalledModules() {
+  try {
+    const modulesDir = getModulesDir();
+    const entries = await import_promises5.default.readdir(modulesDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+function isServercraftProject() {
+  try {
+    getProjectRoot();
+    return true;
+  } catch {
+    return false;
+  }
+}
+var listCommand = new import_commander6.Command("list").alias("ls").description("List available and installed modules").option("-a, --available", "Show only available modules").option("-i, --installed", "Show only installed modules").option("-c, --category <category>", "Filter by category").option("--json", "Output as JSON").action(
+  async (options) => {
+    const installedModules = await getInstalledModules();
+    const isProject = isServercraftProject();
+    if (options.json) {
+      const output = {
+        available: Object.entries(AVAILABLE_MODULES2).map(([key, mod]) => ({
+          id: key,
+          ...mod,
+          installed: installedModules.includes(key)
+        }))
+      };
+      if (isProject) {
+        output.installed = installedModules;
+      }
+      console.log(JSON.stringify(output, null, 2));
+      return;
+    }
+    const byCategory = {};
+    for (const [key, mod] of Object.entries(AVAILABLE_MODULES2)) {
+      if (options.category && mod.category.toLowerCase() !== options.category.toLowerCase()) {
+        continue;
+      }
+      if (!byCategory[mod.category]) {
+        byCategory[mod.category] = [];
+      }
+      byCategory[mod.category]?.push({
+        id: key,
+        name: mod.name,
+        description: mod.description,
+        installed: installedModules.includes(key)
+      });
+    }
+    if (options.installed) {
+      if (!isProject) {
+        console.log(import_chalk10.default.yellow("\n\u26A0 Not in a Servcraft project directory\n"));
+        return;
+      }
+      console.log(import_chalk10.default.bold("\n\u{1F4E6} Installed Modules:\n"));
+      if (installedModules.length === 0) {
+        console.log(import_chalk10.default.gray("  No modules installed yet.\n"));
+        console.log(`  Run ${import_chalk10.default.cyan("servcraft add <module>")} to add a module.
+`);
+        return;
+      }
+      for (const modId of installedModules) {
+        const mod = AVAILABLE_MODULES2[modId];
+        if (mod) {
+          console.log(`  ${import_chalk10.default.green("\u2713")} ${import_chalk10.default.cyan(modId.padEnd(18))} ${mod.name}`);
+        } else {
+          console.log(
+            `  ${import_chalk10.default.green("\u2713")} ${import_chalk10.default.cyan(modId.padEnd(18))} ${import_chalk10.default.gray("(custom module)")}`
+          );
+        }
+      }
+      console.log(`
+  Total: ${import_chalk10.default.bold(installedModules.length)} module(s) installed
+`);
+      return;
+    }
+    console.log(import_chalk10.default.bold("\n\u{1F4E6} Available Modules\n"));
+    if (isProject) {
+      console.log(
+        import_chalk10.default.gray(`  ${import_chalk10.default.green("\u2713")} = installed    ${import_chalk10.default.dim("\u25CB")} = not installed
+`)
+      );
+    }
+    for (const [category, modules] of Object.entries(byCategory)) {
+      console.log(import_chalk10.default.bold.blue(`  ${category}`));
+      console.log(import_chalk10.default.gray("  " + "\u2500".repeat(40)));
+      for (const mod of modules) {
+        const status = isProject ? mod.installed ? import_chalk10.default.green("\u2713") : import_chalk10.default.dim("\u25CB") : " ";
+        const nameColor = mod.installed ? import_chalk10.default.green : import_chalk10.default.cyan;
+        console.log(`  ${status} ${nameColor(mod.id.padEnd(18))} ${mod.name}`);
+        console.log(`    ${import_chalk10.default.gray(mod.description)}`);
+      }
+      console.log();
+    }
+    const totalAvailable = Object.keys(AVAILABLE_MODULES2).length;
+    const totalInstalled = installedModules.filter((m) => AVAILABLE_MODULES2[m]).length;
+    console.log(import_chalk10.default.gray("\u2500".repeat(50)));
+    console.log(
+      `  ${import_chalk10.default.bold(totalAvailable)} modules available` + (isProject ? ` | ${import_chalk10.default.green.bold(totalInstalled)} installed` : "")
+    );
+    console.log();
+    console.log(import_chalk10.default.bold("  Usage:"));
+    console.log(`    ${import_chalk10.default.yellow("servcraft add <module>")}      Add a module`);
+    console.log(`    ${import_chalk10.default.yellow("servcraft list --installed")}  Show installed only`);
+    console.log(`    ${import_chalk10.default.yellow("servcraft list --category Security")}  Filter by category`);
+    console.log();
+  }
+);
+
+// src/cli/commands/remove.ts
+var import_commander7 = require("commander");
+var import_path8 = __toESM(require("path"), 1);
+var import_ora7 = __toESM(require("ora"), 1);
+var import_chalk11 = __toESM(require("chalk"), 1);
+var import_promises6 = __toESM(require("fs/promises"), 1);
+var import_inquirer4 = __toESM(require("inquirer"), 1);
+var removeCommand = new import_commander7.Command("remove").alias("rm").description("Remove an installed module from your project").argument("<module>", "Module to remove").option("-y, --yes", "Skip confirmation prompt").option("--keep-env", "Keep environment variables").action(async (moduleName, options) => {
+  const projectError = validateProject();
+  if (projectError) {
+    displayError(projectError);
+    return;
+  }
+  console.log(import_chalk11.default.bold.cyan("\n\u{1F5D1}\uFE0F  ServCraft Module Removal\n"));
+  const moduleDir = import_path8.default.join(getModulesDir(), moduleName);
+  try {
+    const exists = await import_promises6.default.access(moduleDir).then(() => true).catch(() => false);
+    if (!exists) {
+      displayError(
+        new ServCraftError(`Module "${moduleName}" is not installed`, [
+          `Run ${import_chalk11.default.cyan("servcraft list --installed")} to see installed modules`,
+          `Check the spelling of the module name`
+        ])
+      );
+      return;
+    }
+    const files = await import_promises6.default.readdir(moduleDir);
+    const fileCount = files.length;
+    if (!options?.yes) {
+      console.log(import_chalk11.default.yellow(`\u26A0  This will remove the "${moduleName}" module:`));
+      console.log(import_chalk11.default.gray(`   Directory: ${moduleDir}`));
+      console.log(import_chalk11.default.gray(`   Files: ${fileCount} file(s)`));
+      console.log();
+      const { confirm } = await import_inquirer4.default.prompt([
+        {
+          type: "confirm",
+          name: "confirm",
+          message: "Are you sure you want to remove this module?",
+          default: false
+        }
+      ]);
+      if (!confirm) {
+        console.log(import_chalk11.default.yellow("\n\u2716 Removal cancelled\n"));
+        return;
+      }
+    }
+    const spinner = (0, import_ora7.default)("Removing module...").start();
+    await import_promises6.default.rm(moduleDir, { recursive: true, force: true });
+    spinner.succeed(`Module "${moduleName}" removed successfully!`);
+    console.log("\n" + import_chalk11.default.bold("\u2713 Removed:"));
+    success(`  src/modules/${moduleName}/ (${fileCount} files)`);
+    if (!options?.keepEnv) {
+      console.log("\n" + import_chalk11.default.bold("\u{1F4CC} Manual cleanup needed:"));
+      info("  1. Remove environment variables related to this module from .env");
+      info("  2. Remove module imports from your main app file");
+      info("  3. Remove related database migrations if any");
+      info("  4. Update your routes if they reference this module");
+    } else {
+      console.log("\n" + import_chalk11.default.bold("\u{1F4CC} Manual cleanup needed:"));
+      info("  1. Environment variables were kept (--keep-env flag)");
+      info("  2. Remove module imports from your main app file");
+      info("  3. Update your routes if they reference this module");
+    }
+    console.log();
+  } catch (err) {
+    error(err instanceof Error ? err.message : String(err));
+    console.log();
+  }
+});
+
+// src/cli/commands/doctor.ts
+var import_commander8 = require("commander");
+var import_chalk12 = __toESM(require("chalk"), 1);
+var import_promises7 = __toESM(require("fs/promises"), 1);
+async function checkNodeVersion() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split(".")[0] || "0", 10);
+  if (major >= 18) {
+    return { name: "Node.js", status: "pass", message: `${version} \u2713` };
+  }
+  return {
+    name: "Node.js",
+    status: "fail",
+    message: `${version} (< 18)`,
+    suggestion: "Upgrade to Node.js 18+"
+  };
+}
+async function checkPackageJson() {
+  const checks = [];
+  try {
+    const content = await import_promises7.default.readFile("package.json", "utf-8");
+    const pkg = JSON.parse(content);
+    checks.push({ name: "package.json", status: "pass", message: "Found" });
+    if (pkg.dependencies?.fastify) {
+      checks.push({ name: "Fastify", status: "pass", message: "Installed" });
+    } else {
+      checks.push({
+        name: "Fastify",
+        status: "fail",
+        message: "Missing",
+        suggestion: "npm install fastify"
+      });
+    }
+  } catch {
+    checks.push({
+      name: "package.json",
+      status: "fail",
+      message: "Not found",
+      suggestion: "Run servcraft init"
+    });
+  }
+  return checks;
+}
+async function checkDirectories() {
+  const checks = [];
+  const dirs = ["src", "node_modules", ".git", ".env"];
+  for (const dir of dirs) {
+    try {
+      await import_promises7.default.access(dir);
+      checks.push({ name: dir, status: "pass", message: "Exists" });
+    } catch {
+      const isCritical = dir === "src" || dir === "node_modules";
+      checks.push({
+        name: dir,
+        status: isCritical ? "fail" : "warn",
+        message: "Not found",
+        suggestion: dir === "node_modules" ? "npm install" : dir === ".env" ? "Create .env file" : void 0
+      });
+    }
+  }
+  return checks;
+}
+var doctorCommand = new import_commander8.Command("doctor").description("Diagnose project configuration and dependencies").action(async () => {
+  console.log(import_chalk12.default.bold.cyan("\n\u{1F50D} ServCraft Doctor\n"));
+  const allChecks = [];
+  allChecks.push(await checkNodeVersion());
+  allChecks.push(...await checkPackageJson());
+  allChecks.push(...await checkDirectories());
+  allChecks.forEach((check) => {
+    const icon = check.status === "pass" ? import_chalk12.default.green("\u2713") : check.status === "warn" ? import_chalk12.default.yellow("\u26A0") : import_chalk12.default.red("\u2717");
+    const color = check.status === "pass" ? import_chalk12.default.green : check.status === "warn" ? import_chalk12.default.yellow : import_chalk12.default.red;
+    console.log(`${icon} ${check.name.padEnd(20)} ${color(check.message)}`);
+    if (check.suggestion) {
+      console.log(import_chalk12.default.gray(`   \u2192 ${check.suggestion}`));
+    }
+  });
+  const pass = allChecks.filter((c) => c.status === "pass").length;
+  const warn2 = allChecks.filter((c) => c.status === "warn").length;
+  const fail = allChecks.filter((c) => c.status === "fail").length;
+  console.log(import_chalk12.default.gray("\n" + "\u2500".repeat(60)));
+  console.log(
+    `
+${import_chalk12.default.green(pass + " passed")} | ${import_chalk12.default.yellow(warn2 + " warnings")} | ${import_chalk12.default.red(fail + " failed")}
+`
+  );
+  if (fail === 0 && warn2 === 0) {
+    console.log(import_chalk12.default.green.bold("\u2728 Everything looks good!\n"));
+  } else if (fail > 0) {
+    console.log(import_chalk12.default.red.bold("\u2717 Fix critical issues before using ServCraft.\n"));
+  } else {
+    console.log(import_chalk12.default.yellow.bold("\u26A0 Some warnings, but should work.\n"));
+  }
+});
+
+// src/cli/commands/update.ts
+var import_commander9 = require("commander");
+var import_chalk13 = __toESM(require("chalk"), 1);
+var import_promises8 = __toESM(require("fs/promises"), 1);
+var import_path9 = __toESM(require("path"), 1);
+var import_url = require("url");
+var import_inquirer5 = __toESM(require("inquirer"), 1);
+var __filename2 = (0, import_url.fileURLToPath)(importMetaUrl);
+var __dirname = import_path9.default.dirname(__filename2);
+var AVAILABLE_MODULES3 = [
+  "auth",
+  "users",
+  "email",
+  "mfa",
+  "oauth",
+  "rate-limit",
+  "cache",
+  "upload",
+  "search",
+  "notification",
+  "webhook",
+  "websocket",
+  "queue",
+  "payment",
+  "i18n",
+  "feature-flag",
+  "analytics",
+  "media-processing",
+  "api-versioning",
+  "audit",
+  "swagger",
+  "validation"
+];
+async function getInstalledModules2() {
+  try {
+    const modulesDir = getModulesDir();
+    const entries = await import_promises8.default.readdir(modulesDir, { withFileTypes: true });
+    const installedModules = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => AVAILABLE_MODULES3.includes(name));
+    return installedModules;
+  } catch {
+    return [];
+  }
+}
+async function copyModuleFiles(moduleName, _projectRoot) {
+  const cliRoot = import_path9.default.resolve(__dirname, "../../../");
+  const sourceModulePath = import_path9.default.join(cliRoot, "src", "modules", moduleName);
+  const targetModulesDir = getModulesDir();
+  const targetModulePath = import_path9.default.join(targetModulesDir, moduleName);
+  try {
+    await import_promises8.default.access(sourceModulePath);
+  } catch {
+    throw new Error(`Module source not found: ${moduleName}`);
+  }
+  await import_promises8.default.cp(sourceModulePath, targetModulePath, { recursive: true });
+}
+async function updateModule(moduleName, options) {
+  const projectError = validateProject();
+  if (projectError) {
+    displayError(projectError);
+    return;
+  }
+  const projectRoot = getProjectRoot();
+  const installedModules = await getInstalledModules2();
+  if (!installedModules.includes(moduleName)) {
+    console.log(import_chalk13.default.yellow(`
+\u26A0 Module "${moduleName}" is not installed
+`));
+    console.log(
+      import_chalk13.default.gray(`Run ${import_chalk13.default.cyan(`servcraft add ${moduleName}`)} to install it first.
+`)
+    );
+    return;
+  }
+  if (options.check) {
+    console.log(import_chalk13.default.cyan(`
+\u{1F4E6} Checking updates for "${moduleName}"...
+`));
+    console.log(import_chalk13.default.gray("Note: Version tracking will be implemented in a future release."));
+    console.log(import_chalk13.default.gray("Currently, update will always reinstall the latest version.\n"));
+    return;
+  }
+  const { confirmed } = await import_inquirer5.default.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message: `Update "${moduleName}" module? This will overwrite existing files.`,
+      default: false
+    }
+  ]);
+  if (!confirmed) {
+    console.log(import_chalk13.default.yellow("\n\u26A0 Update cancelled\n"));
+    return;
+  }
+  console.log(import_chalk13.default.cyan(`
+\u{1F504} Updating "${moduleName}" module...
+`));
+  try {
+    await copyModuleFiles(moduleName, projectRoot);
+    console.log(import_chalk13.default.green(`\u2714 Module "${moduleName}" updated successfully!
+`));
+    console.log(
+      import_chalk13.default.gray("Note: Remember to review any breaking changes in the documentation.\n")
+    );
+  } catch (error2) {
+    if (error2 instanceof Error) {
+      console.error(import_chalk13.default.red(`
+\u2717 Failed to update module: ${error2.message}
+`));
+    }
+  }
+}
+async function updateAllModules(options) {
+  const projectError = validateProject();
+  if (projectError) {
+    displayError(projectError);
+    return;
+  }
+  const installedModules = await getInstalledModules2();
+  if (installedModules.length === 0) {
+    console.log(import_chalk13.default.yellow("\n\u26A0 No modules installed\n"));
+    console.log(import_chalk13.default.gray(`Run ${import_chalk13.default.cyan("servcraft list")} to see available modules.
+`));
+    return;
+  }
+  if (options.check) {
+    console.log(import_chalk13.default.cyan("\n\u{1F4E6} Checking updates for all modules...\n"));
+    console.log(import_chalk13.default.bold("Installed modules:"));
+    installedModules.forEach((mod) => {
+      console.log(`  \u2022 ${import_chalk13.default.cyan(mod)}`);
+    });
+    console.log();
+    console.log(import_chalk13.default.gray("Note: Version tracking will be implemented in a future release."));
+    console.log(import_chalk13.default.gray("Currently, update will always reinstall the latest version.\n"));
+    return;
+  }
+  console.log(import_chalk13.default.cyan(`
+\u{1F4E6} Found ${installedModules.length} installed module(s):
+`));
+  installedModules.forEach((mod) => {
+    console.log(`  \u2022 ${import_chalk13.default.cyan(mod)}`);
+  });
+  console.log();
+  const { confirmed } = await import_inquirer5.default.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message: "Update all modules? This will overwrite existing files.",
+      default: false
+    }
+  ]);
+  if (!confirmed) {
+    console.log(import_chalk13.default.yellow("\n\u26A0 Update cancelled\n"));
+    return;
+  }
+  console.log(import_chalk13.default.cyan("\n\u{1F504} Updating all modules...\n"));
+  const projectRoot = getProjectRoot();
+  let successCount = 0;
+  let failCount = 0;
+  for (const moduleName of installedModules) {
+    try {
+      await copyModuleFiles(moduleName, projectRoot);
+      console.log(import_chalk13.default.green(`\u2714 Updated: ${moduleName}`));
+      successCount++;
+    } catch {
+      console.error(import_chalk13.default.red(`\u2717 Failed: ${moduleName}`));
+      failCount++;
+    }
+  }
+  console.log();
+  console.log(
+    import_chalk13.default.bold(
+      `
+\u2714 Update complete: ${import_chalk13.default.green(successCount)} succeeded, ${import_chalk13.default.red(failCount)} failed
+`
+    )
+  );
+  if (successCount > 0) {
+    console.log(
+      import_chalk13.default.gray("Note: Remember to review any breaking changes in the documentation.\n")
+    );
+  }
+}
+var updateCommand = new import_commander9.Command("update").description("Update installed modules to latest version").argument("[module]", "Specific module to update").option("--check", "Check for updates without applying").option("-y, --yes", "Skip confirmation prompt").action(async (moduleName, options) => {
+  if (moduleName) {
+    await updateModule(moduleName, { check: options?.check });
+  } else {
+    await updateAllModules({ check: options?.check });
+  }
+});
+
+// src/cli/commands/completion.ts
+var import_commander10 = require("commander");
+var bashScript = `
+# servcraft bash completion script
+_servcraft_completions() {
+  local cur prev words cword
+  _init_completion || return
+
+  # Main commands
+  local commands="init add generate list remove doctor update completion docs --version --help"
+
+  # Generate subcommands
+  local generate_subcommands="module controller service repository types schema routes m c s r t"
+
+  case "\${words[1]}" in
+    generate|g)
+      if [[ \${cword} -eq 2 ]]; then
+        COMPREPLY=( $(compgen -W "\${generate_subcommands}" -- "\${cur}") )
+      fi
+      ;;
+    add|remove|rm|update)
+      if [[ \${cword} -eq 2 ]]; then
+        # Get available modules
+        local modules="auth cache rate-limit notification payment oauth mfa queue websocket upload"
+        COMPREPLY=( $(compgen -W "\${modules}" -- "\${cur}") )
+      fi
+      ;;
+    completion)
+      if [[ \${cword} -eq 2 ]]; then
+        COMPREPLY=( $(compgen -W "bash zsh" -- "\${cur}") )
+      fi
+      ;;
+    *)
+      if [[ \${cword} -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+      fi
+      ;;
+  esac
+}
+
+complete -F _servcraft_completions servcraft
+`;
+var zshScript = `
+#compdef servcraft
+
+_servcraft() {
+  local context state state_descr line
+  typeset -A opt_args
+
+  _arguments -C \\
+    '1: :_servcraft_commands' \\
+    '*::arg:->args'
+
+  case $state in
+    args)
+      case $line[1] in
+        generate|g)
+          _servcraft_generate
+          ;;
+        add|remove|rm|update)
+          _servcraft_modules
+          ;;
+        completion)
+          _arguments '1: :(bash zsh)'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_servcraft_commands() {
+  local commands
+  commands=(
+    'init:Initialize a new ServCraft project'
+    'add:Add a pre-built module to your project'
+    'generate:Generate code files (controller, service, etc.)'
+    'list:List available and installed modules'
+    'remove:Remove an installed module'
+    'doctor:Diagnose project configuration'
+    'update:Update installed modules'
+    'completion:Generate shell completion scripts'
+    'docs:Open documentation'
+    '--version:Show version'
+    '--help:Show help'
+  )
+  _describe 'command' commands
+}
+
+_servcraft_generate() {
+  local subcommands
+  subcommands=(
+    'module:Generate a complete module (controller + service + routes)'
+    'controller:Generate a controller'
+    'service:Generate a service'
+    'repository:Generate a repository'
+    'types:Generate TypeScript types'
+    'schema:Generate validation schema'
+    'routes:Generate routes file'
+    'm:Alias for module'
+    'c:Alias for controller'
+    's:Alias for service'
+    'r:Alias for repository'
+    't:Alias for types'
+  )
+  _describe 'subcommand' subcommands
+}
+
+_servcraft_modules() {
+  local modules
+  modules=(
+    'auth:Authentication & Authorization'
+    'cache:Redis caching'
+    'rate-limit:Rate limiting'
+    'notification:Email/SMS notifications'
+    'payment:Payment integration'
+    'oauth:OAuth providers'
+    'mfa:Multi-factor authentication'
+    'queue:Background jobs'
+    'websocket:WebSocket support'
+    'upload:File upload handling'
+  )
+  _describe 'module' modules
+}
+
+_servcraft "$@"
+`;
+var completionCommand = new import_commander10.Command("completion").description("Generate shell completion scripts").argument("<shell>", "Shell type (bash or zsh)").action((shell) => {
+  const shellLower = shell.toLowerCase();
+  if (shellLower === "bash") {
+    console.log(bashScript);
+  } else if (shellLower === "zsh") {
+    console.log(zshScript);
+  } else {
+    console.error(`Unsupported shell: ${shell}`);
+    console.error("Supported shells: bash, zsh");
+    process.exit(1);
+  }
+});
+
 // src/cli/index.ts
-var program = new import_commander6.Command();
+var program = new import_commander11.Command();
 program.name("servcraft").description("Servcraft - A modular Node.js backend framework CLI").version("0.1.0");
 program.addCommand(initCommand);
 program.addCommand(generateCommand);
 program.addCommand(addModuleCommand);
 program.addCommand(dbCommand);
 program.addCommand(docsCommand);
+program.addCommand(listCommand);
+program.addCommand(removeCommand);
+program.addCommand(doctorCommand);
+program.addCommand(updateCommand);
+program.addCommand(completionCommand);
 program.parse();
 //# sourceMappingURL=index.cjs.map