nestcraftx 0.2.6 → 0.3.0

package/CHANGELOG.fr.md

@@ -2,6 +2,28 @@
 
 Toutes les modifications notables apportées à NestCraftX seront documentées dans ce fichier.
 
+## [0.3.0] - 07-06-2026
+
+### Ajouté
+
+- **Version dynamique de l'aide** : Lecture dynamique de la version depuis le `package.json` dans la commande d'aide pour éviter les incohérences.
+- **Validation interactive des flags** : Correction de la logique de vérification pour supporter correctement le mode non-interactif.
+- **Package Manager dynamique** : Prise en compte dynamique du gestionnaire de paquets choisi au lieu de forcer `npm` dans le setup auth.
+
+### Changé
+
+- **Système de modules unifié** : Standardisation de tous les fichiers du projet en CommonJS afin d'éviter les crashs hybrides ESM/CJS au runtime.
+- **Gestion gracieuse des erreurs** : Les échecs de commandes non critiques (comme `prisma format`) ne tuent plus l'ensemble du processus de génération.
+
+### Corrigé
+
+- **Capitalisation dans le générateur Prisma** : Capitalisation forcée des noms de modèles dans les relations du schéma pour respecter les contraintes Prisma.
+- **Déduplication des clés étrangères (FK)** : Résolution de la duplication des clés étrangères lors de la génération des relations Prisma.
+- **Boucles asynchrones Clean Architecture** : Remplacement des boucles `forEach` asynchrones par des boucles `for...of` séquentielles pour garantir l'ordre de création des fichiers.
+- **Sauvegarde de l'environnement** : Modification de `setupMongoose` pour mettre à jour le fichier `.env` au lieu de l'écraser complètement.
+- **Analyse robuste de AppModule** : Amélioration de la regex dans `safeUpdateAppModule` pour gérer en toute sécurité les crochets de tableaux imbriqués.
+- **Nettoyages de code** : Suppression du code mort ou commenté et retrait des `console.log` de débogage dans les guards de sécurité générés.
+
 ## [0.2.5] - 10-01-2026
 
 ### Ajouté

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to NestCraftX will be documented in this file.
 
+## [0.3.0] - 2026-06-07
+
+### Added
+
+- **Dynamic Help Version**: Read version dynamically from `package.json` in the help command to prevent version mismatches.
+- **Interactive Flags Check**: Fixed flag check validations to support non-interactive execution modes properly.
+- **Dynamic Package Manager**: Support package manager selection dynamically based on inputs rather than hardcoding `npm`.
+
+### Changed
+
+- **Unified Module System**: Standardized all project files under CommonJS format to avoid hybrid ESM/CommonJS runtime crashes.
+- **Graceful Error Handling**: Non-critical shell command failures (like `prisma format`) now log warnings rather than forcing process exit.
+
+### Fixed
+
+- **Prisma Generator Capitalization**: Forced capitalization of model names in database relations to match Prisma schema constraints.
+- **Foreign Key Duplication**: Fixed relation mappings to prevent duplicate foreign key definitions in generated Prisma schemas.
+- **Clean Architecture Loops**: Replaced asynchronous `forEach` loops with sequential `for...of` to prevent files being written out-of-order.
+- **Safe Environment Generation**: `setupMongoose` now updates the `.env` file instead of overwriting it completely.
+- **Robust AppModule Parsing**: Upgraded regex pattern matching in `safeUpdateAppModule` to handle nested array brackets safely.
+- **Cleanups**: Removed dead/commented-out code and removed active debug `console.log` statements in generated security guards.
+
 ## [0.2.5] - 2026-01-10
 
 ### Added

package/PROGRESS.md

@@ -0,0 +1,258 @@
+# ✅ NestCraftX — Suivi de Progression vers v1.0
+> Fichier de check indépendant — le roadmap complet est dans `AUDIT_ROADMAP.md`
+> **Ne jamais modifier `AUDIT_ROADMAP.md`** — il est la référence figée de l'audit.
+
+---
+
+## 📊 Tableau de bord
+
+| Phase | Statut | Tickets | Complétés | Progression |
+|---|---|---|---|---|
+| Phase 0 — Stabilisation (v0.3.0) | ✅ Terminé | 17 | 17 | 100% |
+| Phase 1 — Refactorisation (v0.4.0) | 🔵 En cours | 18 | 9 | 50% |
+| Phase 2 — Qualité & Sécurité (v0.5.0) | ⏸️ En attente | 10 | 0 | 0% |
+| Phase 3 — Tests & CI/CD (v0.6.0) | ⏸️ En attente | 15 | 0 | 0% |
+| Phase 4 — Features (v0.7–0.9) | ⏸️ En attente | 14 | 0 | 0% |
+| Phase 5 — Documentation (v0.9.x) | ⏸️ En attente | 8 | 0 | 0% |
+| Phase 6 — Release v1.0 | ⏸️ En attente | 7 | 0 | 0% |
+| **TOTAL** | | **89** | **26** | **29%** |
+
+> Mis à jour : 2026-06-07
+
+---
+
+## 🔴 PHASE 0 — Stabilisation d'urgence (v0.3.0)
+> Objectif : Zéro crash, zéro bug bloquant
+
+### 0A — Crash & Stabilité _(priorité maximale)_
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| PROD-03 | Refactoriser `runCommand` : ajouter `{ critical: boolean }` | `utils/shell.js` | ✅ Terminé | 2026-06-05 |
+| PROD-01a | Dégradation gracieuse si `prisma format` échoue | `utils/setups/setupPrisma.js` | ✅ Terminé | 2026-06-05 |
+| PROD-01b | Capitalisation modèles Prisma (`capitalize(from/to)`) | `utils/setups/setupPrisma.js` | ✅ Terminé | 2026-06-05 |
+| PROD-01c | Déduplication FK dans le 2e pass des relations | `utils/setups/setupPrisma.js` | ✅ Terminé | 2026-06-05 |
+| BUG-09 | `forEach async` → `for...of` dans setupCleanArchitecture | `utils/configs/setupCleanArchitecture.js` | ✅ Terminé | 2026-06-05 |
+| BUG-01 | Unifier module system ESM/CJS (`utils.js` + `userInput.js`) | `utils/utils.js`, `utils/userInput.js` | ✅ Terminé | 2026-06-06 |
+
+### 0B — Comportement incorrect
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| BUG-03 | Fixer logique `hasAllLightModeFlags` / `hasAllFullModeFlags` | `commands/new.js` | ✅ Terminé | 2026-06-06 |
+| BUG-06 | `setupAuth` : utiliser `inputs.packageManager` (pas `npm` hardcodé) | `utils/setups/setupAuth.js` | ✅ Terminé | 2026-06-06 |
+| BUG-07 | `setupMongoose` : ne plus écraser le `.env` complet | `utils/setups/setupMongoose.js` | ✅ Terminé | 2026-06-07 |
+| BUG-04 | `createFile` : vraiment ne pas écraser quand `overwrite: false` | `utils/userInput.js` | ✅ Terminé | 2026-06-07 |
+| BUG-08 | Corriger regex AppModule dans `safeUpdateAppModule` | `utils/userInput.js` | ✅ Terminé | 2026-06-07 |
+
+### 0C — Nettoyage immédiat
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| BUG-12 | `help.js` : version dynamique depuis `package.json` | `commands/help.js` | ✅ Terminé | 2026-06-07 |
+| MP-07a | Supprimer code mort dans `cliParser.js` (45 lignes) | `utils/cliParser.js` | ✅ Terminé | 2026-06-07 |
+| MP-07b | Supprimer code mort dans `setupPrisma.js` (44 lignes) | `utils/setups/setupPrisma.js` | ✅ Terminé | 2026-06-07 |
+| BUG-02 | `handleAuthGeneration` : implémenter ou message clair | `commands/generate.js` | ✅ Terminé | 2026-06-07 |
+| BUG-11 | Retirer `console.log` debug du `RolesGuard` généré | `utils/setups/setupAuth.js` | ✅ Terminé | 2026-06-07 |
+| BUG-12b | Corriger commentaire `PostMapper` hardcodé dans mapper généré | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+
+---
+
+## 🟠 PHASE 1 — Refactorisation Architecture (v0.4.0)
+> Objectif : Code maintenable, testable, sans duplication
+
+### 1A — Découpage des gros fichiers
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| MP-01a | Extraire `generators/entity.generator.js` depuis `utils.js` | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-01b | Extraire `generators/dto.generator.js` depuis `utils.js` | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-01c | Extraire `generators/controller.generator.js` depuis `utils.js` | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-01d | Extraire `generators/mapper.generator.js` depuis `utils.js` | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-01e | Extraire `generators/service.generator.js` depuis `utils.js` | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-01f | Extraire `utils/helpers.js` (capitalize, decapitalize, pluralize) | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+| MP-07c | Éclater `userInput.js` → `utils/file-system.js` | `utils/userInput.js` | ✅ Terminé | 2026-06-07 |
+| MP-07d | Éclater `userInput.js` → `utils/app-module.updater.js` | `utils/userInput.js` | ✅ Terminé | 2026-06-07 |
+| MP-03 | Supprimer `generateDtox` (doublon de `generateDto`) | `utils/utils.js` | ✅ Terminé | 2026-06-07 |
+
+### 1B — Refonte du flow d'input entités (PROD-04 + PROD-05)
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| PROD-04a | Étendre modèle de champ : `unique`, `nullable`, `default` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
+| PROD-05 | Écran de révision d'entité (modifier, supprimer, renommer) | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
+| PROD-04b | Refonte state-based : `EntityBuilder` navigable | `utils/fullModeInput.js` | ⬜ À faire | — |
+| MP-02 | Dédupliquer `addCustomEntities` et `addRelations` | `utils/fullModeInput.js`, `utils/lightModeInput.js` | ⬜ À faire | — |
+
+### 1C — Architecture générale
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| MA-05 | Extraire flow commun `demo.js` → partager avec `new.js` | `commands/demo.js`, `commands/new.js` | ⬜ À faire | — |
+| MP-04 | Remplacer `execSync` par `execa` avec timeout | `utils/shell.js` | ⬜ À faire | — |
+| MA-01 | Mécanisme de rapport final (accumuler warnings, afficher en bloc) | `utils/shell.js`, `commands/new.js` | ⬜ À faire | — |
+| MA-02 | Isoler `process.chdir` — vérifier CWD avant chaque I/O | `utils/setups/projectSetup.js` | ⬜ À faire | — |
+| DRY-01 | Ajouter `--dry-run` flag (simuler sans écrire) | `bin/nestcraft.js`, `commands/new.js` | ⬜ À faire | — |
+
+---
+
+## 🟠 PHASE 2 — Qualité & Sécurité (v0.5.0)
+> Objectif : Code généré sécurisé et professionnel
+
+### 2A — Sécurité du code généré
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| MP-17 | `resetPassword` : stocker et valider le token (table DB / Redis) | `utils/setups/setupAuth.js` | ⬜ À faire | — |
+| MP-16 | OTPs : utiliser DB ou Redis au lieu de `Map` en mémoire | `utils/setups/setupAuth.js` | ⬜ À faire | — |
+| MA-06 | Pinning versions dépendances générées (ranges semver stricts) | `utils/setups/*.js` | ⬜ À faire | — |
+
+### 2B — Descriptions Swagger (PROD-02)
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| PROD-02a | Système de descriptions sémantiques par catégorie de champ | `utils/utils.js` (getFieldDescription) | ⬜ À faire | — |
+| PROD-02b | Description manuelle optionnelle dans `getFullModeInputs` | `utils/fullModeInput.js` | ⬜ À faire | — |
+| PROD-02c | Description contextuelle Create vs Update DTO | `utils/utils.js` (generateDto) | ⬜ À faire | — |
+
+### 2C — Corrections qualité
+
+| Ticket | Description | Fichier(s) | Statut | Date |
+|---|---|---|---|---|
+| BUG-18 | Corriger condition De Morgan dans `cleanModuleGenerator` | `utils/generators/cleanModuleGenerator.js` | ⬜ À faire | — |
+| MP-09 | Corriger détection ORM dans `generateConf` (ordre priorité) | `commands/generateConf.js` | ⬜ À faire | — |
+| MP-13 | JWT vars conditionnelles à `useAuth` dans `envGenerator` | `utils/envGenerator.js` | ⬜ À faire | — |
+| MP-10 | Supporter mode LIGHT sans nom en argument dans `new.js` | `commands/new.js` | ⬜ À faire | — |
+| MA-09 | Timeout 5 min sur `npm install` dans `runCommand` | `utils/shell.js` | ⬜ À faire | — |
+
+---
+
+## 🟡 PHASE 3 — Tests & CI/CD (v0.6.0)
+> Objectif : Zéro régression possible sur chaque PR
+
+### 3A — Tests unitaires (Jest)
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| TEST-01 | `generateDto()` — output TypeScript valide pour chaque ORM | ⬜ À faire | — |
+| TEST-02 | `generateEntityFileContent()` — structure domaine correcte | ⬜ À faire | — |
+| TEST-03 | `generateController()` — routes, guards, decorators | ⬜ À faire | — |
+| TEST-04 | `mapTypeToPrisma()` — tous les types | ⬜ À faire | — |
+| TEST-05 | `mapTypeToMongoose()` — tous les types | ⬜ À faire | — |
+| TEST-06 | Schema Prisma relations 1-n (FK, inverse, capitalisation) | ⬜ À faire | — |
+| TEST-07 | Schema Prisma relations n-n et 1-1 | ⬜ À faire | — |
+| TEST-08 | CLI Parser — tous les cas de flags | ⬜ À faire | — |
+| TEST-09 | `safeUpdateAppModule` — différents états `app.module.ts` | ⬜ À faire | — |
+
+### 3B — Tests d'intégration E2E
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| E2E-01 | Générer `test-full-prisma` → `tsc --noEmit` passe | ⬜ À faire | — |
+| E2E-02 | Générer `test-full-typeorm` → `tsc --noEmit` passe | ⬜ À faire | — |
+| E2E-03 | Générer `test-full-mongoose` → `tsc --noEmit` passe | ⬜ À faire | — |
+| E2E-04 | Générer `test-light-prisma` → `tsc --noEmit` passe | ⬜ À faire | — |
+| E2E-05 | Générer avec auth → `auth.module.ts` correctement câblé | ⬜ À faire | — |
+| E2E-06 | Générer avec relations 1-n → schema Prisma valide | ⬜ À faire | — |
+| E2E-07 | Test résilience PROD-03 : erreur migration → reste généré | ⬜ À faire | — |
+
+### 3C — CI/CD
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| CI-01 | ESLint sur chaque PR | ⬜ À faire | — |
+| CI-02 | Tests Node 18, 20, 22 LTS (matrix) | ⬜ À faire | — |
+| CI-03 | Génération sur Ubuntu + Windows (matrix) | ⬜ À faire | — |
+| CI-04 | Semantic Release automatique | ⬜ À faire | — |
+| CI-05 | Publish automatique sur npm | ⬜ À faire | — |
+
+---
+
+## 🟡 PHASE 4 — Features Manquantes (v0.7.0–v0.9.0)
+> Objectif : Être feature-complete avant la v1.0
+
+### 4A — Features CLI
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| FEAT-01 | `nestcraftx g auth` — implémenter complètement | ⬜ À faire | — |
+| FEAT-02 | Mode non-interactif complet (tous les flags) | ⬜ À faire | — |
+| FEAT-03 | `nestcraftx update` — auto-update de la CLI | ⬜ À faire | — |
+| FEAT-04 | `nestcraftx list` — lister entités depuis `.nestcraftxrc` | ⬜ À faire | — |
+| FEAT-05 | Support `pnpm` | ⬜ À faire | — |
+
+### 4B — Qualité du code généré
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| FEAT-06 | Pagination GET all (`?page=1&limit=10`) | ⬜ À faire | — |
+| FEAT-07 | Filtering & Sorting query params | ⬜ À faire | — |
+| FEAT-08 | Rate limiting global (`@nestjs/throttler`) | ⬜ À faire | — |
+| FEAT-09 | Health check endpoint (`/health`) | ⬜ À faire | — |
+| FEAT-10 | Exception filter global typé | ⬜ À faire | — |
+| FEAT-11 | Guards RBAC conditionnels sur endpoints | ⬜ À faire | — |
+| FEAT-12 | Support MySQL/SQLite (Prisma/TypeORM) | ⬜ À faire | — |
+
+### 4C — Expérience développeur
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| FEAT-13 | Templates personnalisés depuis GitHub | ⬜ À faire | — |
+| FEAT-14 | `nestcraftx g relation` — relation entre modules existants | ⬜ À faire | — |
+| FEAT-15 | Rapport de génération en fin de commande | ⬜ À faire | — |
+
+---
+
+## 🟢 PHASE 5 — Documentation & Site Web (v0.9.x)
+> Objectif : Site officiel avant la v1.0
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| DOC-01 | Créer site Docusaurus/VitePress (`nestcraftx.dev`) | ⬜ À faire | — |
+| DOC-02 | Page Getting Started (5 minutes) | ⬜ À faire | — |
+| DOC-03 | CLI Reference (toutes les commandes et flags) | ⬜ À faire | — |
+| DOC-04 | Architecture Guide (Clean Arch générée) | ⬜ À faire | — |
+| DOC-05 | ORM Guide (Prisma vs TypeORM vs Mongoose) | ⬜ À faire | — |
+| DOC-06 | Auth Deep Dive (JWT, guards, roles) | ⬜ À faire | — |
+| DOC-07 | Troubleshooting & Migration Guide (0.2.x → 1.0) | ⬜ À faire | — |
+| DOC-08 | Playground interactif dans le navigateur | ⬜ À faire | — |
+
+---
+
+## 🟢 PHASE 6 — Release v1.0 stable
+
+| Ticket | Description | Statut | Date |
+|---|---|---|---|
+| REL-01 | Audit de sécurité final | ⬜ À faire | — |
+| REL-02 | Test complet Windows + macOS + Linux | ⬜ À faire | — |
+| REL-03 | Revue de toutes les sorties CLI | ⬜ À faire | — |
+| REL-04 | README mis à jour avec badges CI | ⬜ À faire | — |
+| REL-05 | CHANGELOG complet depuis v0.2.6 | ⬜ À faire | — |
+| REL-06 | Publication npm avec tag `@stable` | ⬜ À faire | — |
+| REL-07 | Annonce GitHub Release avec notes détaillées | ⬜ À faire | — |
+
+---
+
+## 📝 Journal des changements
+
+| 2026-06-05 | 0.2.6 | — | Audit initial + retours prod intégrés |
+| 2026-06-05 | 0.3.0-wip | PROD-03, PROD-01a, PROD-01b, PROD-01c, BUG-09 | `runCommand` refactorisé (PROD-03). Prisma relations : capitalisation forcée des modèles et types, déduplication complète des clés étrangères (PROD-01a, b, c). Correction de la boucle asynchrone des use cases clean architecture (BUG-09). |
+| 2026-06-06 | 0.3.0-wip | BUG-01, BUG-03, BUG-06 | Unification du module system en CommonJS (BUG-01). Validation non-interactive des flags (BUG-03). Utilisation de inputs.packageManager dynamique dans `setupAuth.js` au lieu de npm en dur (BUG-06). |
+| 2026-06-07 | 0.3.0 | BUG-07, BUG-04, BUG-08, BUG-12, MP-07a, MP-07b, BUG-02, BUG-11, BUG-12b | Clôture de la Phase 0. Mongoose .env préservé. createFile supporte overwrite. safeUpdateAppModule robuste aux crochets imbriqués. help.js dynamic. Nettoyage de code mort et debug logs. |
+
+---
+
+## 🔑 Légende des statuts
+
+| Icône | Signification |
+|---|---|
+| ⬜ À faire | Ticket non démarré |
+| 🔵 En cours | Travail en cours |
+| ✅ Terminé | Ticket complété et validé |
+| ❌ Annulé | Ticket annulé (avec raison dans Notes) |
+| ⏸️ Bloqué | En attente d'un autre ticket |
+
+---
+
+*Ce fichier est mis à jour manuellement à chaque session de travail.*
+*Pour le détail technique de chaque ticket, voir [AUDIT_ROADMAP.md](./AUDIT_ROADMAP.md)*

package/commands/demo.js

@@ -15,6 +15,7 @@ const { configureDocker } = require("../utils/configs/configureDocker");
 const { generateEnvFile, writeEnvFile } = require("../utils/envGenerator");
 const { setupBootstrapLogger } = require("../utils/setups/setupLogger");
 const { saveProjectConfig } = require("../utils/file-utils/saveProjectConfig");
+const { printSetupWarnings } = require("../utils/shell");
 const actualInquirer = inquirer.default || inquirer;
 
 async function demoCommand(flags = {}) {
@@ -238,6 +239,9 @@ async function demoCommand(flags = {}) {
 
   await saveProjectConfig(demoInputs);
 
+  // Show any non-critical warnings accumulated during generation
+  printSetupWarnings();
+
   console.log("\n" + "=".repeat(60));
   logSuccess("Demonstration project created successfully!");
   console.log("=".repeat(60));

package/commands/generate.js

@@ -6,8 +6,10 @@ const { logWarning } = require("../utils/loggers/logWarning");
 const generateCleanModule = require("../utils/generators/cleanModuleGenerator");
 const { askEntityInputs } = require("../utils/interactive/askEntityInputs");
 const lightModuleGenerator = require("../utils/generators/lightModuleGenerator");
+const { printSetupWarnings, clearSetupWarnings } = require("../utils/shell");
 
 async function generate(subCommand, targetName, flags) {
+  clearSetupWarnings();
   // 1. Localisation of config file
   const configPath = path.join(process.cwd(), ".nestcraftx", ".nestcraftxrc");
 
@@ -81,13 +83,12 @@ async function handleModuleGeneration(name, config) {
   } else {
     await lightModuleGenerator(entityData, config);
   }
+
+  printSetupWarnings();
 }
 
 async function handleAuthGeneration(config) {
-  // On réutilisera ton script setupAuth corrigé
-  // await require('../utils/setups/setupAuth')(config);
-
-  logInfo("🚀 Generating module auth...");
+  logWarning("nestcraftx g auth n'est pas encore disponible en v0.3 — prévu en v0.7");
 }
 
 module.exports = generate;

package/commands/help.js

@@ -1,9 +1,36 @@
+const fs = require("fs");
+const path = require("path");
+
+function getVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"));
+    return pkg.version;
+  } catch (err) {
+    return "0.2.6";
+  }
+}
+
+function centerText(text, width) {
+  const totalSpaces = width - text.length;
+  const leftSpaces = Math.max(0, Math.floor(totalSpaces / 2));
+  const rightSpaces = Math.max(0, totalSpaces - leftSpaces);
+  return " ".repeat(leftSpaces) + text + " ".repeat(rightSpaces);
+}
+
 async function helpCommand() {
+  const version = getVersion();
+  const versionLineText = `🌟 NestCraftX CLI v${version} 🌟`;
+  const descLineText = "Clean Architecture Generator for NestJS";
+
+  const innerWidth = 59; // 59 characters inside the border
+  const paddedVersionLine = centerText(versionLineText, innerWidth);
+  const paddedDescLine = centerText(descLineText, innerWidth);
+
   console.log(`
     ╔═══════════════════════════════════════════════════════════╗
     ║                                                           ║
-    ║              🌟 NestCraftX CLI v0.2.5 🌟                  ║
-    ║          Clean Architecture Generator for NestJS          ║
+    ║${paddedVersionLine}║
+    ║${paddedDescLine}║
     ║                                                           ║
     ╚═══════════════════════════════════════════════════════════╝
 

package/commands/new.js

@@ -20,6 +20,7 @@ const readline = require("readline-sync");
 const { info, warning } = require("../utils/colors");
 const { logWarning } = require("../utils/loggers/logWarning");
 const { saveProjectConfig } = require("../utils/file-utils/saveProjectConfig");
+const { printSetupWarnings } = require("../utils/shell");
 
 async function newCommand(projectName, flags = {}) {
   if (!projectName) {
@@ -96,11 +97,10 @@ async function buildFullModeInputs(projectName, flags) {
 }
 
 function hasAllLightModeFlags(flags) {
-  // Logique interne, pas de traduction nécessaire
-  if (!flags.interactive || flags.interactive === false) {
+  if (flags.interactive === true) {
     return false;
   }
-  return true;
+  return flags.orm !== undefined;
 }
 
 function buildLightModeFromFlags(projectName, flags) {
@@ -166,11 +166,10 @@ function buildLightModeFromFlags(projectName, flags) {
 }
 
 function hasAllFullModeFlags(flags) {
-  // Logique interne, pas de traduction nécessaire
-  if (!flags.interactive || flags.interactive === false) {
+  if (flags.interactive === true) {
     return false;
   }
-  return true;
+  return flags.orm !== undefined;
 }
 
 function buildFullModeFromFlags(projectName, flags) {
@@ -268,6 +267,9 @@ async function executeProjectSetup(inputs) {
 
     await saveProjectConfig(inputs);
 
+    // Show any non-critical warnings accumulated during generation
+    printSetupWarnings();
+
     printSuccessSummary(inputs);
   } catch (error) {
     // Erreur lors de la creation du projet: ${error.message}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestcraftx",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Modern CLI to generate scalable NestJS projects with Clean Architecture (FULL) and MVP mode (LIGHT) - Enhanced with auto-generated .env secrets, complete ORM support, and entity relations",
   "main": "bin/nestcraft.js",
   "bin": {

package/utils/app-module.updater.js

@@ -0,0 +1,96 @@
+/**
+ * utils/app-module.updater.js
+ *
+ * Gestion de la mise à jour sécurisée du fichier app.module.ts.
+ * Extrait de userInput.js pour isoler cette responsabilité spécifique.
+ *
+ * Les fichiers qui importent `safeUpdateAppModule` depuis userInput.js
+ * continuent de fonctionner sans modification grâce aux ré-exports.
+ */
+
+const fs = require("fs");
+const { updateFile } = require("./file-system");
+const { logInfo } = require("./loggers/logInfo");
+const { capitalize } = require("./helpers");
+
+/**
+ * Ajoute un module NestJS dans le fichier `src/app.module.ts` de manière idempotente.
+ *
+ * - Ajoute la ligne `import { XModule } from 'src/x/x.module'` si absente
+ * - Ajoute `XModule` dans le tableau `imports: []` du décorateur @Module si absent
+ * - Utilise un parsing par comptage de crochets pour gérer les imports imbriqués
+ *   (ex: ConfigModule.forRoot({ ... }))
+ *
+ * @param {string} entity - Le nom de l'entité en minuscule (ex: "user", "post")
+ */
+async function safeUpdateAppModule(entity) {
+  const filePath = "src/app.module.ts";
+  const moduleName = `${capitalize(entity)}Module`;
+  const importLine = `import { ${moduleName} } from 'src/${entity}/${entity}.module';`;
+
+  let content = fs.readFileSync(filePath, "utf-8");
+
+  // Étape 1 : Ajout de l'import en haut du fichier si nécessaire
+  if (!content.includes(importLine)) {
+    const importMarker = `import { ConfigModule } from '@nestjs/config';`;
+
+    if (content.includes(importMarker)) {
+      await updateFile({
+        path: filePath,
+        pattern: importMarker,
+        replacement: `${importMarker}\n${importLine}`,
+      });
+      content = fs.readFileSync(filePath, "utf-8");
+    } else {
+      logInfo(
+        "  Impossible de trouver le point d'insertion de l'import (ConfigModule manquant)",
+      );
+    }
+  }
+
+  // Étape 2 : Vérifier le bloc des imports du @Module avec gestion des crochets imbriqués
+  const importsHeaderMatch = content.match(/imports:\s*\[/);
+  if (!importsHeaderMatch) {
+    logInfo("  Impossible de trouver le bloc 'imports' dans AppModule.");
+    return;
+  }
+
+  const startIndex =
+    importsHeaderMatch.index + importsHeaderMatch[0].length - 1; // index du '['
+  let depth = 1;
+  let endIndex = -1;
+  for (let i = startIndex + 1; i < content.length; i++) {
+    if (content[i] === "[") {
+      depth++;
+    } else if (content[i] === "]") {
+      depth--;
+      if (depth === 0) {
+        endIndex = i;
+        break;
+      }
+    }
+  }
+
+  if (endIndex === -1) {
+    logInfo(
+      "  Impossible de trouver le crochet de fermeture du bloc 'imports' dans AppModule.",
+    );
+    return;
+  }
+
+  const currentImportsBlock = content.substring(startIndex + 1, endIndex);
+  const isAlreadyImportedInModule = currentImportsBlock.includes(moduleName);
+
+  if (!isAlreadyImportedInModule) {
+    const updatedBlock = currentImportsBlock.trim().endsWith(",")
+      ? `${currentImportsBlock.trim()} ${moduleName},`
+      : `${currentImportsBlock.trim()}, ${moduleName},`;
+
+    const beforeBlock = content.substring(0, startIndex + 1);
+    const afterBlock = content.substring(endIndex);
+    const newContent = beforeBlock + updatedBlock + afterBlock;
+    fs.writeFileSync(filePath, newContent, "utf-8");
+  }
+}
+
+module.exports = { safeUpdateAppModule };

package/utils/cliParser.js

@@ -1,48 +1,3 @@
-/* function parseCliArgs(args) {
-  const parsed = {
-    command: null,
-    projectName: null,
-    flags: {},
-    positional: [],
-    errors: []
-  };
-
-  for (let i = 2; i < args.length; i++) {
-    const arg = args[i];
-
-    if (i === 2 && !arg.startsWith('--')) {
-      parsed.command = arg;
-      continue;
-    }
-
-    if (i === 3 && !arg.startsWith('--') && parsed.command === 'new') {
-      if (!isValidProjectName(arg)) {
-        parsed.errors.push(`Nom de projet invalide: "${arg}". Utilisez uniquement des lettres, chiffres, tirets et underscores.`);
-      }
-      parsed.projectName = arg;
-      continue;
-    }
-
-    if (arg.startsWith('--')) {
-      const [key, value] = parseFlag(arg);
-      const nextArg = args[i + 1];
-
-      if (value !== null) {
-        parsed.flags[key] = value;
-      } else if (nextArg && !nextArg.startsWith('--')) {
-        parsed.flags[key] = nextArg;
-        i++;
-      } else {
-        parsed.flags[key] = true;
-      }
-    } else {
-      parsed.positional.push(arg);
-    }
-  }
-
-  validateFlags(parsed);
-  return parsed;
-} */
 
 function parseCliArgs(args) {
   const parsed = {

package/utils/configs/setupCleanArchitecture.js

@@ -128,7 +128,7 @@ async function setupCleanArchitecture(inputs) {
 
       // 4. Use Cases
       const useCases = ["Create", "GetById", "GetAll", "Update", "Delete"];
-      useCases.forEach(async (useCase) => {
+      for (const useCase of useCases) {
         let content = "";
         const entityName = capitalize(entity.name);
         const entityNameLower = decapitalize(entity.name);
@@ -302,7 +302,7 @@ export class Delete${entityName}UseCase {
           }.use-case.ts`,
           contente: content.trim(),
         });
-      });
+      }
 
       // 5. DTOs
       const DtoFileContent = await generateDto(entity, useSwagger);