@silvestv/migration-planificator 7.1.2 → 7.1.4

package/README.fr.md

@@ -1,27 +1,24 @@
 # Angular Migration Planner
 
-> **Outil professionnel d'analyse de migrations Angular pour montées de version, refactoring Nx monorepo, et évaluation de dette technique**
-
-Planifiez vos migrations Angular (17→18, 18→19, 19→20, 20→21) avec analyse AST précise, calculez les charges de travail, et générez des dashboards HTML interactifs.
-
-[![npm version](https://img.shields.io/npm/v/@silvestv/migration-planificator.svg)](https://www.npmjs.com/package/@silvestv/migration-planificator)
+> **Effectuez vos migrations Angular sans stress et avec accompagnement !**
+> 
+> **Outil professionnel d'accompagnement de migrations Angular pour montées de version, refactoring Nx monorepo, et evaluation de dette technique**
+> 
+> **Auto fix de migration par IA + schematics angular (expérimental)**
+> 
 [![npm downloads](https://img.shields.io/npm/dm/@silvestv/migration-planificator.svg)](https://www.npmjs.com/package/@silvestv/migration-planificator)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/typescript-5.9-blue)](https://www.typescriptlang.org/)
 [![Tests](https://img.shields.io/badge/tests-748%20passing-success)](tests)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)[![Status](https://img.shields.io/badge/statut-alpha-orange)](https://www.npmjs.com/package/@silvestv/migration-planificator)
 
-**[🇬🇧 English](https://github.com/silvestv/migration-planificator-documentation/blob/master/README.md) | [🇫🇷 Français](https://github.com/silvestv/migration-planificator-documentation/blob/master/README.fr.md)**
-
----
-
-Pour toute préoccupation de sécurité ou signaler une vulnérabilité, voir [SECURITY.md](https://github.com/silvestv/migration-planificator-documentation/blob/master/SECURITY.md)
+**[🇬🇧 English](https://github.com/silvestv/migration-planificator-documentation/blob/master/README.md) | [🇫🇷 Francais](https://github.com/silvestv/migration-planificator-documentation/blob/master/README.fr.md)**
 
 ---
 
 ## 🎯 C'est Quoi ?
 
-Un **outil d'analyse de migrations Angular** complet pour :
+Un **outil d'analyse (AST) de migrations Angular** ET **de migration assistée par IA** complet pour :
 
 - 🔄 **Migrations Angular** : Planifiez migrations 17→18, 18→19, 19→20, 20→21 avec estimations précises
 - 🏢 **Monorepo Nx** : Analysez workspaces multi-apps/libs avec détail par target
@@ -31,6 +28,8 @@ Un **outil d'analyse de migrations Angular** complet pour :
 
 Parfait pour **équipes techniques** et **tech leads** planifiant des upgrades Angular ou refactoring.
 
+📸 [Voir le résultat](#vue-générale-du-résultat-page-workload) | 🤖 [AI Auto-Fix](#-ai-auto-fix-experimental)
+
 ---
 
 ## 🏆 Pourquoi Choisir Cet Outil ?
@@ -45,319 +44,165 @@ Contrairement aux scanners regex simples ou audits manuels :
 
 ---
 
-## ✨ Fonctionnalités
+## 🚀 Demarrage Rapide
 
-- **Précision AST** : Détection contextuelle via ts-morph + @angular/compiler (88% règles)
-- **Dashboard Interactif** : Rapport HTML avec charts, timeline Gantt, édition temps réel
-- **3 Modes Scan** : AST (précis), Regex (rapide), Both (comparatif avec analyse delta)
-- **119 Règles Migration** : Couvrant breaking changes, dépréciations, best practices (to18, to19, to20, to21)
-- **Analyse Cross-File** : Détection TypeScript ↔ templates HTML
-- **Multi-Projets** : Support Nx Monorepo et Angular Standalone
-
----
-
-## 🎓 Cas d'Usage
-
-### Migration Version Angular
-Upgrade Angular 17→21 avec liste complète changements et estimations :
 ```bash
-npx @silvestv/migration-planificator --scanner=both --rules=all --project-path=/path/to/angular-app
-```
-**Résultat** : Tous changements requis, breakdown temps, évaluation risques, planificateur interactif
+# Se placer sur son projet
+cd path-to-my-project # (si install local)
 
-### Refactoring Monorepo Nx
-Moderniser workspace Nx avec 10+ apps/libs :
-```bash
-npx @silvestv/migration-planificator --scanner=both --project-path=/path/to/nx-workspace
-```
-**Résultat** : Breakdown par app/lib, impact dépendances partagées, timeline Gantt
-
-### Évaluation Dette Technique
-Auditer codebase pour APIs dépréciées :
-```bash
-npx @silvestv/migration-planificator --scanner=ast --rules=[18,19,20]
-```
-**Résultat** : Patterns dépréciés (*ngIf, @Input()), opportunités modernisation, tracking fichiers
-
----
-
-## 🚀 Démarrage Rapide
-
-### Installation
-
-#### Via npm (Recommandé)
-```bash
+# Installer
+npm install -D @silvestv/migration-planificator
 npm install -g @silvestv/migration-planificator
-# ou
-npx @silvestv/migration-planificator --project-path=/chemin/vers/projet
-```
 
-#### Depuis les Sources
-```bash
-git clone <repository-url>
-cd @silvestv/migration-planificator
-npm install
-npm run build
-```
-
-### Générer Premier Rapport
-```bash
-# Analyser répertoire courant
-npx @silvestv/migration-planificator
-
-# Analyser projet spécifique avec options
-npx @silvestv/migration-planificator --scanner=both --project-path=/chemin/vers/projet
-
-# Filtrer par version migration
-npx @silvestv/migration-planificator --rules=18              # Seulement Angular 17→18
-npx @silvestv/migration-planificator --rules=[18,19]         # Angular 17→19
-
-# Ou avec installation globale
-@silvestv/migration-planificator --scanner=both --project-path=/chemin/vers/projet
-```
-
-### Ouvrir Rapport
-```bash
-open output/index.html  # macOS/Linux
-start output/index.html # Windows
-```
-
----
-
-## 💻 Utilisation
-
-### Après installation npm
-
-```bash
-# Utilisation basique
+# Executer directement
 npx @silvestv/migration-planificator
-
-# Avec options
-npx @silvestv/migration-planificator --scanner=both --project-path=/chemin/vers/projet --rules=all
-
-# Installation globale
-npm install -g @silvestv/migration-planificator
-@silvestv/migration-planificator --scanner=ast --project-path=./mon-app-angular
+npx @silvestv/migration-planificator --project-path=path-to-my-project
 ```
 
 ### Options CLI
+
 ```bash
---scanner=<mode>        ast | regex | both [défaut: ast]
---project-path=<path>   Chemin vers projet Angular [défaut: répertoire courant]
---rules=<versions>      18 | [18,19] | all [défaut: all]
+--scanner=<mode>        ast | regex | both              [defaut: ast]
+--project-path=<path>   Chemin vers projet Angular      [defaut: .]
+--rules=<versions>      18 | [18,19] | all              [defaut: all]
 ```
 
 ### Exemples
+
 ```bash
-# Scanner répertoire courant avec AST
+# Scanner repertoire courant (AST, toutes regles)
 npx @silvestv/migration-planificator
 
-# Scan comparatif (AST vs Regex) sur projet spécifique
+# Scan comparatif sur workspace Nx
 npx @silvestv/migration-planificator --scanner=both --project-path=/workspace/mon-app
 
-# Vérifier uniquement règles migration Angular 17→18
+# Uniquement regles Angular 17→18
 npx @silvestv/migration-planificator --rules=18
 
-# Plusieurs versions avec scanner regex
-npx @silvestv/migration-planificator --scanner=regex --rules=[18,19]
+# Plusieurs versions
+npx @silvestv/migration-planificator --rules=[18,19,20]
 ```
 
-### Pour Développement (depuis repository cloné)
+### Ouvrir le Rapport
+
 ```bash
-# Build et exécution
-npm run build
-npm start -- --scanner=both --project-path=/chemin/vers/projet
-
-# Scripts rapports rapides
-npm run report                          # AST scan + HTML (default)
-npm run report -- --scanner=ast         # AST mode only
-npm run report -- --scanner=regex       # Regex mode only
-npm run report -- --scanner=both        # Comparative AST vs Regex
+open output/index.html   # macOS/Linux
+start output/index.html  # Windows
 ```
 
 ---
 
-## 📊 Contenu Rapport
-
-### Page Overview
-- Résumé projet (type, version Angular, compteur apps/libs)
-- Statistiques globales (règles détectées, charge totale)
-- Cards apps/libs avec analyse individuelle
+## 📊 Contenu du Rapport
 
-### Page Workload
-- **Charts** : Pie (migrations), Bar (top règles), Doughnut (priorités)
-- **Timeline Gantt** : Phases migration séquentielles
-- **Arbre Hiérarchique** : Monorepo → Apps/Libs → Migrations → Priorités → Règles
-- **Édition Temps Réel** : Cliquer estimations pour ajuster, recalcul auto
-- **Filtres** : Niveau risque, catégorie, type règle, recherche texte
+5 fichiers HTML generes dans `output/` :
 
-### Page Delta (Mode Both)
-- Comparaison règle par règle (précision AST vs Regex)
-- Analyse divergences, stats performance, recommandations
+- **Overview** — Resume projet, stats globales, cards apps/libs
+- **Workload** — Charts (pie, bar, doughnut), timeline Gantt, arbre hierarchique, edition temps reel, filtres
+- **Migration Guide** — Checklist etape par etape par regle
+- **Rules Overview** — Toutes les 119 regles avec statut detection
+- **Delta** *(mode both)* — Comparaison AST vs Regex, analyse divergences
 
 ---
 
-## 📋 Règles Migration
-
-**119 règles** sur 4 versions :
-
-| Migration | Obligatoires | Recommandées | Optionnelles | Total |
-|-----------|--------------|--------------|--------------|-------|
-| **17→18** | 8            | 17           | 0            | 25    |
-| **18→19** | 15           | 13           | 9            | 37    |
-| **19→20** | 6            | 7            | 5            | 18    |
-| **20→21** | 21           | 6            | 12           | 39    |
-
-### Catégories
-`environment` (versions Node/TS) • `imports` (modules) • `api` (APIs Angular) • `routing` (Router) • `template` (directives) • `test` (tests) • `ssr` (SSR) • `reactive` (Signals)
+## Vue générale du résultat (page workload)
 
-### Niveaux Risque
-🔴 **Critical** (breaking changes) • 🟠 **High** (dépréciations majeures) • 🟡 **Medium** (améliorations) • 🟢 **Low** (optimisations)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/silvestv/migration-planificator-documentation/master/public/img/migration-page-light.jpg" alt="Workload page" width="600"/>
+</p>
 
 ---
 
-## 🐛 Dépannage
+## 🤖 AI Auto-Fix (Experimental)
 
-### Expression Régulière Invalide
-Vérifier compatibilité JavaScript :
-```bash
-# (?s) non supporté → utiliser [\s\S]*?
-```
-
-### Build Échoue
-```bash
-rm -rf dist/
-npm run build
-```
-
-### Rapport Vide
-- Vérifier `--project-path` pointe vers racine Angular
-- Vérifier présence `angular.json` ou `nx.json`
-- Support Angular 17, 18, 19, 20, 21
+Generez des prompts structures pour agents IA (Claude CLI / Gemini CLI -> pas recommandé) afin de migrer automatiquement votre code.
 
----
+> **Recommande** : **Claude Code Opus 4 (CLI)** avec un **depot de petite a moyenne taille** (< 500 fichiers impactes). Experimental — relisez toutes les modifications de l'agent avant de merger.
 
-## 🔒 Sécurité et Confidentialité
-
-**Ce CLI s'exécute entièrement sur votre machine locale.** Il ne **collecte, ne transmet, ni ne stocke** aucune donnée externe. Aucune requête réseau n'est effectuée pendant l'analyse.
-
-- ✅ **100% Traitement Local** - Votre code ne quitte jamais votre machine
-- ✅ **Aucune Télémétrie** - Zéro collecte de données ou tracking
-- ✅ **Aucune API Externe** - Analyse AST pure avec bibliothèques locales
-- ✅ **Package Signé** - Signé automatiquement par le registre npm pour vérification d'intégrité
-- ✅ **Auditable** - Inspectez le contenu du package publié à tout moment :
-  ```bash
-  npm pack @silvestv/migration-planificator
-  tar -tzf silvestv-migration-planificator-*.tgz
-  # Ou visualisez les fichiers directement
-  npm view @silvestv/migration-planificator files
-  ```
-
-Pour toute préoccupation de sécurité ou signaler une vulnérabilité, voir [SECURITY.md](https://github.com/silvestv/migration-planificator-documentation/blob/master/SECURITY.md)
-
----
+### Prérequis
 
-## 🤝 Contribuer & Support
+- Un IDE (Vscode / Webstorm)
+- Un Claude Code (recommandée) OU Gemini CLI
+- Attention : la migration d'une règle coûte un certain nombre de tokens !
 
-Ce projet est sous licence **Apache License 2.0** - libre pour usage commercial et open-source.
+### Commande
 
-### 🐛 Signaler un Bug
-
-Vous avez trouvé un bug ? Signalez-le via GitHub Issues :
-
-1. **Aller sur** : [GitHub Issues](https://github.com/silvestv/migration-planificator-documentation/issues/new/choose)
-2. **Sélectionner** : Template "Bug Report"
-3. **Remplir** :
-   - Description du bug
-   - Étapes pour reproduire
-   - Comportement attendu vs réel
-   - Votre environnement (OS, version Node.js, version Angular)
-   - Commande utilisée
-
-**Lien direct** : [Signaler un Bug](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=bug_report.md)
-
-### ✨ Demander une Fonctionnalité
-
-Vous avez une idée d'amélioration ?
-
-1. **Aller sur** : [GitHub Issues](https://github.com/silvestv/migration-planificator-documentation/issues/new/choose)
-2. **Sélectionner** : Template "Feature Request"
-3. **Décrire** :
-   - Le problème que vous essayez de résoudre
-   - Votre solution proposée
-   - Cas d'usage et qui en bénéficie
-   - Maquettes ou exemples éventuels
+```bash
+npx @silvestv/migration-planificator fix --rule=RULE_KEY --project-path=/chemin/vers/projet
+```
 
-**Lien direct** : [Demander une Fonctionnalité](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=feature_request.md)
+| Option | Description | Defaut |
+|--------|-------------|--------|
+| `--rule=RULE_KEY` | Regle de migration a corriger **(requis)** | — |
+| `--project-path=PATH` | Chemin vers le projet Angular | `.` |
+| `--branch=BRANCH` | Branche de base | `master` |
+| `-y` | Skip confirmation preconditions | `false` |
+| `--skip-validation` | Skip build & tests dans le prompt | `false` |
 
-### ❓ Poser une Question
+### Sortie
 
-Besoin d'aide ou vous avez des questions ?
+4 fichiers dans `output/ai/migration/{version}/{rule}-prompts/` :
 
-1. **Aller sur** : [GitHub Issues](https://github.com/silvestv/migration-planificator-documentation/issues/new/choose)
-2. **Sélectionner** : Template "Question"
-3. **Vérifier d'abord** :
-   - [FAQ](https://github.com/silvestv/migration-planificator-documentation/blob/master/FAQ.md)
-   - [Guide de Dépannage](https://github.com/silvestv/migration-planificator-documentation/blob/master/TROUBLESHOOTING.md)
+| Fichier | Role |
+|---------|------|
+| `constitution.md` | Regles absolues de l'agent (securite, qualite, imports) |
+| `context.md` | Description regle + toutes les occurrences (fichier:ligne) |
+| `ledger.json` | Suivi migration (schematic, iterations, blame) |
+| `file-prompt.md` | Instructions completes en 7 phases pour l'agent |
 
-**Lien direct** : [Poser une Question](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=question.md)
+### Utilisation
 
-### 📧 Contact Direct
+```bash
+cd /chemin/vers/projet && claude       # ou gemini
+> Execute output/ai/migration/19/signal_inputs-prompts/file-prompt.md
+```
 
-Pour les problèmes urgents, préoccupations de sécurité ou demandes commerciales :
+L'agent va : verifier preconditions → creer branche → proposer plan → implementer → valider (AST + build + tests) → commit & push.
 
-📧 **Email** : victor.silvestre.dev@gmail.com
+### Pipeline de l'Agent
 
-**Utilisateurs entreprise** : Contactez-nous pour licence commerciale, support prioritaire et fonctionnalités personnalisées.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/silvestv/migration-planificator-documentation/master/public/img/autofix-pipeline.jpg" alt="Pipeline Agent AI Auto-Fix" width="600"/>
+</p>
 
 ---
 
-## 📝 Licence
-
-© 2025 Victor SILVESTRE
+## 📋 Regles Migration
 
-Sous licence **Apache License, Version 2.0** (la "Licence").
-Vous ne pouvez utiliser ce fichier qu'en conformité avec la Licence.
-Vous pouvez obtenir une copie de la Licence à :
+**119 regles** sur 4 versions :
 
-http://www.apache.org/licenses/LICENSE-2.0
+| Migration | Obligatoires | Recommandees | Optionnelles | Total |
+|-----------|--------------|--------------|--------------|-------|
+| **17→18** | 8            | 17           | 0            | 25    |
+| **18→19** | 15           | 13           | 9            | 37    |
+| **19→20** | 6            | 7            | 5            | 18    |
+| **20→21** | 21           | 6            | 12           | 39    |
 
-### Conditions Principales
+**Categories** : `environment` • `imports` • `api` • `routing` • `template` • `test` • `ssr` • `reactive` • `signals` • `config`
 
-- ✅ **Usage Commercial** - Utilisation libre pour tout usage incluant commercial
-- ✅ **Modification** - Modifier et distribuer vos propres versions
-- ✅ **Distribution** - Redistribuer les versions originales ou modifiées
-- ✅ **Droits de Brevets** - Inclut une concession explicite des droits de brevet des contributeurs
-- ✅ **Usage Privé** - Utiliser en privé sans aucune obligation
+**Niveaux Risque** : 🔴 Critical • 🟠 High • 🟡 Medium • 🟢 Low
 
-### Obligations
+---
 
-Lors de la distribution ou modification :
-- 📝 Inclure le fichier LICENSE
-- 📝 Inclure le fichier NOTICE (si présent)
-- 📝 Indiquer tout changement significatif apporté au code
+## 🔒 Securite
 
-### Avertissement
+**100% traitement local.** Aucune telemetrie, aucune API externe, vos donnees ne quittent jamais votre machine. Voir [SECURITY.md](https://github.com/silvestv/migration-planificator-documentation/blob/master/SECURITY.md)
 
-Sauf si requis par la loi applicable ou convenu par écrit, le logiciel
-distribué sous la Licence est distribué "TEL QUEL",
-SANS GARANTIES OU CONDITIONS D'AUCUNE SORTE, expresses ou implicites.
-Consultez la Licence pour les autorisations et limitations
-spécifiques régissant la Licence.
+---
 
-Voir [LICENSE](LICENSE) pour le texte complet de la licence.
+## 🤝 Support
 
-📧 **Contact** : victor.silvestre.dev@gmail.com
+- 🐛 [Signaler un Bug](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=bug_report.md)
+- ✨ [Demander une Fonctionnalite](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=feature_request.md)
+- ❓ [Poser une Question](https://github.com/silvestv/migration-planificator-documentation/issues/new?template=question.md)
+- 📧 victor.silvestre.dev@gmail.com
 
 ---
 
-## 🙏 Remerciements
-
-Construit avec **ts-morph** (AST TypeScript), **@angular/compiler** (parsing HTML), **TailwindCSS** (design), **Chart.js** (visualisation)
+## 📝 Licence
 
----
+© 2025 Victor SILVESTRE — [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0). Libre pour usage commercial. Voir [LICENSE](LICENSE).
 
-**🚀 Commencez à planifier votre migration Angular dès aujourd'hui !**
+Construit avec **ts-morph**, **@angular/compiler**, **TailwindCSS**, **Chart.js**
 
 ---