nestcraftx 0.4.0 → 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: NestCraftX CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        node-version: [18.x, 20.x, 22.x]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm install
+
+    - name: Run unit tests
+      run: npm run test:unit
+
+    - name: Run E2E integration tests
+      run: npm run test:e2e

package/CHANGELOG.fr.md

@@ -2,6 +2,80 @@
 
 Toutes les modifications notables apportées à NestCraftX seront documentées dans ce fichier.
 
+## [1.0.0] - 02-07-2026
+
+### Ajouté
+
+- **Commande de relation autonome (`nestcraftx g relation`)** : Générateur interactif autonome de relations inter-modules (1-n, n-1, 1-1, n-n) mettant à jour les entités, les DTOs, les mappers et le schéma de base de données (migrations Prisma et références Mongoose).
+- **Guards RBAC conditionnels** : Protection automatique des routes de mutation (`POST`, `PATCH`, `DELETE`) par `JwtAuthGuard` et `RolesGuard` (`@Roles('ADMIN')`) et des routes de lecture avec `@Public()` lorsque l'authentification est activée.
+- **Rate limiting global (`@nestjs/throttler`)** : Intégration de la limitation de requêtes globale, configurable interactivement ou par le flag CLI `--throttler`.
+- **Endpoint de Health Check (`/health`)** : Route native de surveillance `/health` exposant le statut, le timestamp et l'uptime de l'application, documentée dans Swagger.
+- **Paramètres de requête avancés** : Pagination, filtrage et tri injectés automatiquement dans les contrôleurs et les dépôts.
+- **Rapport de génération interactif** : Boîte ASCII affichée en fin de génération récapitulant les fichiers créés et les prochaines étapes.
+- **62 tests unitaires Jest** : Couverture unitaire robuste.
+
+### Corrigé
+
+- **Unification CommonJS** : Résolution des crashes de runtime en unifiant le module system (CommonJS) dans `utils.js` et `userInput.js`.
+- **Validation non-interactive des flags** : Correction du comportement des flags de configuration rapide du projet.
+- **Capitalisation Prisma** : Correction de la capitalisation lors de la génération de relations Prisma.
+
+---
+
+## [0.6.0] - 16-06-2026
+
+### Ajouté
+
+- **Framework de test Jest** : Configuration de Jest pour exécuter des tests dans le projet.
+- **Tests Unitaires** : Écriture de 26 tests unitaires validant le parseur CLI, les générateurs d'entités, de DTOs (avec Swagger sémantique), de contrôleurs et la mise à jour d'`app.module.ts`.
+- **Tests d'Intégration E2E** : Test de génération de projet réel en tâche de fond avec installation et compilation TypeScript (`tsc --noEmit`) pour garantir un code généré valide.
+- **CI/CD GitHub Actions** : Pipeline de tests automatique s'exécutant sur Ubuntu et Windows pour les versions LTS de Node.js (18, 20, 22).
+
+### Corrigé
+
+- **Conflits de Peer Dependencies Upstream (NestJS 11)** :
+  - Ajout automatique du flag `--legacy-peer-deps` sur toutes les commandes d'installation npm lancées par le projet généré.
+  - Ajout du flag `--skip-install` sur la commande Nest CLI initiale pour accélérer la génération et éviter les conflits d'installation doublonnés.
+- **Suivi Git des Tests** : Correction du `.gitignore` pour suivre les fichiers de tests unitaires et E2E en ignorant le dossier temporaire `tests/e2e-output`.
+
+---
+
+## [0.5.0] - 16-06-2026
+
+### Ajouté
+
+- **Persistance DB-backed pour les OTPs & Reset Tokens** : Remplacement du stockage en mémoire process par des tables et des schémas de base de données dédiés pour Prisma, TypeORM, et Mongoose.
+- **Sécurisation de la réinitialisation de mot de passe** : Intégration de la validation complète de non-expiration et d'invalidation après usage du token dans `AuthService`.
+- **Pinning de versions strict** : Remplacement des dépendances de dernière version par des plages semver stables dans tous les setups de base de données, auth et swagger.
+- **Descriptions Swagger Sémantiques** : Remplacement des descriptions par défaut par des templates sémantiques contextuels et support de descriptions personnalisées saisies par l'utilisateur.
+
+### Corrigé
+
+- **Condition logique De Morgan** : Correction du type de relation dans `cleanModuleGenerator`.
+- **Détection d'ORM** : Réorganisation de l'ordre de détection en vérifiant l'existence de `prisma/` avant de lire le package.json.
+- **JWT Secrets Conditionnels** : Génération des variables d'environnement JWT uniquement si `useAuth` est activé.
+- **Mode LIGHT sans arguments** : Prise en charge correcte du mode LIGHT sans nom de projet fourni en premier argument dans `new.js`.
+- **Timeout npm install** : Timeout de 5 minutes ajouté sur `npm install` pour éviter les blocages.
+
+---
+
+## [0.4.0] - 14-06-2026
+
+### Ajouté
+
+- **Saisie interactive d'entités state-based (EntityBuilder)** : Saisie flexible des types, des clés uniques, des champs optionnels et des valeurs par défaut.
+- **Écran de révision d'entité** : Menu interactif post-saisie permettant de modifier, renommer, supprimer des champs ou l'entité avant génération.
+- **Mode de simulation (--dry-run)** : Prévisualisation complète des répertoires et fichiers simulés sans écriture sur le disque physique.
+- **Rapport de warnings final** : Accumulation et affichage des avertissements non critiques en fin de pipeline de génération.
+
+### Changé
+
+- **Découpage de utils.js** : Éclatement du fichier monolithique de 2198 lignes en générateurs spécialisés par couche architecture (`entity.generator`, `dto.generator`, `controller.generator`, etc.).
+- **Découpage de userInput.js** : Éclatement en modules d'accès fichier (`file-system.js`) et de mise à jour AppModule (`app-module.updater.js`).
+- **Pipeline partagé DRY** : Unification des séquences de création de projets entre `demo.js` et `new.js`.
+
+---
+
 ## [0.3.0] - 07-06-2026
 
 ### Ajouté

package/CHANGELOG.md

@@ -2,6 +2,80 @@
 
 All notable changes to NestCraftX will be documented in this file.
 
+## [1.0.0] - 2026-07-02
+
+### Added
+
+- **Standalone Relation Command (`nestcraftx g relation`)**: Standalone interactive module-to-module relation generator updating domain entities, DTOs, mappers, and database schemas.
+- **Conditional RBAC Guards**: Automatically protects mutation endpoints (`POST`, `PATCH`, `DELETE`) with `JwtAuthGuard` and `RolesGuard` and read endpoints with `@Public()` if auth is enabled.
+- **Global Rate Limiting (`@nestjs/throttler`)**: Configurable global rate limit policy with interactive prompts and `--throttler` flag.
+- **Health Check Endpoint (`/health`)**: Exposes native health probe routes out of the box.
+- **Advanced Query Parameters (Pagination, Filtering, Sorting)**: Auto-injects paginated data query parameters and repository mapping.
+- **Interactive Scaffolding Report**: Post-scaffolding ASCII table summarizing files created and next steps.
+- **62 Unit Tests**: Clean testing environment with Jest.
+
+### Fixed
+
+- **CommonJS Module System**: Unified ESM imports and CommonJS exports inside `utils.js` and `userInput.js` to prevent runtime crashes.
+- **Non-Interactive Flag Parsing**: Corrected boolean flags and path arguments validations in `newCommand` parser.
+- **Prisma capitalization**: Forced capitalization mapping for related model fields.
+
+---
+
+## [0.6.0] - 2026-06-16
+
+### Added
+
+- **Jest Testing Framework**: Standard Jest configuration to support unit and integration tests.
+- **Unit Tests**: Wrote 26 unit tests cover CLI parsing, entity generation, DTO generation (including semantic Swagger), controller presentation, and app.module.ts updates.
+- **E2E Integration Tests**: Wrote a complete generator integration test validating scaffolding, package installation, and TypeScript compilation (`tsc --noEmit`).
+- **CI/CD GitHub Actions**: Pipeline executing tests on Ubuntu & Windows across all Node.js LTS versions (18, 20, 22).
+
+### Fixed
+
+- **Upstream Peer Dependency Conflicts (NestJS 11)**:
+  - Appended `--legacy-peer-deps` dynamically to all npm install/add commands.
+  - Injected `--skip-install` flag into initial Nest CLI creation to speed up scaffolding and avoid initial dependency clashes.
+- **Test Files Tracking**: Adjusted `.gitignore` to allow tracking test files while keeping `tests/e2e-output` clean.
+
+---
+
+## [0.5.0] - 2026-06-16
+
+### Added
+
+- **Persistent DB Storage for OTPs & Password Reset Tokens**: Replaced process memory maps with dedicated DB tables/schemas and ORM repositories (Prisma, TypeORM, Mongoose).
+- **Password Reset Validation**: Implemented validation of non-expiration and single-use invalidation of reset tokens in `AuthService`.
+- **Strict Version Pinning**: Restricted all package installations (Prisma, Mongoose, TypeORM, Swagger, Auth) to precise semver ranges.
+- **Semantic Swagger Descriptions**: Context-aware description templates for dates, decimals, foreign keys, and custom manually prompt descriptions.
+
+### Fixed
+
+- **De Morgan Logic Bug**: Fixed relation type exclusion check in `cleanModuleGenerator`.
+- **ORM Detection Order**: Prioritized checking the physical existence of the `/prisma` folder over package dependencies in `generateConf`.
+- **Conditional JWT Env Variables**: Generated JWT environment variables only if `useAuth` is true.
+- **LIGHT Mode Arguments**: Fixed LIGHT mode scaffolding when no project name was passed.
+- **npm install Timeout**: Set a 5-minute timeout on dependency installations.
+
+---
+
+## [0.4.0] - 2026-06-14
+
+### Added
+
+- **State-Based Entity Input Flow**: Navigable `EntityBuilder` to support unique constraints, nullable attributes, and default values.
+- **Interactive Entity Revision Screen**: Revision menu allowing users to modify, rename, delete fields, or rename entities before code generation.
+- **Dry-Run Simulation**: Global `--dry-run` flag to preview generated files without writing to disk.
+- **Warnings Report**: Collected non-critical errors and displayed them as a warnings report at the end of execution.
+
+### Changed
+
+- **utils.js Split**: Eclated 2198-line monolith into dedicated generators (`entity.generator`, `dto.generator`, etc.).
+- **userInput.js Split**: Split into file-system helpers (`file-system.js`) and module updaters (`app-module.updater.js`).
+- **DRY Shared Pipeline**: Unified the project creation steps between `new` and `demo` commands.
+
+---
+
 ## [0.3.0] - 2026-06-07
 
 ### Added

package/PROGRESS.md

@@ -10,14 +10,14 @@
 |---|---|---|---|---|
 | Phase 0 — Stabilisation (v0.3.0) | ✅ Terminé | 17 | 17 | 100% |
 | Phase 1 — Refactorisation (v0.4.0) | ✅ Terminé | 18 | 18 | 100% |
-| 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 2 — Qualité & Sécurité (v0.5.0) | ✅ Terminé | 11 | 11 | 100% |
+| Phase 3 — Tests & CI/CD (v0.6.0) | ✅ Terminé | 15 | 15 | 100% |
+| Phase 4 — Features (v0.7–0.9) | ✅ Terminé | 12 | 12 | 100% |
 | Phase 5 — Documentation (v0.9.x) | ⏸️ En attente | 8 | 0 | 0% |
-| Phase 6 — Release v1.0 | ⏸️ En attente | 7 | 0 | 0% |
-| **TOTAL** | | **89** | **35** | **39%** |
+| Phase 6 — Release v1.0 | 🔵 En cours | 7 | 5 | 71% |
+| **TOTAL (v1.0)** | | **88** | **78** | **89%** |
 
-> Mis à jour : 2026-06-16
+> Mis à jour : 2026-06-29
 
 ---
 
@@ -103,27 +103,27 @@
 
 | 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 | — |
+| MP-17 | `resetPassword` : stocker et valider le token (table DB / Redis) | `utils/setups/setupAuth.js` | ✅ Terminé | 2026-06-16 |
+| MP-16 | OTPs : utiliser DB ou Redis au lieu de `Map` en mémoire | `utils/setups/setupAuth.js` | ✅ Terminé | 2026-06-16 |
+| MA-06 | Pinning versions dépendances générées (ranges semver stricts) | `utils/setups/*.js` | ✅ Terminé | 2026-06-16 |
 
 ### 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 | — |
+| PROD-02a | Système de descriptions sémantiques par catégorie de champ | `utils/generators/application/dtoGenerator.js` | ✅ Terminé | 2026-06-16 |
+| PROD-02b | Description manuelle optionnelle dans `getFullModeInputs` | `utils/interactive/entityBuilder.js` | ✅ Terminé | 2026-06-16 |
+| PROD-02c | Description contextuelle Create vs Update DTO | `utils/generators/application/dtoGenerator.js` | ✅ Terminé | 2026-06-16 |
 
 ### 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 | — |
+| BUG-18 | Corriger condition De Morgan dans `cleanModuleGenerator` | `utils/generators/cleanModuleGenerator.js` | ✅ Terminé | 2026-06-16 |
+| MP-09 | Corriger détection ORM dans `generateConf` (ordre priorité) | `commands/generateConf.js` | ✅ Terminé | 2026-06-16 |
+| MP-13 | JWT vars conditionnelles à `useAuth` dans `envGenerator` | `utils/envGenerator.js` | ✅ Terminé | 2026-06-16 |
+| MP-10 | Supporter mode LIGHT sans nom en argument dans `new.js` | `commands/new.js` | ✅ Terminé | 2026-06-16 |
+| MA-09 | Timeout 5 min sur `npm install` dans `runCommand` | `utils/shell.js` | ✅ Terminé | 2026-06-16 |
 
 ---
 
@@ -134,37 +134,37 @@
 
 | 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 | — |
+| TEST-01 | `generateDto()` — output TypeScript valide pour chaque ORM | ✅ Terminé | 2026-06-16 |
+| TEST-02 | `generateEntityFileContent()` — structure domaine correcte | ✅ Terminé | 2026-06-16 |
+| TEST-03 | `generateController()` — routes, guards, decorators | ✅ Terminé | 2026-06-16 |
+| TEST-04 | `mapTypeToPrisma()` — tous les types | ✅ Terminé | 2026-06-16 |
+| TEST-05 | `mapTypeToMongoose()` — tous les types | ✅ Terminé | 2026-06-16 |
+| TEST-06 | Schema Prisma relations 1-n (FK, inverse, capitalisation) | ✅ Terminé | 2026-06-16 |
+| TEST-07 | Schema Prisma relations n-n et 1-1 | ✅ Terminé | 2026-06-16 |
+| TEST-08 | CLI Parser — tous les cas de flags | ✅ Terminé | 2026-06-16 |
+| TEST-09 | `safeUpdateAppModule` — différents états `app.module.ts` | ✅ Terminé | 2026-06-16 |
 
 ### 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 | — |
+| E2E-01 | Générer `test-full-prisma` → `tsc --noEmit` passe | ✅ Terminé | 2026-06-16 |
+| E2E-02 | Générer `test-full-typeorm` → `tsc --noEmit` passe | ✅ Terminé | 2026-06-16 |
+| E2E-03 | Générer `test-full-mongoose` → `tsc --noEmit` passe | ✅ Terminé | 2026-06-16 |
+| E2E-04 | Générer `test-light-prisma` → `tsc --noEmit` passe | ✅ Terminé | 2026-06-16 |
+| E2E-05 | Générer avec auth → `auth.module.ts` correctement câblé | ✅ Terminé | 2026-06-16 |
+| E2E-06 | Générer avec relations 1-n → schema Prisma valide | ✅ Terminé | 2026-06-16 |
+| E2E-07 | Test résilience PROD-03 : erreur migration → reste généré | ✅ Terminé | 2026-06-16 |
 
 ### 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 | — |
+| CI-01 | ESLint sur chaque PR | ✅ Terminé | 2026-06-16 |
+| CI-02 | Tests Node 18, 20, 22 LTS (matrix) | ✅ Terminé | 2026-06-16 |
+| CI-03 | Génération sur Ubuntu + Windows (matrix) | ✅ Terminé | 2026-06-16 |
+| CI-04 | Semantic Release automatique | ✅ Terminé | 2026-06-16 |
+| CI-05 | Publish automatique sur npm | ✅ Terminé | 2026-06-16 |
 
 ---
 
@@ -175,31 +175,31 @@
 
 | 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 | — |
+| FEAT-01 | `nestcraftx g auth` — implémenter complètement | ✅ Terminé | 2026-06-18 |
+| FEAT-02 | Mode non-interactif complet (tous les flags) | ✅ Terminé | 2026-06-18 |
+| FEAT-03 | `nestcraftx update` — auto-update de la CLI | ⏸️ Post-v1.0 | — |
+| FEAT-04 | `nestcraftx list` — lister entités depuis `.nestcraftxrc` | ✅ Terminé | 2026-06-18 |
+| FEAT-05 | Support `pnpm` | ✅ Terminé | 2026-06-18 |
 
 ### 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 | — |
+| FEAT-06 | Pagination GET all (`?page=1&limit=10`) | ✅ Terminé | 2026-06-29 |
+| FEAT-07 | Filtering & Sorting query params | ✅ Terminé | 2026-06-29 |
+| FEAT-08 | Rate limiting global (`@nestjs/throttler`) | ✅ Terminé | 2026-07-02 |
+| FEAT-09 | Health check endpoint (`/health`) | ✅ Terminé | 2026-07-02 |
+| FEAT-10 | Exception filter global typé | ✅ Terminé | 2026-06-29 |
+| FEAT-11 | Guards RBAC conditionnels sur endpoints | ✅ Terminé | 2026-07-01 |
+| FEAT-12 | Support MySQL/SQLite (Prisma/TypeORM) | ⏸️ Post-v1.0 | — |
 
 ### 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 | — |
+| FEAT-13 | Templates personnalisés depuis GitHub | ⏸️ Post-v1.0 | — |
+| FEAT-14 | `nestcraftx g relation` — relation entre modules existants | ✅ Terminé | 2026-07-02 |
+| FEAT-15 | Rapport de génération en fin de commande | ✅ Terminé | 2026-07-02 |
 
 ---
 
@@ -223,11 +223,11 @@
 
 | Ticket | Description | Statut | Date |
 |---|---|---|---|
-| REL-01 | Audit de sécurité final | ⬜ À faire | — |
+| REL-01 | Audit de sécurité final | ✅ Terminé | 2026-07-02 |
 | 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-03 | Revue de toutes les sorties CLI | ✅ Terminé | 2026-07-02 |
+| REL-04 | README mis à jour avec badges CI | ✅ Terminé | 2026-07-02 |
+| REL-05 | CHANGELOG complet depuis v0.2.6 | ✅ Terminé | 2026-07-02 |
 | REL-06 | Publication npm avec tag `@stable` | ⬜ À faire | — |
 | REL-07 | Annonce GitHub Release avec notes détaillées | ⬜ À faire | — |
 
@@ -240,6 +240,8 @@
 | 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. |
 | 2026-06-14 | 0.3.0-wip | PROD-04a, PROD-04b, PROD-05, MP-02 | Refonte state-based interactive de la saisie d'entités avec EntityBuilder. Support des contraintes unique, nullable et valeurs par défaut. Alignement et déduplication des générateurs (Prisma, TypeORM, Mongoose, DTOs, et Domain Entities). |
+| 2026-06-16 | 0.6.0 | TEST-01..09, E2E-01..07, CI-01..05 | Clôture de la Phase 3. Ajout de 26 tests unitaires Jest, tests d'intégration E2E vérifiant la compilation TypeScript sans erreur des projets générés (Prisma/TypeORM/Mongoose) et pipeline GitHub Actions (Ubuntu/Windows). |
+| 2026-06-18 | 0.7.0 | FEAT-01, FEAT-02, FEAT-04, FEAT-05 | Clôture des tickets CLI de la Phase 4. Implémentation complète de `nestcraftx g auth` (multi-ORM, secrets JWT et migrations), mode de génération non-interactif robuste via CLI flags, commande `nestcraftx list` avec tableaux ASCII, et support complet multi-package manager (pnpm, yarn). |
 
 ---
 

package/README.fr.md

@@ -29,13 +29,13 @@ NestCraftX implémente les meilleures pratiques modernes : **Clean Architecture*
 - **Relations Interactives :** Définissez vos relations 1-N ou N-N directement depuis votre terminal.
 - **Configuration Intelligente :** Décorateurs Swagger automatiques, fichiers .env auto-documentés et connexions aux bases de données pré-configurées.
 
-> **Version 0.2.5 :** Mise à jour majeure — Génération interactive par flags, refonte de l'authentification avec gestionnaire de session, templates professionnels (.gitignore, README) et standards de code maintenus par la communauté !
+> **Version 1.0.0 (Version Stable) :** Échafaudage de qualité production avec Clean Architecture, authentification JWT, mise à jour dynamique des relations, guards RBAC conditionnels, rate limiting global, health checks, pagination/filtrage/tri avancés, Swagger UI et fichiers Docker Compose !
 
 ---
 
 ## Sommaire
 
-- [Nouveautes v0.2.5](#nouveautes-v025)
+- [Nouveautés v1.0.0](#nouveautes-v100-version-stable)
 - [Objectif du projet](#objectif-du-projet)
 - [Prérequis](#prérequis)
 - [Installation](#installation)
@@ -50,59 +50,32 @@ NestCraftX implémente les meilleures pratiques modernes : **Clean Architecture*
 
 ---
 
-## Nouveautes v0.2.5
+## Nouveautés v1.0.0 (Version Stable)
 
-### Deux Modes d'Architecture
+### 🔗 Commande de Relation Autonome (`nestcraftx g relation`)
+- Créez des relations 1-n, n-1, 1-1, ou n-n entre des **modules existants** à tout moment.
+- Met automatiquement à jour les entités de domaine (champs FK et getters), les DTOs (Create et Update) et les mappers de données.
+- Synchronise les schémas de base de données (exécution de format, génération du client et migrations dev pour Prisma ; injection de références ObjectId pour Mongoose).
 
-**Mode FULL - Architecture Complete**
+### 🛡️ Guards RBAC Conditionnels & Intégration Swagger
+- Les endpoints de mutation (`POST`, `PATCH`, `DELETE`) sont protégés par `JwtAuthGuard` et `RolesGuard` (`@Roles('ADMIN')`) uniquement si l'authentification est active.
+- Les endpoints de lecture (`GET`, `GET :id`) sont décorés de `@Public()`.
+- Génère une documentation API complète avec `@ApiBearerAuth()` et des réponses d'erreur standardisées lorsque Swagger est activé.
 
-- Clean Architecture avec use-cases, mappers, adapters
-- Separation stricte domain/application/infrastructure/presentation
-- Ideal pour projets complexes et scalables
+### 🚦 Rate Limiting Global (Module Throttler)
+- Intégration du package officiel `@nestjs/throttler` avec des politiques de rate limiting globales pré-configurées (par défaut : 10 requêtes par minute).
+- Configurable via les prompts interactifs ou via le flag CLI `--throttler`.
 
-**Mode LIGHT - Architecture MVP**
+### 🏥 Endpoint de Health Check (`/health`)
+- Expose une route native `/health` renvoyant le statut global (`ok`), le timestamp et l'uptime de l'application (`process.uptime()`).
+- Entièrement documenté dans Swagger, optimisé sans package tiers lourd pour une compilation ultra-rapide et une sécurité maximale.
 
-- Structure simplifiee : controllers → services → repositories
-- Demarrage rapide pour prototypes
-- Parfait pour petits projets et MVPs
+### 🚀 Paramètres de Requête Avancés (Pagination, Filtrage, Tri)
+- Injection automatique des fonctionnalités de récupération paginée (ex: `?page=1&limit=10&search=...&sortBy=createdAt&sortOrder=desc`) dans les contrôleurs et les couches de dépôts.
+- Mappe les paramètres de requête de manière fluide vers les requêtes Prisma, TypeORM ou Mongoose.
 
-### Demo Command Amélioré
-
-- ✅ Options par flags : `--light`, `--orm`, `--auth`, `--swagger`, `--docker`
-- ✅ Mode interactif : pose les questions uniquement si flags manquants
-- ✅ Fusion intelligente flags + réponses interactives
-- ✅ 3 entités pré-configurées avec relations
-- ✅ Support de tous les ORMs (Prisma, TypeORM, Mongoose)
-- ✅ Instructions séparées dans [Documentation Demo](./DEMO.md)
-
-### CLI Moderne avec Flags
-
-```bash
-nestcraftx new <project-name> [options]
-
-Options:
-  --light              Mode architecture simplifiee
-  --full               Mode architecture complete (defaut)
-  --dn=<db>            Choix db: postgresql|mongodb
-  --orm=<orm>          Choix ORM: prisma|typeorm|mongoose
-  --auth               Active authentification JWT
-  --swagger            Active documentation Swagger
-  --docker             Active Docker (defaut: true)
-```
-
-### Generation Automatique de Secrets
-
-- Secrets JWT auto-generes (64 caracteres securises)
-- Fichier .env pret a l'emploi
-- DATABASE_URL configure automatiquement
-- Fichier .env.example sanitise
-
-### UX Amelioree
-
-- Messages avec couleurs (info, success, error)
-- Spinners animes pour operations longues
-- Resume detaille post-generation
-- Validation des options en temps reel
+### 📋 Rapport de Génération Interactif
+- Affichage automatique d'un rapport CLI enrichi encadré en ASCII après chaque génération de module, listant les fichiers générés, les schémas DB mis à jour, les relations établies et les étapes suivantes.
 
 ### Exemples Rapides
 
@@ -176,6 +149,21 @@ npm install
 npm link
 ```
 
+### Exécuter les tests
+
+Nous utilisons Jest pour exécuter les tests unitaires et les tests d'intégration E2E du compilateur :
+
+```bash
+# Lancer les tests unitaires (rapides)
+npm run test:unit
+
+# Lancer les tests d'intégration E2E (génère un projet, exécute npm install & tsc)
+npm run test:e2e
+
+# Lancer tous les tests
+npm test
+```
+
 ---
 
 ## Commandes disponibles
@@ -565,31 +553,34 @@ open http://localhost:3000/api/docs
 
 ## Feuille de Route (Roadmap)
 
-### Version 0.2.x — Stabilisation
+### Version 0.3.0 — Stabilisation & UX (Terminé)
+- [x] Unification du module system CommonJS.
+- [x] Version d'aide dynamique et validation interactive des flags.
+- [x] Configuration dynamique du package manager.
 
-- [x] Architectures Light & Full
-- [x] CLI Interactif
-- [x] Support Multi-ORM (Prisma / TypeORM / Mongoose)
-- [ ] Amélioration de la documentation et des exemples
+### Version 0.4.0 — Refactorisation d'Architecture (Terminé)
+- [x] Découpage du fichier monolithique utils.js en générateurs spécialisés.
+- [x] EntityBuilder interactif basé sur un state avec révision et corrections de champs.
+- [x] Mode simulation globale (`--dry-run`).
 
-### Version 0.3.0 — Expérience Développeur (DX)
+### Version 0.5.0 — Qualité & Sécurité (Terminé)
+- [x] Stockage persistant en DB pour les OTPs et tokens de réinitialisation de mot de passe.
+- [x] Pinning strict des versions de dépendances installées par les setups.
+- [x] Descriptions Swagger sémantiques contextuelles et saisie optionnelle de descriptions manuelles.
 
-- [ ] Commande `generate` (ajouter des modules/entités à un projet existant)
-- [ ] Support SQLite pour des démos et tests rapides sans config
-- [ ] Meilleure gestion des erreurs et logs terminaux colorés
+### Version 0.6.0 — Tests & CI/CD (Terminé)
+- [x] Couverture de tests unitaires via Jest.
+- [x] Tests de compilation E2E du projet généré et résolution des conflits peer deps (NestJS 11).
+- [x] Pipeline CI/CD GitHub Actions multi-OS pour Node.js.
 
-### Version 0.4.0 — Prêt pour la Production
-
-- [ ] Stratégies de session optionnelles (Map / Base de données / Redis)
-- [ ] Templates de seeding (peuplement de données) avancés
-- [ ] Presets de projet (API seule / Auth / CRUD complet)
+### Version 0.7.0 - 0.9.0 — Fonctionnalités Manquantes (En cours)
+- [ ] Commande `generate auth` interactive et mode non-interactif complet.
+- [ ] Pagination, filtres de requêtes, rate limiting et guards RBAC.
+- [ ] Support de MySQL et SQLite.
 
 ### Version 1.0.0 — Version Stable
-
-- [ ] CLI nativement en TypeScript
-- [ ] Conventions strictes et contrats d'API stables
-- [ ] Site officiel de documentation
-- [ ] Garanties de support à long terme (LTS)
+- [ ] Site officiel de documentation.
+- [ ] Audit final de production et garanties de support LTS.
 
 ## Contribuer
 
@@ -644,7 +635,7 @@ Merci à tous les contributeurs et à la communauté NestJS !
 
 ---
 
-**NestCraftX v0.2.5** - Clean Architecture Made Simple
+**NestCraftX v0.6.0** - Clean Architecture Made Simple
 
 Pour plus d'informations:
 

package/bin/nestcraft.js

@@ -61,6 +61,14 @@ switch (command) {
     });
     break;
 
+  case "list":
+  case "l":
+    require("../commands/list")().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) => {

package/commands/demo.js

@@ -42,6 +42,14 @@ async function demoCommand(flags = {}) {
       default: true,
     });
   }
+  if (flags.throttler === undefined) {
+    questions.push({
+      type: "confirm",
+      name: "throttler",
+      message: "Enable Rate Limiting (Throttler)?",
+      default: true,
+    });
+  }
   if (flags.orm === undefined) {
     questions.push({
       type: "list",
@@ -81,6 +89,7 @@ async function demoCommand(flags = {}) {
   const useDocker = !!options.docker;
   const useAuth = !!options.auth;
   const useSwagger = !!options.swagger;
+  const useThrottler = !!options.throttler;
   const orm = options.orm || "prisma";
 
   let selectedDB = "postgresql";
@@ -181,6 +190,7 @@ async function demoCommand(flags = {}) {
     useDocker,
     useAuth,
     useSwagger,
+    useThrottler,
     swaggerInputs: {
       title: "Blog Demo API",
       description: