push-guardian 1.0.0

package/.dockerignore

@@ -0,0 +1,15 @@
+node_modules
+npm-debug.log
+coverage
+.git
+.gitignore
+.env
+*.md
+tests
+.github
+.vscode
+.idea
+*.log
+temp-*
+dist
+build

package/.pushguardian-plugins.json

@@ -0,0 +1,10 @@
+{
+  "plugins": {
+    "example-plugin": {
+      "path": "example-plugin",
+      "version": "1.0.0",
+      "enabled": true,
+      "installedAt": "2024-01-15T12:00:00.000Z"
+    }
+  }
+}

package/Dockerfile

@@ -0,0 +1,41 @@
+# Build stage
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# Copier les fichiers de dépendances
+COPY package*.json ./
+
+# Installer les dépendances (production uniquement)
+RUN npm ci --only=production
+
+# Production stage
+FROM node:22-alpine
+
+WORKDIR /app
+
+# Installer git (requis pour push-guardian)
+RUN apk add --no-cache git
+
+# Créer un utilisateur non-root
+RUN addgroup -g 1001 -S push-guardian && \
+    adduser -S push-guardian -u 1001
+
+# Copier les dépendances depuis builder
+COPY --from=builder /app/node_modules ./node_modules
+
+# Copier le code source
+COPY . .
+
+# Installer globalement AVANT de changer d'utilisateur
+RUN npm link
+
+# Créer les répertoires nécessaires et ajuster les permissions
+RUN chown -R push-guardian:push-guardian /app
+
+# Passer à l'utilisateur non-root
+USER push-guardian
+
+# Point d'entrée
+ENTRYPOINT ["push-guardian"]
+CMD ["--help"]

package/Dockerfile.dev

@@ -0,0 +1,20 @@
+FROM node:22-alpine
+
+WORKDIR /app
+
+# Installer git et dépendances de build
+RUN apk add --no-cache git python3 make g++
+
+# Copier les fichiers de dépendances
+COPY package*.json ./
+
+# Installer toutes les dépendances (dev incluses)
+RUN npm install
+
+# Copier le code source
+COPY . .
+
+# Exposer le port pour le debugger (optionnel)
+EXPOSE 9229
+
+CMD ["npm", "test"]

package/README.md

@@ -0,0 +1,386 @@
+# **push-guardian 🛡️**
+
+**push-guardian** est un outil complet de validation CI/CD conçu pour garantir la qualité du code et automatiser les vérifications avant les pushs Git. Il intègre des outils comme ESLint, Prettier et des contraintes personnalisées pour analyser, formater et valider votre code selon les meilleures pratiques.
+
+---
+
+## 📋 Table des matières
+
+- [Fonctionnalités](#fonctionnalités)
+- [Installation](#installation)
+- [Utilisation](#utilisation)
+- [Configuration](#configuration)
+- [Sections de Configuration](#sections-de-configuration)
+- [Contraintes Disponibles](#contraintes-disponibles)
+- [Architecture](#architecture)
+- [Flux de Validation](#flux-de-validation)
+- [Développement](#développement)
+- [Dépannage](#dépannage)
+- [Contribution](#contribution)
+- [Licence](#licence)
+- [Auteurs](#auteurs)
+---
+
+## **Fonctionnalités**
+
+### **🔧 Validation de Code Automatique**
+- **Analyse statique** avec ESLint pour multiples langages (JavaScript, TypeScript, JSON, Markdown, CSS, YAML, HTML)
+- **Formatage automatique** avec Prettier
+- **Correction automatique** des erreurs fixables
+- **Mode strict** pour échouer sur les warnings
+
+### **🔗 Hooks Git Intelligents**
+- **Pre-push** : Validation du code avant le push
+- **Commit-msg** : Validation du format des messages de commit
+- **Post-checkout** : Validation des noms de branches
+
+### **🎯 Contraintes Personnalisables**
+- **Messages de commit** : Format [TYPE]: description avec types personnalisables
+- **Noms de branches** : Validation selon des patterns définis
+- **Contraintes avancées** : longueur, caractères spéciaux, mots interdits, etc.
+
+### **📊 Multi-Langages Supportés**
+- **JavaScript/TypeScript** avec configuration ESLint avancée
+- **CSS/SCSS** avec Stylelint
+- **Markdown, JSON, YAML, HTML** avec plugins dédiés
+- **Détection automatique** des langages utilisés dans le projet
+
+---
+
+## **Installation**
+
+### **Prérequis**
+
+- **Node.js** version 16 ou supérieure
+- **npm** ou **yarn**
+- **Git** (pour les hooks)
+
+### **Installation Globale**
+
+```bash
+npm install -g push-guardian
+```
+### **Installation Locale dans un Projet**
+
+```bash
+cd votre-projet
+npx push-guardian install
+```
+
+### **Développement**
+```bash
+git clone <repository>
+cd push-guardian
+npm install
+npm link  # Pour l'utiliser en développement
+```
+
+## **Utilisation**
+### **Commandes Principales**
+
+### **1. Installation Interactive**
+```bash
+npx push-guardian install
+```
+
+Lance un menu interactif pour installer :
+
+* **Hooks Git** : Configure les hooks Git automatiquement
+* **Code Quality Tools** : Installe et configure ESLint, Prettier, etc.
+* **Mirroring** : Configure le système de mirroring multi-plateformes
+
+Options:
+* `--force`: Force l'installation même si les hooks existent déjà
+
+### **2. Validation du Code**
+```bash
+npx push-guardian validate
+```
+Valide le code selon la configuration établie.
+
+Options :
+
+* `**--fix**` : Corrige automatiquement les erreurs fixables
+* `**--strict**` : Échoue si des warnings sont détectés
+* `**--verbose**` : Affiche plus de détails
+* `**--hooks <hook>**` : Valide spécifiquement certains hooks
+
+### **3. Mirroring de Référentiels**
+
+```bash
+npx push-guardian mirror
+```
+Effectue le mirroring d'un référentiel source vers une plateforme cible (GitHub, GitLab, BitBucket, Azure DevOps).
+
+Options :
+* `--source <platform>` : Plateforme source (github, gitlab, bitbucket, azure)
+* `--target <platform>` : Plateforme cible (github, gitlab, bitbucket, azure)
+* `--repo <name>` : Nom du référentiel source (et cible si --target-repo non spécifié)
+* `--source-repo <name>` : Nom du référentiel source
+* `--target-repo <name>` : Nom du référentiel cible
+* `--source-owner <owner>` : Propriétaire du référentiel source (requis pour GitHub)
+* `--target-owner <owner>` : Propriétaire du référentiel cible (requis pour GitHub)
+* `--sync-branches` : Active la synchronisation des branches
+* `--public-repo` : Visibilité du mirroir en public
+* `--generate` : Génère un workflow GitHub Actions pour automatiser le mirroring
+
+Exemples :
+
+```bash
+npx push-guardian mirror --source github --target gitlab --repo myproject --source-owner myorg --target-owner myorg
+npx push-guardian mirror --sync-branches --public-repo
+npx push-guardian mirror --generate 
+```
+
+#### **Workflow GitHub Actions**
+push-guardian inclut un workflow GitHub Actions pour automatiser le mirroring. Le workflow se déclenche automatiquement sur les événements suivants :
+- **Push** sur les branches `main` ou `master`
+- **Manuellement** via workflow_dispatch
+- **Planifié** tous les jours à 2h UTC
+
+Pour configurer le mirroring automatique :
+
+1. **Copiez le workflow** `.github/workflows/mirror.yml` dans votre repository
+2. **Configurez les variables d'environnement** dans Settings > Secrets and variables > Actions :
+   - Variables (Variables) :
+     - `SOURCE_PLATFORM` : Plateforme source (github, gitlab, bitbucket, azure)
+     - `TARGET_PLATFORM` : Plateforme cible (github, gitlab, bitbucket, azure)
+     - `REPO_NAME` : Nom du repository
+     - `SOURCE_OWNER` : Propriétaire/organisation source
+     - `TARGET_OWNER` : Propriétaire/organisation cible
+     - `SYNC_BRANCHES` : true/false pour synchroniser les branches
+     - `PUBLIC_REPO` : true/false pour rendre le mirror public
+   - Secrets :
+     - `GITHUB_TOKEN` : Token GitHub (généré automatiquement)
+     - `GITLAB_TOKEN` : Token d'accès GitLab
+     - `BITBUCKET_USERNAME` : Nom d'utilisateur BitBucket
+     - `BITBUCKET_PASSWORD` : Mot de passe ou token d'app BitBucket
+     - `AZURE_DEVOPS_URL` : URL de l'organisation Azure DevOps
+     - `AZURE_DEVOPS_TOKEN` : Token d'accès Azure DevOps
+
+Le workflow clonera automatiquement push-guardian, installera les dépendances et exécutera la commande mirror avec vos paramètres configurés.
+
+### **4. Gestion de Configuration**
+```bash
+npx push-guardian config [clé] [valeur]
+```
+Gère la configuration de push-guardian.
+
+Options :
+
+* `--list` : Affiche toute la configuration actuelle
+* `[clé] [valeur]` : Modifie une valeur spécifique
+
+Exemples :
+```bash
+npx push-guardian config --list
+npx push-guardian config validate.directories '["src/", "lib/"]'
+```
+
+## **Configuration**
+### **Fichier de Configuration Principal**
+push-guardian utilise un fichier `push-guardian.config.json` à la racine de votre projet :
+```json
+{
+  "validate": {
+    "directories": ["./"],
+    "onMissing": "ignore",
+    "activateCQT": true
+  },
+  "hooks": {
+    "commit-msg": {
+      "type": ["ADD", "UPDATE", "DELETE", "FIX", "MERGE", "CHORE"], 
+      "constraints": {
+        "maxLength": 80,
+        "mustStartWith": "[",
+        "mustEndWith": "]"
+      }
+    },
+    "post-checkout": {
+      "type": ["main", "develop", "feat", "fix", "chore"],
+      "constraints": {
+        "noUppercase": true,
+        "noSpecialChars": true
+      }
+    },
+    "pre-push": {}
+  }
+}
+```
+## **Sections de Configuration**
+## **🔍 Validation (validate)**
+* `directories` : Tableau des répertoires à analyser
+* `onMissing` : Comportement si répertoire manquant (ignore ou error)
+* `activateCQT` : Active/désactive les outils de qualité de code
+
+## 🔗 Hooks Git (`hooks`)
+### **Commit Message (`commit-msg`)**
+
+* `type` : Types de commits autorisés
+* `constraints` : Contraintes supplémentaires
+
+### **Post Checkout (`post-checkout`)**
+* `type` : Types de branches autorisés
+* `constraints` : Contraintes sur les noms de branches
+### **Pre Push (`pre-push`)**
+* Validation automatique du code avant push
+## **Contraintes Disponibles**
+
+Voici les contraintes prédéfinies que vous pouvez utiliser dans la configuration des hooks :
+
+| Contrainte       | Description              | Exemple                          |
+|------------------|--------------------------|----------------------------------|
+| maxLength       | Longueur maximale       | `"maxLength": 80`               |
+| minLength       | Longueur minimale       | `"minLength": 10`               |
+| mustStartWith   | Doit commencer par      | `"mustStartWith": "["`          |
+| mustEndWith     | Doit terminer par       | `"mustEndWith": "]"`            |
+| autoStartWith   | Mis automatiquement si manquant | `"autoStartWith": "["`          |
+| noUppercase     | Pas de majuscules       | `"noUppercase": true`           |
+| noDigits        | Pas de chiffres         | `"noDigits": true`              |
+| noSpecialChars  | Pas de caractères spéciaux | `"noSpecialChars": true`        |
+| disallowedWords | Mots interdits           | `"disallowedWords": ["test", "tmp"]` |
+| mustMatchPattern| Doit matcher un regex   | `"mustMatchPattern": "^\\[.*\\]:"` |
+
+## **Architecture**
+### **Structure des Fichiers**
+```text
+push-guardian/
+├── src/
+│   ├── cli/                          # Interface en ligne de commande
+│   │   ├── command/                  # Commandes principales
+│   │   │   ├── [config.js](http://_vscodecontentref_/0)             # Gestion configuration
+│   │   │   ├── [install.js](http://_vscodecontentref_/1)            # Installation système
+│   │   │   ├── [mirror.js](http://_vscodecontentref_/2)             # Commande de mirroring
+│   │   │   └── [validate.js](http://_vscodecontentref_/3)           # Validation manuelle
+│   │   ├── [index.js](http://_vscodecontentref_/4)                  # Point d'entrée CLI
+│   │   └── install/                  # Sous-commandes installation
+│   │       ├── [codeQualityTools.js](http://_vscodecontentref_/5)   # Installation outils qualité
+│   │       ├── [hooks.js](http://_vscodecontentref_/6)              # Installation hooks Git
+│   │       └── [mirroring.js](http://_vscodecontentref_/7)          # Installation mirroring
+│   │
+│   ├── core/                         # Cœur métier de l'application
+│   │   ├── codeQualityTools/         # Gestion outils qualité code
+│   │   │   ├── [configAnalyzer.js](http://_vscodecontentref_/8)     # Analyse configurations existantes
+│   │   │   ├── [configGenerator.js](http://_vscodecontentref_/9)    # Génération configurations
+│   │   │   ├── [configManager.js](http://_vscodecontentref_/10)      # Gestion configurations CQT
+│   │   │   ├── [fileDetector.js](http://_vscodecontentref_/11)       # Détection types de fichiers
+│   │   │   ├── [languageTools.js](http://_vscodecontentref_/12)      # Outils par langage
+│   │   │   └── [toolInstaller.js](http://_vscodecontentref_/13)      # Installation outils
+│   │   │
+│   │   ├── [configManager.js](http://_vscodecontentref_/14)          # Gestion configuration globale
+│   │   ├── [errorCMD.js](http://_vscodecontentref_/15)               # Gestion centralisée des erreurs
+│   │   ├── interactiveMenu/          # Système de menus interactifs
+│   │   │   └── [interactiveMenu.js](http://_vscodecontentref_/16)    # Menu de sélection
+│   │   ├── mirroring/                # Système de mirroring
+│   │   │   ├── [branchSynchronizer.js](http://_vscodecontentref_/17) # Synchronisation des branches
+│   │   │   ├── [repoManager.js](http://_vscodecontentref_/18)        # Gestion des dépôts
+│   │   │   └── [syncManager.js](http://_vscodecontentref_/19)        # Gestionnaire de synchronisation
+│   │   └── [validator.js](http://_vscodecontentref_/20)              # Moteur de validation principal
+│   │
+│   ├── hooks/                        # Gestion des hooks Git
+│   │   └── constrains/               # Système de contraintes
+│   │       ├── [constrains.js](http://_vscodecontentref_/21)         # Définition des contraintes
+│   │       └── [constraintEngine.js](http://_vscodecontentref_/22)   # Moteur d'exécution contraintes
+│   │
+│   └── utils/                        # Utilitaires partagés
+│       ├── [chalk-wrapper.js](http://_vscodecontentref_/23)          # Wrapper pour Chalk
+│       └── [exec-wrapper.js](http://_vscodecontentref_/24)           # Wrapper pour exécution commandes
+└── tests/                            # Tests automatisés
+    └── unit/
+```
+## **Flux de Validation**
+1. **Détection** : Scan du projet pour identifier les langages utilisés
+2. **Configuration** : Génération automatique des fichiers de config ESLint
+3. **Installation** : Setup des hooks Git et dépendances npm
+4. **Validation** : Exécution des vérifications selon les hooks déclenchés
+5. **Rapport** : Affichage clair des erreurs et suggestions
+
+## **🔧 Développement**
+### **Ajouter une Nouvelle Contrainte**
+1. **Dans** `votre_fichier.js` :
+```js
+const { constraintEngine } = require('./constraintEngine');
+
+constraintEngine.addConstraint(
+  'maNouvelleContrainte',
+  (value, param) => {
+    // Logique de validation
+    return value.includes(param);
+  },
+  (param) => `Le message doit contenir "${param}"`
+);
+```
+2. **Utilisation dans la config (en cours de développement) :**
+```json
+{
+  "constraints": {
+    "maNouvelleContrainte": "valeur-requise"
+  }
+}
+```
+## **Ajouter un Support de Langage**
+1. **Dans** `codeQualityTools.js` :
+```js
+const LANGUAGE_TOOLS = {
+  'Nouveau Langage': {
+    packages: ['package-eslint', 'autre-package'],
+    setup: setupNouveauLangage
+  }
+};
+```
+2. **Implémenter la fonction setup :**
+```js
+async function setupNouveauLangage() {
+  // Configuration spécifique au langage
+}
+```
+## **Dépannage**
+## **Problèmes Courants**
+### **❌ "Hook existe déjà"**
+```bash
+npx push-guardian install --force
+```
+### **❌ "Répertoire .git/hooks non trouvé"**
+Assurez-vous d'être dans un dépôt Git initialisé :
+```bash
+git init
+```
+### **❌ "Erreurs ESLint"**
+Vérifiez la configuration dans `eslint.config.js` et ajustez selon votre projet.
+
+### **❌ "Permissions denied sur les hooks"**
+```bash
+chmod +x .git/hooks/*
+```
+## **Logs de Débogage**
+Activez le mode verbeux :
+```bash
+npx push-guardian validate --verbose
+```
+## **Réinitialisation**
+Pour tout réinitialiser :
+```bash
+rm -f push-guardian.config.json
+rm -f eslint.config.js
+rm -f .git/hooks/pre-push .git/hooks/commit-msg .git/hooks/post-checkout
+```
+## **Contribution**
+Les contributions sont bienvenues ! Voici comment contribuer :
+1. **Fork** le repository
+2. **Créez** une branche : git checkout -b feature/ma-fonctionnalite
+3. **Commitez** vos changements : git commit -am 'Ajout ma fonctionnalité'
+4. **Push** : git push origin feature/ma-fonctionnalite
+5. **Ouvrez** une Pull Request
+
+## **Standards de Code**
+* Suivez le style de code existant
+* Ajoutez des tests pour les nouvelles fonctionnalités
+* Mettez à jour la documentation
+
+## **Licence**
+Ce projet est sous licence ISC.
+
+# **Auteurs**
+
+![AUTHORS](https://img.shields.io/badge/AUTHORS:-gray?style=for-the-badge)
+![https://github.com/lagie-marin](https://img.shields.io/badge/Marin%20Lagie-yellow?style=for-the-badge&logo=undertale&logoColor=E71D29)

package/TECHNO.md

@@ -0,0 +1,139 @@
+# **🛠️ JUSTIFICATION DES CHOIX TECHNOLOGIQUES push-guardian**
+## **🎯 POURQUOI CES TECHNOLOGIES ?**
+
+## **1. 🟢 NODE.JS & JavaScript**
+
+### **✅ Justification :**
+
+- **Écosystème riche** : Plus grand écosystème de packages (npm)
+- **Cross-platform** : Fonctionne sur Windows, macOS, Linux sans modification
+- **Communauté active** : Support et maintenance à long terme
+- **Performance** : Asynchrone natif pour les opérations I/O
+- **Facile à déployer** : Un seul binaire pour tous les environnements
+
+**📊 Alternative considérée** : Python ❌
+- Moins bon pour les outils CLI complexes
+- Gestion des dépendances moins mature que npm
+
+## **2. 🔵 COMMANDER.JS CLI Framework**
+### 
+- **✅ Justification :**
+- **Standard industriel** : Utilisé par Vue CLI, React Native, etc.
+- **Expérience développeur** : Auto-génération d'aide, validation des options
+- **Extensible** : Système de plugins et hooks
+- **Documentation excellente** : Communauté active et nombreux exemples
+
+
+**📊 Alternatives considérées** :
+
+- yargs ❌ Plus complexe pour nos besoins
+- oclif ❌ Trop lourd pour un projet de cette taille
+
+## **3. 🎨 CHALK (Stylisation Terminal)**
+### **✅ Justification :**
+- **Feedback visuel clair** : Couleurs pour différencier succès/erreurs/infos
+- **Expérience utilisateur** : Meilleure lisibilité des résultats
+- **Léger** : Aucun impact sur les performances
+- **Cross-terminal** : Compatible avec tous les terminaux modernes
+
+**📊 Alternative considérée** : colors ❌
+- Moins maintenu, API moins cohérente
+
+## **4. ⚡ EXECA (Execution de Commandes)**
+### **✅ Justification :**
+- **Interface Promise-native** : Async/await naturel
+- **Cross-platform** : Gère les différences Windows/Uni
+- **Sécurisé** : Échappement automatique des arguments
+- **Rich features** : Timeouts, stdio management, cancellation
+
+**📊 Alternative considérée** : child_process natif ❌
+- API verbeuse et error-prone
+- Gestion manuelle de tous les edge cases
+
+## **5. 🪝 HOOKS GIT NATIFS (vs Husky)**
+### **✅ Justification :**
+- **Plus léger** : Aucune dépendance supplémentaire
+- **Plus transparent** : Utilise le système standard Git
+- **Plus portable** : Fonctionne avec toutes versions de Git
+- **Plus simple** : Moins de configuration, plus fiable
+
+**📊 Alternative considérée** : Husky ❌
+- Dépendance supplémentaire
+- Configuration plus complexe
+- Historique de breaking changes
+
+## **6. 📋 ESLINT (Qualité de Code)**
+### **✅ Justification :**
+- **Standard industriel** : Outil le plus utilisé pour JavaScript/TypeScript
+- **Extensible** : Plugins pour tous les langages (JSON, MD, YAML, HTML)
+- **Configurable** : Règles personnalisables par projet
+- **Écosystème riche** : Intégrations avec tous les éditeurs
+
+**📊 Alternative considérée** : JSHint ❌
+- Moins maintenu, moins de fonctionnalités
+
+## **7. 🎯 PRETTIER (Formatage de Code)**
+
+- **Style imposé par défaut** : Moins de débats sur le style dans l'équipe
+- **Zero-config** : Fonctionne immédiatement
+- **Multi-langage** : JS, TS, JSON, CSS, MD, YAML, etc.
+- **Intégration parfaite** avec ESLint
+
+**📊 Alternative considérée** : StandardJS ❌
+- Trop restrictif, moins flexible
+
+## **8. 🧪 JEST (Testing)**
+### **✅ Justification :**
+- **Tout-en-un** : Runner, assertions, mocking, coverage
+- **Performance** : Parallelisation intelligente
+- **Developer experience** : Messages d'erreur clairs, watch mode
+- **Écosystème** : Plugins pour tous les besoins
+
+**📊 Alternative considérée** : Mocha + Chai ❌
+- Configuration plus complexe
+- Nécessite plusieurs packages
+
+# **🎯 ARCHITECTURE GLOBALE : POURQUOI CE CHOIX ?**
+
+## **MODULARITÉ**
+```text
+src/
+├── cli/          # Interface utilisateur
+├── core/         # Logique métier
+├── hooks/        # Intégrations Git
+└── utils/        # Utilities partagées
+```
+## **✅ Avantages** :
+- **Maintenance** : Équipes peuvent travailler sur différents modules
+- **Testabilité** : Modules testables indépendamment
+- **Évolution** : Possible de remplacer un module sans affecter les autres
+- **Compréhension** : Structure claire pour les nouveaux développeurs
+
+## **🔄 COMPATIBILITÉ & MIGRATION**
+### **SUPPORT MULTI-VERSIONS**
+```json
+{
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=8.0.0"
+  }
+}
+```
+✅ Choix raisonnable :
+- **Node 16+** : Support LTS jusqu'en 2025
+- **ESM + CJS** : Compatibilité avec les deux systèmes
+- **Git 2.13+** : Version stable largement déployée
+
+## **🚀 CONCLUSION STRATÉGIQUE**
+### **POURQUOI CETTE STACK ?**
+
+| Besoin           | Technologie           | Résultat                        |
+|------------------|----------------------|---------------------------------|
+| CLI robuste      | Commander.js         | Expérience développeur fluide   |
+| Qualité code     | ESLint + Prettier    | Standards cohérents             |
+| Execution cmd    | Execa                | Cross-platform fiable           |
+| Feedback visuel  | Chalk                | Lisibilité immédiate            |
+| Tests            | Jest                 | Couverture complète             |
+| Intégration      | Hooks Git natifs     | Simplicité et fiabilité         |
+
+Une stack moderne, maintenable, et professionnelle qui résout les vrais problèmes des développeurs sans introduire de complexité inutile.

package/babel.config.js

@@ -0,0 +1 @@
+module.exports = { presets: [['@babel/preset-env', { targets: { node: 'current' } }]] };