create-gef 1.2.0 → 1.3.0

package/.cursorrules

@@ -182,6 +182,9 @@ Ces limites sont non-négociables. L'IA ne peut JAMAIS générer du code qui les
 - Commit dédié : `docs(adr): création ADR-XXX — [titre] (#ticket)`
 - ⚠️ Ne PAS consigner les ADR dans le RESEARCH_LOG (réservé aux bugs).
 
+### Fin d'une tâche (Avant de conclure)
+- [ ] **Vérification Documentaire** : As-tu mis à jour le `README.md`, le `CHANGELOG.md` ou la doc Diátaxis si tes changements impactent l'architecture, l'installation ou les fonctionnalités globales ? **Tu dois toujours faire cette vérification proactivement, sans que l'utilisateur te le demande.**
+
 ---
 
 *Ce fichier est la loi fondamentale du GEF. Il garantit un niveau d'ingénierie DORA "Elite" sur tous les projets.*

package/.windsurfrules

@@ -182,6 +182,9 @@ Ces limites sont non-négociables. L'IA ne peut JAMAIS générer du code qui les
 - Commit dédié : `docs(adr): création ADR-XXX — [titre] (#ticket)`
 - ⚠️ Ne PAS consigner les ADR dans le RESEARCH_LOG (réservé aux bugs).
 
+### Fin d'une tâche (Avant de conclure)
+- [ ] **Vérification Documentaire** : As-tu mis à jour le `README.md`, le `CHANGELOG.md` ou la doc Diátaxis si tes changements impactent l'architecture, l'installation ou les fonctionnalités globales ? **Tu dois toujours faire cette vérification proactivement, sans que l'utilisateur te le demande.**
+
 ---
 
 *Ce fichier est la loi fondamentale du GEF. Il garantit un niveau d'ingénierie DORA "Elite" sur tous les projets.*

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [1.3.0](https://github.com/Gnzikoune/GEF/compare/v1.2.0...v1.3.0) (2026-07-21)
+
+
+### Features
+
+* **generator:** automatisation des verrous mecaniques ([#10](https://github.com/Gnzikoune/GEF/issues/10)) ([1b92577](https://github.com/Gnzikoune/GEF/commit/1b9257770bb33ddf653ecbcb09cb4e5c50ff4826))
+* **generator:** verrous physiques anti-contournement (Linter, PR, CI) ([fede0ce](https://github.com/Gnzikoune/GEF/commit/fede0ce4a9dfa9e4fd5de6f84108fe4aee24ea48))
+
 ## [1.2.0](https://github.com/Gnzikoune/GEF/compare/v1.1.1...v1.2.0) (2026-07-21)
 
 

package/README.md

@@ -2,7 +2,7 @@
 
 > Un framework d'ingénierie logicielle qui transforme des règles de travail en outils automatisés. Il garantit traçabilité, sécurité et qualité sur chaque projet, dès le premier commit.
 > 
-> **🛡️ Standards de l'Industrie Enforcés :** GitHub Flow (PRs obligatoires), OWASP Security Limits (Rate Limiting, JWT Exp), et Clean Code Metrics adaptatifs (Startup / Standard / Mission Critical).
+> **🛡️ Standards de l'Industrie Enforcés :** GitHub Flow (PRs obligatoires), OWASP Security Limits (Rate Limiting, JWT Exp), Clean Code Metrics adaptatifs (Startup / Standard / Mission Critical), et **Garantie Anti-Contournement IA** (Crash Clause, `.cursorrules` complets, CI d'intention).
 
 ---
 
@@ -16,7 +16,8 @@
 6. [Le Pipeline CI/CD (Brique C)](#6-le-pipeline-cicd-brique-c)
 7. [Les Prompts IA (Brique D)](#7-les-prompts-ia-brique-d)
 8. [Le Tech Lead Virtuel (Brique E)](#8-le-tech-lead-virtuel-brique-e)
-9. [La Source de Vérité](#9-la-source-de-vérité)
+9. [La Garantie Anti-Contournement IA (Brique F)](#9-la-garantie-anti-contournement-ia-brique-f)
+10. [La Source de Vérité](#10-la-source-de-vérité)
 
 ---
 
@@ -39,6 +40,8 @@ GEF/
 ├── PROJECT_CONFIG.template.md    ← Template de configuration projet
 ├── README.md                     ← Ce fichier
 ├── package.json                  ← Package NPM (rend le GEF exécutable via npx)
+├── .cursorrules                  ← Brique F : Toutes les règles GEF pour les IDEs IA (Cursor, Windsurf)
+├── .windsurfrules                ← Brique F : Alias .cursorrules pour Windsurf
 │
 ├── generator/                    ← Brique A : CLI de génération de projet
 │   ├── index.js                  ← Point d'entrée (routage des commandes : help, version, update, interactif)
@@ -52,16 +55,18 @@ GEF/
 │   │   ├── scaffold-linter.js    ← Génération des configs Biome, ESLint, Ruff
 │   │   ├── scaffold-docker.js    ← Dockerfile, docker-compose, init.sql
 │   │   ├── scaffold-ci.js        ← Workflows GitHub Actions (CI/CD, release-please)
+│   │   ├── scaffold-ai-rules.js  ← Brique F : Copie .cursorrules dans chaque projet généré
 │   │   └── update.js             ← Mise à jour d'un projet existant
 │   └── templates/
 │       └── adr-template.md       ← Template d'ADR prêt à l'emploi
 │
-├── hooks/                        ← Hooks Git (installés dans le dépôt GEF lui-même)
+├── hooks/                        ← Brique B : Hooks Git (installés dans le dépôt GEF lui-même)
 │   ├── commit-msg                ← Conventional Commits + référence Kanban obligatoire (#XYZ)
-│   └── pre-commit                ← Détection secrets, lint
+│   └── pre-commit                ← Détection secrets, lint, blocage commit sur main/master
 │
-├── ci-templates/                 ← Brique C : Template de base CI/CD
-│   └── main.yml                  ← (le générateur produit un CI adapté à la stack)
+├── ci-templates/                 ← Brique C : Templates de base CI/CD
+│   ├── main.yml                  ← (le générateur produit un CI adapté à la stack)
+│   └── pr-intention-check.yml   ← Brique F : Bloque les PRs sans intention métier déclarée
 │
 ├── .github/workflows/
 │   └── release-please.yml        ← Automatisation des releases du GEF lui-même
@@ -224,7 +229,7 @@ Installés automatiquement par le générateur dans `.git/hooks/` de chaque proj
 | Hook | Règle appliquée |
 |---|---|
 | **`commit-msg`** | Bloque tout commit dont le message ne respecte pas le format `Conventional Commits + référence Kanban`. Format : `feat: description (#42)`. |
-| **`pre-commit`** | Détecte les secrets en clair (clés API, tokens). Vérifie le formatage (linter). Analyse la taille des fichiers selon la sévérité choisie. Bloquant. |
+| **`pre-commit`** | Détecte les secrets en clair (clés API, tokens). Vérifie le formatage (linter). Analyse la taille des fichiers selon la sévérité choisie. **Bloque tout commit direct sur `main` ou `master`.** |
 | **`pre-push`** | **Dynamique** : Bloque tout push direct sur `main` si le projet est en GitHub Flow. Exécute les tests locaux si en Trunk-Based Development. |
 
 Ces hooks sont générés à la volée par le générateur en fonction des choix de l'équipe, et installablés dans `.git/hooks/` du projet.
@@ -283,7 +288,27 @@ Avant d'écrire le code applicatif, l'IA rédige le test E2E (Playwright) qui d
 
 ---
 
-## 9. La Source de Vérité
+## 9. La Garantie Anti-Contournement IA (Brique F)
+
+Le GEF va au-delà des règles textuelles. Il **impose mécaniquement** aux IA les bonnes pratiques dès l'ouverture du projet, sans que l'utilisateur ait à les répéter.
+
+### Comment ça fonctionne
+
+| Mécanisme | Fichier | Effet |
+|---|---|---|
+| **Règles natives IDE** | `.cursorrules` / `.windsurfrules` | Toute IA (Cursor, Windsurf, Copilot) lit ces fichiers au démarrage et connaît instantanément les §0 à §10 du Playbook (Clean Code, Architecture, Sécurité OWASP, Git Flow, Tests, Workflows). |
+| **Crash Clause** | `prompts/system_prompt.md` | L'IA est instruite de s'arrêter immédiatement et de signaler tout obstacle, au lieu de l'improvisation silencieuse. |
+| **Checklist Pull Request** | `.github/PULL_REQUEST_TEMPLATE.md` | L'IA (et l'humain) doit physiquement cocher les validations (Tests, Docs, ADR) avant qu'une PR puisse être mergée. |
+| **Blocage Linter (Hard Limits)** | `biome.json` / `.eslintrc.json` / `ruff.toml` | Le linter est configuré avec les limites (ex: 15 lignes max, 2 paramètres) et plantera si l'IA tente de bypasser le framework. |
+| **Blocage local** | `hooks/pre-commit` | Un commit direct sur `main` est physiquement impossible, tout comme un commit qui ne passe pas le Linter. |
+| **Validation CI (Intention & Tests)** | `ci-templates/pr-intention-check.yml` & `main.yml` | La CI rejette les PRs sans intention métier, et bloque si la couverture de tests < 80%. |
+| **Propagation** | `generator/features/scaffold-ai-rules.js` | Chaque projet généré hérite automatiquement du `.cursorrules` complet (source unique de vérité). |
+
+> La puissance réside ici : l'utilisateur n'a jamais à expliquer les règles à l'IA. Elles sont déjà là.
+
+---
+
+## 10. La Source de Vérité
 
 Toutes les règles appliquées par ce framework sont définies dans un seul document :
 

package/generator/features/scaffold-ci.js

@@ -129,6 +129,8 @@ function buildTestBlock(isNode, isPython, database) {
   if (isNode) {
     return `      - name: Tests (avec couverture)
         run: npm test -- --coverage --if-present${dbEnv}
+        # Note: Configurez Jest ou Vitest dans votre projet pour échouer si la couverture < 80%
+        # Ex Jest: "coverageThreshold": { "global": { "lines": 80 } }
 
       - name: Upload Coverage
         uses: codecov/codecov-action@v4
@@ -139,7 +141,7 @@ function buildTestBlock(isNode, isPython, database) {
     return `      - name: Tests (pytest + coverage)
         run: |
           pip install pytest pytest-cov
-          pytest tests/ -v --cov=src --cov-report=xml${dbEnv}
+          pytest tests/ -v --cov=src --cov-report=xml --cov-fail-under=80${dbEnv}
 
       - name: Upload Coverage
         uses: codecov/codecov-action@v4

package/generator/features/scaffold-gef.js

@@ -90,6 +90,20 @@ function createAdrTemplate(gefDir) {
   if (fs.existsSync(templateSrc)) fs.copyFileSync(templateSrc, dest);
 }
 
+function createPRTemplate(gefDir) {
+  const templateSrc = path.join(gefDir, 'generator', 'templates', 'PULL_REQUEST_TEMPLATE.md');
+  fs.mkdirSync('.github', { recursive: true });
+  const dest = '.github/PULL_REQUEST_TEMPLATE.md';
+  if (fs.existsSync(templateSrc)) fs.copyFileSync(templateSrc, dest);
+}
+
+function copyAdditionalWorkflows(gefDir) {
+  const src = path.join(gefDir, 'ci-templates', 'pr-intention-check.yml');
+  const destDir = '.github/workflows';
+  fs.mkdirSync(destDir, { recursive: true });
+  if (fs.existsSync(src)) fs.copyFileSync(src, path.join(destDir, 'pr-intention-check.yml'));
+}
+
 function createResearchLog(language) {
   const isEn = language === 'English';
   const dest = 'docs/research/RESEARCH_LOG.md';
@@ -148,6 +162,8 @@ export function scaffoldGef(answers, gefDir) {
   createDirectories(answers.includeCI);
   copyAndTemplateGefAssets(gefDir, answers.strictness, answers.language);
   createAdrTemplate(gefDir);
+  createPRTemplate(gefDir);
+  if (answers.includeCI) copyAdditionalWorkflows(gefDir);
   createResearchLog(answers.language);
   createProjectConfig(answers, gefDir);
   createReadme(answers);

package/generator/features/scaffold-linter.js

@@ -5,16 +5,30 @@ import fs from 'fs';
 import { execSync } from 'child_process';
 import chalk from 'chalk';
 
+/**
+ * Détermine les limites métriques selon le niveau de sévérité.
+ */
+function getLimits(strictness) {
+  if (strictness.includes('Startup')) return { maxLines: 50, maxParams: 4, maxComplexity: 15 };
+  if (strictness.includes('Mission Critical')) return { maxLines: 15, maxParams: 2, maxComplexity: 5 };
+  return { maxLines: 30, maxParams: 3, maxComplexity: 10 }; // Standard
+}
+
 /**
  * Configure ESLint et Prettier.
  */
-function configureEslint(stack) {
-  console.log(chalk.yellow('🧹 Configuration de ESLint + Prettier...'));
+function configureEslint(stack, strictness) {
+  console.log(chalk.yellow('🧹 Configuration de ESLint + Prettier avec Hard Limits...'));
+  const limits = getLimits(strictness);
   const eslintConfig = {
     env: { browser: true, es2021: true, node: true },
     extends: ['eslint:recommended', 'prettier'],
     parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
-    rules: {},
+    rules: {
+      'max-lines-per-function': ['error', limits.maxLines],
+      'max-params': ['error', limits.maxParams],
+      'complexity': ['error', limits.maxComplexity]
+    },
   };
   fs.writeFileSync('.eslintrc.json', JSON.stringify(eslintConfig, null, 2));
   fs.writeFileSync('.prettierrc', '{\n  "semi": true,\n  "singleQuote": true,\n  "printWidth": 100\n}\n');
@@ -31,8 +45,9 @@ function configureEslint(stack) {
 /**
  * Configure Biome.
  */
-function configureBiome() {
-  console.log(chalk.yellow('⚡ Configuration de Biome...'));
+function configureBiome(strictness) {
+  console.log(chalk.yellow('⚡ Configuration de Biome avec Hard Limits...'));
+  const limits = getLimits(strictness);
   const biomeConfig = {
     $schema: "https://biomejs.dev/schemas/1.8.3/schema.json",
     formatter: {
@@ -44,7 +59,15 @@ function configureBiome() {
     },
     linter: {
       enabled: true,
-      rules: { recommended: true }
+      rules: {
+        recommended: true,
+        complexity: {
+          noExcessiveCognitiveComplexity: {
+            level: "error",
+            options: { maxAllowedComplexity: limits.maxComplexity }
+          }
+        }
+      }
     }
   };
   fs.writeFileSync('biome.json', JSON.stringify(biomeConfig, null, 2));
@@ -61,12 +84,16 @@ function configureBiome() {
 /**
  * Configure Ruff pour Python.
  */
-function configureRuff() {
-  console.log(chalk.yellow('🐍 Configuration de Ruff...'));
+function configureRuff(strictness) {
+  console.log(chalk.yellow('🐍 Configuration de Ruff avec Hard Limits...'));
+  const limits = getLimits(strictness);
   const ruffToml = `[lint]
-select = ["E", "F", "I"]
+select = ["E", "F", "I", "C90"]
 ignore = []
 
+[lint.mccabe]
+max-complexity = ${limits.maxComplexity}
+
 [format]
 quote-style = "double"
 indent-style = "space"
@@ -77,13 +104,13 @@ indent-style = "space"
 /**
  * Orchestre la génération de la configuration du linter.
  */
-export function scaffoldLinter(linterChoice, stack) {
+export function scaffoldLinter(linterChoice, stack, strictness) {
   if (linterChoice === 'Aucun' || !linterChoice) return;
 
   try {
-    if (linterChoice.includes('ESLint')) configureEslint(stack);
-    else if (linterChoice.includes('Biome')) configureBiome();
-    else if (linterChoice.includes('Ruff')) configureRuff();
+    if (linterChoice.includes('ESLint')) configureEslint(stack, strictness);
+    else if (linterChoice.includes('Biome')) configureBiome(strictness);
+    else if (linterChoice.includes('Ruff')) configureRuff(strictness);
     console.log(chalk.green('✅ Linter configuré.'));
   } catch (err) {
     console.log(chalk.red('Erreur lors de la configuration du linter.'));

package/generator/index.js

@@ -44,7 +44,7 @@ async function run() {
   process.chdir(projectPath);
 
   scaffoldStack(answers, projectPath);
-  scaffoldLinter(answers.linter, answers.stack);
+  scaffoldLinter(answers.linter, answers.stack, answers.strictness);
   scaffoldGef(answers, GEF_DIR);
   scaffoldAiRules(GEF_DIR, projectPath);
   if (answers.includeDocker) scaffoldDocker(answers.stack, answers.database, answers.projectName);

package/generator/templates/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Intention
+*Décrivez ici le "Pourquoi" de cette Pull Request. Quel problème résout-elle ou quelle valeur métier apporte-t-elle ?*
+
+## Changements
+*Liste des fichiers majeurs ou composants modifiés.*
+
+## Checklist Qualité GEF (Obligatoire)
+Avant de fusionner, vous DEVEZ valider ces éléments :
+
+- [ ] J'ai vérifié que le code respecte les Hard Limits du niveau de sévérité du projet.
+- [ ] J'ai écrit ou mis à jour le test unitaire / E2E associé (la CI bloquera si coverage < 80%).
+- [ ] J'ai créé un rapport ADR dans `docs/explanation/adr/` s'il y a un ajout de dépendance majeure ou une nouvelle architecture.
+- [ ] J'ai mis à jour le README.md / CHANGELOG.md si nécessaire.
+- [ ] La pipeline CI/CD de validation est verte.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gef",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Générateur interactif de projets respectant le framework GEF",
   "type": "module",
   "bin": {