nodejs-quickstart-structure 1.16.2 → 1.18.0

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.18.0] - 2026-03-25
+
+### Added
+- **Enterprise-Grade Security Hardening**: Integrated **Snyk (SCA)** and **SonarQube (SAST)** into the project scaffolding, providing "Big Tech" industry-standard security analysis out of the box.
+- **Automated Security Workflows**: Pre-configured CI/CD stages for security scanning across GitHub Actions, GitLab CI, and Jenkins.
+- **Pre-commit Security Gates**: Integrated **Husky** and **lint-staged** to automatically enforce code quality and security standards locally before every commit.
+- **Security Standard Enforcement**: Added a standardized `SECURITY.md` policy and automated quality gates to ensure code resilience.
+- **Comprehensive Security Guide**: Created a new documentation guide detailing the setup and operational workflows for the enterprise security features.
+
+### Changed
+- **Matrix Expansion**: Updated the CLI to support over **1,680+ project combinations** by adding a conditional security hardening layer across all CI/CD providers.
+
+### Fixed
+- **Docker Node Version**: Updated Docker node version to 22.22.2-trixie-slim
+
+## [1.17.0] - 2026-03-23
+
+### Added
+- **Kafka KRaft Mode Integration**: Modernized Kafka setups across all templates (MVC & Clean Architecture) by completely removing the Zookeeper dependency and enabling KRaft mode in `docker-compose.yml`, reducing project orchestration overhead.
+- **End-to-End (E2E) Verification Framework**: Implemented dedicated Docker container targeted end-to-end tests (`tests/e2e/`) utilizing Supertest via dynamic `SERVER_URL` mapping to eliminate port collisions and test the fully assembled container cluster directly.
+- **Enhanced Validation Pipelines**: Automatically executes the `npm run test:e2e` suite at the conclusion of internal validations across the entire platform matrix for improved CI accountability.
+
+### Refactored
+- **Test Directory Strict Isolation**: Restructured internal code generation workflows (`lib/modules/`) to pipe all generated `.spec` files strictly into a dedicated `tests/unit/` subdirectory, cleanly abstracting unit specifications from end-to-end specifications.
+
 ## [1.16.2] - 2026-03-19
 
 ### Changed

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Pau Dang
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,135 +1,144 @@
-# Node.js Quickstart Generator
-
-[![npm version](https://img.shields.io/npm/v/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
-[![npm total downloads](https://img.shields.io/npm/dt/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
-[![npm monthly downloads](https://img.shields.io/npm/dm/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
-[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)
-
-A powerful CLI tool to scaffold production-ready Node.js microservices with built-in best practices, allowing you to choose between **MVC** or **Clean Architecture**, **JavaScript** or **TypeScript**, and your preferred database.
-
-![Demo](docs/demo.gif)
-
-## Features
-
-- **Interactive CLI**: Easy-to-use prompts to configure your project.
-- **Multiple Architectures**: Supports both **MVC** (Model-View-Controller) and **Clean Architecture**.
-- **Language Support**: Choose between **JavaScript** and **TypeScript**.
-- **Database Integration**: Pre-configured setup for **MySQL**, **PostgreSQL**, or **MongoDB**.
-- **Communication Flow**: Scaffold APIs using **REST**, **GraphQL** (with Apollo Server), or **Kafka** (event-driven).
-- **Caching Layer**: Choose between **Redis** or built-in **Memory Cache** for data caching.
-- **Centralized Error Handling**: Every project ships with a global error handler, custom error classes and structured JSON error responses — consistent across REST & GraphQL.
-- **Dockerized**: Automatically generates `docker-compose.yml` for DB, Kafka, Redis, and Zookeeper.
-- **Database Migrations/Schemas**: Integrated **Flyway** for SQL migrations or **Mongoose** schemas for MongoDB.
-- **Professional Standards**: Generated projects come with highly professional, industry-standard tooling.
-
-## 🌟 Why developers love this?
-
-- **Community Trusted**: Over **3,000+** projects bootstrapped within the first month.
-- **Actively Maintained**: Constant updates and optimizations (30+ versions released) based on real-world developer feedback.
-- **Resilience First**: Unlike basic boilerplates, our generated code focuses on infrastructure stability (Retry logic, Health checks, and Graceful shutdowns).
-
-## 🏆 Professional Standards (New)
-
-We don't just generate boilerplate; we generate **production-ready** foundations. Every project includes:
-
--   **🔍 Code Quality**: Pre-configured `Eslint` and `Prettier` for consistent coding standards.
--   **🛡️ Security**: Built-in `Helmet`, `HPP`, `CORS`, and Rate-Limiting middleware.
--   **🚨 Error Handling**: Centralized global error middleware with custom error classes and structured JSON responses. GraphQL uses Apollo's `formatError` hook; REST uses Express error middleware.
--   **🧪 Testing Excellence**: Integrated `Jest` and `Supertest`. Every generated project maintains **>70% Unit Test coverage** for controllers, services, and resolvers out of the box.
--   **🔄 CI/CD Integration**: Pre-configured workflows for **GitHub Actions**, **Jenkins**, and **GitLab CI**.
--   **⚓ Git Hooks**: `Husky` and `Lint-Staged` to ensure no bad code is ever committed.
--   **🤝 Reliability**: Health Checks (`/health`) with deep database pings, Infrastructure Retry Logic (handling Docker startup delays), and Graceful Shutdown workflows.
--   **🐳 DevOps**: Highly optimized **Multi-Stage Dockerfile** for small, secure production images.
--   **🚀 Deployment**: Ship confidently with an integrated **PM2 Ecosystem Configuration** for zero-downtime reloads and robust process management.
-
-## 🧩 480+ Project Combinations
-
-The CLI supports a massive number of configurations to fit your exact needs:
-
--   **240 Core Combinations**:
-    -   **MVC Architecture**: 180 variants (Languages × View Engines × Databases × Communication Patterns × Caching)
-    -   **Clean Architecture**: 60 variants (Languages × Databases × Communication Patterns × Caching)
--   **480 Total Scenarios**:
-    -   Every combination can be generated with or without (**GitHub Actions CI/CD** / **Jenkins** or **GitLab CI**), tripling the possibilities.
-    -   Every single one of these 480 scenarios is verified to be compatible with our 70% Coverage Threshold policy.
-
-For a detailed list of all supported cases, check out [docs/generateCase.md](docs/generateCase.md).
-
-## Installation
-
-You can install the tool globally directly from npm:
-
-```bash
-npm install -g nodejs-quickstart-structure
-```
-
-## Usage
-
-Once installed, simply run the following command in any directory where you want to create a new project:
-
-```bash
-nodejs-quickstart init
-```
-
-## Quick Start (Recommended)
-
-You can run the generator directly without installing it globally:
-
-```bash
-npx nodejs-quickstart-structure@latest init
-```
-
-### Configuration Options
-
-The CLI will guide you through the following steps:
-
-1.  **Project Name**: The name of the folder to create.
-2.  **Language**: `JavaScript` or `TypeScript`.
-3.  **Architecture**: `MVC` or `Clean Architecture`.
-4.  **Database**: `MySQL`, `PostgreSQL`, or `MongoDB`.
-5.  **Database Name**: The name of the initial database.
-6.  **Communication**: `REST APIs` (default), `GraphQL`, or `Kafka`.
-7.  **Caching**: `None`, `Redis`, or `Memory Cache`.
-8.  **CI/CD**: `GitHub Actions`, `Jenkins`, `GitLab CI` or `None`.
-
-## Generated Project Structure
-
-The generated project will include:
-
--   `src/`: Source code (controllers, routes, services/use-cases).
--   `src/errors/`: Custom error classes — `ApiError`, `NotFoundError`, `BadRequestError`.
--   `flyway/sql/`: SQL migration scripts (if SQL database selected).
--   `docker-compose.yml`: Services configuration for DB, Flyway, and Kafka.
--   `package.json`: Dependencies and scripts (`start`, `dev`, `build`).
--   `tsconfig.json`: (If TypeScript is selected) Type checking configuration.
-
-### Getting Started with the Generated App
-
-```bash
-cd <your-project-name>
-
-# Start infrastructure (DB, etc.)
-npm install
-
-docker-compose up
-```
-
-## ❤️ Support the Project
-
-We just hit **3,000 downloads**! If this tool helped you save hours of setup time, please consider:
-- Giving us a ⭐ on [GitHub](https://github.com/paudang/nodejs-quickstart-structure) to help others find it.
-- Following the [Medium Article](https://medium.com/@paudang/nodejs-quickstart-generator-93c276d60e0b) for deep-dive tutorials.
-
-## License
-
-ISC
-
-## 🚀 Roadmap & Upcoming Features
-
-We are constantly working to improve `nodejs-quickstart-structure` and make it the most robust boilerplate generator for Node.js. 
-
-You can track our current progress, see what features are being worked on, and vote for your favorites on our public Trello board:
-
-👉 **[View our Public Roadmap on Trello](https://trello.com/b/TPTo8ylF/nodejs-quickstart-structure-product)**
-
-If you have a feature request or want to contribute, feel free to check the board and open an issue or pull request!
+# Node.js Quickstart Generator
+
+[![npm version](https://img.shields.io/npm/v/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
+[![npm total downloads](https://img.shields.io/npm/dt/nodejs-quickstart-structure?style=flat-square&color=emerald&label=Downloads)](https://www.npmjs.com/package/nodejs-quickstart-structure)
+[![npm monthly downloads](https://img.shields.io/npm/dm/nodejs-quickstart-structure.svg?style=flat-square)](https://www.npmjs.com/package/nodejs-quickstart-structure)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)
+
+A powerful CLI tool to scaffold production-ready Node.js microservices with built-in best practices, allowing you to choose between **MVC** or **Clean Architecture**, **JavaScript** or **TypeScript**, and your preferred database.
+
+![Demo](docs/demo.gif)
+
+---
+
+## 📌 Table of Contents
+
+- [🚀 Quick Start](#-quick-start)
+- [✨ Key Features](#-key-features)
+- [🛡️ Professional Standards](#-professional-standards)
+- [🧩 1,680+ Project Combinations](#-1680-project-combinations)
+- [⚙️ Configuration Options](#-configuration-options)
+- [🏗️ Generated Project Structure](#-generated-project-structure)
+- [📖 Documentation](#-documentation)
+- [🗺️ Roadmap & Support](#️-roadmap--support)
+
+---
+
+## 🚀 Quick Start
+
+Generate your professional Node.js project in seconds without installing anything globally:
+
+```bash
+npx nodejs-quickstart-structure@latest init
+```
+
+### Installation (Optional)
+
+If you prefer to install it globally:
+
+```bash
+npm install -g nodejs-quickstart-structure
+# Then run:
+nodejs-quickstart init
+```
+
+---
+
+## ✨ Key Features
+
+- **Interactive CLI**: Smooth, guided configuration process.
+- **Multiple Architectures**: Supports both **MVC** and **Clean Architecture**.
+- **Modern Languages**: Choice of **JavaScript** or **TypeScript**.
+- **Database Ready**: Pre-configured for **MySQL**, **PostgreSQL**, or **MongoDB**.
+- **Communication Patterns**: Supports **REST**, **GraphQL** (Apollo), and **Kafka** (Event-driven).
+- **Multi-layer Caching**: Integrated **Redis** or built-in **Memory Cache**.
+- **AI-Native Optimized**: specifically designed for **Cursor** and AI agents, including built-in `.cursorrules` and Agent Skill prompts. 🚀
+
+---
+
+## 🛡️ Professional Standards
+
+We don't just generate boilerplate; we generate **production-ready** foundations. Every project includes:
+
+- **🔍 Code Quality**: Pre-configured `Eslint` and `Prettier`.
+- **🛡️ Enterprise Security**: Integrated **Snyk (SCA)**, **SonarCloud (SAST)**, `Helmet`, `HPP`, and Rate-Limiting.
+- **🚨 Robust Error Handling**: Centralized global error middleware with custom error classes (`ApiError`, `NotFoundError`, etc.) — consistent across REST & GraphQL.
+- **🧪 Testing Excellence**: Integrated `Jest` and `Supertest` with **>80% Unit Test coverage** out of the box.
+- **🔄 DevOps & CI/CD**: Optimized **Multi-Stage Dockerfiles**, health checks, infrastructure retry logic, and workflows for **GitHub Actions**, **Jenkins**, and **GitLab CI**.
+- **🚀 Scalable Deployment**: Integrated **PM2 Ecosystem** config for zero-downtime reloads.
+
+---
+
+## 🧩 1,680+ Project Combinations
+
+The CLI supports a massive number of configurations to fit your exact needs:
+
+- **240 Core Combinations**:
+  - **MVC Architecture**: 180 variants (Languages × View Engines × Databases × Communication Patterns × Caching)
+  - **Clean Architecture**: 60 variants (Languages × Databases × Communication Patterns × Caching)
+- **1,680+ Total Scenarios**:
+  - Every combination can be generated across 3 CI/CD providers.
+  - Optional **Enterprise-Grade Security Hardening** doubles the scenarios.
+  - Every single scenario is verified to be compatible with our **80% Coverage Threshold** policy.
+
+---
+
+## ⚙️ Configuration Options
+
+The CLI will guide you through:
+1. **Project Name**
+2. **Language**: `JavaScript` | `TypeScript`
+3. **Architecture**: `MVC` | `Clean Architecture`
+4. **View Engine**: (MVC only) `None` | `EJS` | `Pug`
+5. **Database**: `MySQL` | `PostgreSQL` | `MongoDB`
+6. **Communication**: `REST` | `GraphQL` | `Kafka`
+7. **Caching**: `None` | `Redis` | `Memory Cache`
+8. **CI/CD**: `GitHub Actions` | `Jenkins` | `GitLab CI`
+9. **Security**: (Optional) Snyk & SonarCloud Hardening
+
+---
+
+## 🏗️ Generated Project Structure
+
+A typical generated project (TypeScript + Clean Architecture) looks like this:
+
+```text
+.
+├── src/
+│   ├── application/     # Use cases & Business logic
+│   ├── domain/          # Entities & Repository interfaces
+│   ├── infrastructure/  # DB, External services, Repositories
+│   ├── interfaces/      # Controllers, Routes, GraphQL, Kafka
+│   ├── errors/          # Custom Error Classes
+│   └── index.ts         # Entry point
+├── flyway/sql/          # SQL migrations (if applicable)
+├── docker-compose.yml   # Infrastructure services
+├── package.json         # Scripts and dependencies
+├── tsconfig.json        # TypeScript config
+└── .cursorrules         # AI assistance rules
+```
+
+---
+
+## 📖 Documentation
+
+For full guides, architecture deep-dives, and feature references, visit our **[Official Documentation Site](https://paudang.github.io/nodejs-quickstart-structure/)**.
+
+---
+
+## ❤️ Support & 🗺️ Roadmap
+
+### Support the Project
+We just hit **3,000+ downloads**! If this tool helped you, please:
+- Give us a ⭐ on [GitHub](https://github.com/paudang/nodejs-quickstart-structure).
+- Read our [Medium Article](https://medium.com/@paudang/nodejs-quickstart-generator-93c276d60e0b) for tutorials.
+
+### Roadmap
+Track our progress and vote for features on our public board:
+👉 **[View our Public Roadmap on Trello](https://trello.com/b/TPTo8ylF/nodejs-quickstart-structure-product)**
+
+---
+
+## License
+
+ISC

package/bin/index.js

@@ -1,89 +1,92 @@
-#!/usr/bin/env node
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { getProjectDetails } from '../lib/prompts.js';
-import { generateProject } from '../lib/generator.js';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
-
-const program = new Command();
-
-program
-    .name('nodejs-quickstart')
-    .description('🚀 CLI to scaffold production-ready Node.js microservices.\n\nGenerates projects with:\n- MVC or Clean Architecture\n- REST or Kafka\n- MySQL, PostgreSQL, or MongoDB\n- Docker, Flyway & Mongoose support')
-    .version(pkg.version, '-v, --version', 'Output the current version')
-    .addHelpText('after', `\n${chalk.yellow('Example:')}\n  $ nodejs-quickstart init   ${chalk.gray('# Start the interactive setup')}\n`);
-
-program
-    .command('init')
-    .description('Initialize a new Node.js project')
-    .option('-n, --project-name <name>', 'Project name')
-    .option('-l, --language <language>', 'Language (JavaScript, TypeScript)')
-    .option('-a, --architecture <architecture>', 'Architecture (MVC, Clean Architecture)')
-    .option('--view-engine <view>', 'View Engine (None, EJS, Pug) - MVC only')
-    .option('-d, --database <database>', 'Database (MySQL, PostgreSQL)')
-    .option('--db-name <name>', 'Database name')
-    .option('-c, --communication <communication>', 'Communication (REST APIs, GraphQL, Kafka)')
-    .option('--ci-provider <provider>', 'CI/CD Provider (None, GitHub Actions, Jenkins)')
-    .option('--caching <type>', 'Caching Layer (None/Redis)')
-    .action(async (options) => {
-        // Fix for Commander camelCase conversion
-        if (options.ciProvider) {
-            options.ciProvider = options.ciProvider;
-        }
-
-        console.log(chalk.blue('Welcome to the Node.js Quickstart Generator!'));
-
-        try {
-            const answers = await getProjectDetails(options);
-            console.log(chalk.green('\nConfiguration received:'));
-            console.log(JSON.stringify(answers, null, 2));
-
-            console.log(chalk.yellow('\nGenerating project...'));
-            await generateProject(answers);
-
-            console.log(chalk.green('\n✔ Project generated successfully!'));
-            
-            console.log(chalk.magenta('\n🚀 Project is AI-Ready!'));
-            console.log(chalk.magenta('-----------------------------------------'));
-            console.log(chalk.magenta('🤖 We detected you are using AI tools.'));
-            console.log(chalk.magenta(`📍 Use Cursor? We've configured '.cursorrules' for you.`));
-            console.log(chalk.magenta(`📍 Use ChatGPT/Gemini? Check the 'prompts/' folder for Agent Skills.`));
-            console.log(chalk.magenta('-----------------------------------------'));
-
-            let manualStartInstructions = `\n${chalk.yellow('Development:')}\n  cd ${answers.projectName}\n  npm install`;
-            
-            const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
-            
-            if (needsInfrastructure) {
-                let servicesToStart = '';
-                if (answers.database !== 'None') servicesToStart += ' db';
-                if (answers.caching === 'Redis') servicesToStart += ' redis';
-                if (answers.communication === 'Kafka') servicesToStart += ' zookeeper kafka';
-                
-                manualStartInstructions += `\n  docker-compose up -d${servicesToStart}  # Start infrastructure first\n  npm run dev`;
-            } else {
-                manualStartInstructions += `\n  npm run dev`;
-            }
-            
-            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}\n\n${chalk.yellow('Production (PM2):')}\n  npm run build\n  npm run deploy\n  npx pm2 logs`));
-
-        } catch (error) {
-            if (error.name === 'ExitPromptError') {
-                console.log(chalk.yellow('\n\n👋 Goodbye! Setup cancelled.'));
-                process.exit(0);
-            }
-            console.error(chalk.red('Error generating project:'), error);
-            process.exit(1);
-        }
-    });
-program.parse(process.argv);
-
-if (!process.argv.slice(2).length) {
-    program.outputHelp();
-}
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getProjectDetails } from '../lib/prompts.js';
+import { generateProject } from '../lib/generator.js';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
+const program = new Command();
+
+program
+    .name('nodejs-quickstart')
+    .description('🚀 CLI to scaffold production-ready Node.js microservices.\n\nGenerates projects with:\n- MVC or Clean Architecture\n- REST or Kafka\n- MySQL, PostgreSQL, or MongoDB\n- Docker, Flyway & Mongoose support')
+    .version(pkg.version, '-v, --version', 'Output the current version')
+    .addHelpText('after', `\n${chalk.yellow('Example:')}\n  $ nodejs-quickstart init   ${chalk.gray('# Start the interactive setup')}\n`);
+
+program
+    .command('init')
+    .description('Initialize a new Node.js project')
+    .option('-n, --project-name <name>', 'Project name')
+    .option('-l, --language <language>', 'Language (JavaScript, TypeScript)')
+    .option('-a, --architecture <architecture>', 'Architecture (MVC, Clean Architecture)')
+    .option('--view-engine <view>', 'View Engine (None, EJS, Pug) - MVC only')
+    .option('-d, --database <database>', 'Database (MySQL, PostgreSQL)')
+    .option('--db-name <name>', 'Database name')
+    .option('-c, --communication <communication>', 'Communication (REST APIs, GraphQL, Kafka)')
+    .option('--ci-provider <provider>', 'CI/CD Provider (None, GitHub Actions, Jenkins, GitLab CI)')
+    .option('--include-security', 'Include Enterprise Security Hardening')
+    .option('--caching <type>', 'Caching Layer (None/Redis)')
+    .action(async (options) => {
+        // Fix for Commander camelCase conversion
+        if (options.ciProvider) {
+            options.ciProvider = options.ciProvider;
+        }
+
+        console.log(chalk.blue('Welcome to the Node.js Quickstart Generator!'));
+
+        try {
+            const answers = await getProjectDetails(options);
+            console.log(chalk.green('\nConfiguration received:'));
+            console.log(JSON.stringify(answers, null, 2));
+
+            console.log(chalk.yellow('\nGenerating project...'));
+            await generateProject(answers);
+
+            console.log(chalk.green('\n✔ Project generated successfully!'));
+            
+            console.log(chalk.magenta('\n🚀 Project is AI-Ready!'));
+            console.log(chalk.magenta('-----------------------------------------'));
+            console.log(chalk.magenta('🤖 We detected you are using AI tools.'));
+            console.log(chalk.magenta(`📍 Use Cursor? We've configured '.cursorrules' for you.`));
+            console.log(chalk.magenta(`📍 Use ChatGPT/Gemini? Check the 'prompts/' folder for Agent Skills.`));
+            console.log(chalk.magenta('-----------------------------------------'));
+
+            let manualStartInstructions = `\n${chalk.yellow('Development:')}\n  cd ${answers.projectName}\n  npm install`;
+            
+            const needsInfrastructure = answers.database !== 'None' || answers.caching === 'Redis' || answers.communication === 'Kafka';
+            
+            if (needsInfrastructure) {
+                let servicesToStart = '';
+                if (answers.database === 'MongoDB') servicesToStart += ' db';
+                else if (answers.database !== 'None') servicesToStart += ' db flyway';
+                if (answers.caching === 'Redis') servicesToStart += ' redis';
+                if (answers.communication === 'Kafka') servicesToStart += ' kafka';
+                
+                manualStartInstructions += `\n  docker-compose up -d${servicesToStart}  # Start infrastructure first\n  npm run dev`;
+            } else {
+                manualStartInstructions += `\n  npm run dev`;
+            }
+            
+            console.log(chalk.cyan(`\nNext steps:\n  cd ${answers.projectName}\n  npm install\n  docker-compose up\n-----------------------${manualStartInstructions}\n\n${chalk.yellow('Production (PM2):')}\n  npm run build\n  npm run deploy\n  npx pm2 logs`));
+
+        } catch (error) {
+            if (error.name === 'ExitPromptError') {
+                console.log(chalk.yellow('\n\n👋 Goodbye! Setup cancelled.'));
+                process.exit(0);
+            }
+            console.error(chalk.red('Error generating project:'), error);
+            process.exit(1);
+        }
+    });
+
+program.parse(process.argv);
+
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/lib/generator.js

@@ -16,9 +16,10 @@ export const generateProject = async (config) => {
         viewEngine: 'None',
         caching: 'None',
         dbName: 'demo',
-        ciProvider: 'None',
+        ciProvider: 'GitHub Actions',
         communication: 'REST APIs',
         database: 'None',
+        includeSecurity: false,
         ...config
     };
 
@@ -112,7 +113,7 @@ export const generateProject = async (config) => {
       ----------------------------------------------------
       ✅  Linting & Formatting: Eslint + Prettier configured
       ✅  Git Hooks: Husky + Lint-Staged ready
-      ✅  Security: Helmet, CORS, Rate-Limiting added
+      ✅  Security: Helmet, CORS, Rate-Limiting added${config.includeSecurity ? '\n      ✅  Enterprise Security: Snyk (SCA) & SonarCloud (SAST) integration' : ''}
       ✅  Testing: Jest setup for Unit/Integration tests
       ✅  Docker: Production-ready multi-stage build
       ${config.ciProvider !== 'None' ? `✅  CI/CD: ${config.ciProvider} Workflow ready` : '❌  CI/CD: Skipped (User preferred)'}