nestgen-cli 0.2.3 → 0.2.4

package/dist/engine/generation-manifest.js

@@ -52,6 +52,16 @@ export function loadGenerationManifest(projectRoot) {
     const generations = value.generations;
     if (!generations || typeof generations !== 'object' || Array.isArray(generations))
         throw new Error('Le manifeste de génération est invalide.');
+    for (const entry of Object.values(generations)) {
+        if (!entry || typeof entry !== 'object')
+            throw new Error('Le manifeste de génération est invalide.');
+        const files = entry.files;
+        if (!files || typeof files !== 'object' || Array.isArray(files))
+            throw new Error('Le manifeste de génération est invalide.');
+        for (const fingerprint of Object.values(files))
+            if (typeof fingerprint !== 'string' || !/^[a-f0-9]{64}$/.test(fingerprint))
+                throw new Error('Empreinte invalide dans le manifeste de génération.');
+    }
     return normalizeManifest(value);
 }
 function resourceDefinition(name, orm, sourceRoot, route, table, profile, fields, indexes, relations, list) {
@@ -83,10 +93,19 @@ export function withGenerationManifest(projectRoot, changes, definition) {
     const files = Object.fromEntries(changes
         .map((change) => [change.path, sha256(change.content)])
         .sort(([left], [right]) => left.localeCompare(right)));
+    // A later generation can legitimately rewrite shared files (AppModule, Prisma schema,
+    // test support). Keep every owner aligned with the content committed by this transaction.
+    const generations = Object.fromEntries(Object.entries(existing.generations).map(([key, entry]) => [
+        key,
+        {
+            ...entry,
+            files: Object.fromEntries(Object.entries(entry.files).map(([file, fingerprint]) => [file, files[file] ?? fingerprint])),
+        },
+    ]));
     const manifest = normalizeManifest({
         ...existing,
         generations: {
-            ...existing.generations,
+            ...generations,
             [generationKey(definition)]: {
                 definition,
                 files,
@@ -106,6 +125,34 @@ export function withGenerationManifest(projectRoot, changes, definition) {
         },
     ];
 }
+/** Check all recorded paths once. Older manifests may hold historical hashes for shared files. */
+export function checkGeneratedFiles(projectRoot) {
+    const manifest = loadGenerationManifest(projectRoot);
+    if (!manifest)
+        throw new Error('Manifeste de génération introuvable. Générez d’abord une ressource ou un module.');
+    const expected = new Map();
+    for (const entry of Object.values(manifest.generations)) {
+        for (const [file, fingerprint] of Object.entries(entry.files)) {
+            projectPath(projectRoot, file);
+            const hashes = expected.get(file) ?? new Set();
+            hashes.add(fingerprint);
+            expected.set(file, hashes);
+        }
+    }
+    if (expected.size === 0)
+        throw new Error('Le manifeste de génération ne contient aucun fichier à vérifier.');
+    const missing = [];
+    const modified = [];
+    for (const [file, fingerprints] of [...expected].sort(([left], [right]) => left.localeCompare(right))) {
+        const target = projectPath(projectRoot, file);
+        const stat = fs.lstatSync(target, { throwIfNoEntry: false });
+        if (!stat)
+            missing.push(file);
+        else if (!stat.isFile() || !fingerprints.has(sha256(fs.readFileSync(target, 'utf8'))))
+            modified.push(file);
+    }
+    return { checkedFiles: expected.size, missing, modified };
+}
 /** Report generated files changed after their recorded successful generation. */
 export function modifiedGeneratedFiles(projectRoot, entry) {
     return Object.entries(entry.files)

package/examples/store-api/README.md

@@ -1,6 +1,6 @@
-# Exemple Store API — NestGen CLI 0.2.3
+# Exemple Store API — NestGen CLI 0.2.4
 
-Cette application exemple décrit une API de vente avec des clients, produits, commandes et lignes de commande. Elle est validée avec `nestgen-cli@0.2.3` et TypeORM, avec le profil d’architecture `advanced`.
+Cette application exemple décrit une API de vente avec des clients, produits, commandes et lignes de commande. Elle est validée avec `nestgen-cli@0.2.4` et TypeORM, avec le profil d’architecture `advanced`.
 
 Les fichiers de `definitions/` sont la source de vérité. Ils restent volontairement déclaratifs : l’application est reconstruite par le CLI au lieu de conserver une copie de fichiers générés qui pourrait diverger du produit.
 
@@ -11,7 +11,7 @@ Créez un dossier de travail, installez la version exacte du CLI puis générez
 ```bash
 mkdir nestgen-store-api && cd nestgen-store-api
 npm init --yes
-npm install nestgen-cli@0.2.3
+npm install nestgen-cli@0.2.4
 
 ./node_modules/.bin/nestgen init store-api \
   --no-interactive \

package/examples/store-api/nestgen.example.json

@@ -1,6 +1,6 @@
 {
     "version": 1,
-    "cliVersion": "0.2.3",
+    "cliVersion": "0.2.4",
     "orm": "typeorm",
     "profile": "advanced",
     "resources": ["customers", "products", "orders", "order-items"]

package/nestgen.js

@@ -30,6 +30,7 @@ import {
     formatMigration,
     formatHelp,
 } from './dist/cli/output.js';
+import { checkGeneratedFiles } from './dist/engine/generation-manifest.js';
 
 // ────── Resolve __dirname compatible ES Modules
 const __filename = fileURLToPath(import.meta.url);
@@ -549,6 +550,7 @@ function printUsage() {
     console.log(
         formatHelp(`Usage: nestgen <commande> [options]\n\nCommandes:\n  init [nom]                   Génère un projet NestJS\n  module <nom> [--orm <orm>]  Génère un module\n  resource <nom> --fields ...    Génère un CRUD TypeORM ou Prisma
   config init|show               Gère nestgen.config.json
+  check                          Vérifie les fichiers générés sans les modifier
   doctor                       Vérifie l'installation\n\nOptions:\n  -h, --help                   Affiche cette aide\n  -V, --version                Affiche la version\n  --no-interactive             Refuse les prompts\n  --quiet                      Supprime les sorties non essentielles\n  --verbose                    Active les diagnostics\n  --no-color                   Désactive les couleurs\n  --profile <simple|advanced>   Choisit le profil d'architecture
   --package-manager <pm>        Définit npm, pnpm ou yarn
   --project-path <chemin>       Définit le dossier parent du projet init
@@ -714,14 +716,15 @@ function runDoctor(options = {}) {
 }
 
 function machineResult(command, result) {
-    return { version: 1, ok: true, command, result };
+    return { version: 1, ok: command !== 'check' || result.ok, command, result };
 }
 
 function errorCode(error) {
     const message = error instanceof Error ? error.message : String(error);
     if (/^(Option inconnue|Commande inconnue|.* requiert |Route ou table invalide|Nom de )/.test(message))
         return 'USAGE';
-    if (message.startsWith('Préflight échoué')) return 'PROJECT_INVALID';
+    if (message.startsWith('Préflight échoué') || message.toLowerCase().includes('manifeste de génération'))
+        return 'PROJECT_INVALID';
     if (/(existe déjà|Destination |Conflit |Transaction interrompue)/.test(message)) return 'CONFLICT';
     return 'INTERNAL';
 }
@@ -745,7 +748,9 @@ export async function main(args = process.argv.slice(2)) {
     if (parsed.options.help || !parsed.command) {
         if (machine)
             console.log(
-                JSON.stringify(machineResult('help', { commands: ['init', 'module', 'resource', 'config', 'doctor'] })),
+                JSON.stringify(
+                    machineResult('help', { commands: ['init', 'module', 'resource', 'config', 'check', 'doctor'] }),
+                ),
             );
         else printUsage();
         return;
@@ -807,6 +812,21 @@ export async function main(args = process.argv.slice(2)) {
             result = runDoctor(parsed.options);
             break;
 
+        case 'check': {
+            if (parsed.positionals.length) throw new Error('check ne prend aucun argument.');
+            const report = checkGeneratedFiles(process.cwd());
+            result = { ok: report.missing.length === 0 && report.modified.length === 0, ...report };
+            if (!machine) {
+                if (result.ok) console.log(`${report.checkedFiles} fichiers générés vérifiés.`);
+                else {
+                    for (const file of report.missing) console.log(`MANQUANT ${file}`);
+                    for (const file of report.modified) console.log(`MODIFIÉ ${file}`);
+                }
+            }
+            if (!result.ok) process.exitCode = 1;
+            break;
+        }
+
         default:
             throw new Error(`Commande inconnue : ${parsed.command}. Utilise --help.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nestgen-cli",
-    "version": "0.2.3",
+    "version": "0.2.4",
     "description": "NestGen CLI — Générateur modulaire NestJS (DDD, CQRS, Hexagonal)",
     "files": [
         "dist",

package/readme.md

@@ -6,18 +6,19 @@
 
 NestGen CLI generates NestJS project scaffolding and TypeORM or Prisma resources. The canonical package is [`nestgen-cli`](https://www.npmjs.com/package/nestgen-cli); the canonical repository is [`el-hack/nestgen-cli`](https://github.com/el-hack/nestgen-cli).
 
-## Published in 0.2.3 / Disponible dans 0.2.3
+## Published in 0.2.4 / Disponible dans 0.2.4
 
 | Available now / Disponible maintenant                            | Evidence / Preuve                                                                                                                      |
 | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| Nest project, module and TypeORM or Prisma resource generation   | The commands are shipped by `nestgen-cli@0.2.3` and covered by the CLI contract tests.                                                 |
+| Nest project, module and TypeORM or Prisma resource generation   | The commands are shipped by `nestgen-cli@0.2.4` and covered by the CLI contract tests.                                                 |
 | Declarative resource relations, safe updates and migration plans | The generated manifest protects manual edits; migrations remain explicitly reviewed and applied by the developer.                      |
+| Read-only generation drift check                                 | `nestgen check` compares recorded file fingerprints and returns a nonzero status for missing or modified generated files.              |
 | Operational foundation and authorization metadata                | Both are optional extension points; NestGen does not configure an identity provider, a global guard or an external monitoring service. |
 | Store API example                                                | The package ships the [version-pinned example](examples/store-api/README.md), which CI reconstructs from its resource definitions.     |
 
 ## Planned (not released) / Prévu (non publié)
 
-The [roadmap](roadmap.md) contains topics under consideration after 0.2.3. They have no release date and are not part of the npm contract until they appear in a versioned guide and `CHANGELOG.md`. La roadmap recense des pistes après 0.2.3 ; elles n’ont ni date de sortie ni engagement de compatibilité avant leur publication dans un guide versionné et le changelog.
+The [roadmap](roadmap.md) contains topics under consideration after 0.2.4. They have no release date and are not part of the npm contract until they appear in a versioned guide and `CHANGELOG.md`. La roadmap recense des pistes après 0.2.4 ; elles n’ont ni date de sortie ni engagement de compatibilité avant leur publication dans un guide versionné et le changelog.
 
 ## Supported contract
 
@@ -52,11 +53,11 @@ For Prisma, run `npx prisma generate` and apply the schema with `npx prisma db p
 Install the announced release and verify the exact binary before generating anything. Installez la version annoncée et vérifiez le binaire exact avant toute génération.
 
 ```bash
-npm install --global nestgen-cli@0.2.3
-nestgen --version # 0.2.3
+npm install --global nestgen-cli@0.2.4
+nestgen --version # 0.2.4
 ```
 
-Then follow the [Store API example](examples/store-api/README.md): it generates customers, products, orders and order items; starts PostgreSQL; creates an explicit migration; and runs generated tests. The versioned [guide](docs/versions/0.2.3.md) documents the commands and constraints used by the demo. Ensuite, suivez l’exemple Store API : il couvre la génération, PostgreSQL, une migration explicite, les tests générés et la documentation de la version.
+Then follow the [Store API example](examples/store-api/README.md): it generates customers, products, orders and order items; starts PostgreSQL; creates an explicit migration; and runs generated tests. The versioned [guide](docs/versions/0.2.4.md) documents the commands and constraints used by the demo. Ensuite, suivez l’exemple Store API : il couvre la génération, PostgreSQL, une migration explicite, les tests générés et la documentation de la version.
 
 The CI verifies the public commands against the announced package version, reconstructs the example and installs the npm tarball in a clean consumer. It validates reproducibility of these flows, not a production certification / pas une certification de production.
 
@@ -65,7 +66,7 @@ The CI verifies the public commands against the announced package version, recon
 The following flow is the supported end-to-end TypeORM path. Prerequisites: Node.js `>=24.15.0 <27`, npm 11 and Docker with Compose. It uses Docker for PostgreSQL and creates an explicit migration.
 
 ```bash
-npm install --global nestgen-cli@0.2.3
+npm install --global nestgen-cli@0.2.4
 nestgen --version
 nestgen init
 ```
@@ -131,9 +132,12 @@ nestgen module <name> [--orm typeorm|prisma] [--application name] [--dry-run]
 nestgen resource <name> --fields name:type[,name:type] [--route route] [--table table] [--profile simple|advanced] [--application name]
 nestgen config init [--orm typeorm|prisma] [--profile simple|advanced] [--package-manager npm|pnpm|yarn]
 nestgen config show
+nestgen check
 nestgen doctor
 ```
 
+`nestgen check` compares the files recorded in `.nestgen/generation-manifest.json` with their current contents. It is read-only, exits with status `1` when a recorded file is missing or modified, and supports `--json` for CI. Run it from the generated Nest project. It reports generated-file drift; it does not validate runtime behavior or database migrations. New generations update recorded fingerprints for shared files such as `app.module.ts` across all affected resources.
+
 Pour la CI, `init` accepte toutes les réponses interactives sous forme d’options :
 
 ```bash