nestcraftx 0.2.5 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-2026 Augustin Selete
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+MIT License
+
+Copyright (c) 2025-2026 Augustin Selete
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

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/bin/nestcraft.js

@@ -1,65 +1,85 @@
 #!/usr/bin/env node
-const { execSync } = require("child_process");
-const { parseCliArgs } = require("../utils/cliParser");
-
-const args = parseCliArgs(process.argv);
-const command = args.command || "help";
-
-// 🔐 Forcer UTF-8 uniquement sur Windows
-if (process.platform === "win32") {
-  try {
-    execSync("chcp 65001", { stdio: "ignore" }); // Changer l'encodage de la console
-  } catch (err) {
-    const message = `⚠️ Impossible de forcer UTF-8 dans le terminal Windows: ${err}`;
-    console.warn(message);
-  }
-}
-
-switch (command) {
-  case "new":
-    require("../commands/new")(args.projectName, args.flags).catch((err) => {
-      console.error("❌ Erreur:", err.message);
-      process.exit(1);
-    });
-    break;
-
-  case "start":
-    require("../commands/start")();
-    break;
-
-  case "test":
-    require("../commands/test")().catch((err) => {
-      console.error("❌ Erreur:", err.message);
-      process.exit(1);
-    });
-    break;
-
-  case "info":
-    require("../commands/info")().catch((err) => {
-      console.error("❌ Erreur:", err.message);
-      process.exit(1);
-    });
-    break;
-
-  case "demo":
-    // Passe tous les flags à la commande demo
-    require("../commands/demo")(args.flags).catch((err) => {
-      console.error("❌ Erreur:", err.message);
-      process.exit(1);
-    });
-    break;
-
-  case "--version":
-  case "-v":
-  case "version":
-    const pkg = require("../package.json");
-    console.log("NestCraftX v" + pkg.version);
-    break;
-
-  case "--help":
-  case "-h":
-  case "help":
-  default:
-    require("../commands/help")();
-    break;
-}
+const { execSync } = require("child_process");
+const { parseCliArgs } = require("../utils/cliParser");
+
+const args = parseCliArgs(process.argv);
+const command = args.command || "help";
+
+// 🔐 Forcer UTF-8 uniquement sur Windows
+if (process.platform === "win32") {
+  try {
+    execSync("chcp 65001", { stdio: "ignore" }); // Changer l'encodage de la console
+  } catch (err) {
+    const message = `⚠️ Impossible de forcer UTF-8 dans le terminal Windows: ${err}`;
+    console.warn(message);
+  }
+}
+
+switch (command) {
+  case "new":
+    require("../commands/new")(args.projectName, args.flags).catch((err) => {
+      console.error("❌ Erreur:", err.message);
+      process.exit(1);
+    });
+    break;
+
+  case "generate":
+  case "g":
+    require("../commands/generate")(
+      args.subCommand,
+      args.targetName,
+      args.flags,
+    ).catch((err) => {
+      console.error("❌ Erreur de génération:", err);
+      process.exit(1);
+    });
+    break;
+
+  case "generate-conf":
+  case "g-conf":
+    require("../commands/generateConf")().catch((err) => {
+      console.error("❌ Erreur de récupération:", err.message);
+      process.exit(1);
+    });
+    break;
+
+  case "start":
+    require("../commands/start")();
+    break;
+
+  case "test":
+    require("../commands/test")().catch((err) => {
+      console.error("❌ Erreur:", err.message);
+      process.exit(1);
+    });
+    break;
+
+  case "info":
+    require("../commands/info")().catch((err) => {
+      console.error("❌ Erreur:", err.message);
+      process.exit(1);
+    });
+    break;
+
+  case "demo":
+    // Passe tous les flags à la commande demo
+    require("../commands/demo")(args.flags).catch((err) => {
+      console.error("❌ Erreur:", err.message);
+      process.exit(1);
+    });
+    break;
+
+  case "--version":
+  case "-v":
+  case "version":
+    const pkg = require("../package.json");
+    console.log("NestCraftX v" + pkg.version);
+    break;
+
+  case "--help":
+  case "-h":
+  case "help":
+  default:
+    require("../commands/help")();
+    break;
+}