@atlashub/smartstack-cli 1.23.0 → 1.24.0

package/templates/commands/efcore/_env-check.md

@@ -1,153 +0,0 @@
-# EF Core Environment Check (Shared Step)
-
-> **Usage:** Include ce step dans toutes les commandes EF Core qui interagissent avec la base de donnees.
-
----
-
-## STEP 0: Verification environnement et connexion
-
-### 0.1 Detecter les fichiers appsettings disponibles
-
-```bash
-# Scanner les fichiers appsettings dans le projet API
-API_DIR=$(find . -type d -name "*.Api" -o -name "*Web" | head -1)
-if [ -z "$API_DIR" ]; then
-  API_DIR="."
-fi
-
-# Lister tous les appsettings
-APPSETTINGS_FILES=$(find "$API_DIR" -maxdepth 1 -name "appsettings*.json" 2>/dev/null | sort)
-```
-
-### 0.2 Determiner l'environnement a utiliser
-
-**Priorite:**
-1. Flag `--env {Environment}` si fourni
-2. `appsettings.Local.json` (defaut recommande)
-3. Erreur si aucun fichier trouve
-
-```bash
-# Logique de selection
-ENV_FLAG="$1"  # --env Development par exemple
-
-if [ -n "$ENV_FLAG" ]; then
-  SELECTED_ENV="appsettings.${ENV_FLAG}.json"
-elif [ -f "$API_DIR/appsettings.Local.json" ]; then
-  SELECTED_ENV="appsettings.Local.json"
-else
-  echo "ERROR: Aucun fichier appsettings trouve"
-  echo "  Creez appsettings.Local.json ou utilisez --env {Environment}"
-  exit 1
-fi
-
-# Verifier que le fichier existe
-if [ ! -f "$API_DIR/$SELECTED_ENV" ]; then
-  echo "ERROR: $SELECTED_ENV non trouve dans $API_DIR"
-  exit 1
-fi
-```
-
-### 0.3 Extraire et afficher la connection string
-
-```bash
-# Extraire la connection string (PowerShell pour parsing JSON fiable)
-CONNECTION_STRING=$(powershell -Command "
-  \$json = Get-Content '$API_DIR/$SELECTED_ENV' | ConvertFrom-Json
-  \$json.ConnectionStrings.DefaultConnection
-")
-
-# Extraire le nom de la base de donnees
-DATABASE_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Database=\K[^;]+' || echo "Unknown")
-SERVER_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Server=\K[^;]+' || echo "Unknown")
-
-# Masquer le mot de passe si present
-CONNECTION_MASKED=$(echo "$CONNECTION_STRING" | sed 's/Password=[^;]*/Password=****/g')
-```
-
-### 0.4 Afficher le resume
-
-```
-================================================================================
-                         EF CORE - ENVIRONNEMENT
-================================================================================
-
-FICHIERS DISPONIBLES:
-{liste des appsettings detectes}
-
-SELECTION: {SELECTED_ENV} {(defaut) si Local}
-
-CONNEXION:
-  Server:   {SERVER_NAME}
-  Database: {DATABASE_NAME}
-  String:   {CONNECTION_MASKED}
-
-================================================================================
-```
-
-### 0.5 Protection Production
-
-```bash
-# Bloquer si Production detecte (sauf pour db-status qui est read-only)
-if [[ "$SELECTED_ENV" == *"Production"* ]]; then
-  echo "================================================================================
-                         BLOQUE - ENVIRONNEMENT PRODUCTION
-================================================================================
-
-Cette commande est bloquee pour proteger les donnees de production.
-
-OPTIONS:
-1. Utilisez un environnement non-production
-2. Contactez support@atlshub.ch pour assistance
-
-================================================================================
-"
-  exit 1
-fi
-```
-
-### 0.6 Confirmation (pour commandes destructives)
-
-> **Note:** Utiliser uniquement pour db-reset, db-seed, et autres commandes destructives.
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "Confirmer l'execution sur cette base de donnees?",
-    header: "Confirm",
-    options: [
-      { label: "Oui, continuer", description: "Executer sur " + DATABASE_NAME },
-      { label: "Non, annuler", description: "Arreter l'execution" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## Variables exportees
-
-Apres ce step, les variables suivantes sont disponibles:
-
-| Variable | Description |
-|----------|-------------|
-| `SELECTED_ENV` | Fichier appsettings utilise |
-| `CONNECTION_STRING` | Connection string complete |
-| `CONNECTION_MASKED` | Connection string masquee |
-| `DATABASE_NAME` | Nom de la base de donnees |
-| `SERVER_NAME` | Nom du serveur |
-| `API_DIR` | Repertoire du projet API |
-
----
-
-## Utilisation dans les commandes
-
-```markdown
-## STEP 0: Verification environnement
-
-> **Include:** `_env-check.md`
-
-{Executer les etapes 0.1 a 0.4}
-{Executer 0.5 si commande modifie la base}
-{Executer 0.6 si commande est destructive}
-```

package/templates/commands/efcore/_shared.md

@@ -1,352 +0,0 @@
-# EF Core - Fonctions Partagées
-
-> **Usage:** Référencé par toutes les commandes EF Core
-
----
-
-## Détection Projet EF Core
-
-```bash
-detect_efcore_project() {
-  CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
-  PROJECT_DIR=$(dirname "$CSPROJ")
-  PROJECT_NAME=$(basename "$CSPROJ" .csproj)
-  MIGRATIONS_DIR="$PROJECT_DIR/Persistence/Migrations"
-
-  STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
-  INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
-  [ -z "$INFRA_PROJECT" ] && INFRA_PROJECT="$CSPROJ"
-
-  # Appeler la détection du DbContext
-  detect_dbcontext
-}
-```
-
----
-
-## Détection DbContext (Core vs Extensions)
-
-SmartStack utilise **deux DbContext séparés** avec des historiques de migration distincts :
-
-| Context | DbContext | Schema | History Table |
-|---------|-----------|--------|---------------|
-| `core` | `CoreDbContext` | `core` | `core.__EFMigrationsHistory` |
-| `extensions` | `ExtensionsDbContext` | `extensions` | `extensions.__EFMigrationsHistory` |
-
-```bash
-detect_dbcontext() {
-  # 1. Vérifier si SmartStack.Domain existe → CoreDbContext
-  if find . -type d -name "SmartStack.Domain" | grep -q .; then
-    DBCONTEXT="CoreDbContext"
-    DBCONTEXT_TYPE="core"
-    SCHEMA="core"
-    echo "DbContext détecté: CoreDbContext (SmartStack.Domain trouvé)"
-    return
-  fi
-
-  # 2. Vérifier si projet client avec NuGet SmartStack → ExtensionsDbContext
-  if find . -name "*.csproj" -exec grep -l "SmartStack\." {} \; | grep -qv "SmartStack\."; then
-    DBCONTEXT="ExtensionsDbContext"
-    DBCONTEXT_TYPE="extensions"
-    SCHEMA="extensions"
-    echo "DbContext détecté: ExtensionsDbContext (Client avec NuGet SmartStack)"
-    return
-  fi
-
-  # 3. Vérifier les DbContext présents dans le code
-  CORE_CTX=$(find . -name "*.cs" -exec grep -l "CoreDbContext" {} \; 2>/dev/null | head -1)
-  EXT_CTX=$(find . -name "*.cs" -exec grep -l "ExtensionsDbContext" {} \; 2>/dev/null | head -1)
-
-  if [ -n "$CORE_CTX" ] && [ -z "$EXT_CTX" ]; then
-    DBCONTEXT="CoreDbContext"
-    DBCONTEXT_TYPE="core"
-    SCHEMA="core"
-  elif [ -z "$CORE_CTX" ] && [ -n "$EXT_CTX" ]; then
-    DBCONTEXT="ExtensionsDbContext"
-    DBCONTEXT_TYPE="extensions"
-    SCHEMA="extensions"
-  else
-    # 4. Les deux existent ou aucun trouvé → demander à l'utilisateur
-    DBCONTEXT=""
-    DBCONTEXT_TYPE=""
-    SCHEMA=""
-    echo "⚠️ DbContext non détecté automatiquement"
-    echo "→ Utiliser AskUserQuestion pour demander à l'utilisateur"
-  fi
-}
-```
-
-**Variables exportées :**
-
-| Variable | Valeurs possibles | Description |
-|----------|-------------------|-------------|
-| `$DBCONTEXT` | `CoreDbContext` / `ExtensionsDbContext` | Nom du DbContext |
-| `$DBCONTEXT_TYPE` | `core` / `extensions` | Type pour le MCP |
-| `$SCHEMA` | `core` / `extensions` | Schéma de base de données |
-
-**Si détection échoue, demander à l'utilisateur :**
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "Quel DbContext utiliser pour cette migration ?",
-    header: "DbContext",
-    options: [
-      { label: "CoreDbContext", description: "Entités SmartStack (User, Role, Navigation...)" },
-      { label: "ExtensionsDbContext", description: "Entités client spécifiques" }
-    ],
-    multiSelect: false
-  }]
-})
-
-// Puis définir les variables selon la réponse
-if (answer === "CoreDbContext") {
-  DBCONTEXT="CoreDbContext"; DBCONTEXT_TYPE="core"; SCHEMA="core";
-} else {
-  DBCONTEXT="ExtensionsDbContext"; DBCONTEXT_TYPE="extensions"; SCHEMA="extensions";
-}
-```
-
----
-
-## Détection Environnement
-
-```bash
-detect_environment() {
-  API_DIR=$(find . -type d -name "*.Api" | head -1)
-  [ -z "$API_DIR" ] && API_DIR="src/SmartStack.Api"
-
-  # Priorité: --env flag > appsettings.Local.json > erreur
-  if [ -n "$ENV_FLAG" ]; then
-    SELECTED_ENV="appsettings.${ENV_FLAG}.json"
-  elif [ -f "$API_DIR/appsettings.Local.json" ]; then
-    SELECTED_ENV="appsettings.Local.json"
-  else
-    echo "ERROR: Aucun appsettings trouvé"; exit 1
-  fi
-
-  # Extraire connection string
-  CONNECTION_STRING=$(powershell -Command "
-    \$json = Get-Content '$API_DIR/$SELECTED_ENV' | ConvertFrom-Json
-    \$json.ConnectionStrings.DefaultConnection
-  ")
-  DATABASE_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Database=\K[^;]+')
-  SERVER_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Server=\K[^;]+')
-}
-```
-
----
-
-## Protection Production
-
-```bash
-block_production() {
-  if [[ "$SELECTED_ENV" == *"Production"* ]]; then
-    echo "BLOQUÉ: Environnement Production détecté"
-    echo "Utilisez un environnement non-production"
-    exit 1
-  fi
-}
-```
-
----
-
-## Backup Base de Données
-
-```bash
-backup_database() {
-  BACKUP_DIR=".claude/gitflow/backup/database"
-  mkdir -p "$BACKUP_DIR"
-
-  BACKUP_FILE="${BACKUP_DIR}/${DATABASE_NAME}_$(date +%Y%m%d_%H%M%S).bak"
-
-  echo "Backup: $DATABASE_NAME → $BACKUP_FILE"
-
-  sqlcmd -S "$SERVER_NAME" -E -Q "BACKUP DATABASE [$DATABASE_NAME] TO DISK='$BACKUP_FILE' WITH FORMAT, INIT, COMPRESSION"
-
-  if [ $? -eq 0 ]; then
-    echo "✓ Backup créé: $BACKUP_FILE"
-    BACKUP_PATH="$BACKUP_FILE"
-  else
-    echo "⚠️ Backup échoué (sqlcmd non disponible ou erreur SQL)"
-    BACKUP_PATH="none"
-  fi
-}
-```
-
-**Prérequis:** `sqlcmd` doit être installé et accessible dans le PATH.
-
----
-
-## Détermination Branche Parente
-
-**Règle d'or:** Le ModelSnapshot de référence doit venir de la branche parente (état validé).
-
-```bash
-determine_base_branch() {
-  CURRENT_BRANCH=$(git branch --show-current)
-
-  # Lire config GitFlow si disponible
-  CONFIG_FILE=".claude/gitflow/config.json"
-  GF_MAIN=$(grep -oP '"main":\s*"\K[^"]+' "$CONFIG_FILE" 2>/dev/null || echo "main")
-  GF_DEVELOP=$(grep -oP '"develop":\s*"\K[^"]+' "$CONFIG_FILE" 2>/dev/null || echo "develop")
-
-  case "$CURRENT_BRANCH" in
-    feature/*|bugfix/*)
-      BASE_BRANCH="$GF_DEVELOP"
-      BRANCH_TYPE="feature"
-      ;;
-    develop)
-      BASE_BRANCH="$GF_MAIN"
-      BRANCH_TYPE="develop"
-      ;;
-    release/*)
-      BASE_BRANCH="$GF_MAIN"
-      BRANCH_TYPE="release"
-      ;;
-    hotfix/*)
-      BASE_BRANCH="$GF_MAIN"
-      BRANCH_TYPE="hotfix"
-      ;;
-    main|master)
-      echo "❌ BLOQUÉ: Opération interdite sur $CURRENT_BRANCH"
-      exit 1
-      ;;
-    *)
-      echo "⚠️ Branche non reconnue: $CURRENT_BRANCH"
-      echo "→ Utilisation de $GF_DEVELOP comme référence par défaut"
-      BASE_BRANCH="$GF_DEVELOP"
-      BRANCH_TYPE="unknown"
-      ;;
-  esac
-
-  # Vérifier que la branche parente existe
-  if ! git rev-parse --verify "origin/$BASE_BRANCH" >/dev/null 2>&1; then
-    echo "❌ Branche parente '$BASE_BRANCH' introuvable sur origin"
-    exit 1
-  fi
-
-  echo "Branche parente: $BASE_BRANCH"
-}
-```
-
-| Branche courante | Branche parente | Raison |
-|------------------|-----------------|--------|
-| `feature/*` | `develop` | État validé de develop |
-| `bugfix/*` | `develop` | État validé de develop |
-| `develop` | `main` | État en production |
-| `release/*` | `main` | État en production |
-| `hotfix/*` | `main` | État en production |
-| `main/master` | **BLOQUÉ** | Jamais squash sur branche protégée |
-
----
-
-## Convention Nommage Migration
-
-**OBLIGATOIRE : Utiliser le MCP pour le nommage**
-
-Pattern: `{context}_v{version}_{sequence}_{Description}`
-
-| Contexte | Version | Séquence | Description | Exemple |
-|----------|---------|----------|-------------|---------|
-| core | 1.2.0 | 001 | AddUserRoles | `core_v1.2.0_001_AddUserRoles` |
-| extensions | 1.3.0 | 001 | AddCustomFields | `extensions_v1.3.0_001_AddCustomFields` |
-
-**Appel MCP OBLIGATOIRE :**
-
-```javascript
-// TOUJOURS appeler le MCP pour obtenir le nom conforme
-mcp__smartstack__suggest_migration({
-  description: "Add User Roles",      // Description courte
-  context: DBCONTEXT_TYPE             // "core" ou "extensions" (de detect_dbcontext)
-})
-
-// Résultat: core_v1.2.0_001_AddUserRoles
-```
-
-**Création migration avec le nom MCP :**
-
-```bash
-# $MIGRATION_NAME = résultat du MCP
-# $DBCONTEXT = CoreDbContext ou ExtensionsDbContext (de detect_dbcontext)
-
-dotnet ef migrations add "$MIGRATION_NAME" \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  -o Persistence/Migrations
-```
-
-> **INTERDIT :** Calculer le nom de migration manuellement. Toujours déléguer au MCP.
-
----
-
-## Règle d'Or: 1 Migration par Feature
-
-**Ne jamais accumuler plusieurs migrations sur une feature.** Si modification du modèle:
-1. Supprimer la migration existante
-2. Recréer avec `/efcore:migration`
-
----
-
-## Règles de Conformité
-
-| ❌ INTERDIT | ✅ OBLIGATOIRE |
-|-------------|----------------|
-| Scripts SQL (.sql) dans le repo | `dotnet ef database update` |
-| `sqlcmd` pour DDL/DML | `dotnet ef migrations add` |
-| `migrationBuilder.Sql()` INSERT | `HasData()` pour seeding |
-
-**Exception:** `sqlcmd` est autorisé UNIQUEMENT pour `BACKUP DATABASE` (backup avant reset).
-
----
-
-## MCP Tool Reference
-
-**Tool:** `mcp__smartstack__check_migrations`
-
-| Paramètre | Type | Description |
-|-----------|------|-------------|
-| `projectPath` | string | Chemin projet EF Core (auto-detect) |
-| `branch` | string | Branche Git (current) |
-| `compareBranch` | string | Branche de comparaison |
-
-**Response:** `MigrationCheckResult { hasConflicts, migrations[], conflicts[], suggestions[] }`
-
----
-
-## Niveaux de Risque Conflit
-
-| Condition | Risque | Action |
-|-----------|--------|--------|
-| Snapshot = develop | NONE | Merge OK |
-| Tables différentes | LOW | Merge OK |
-| FK vers même table | MEDIUM | Ordre important |
-| Même tables/colonnes | HIGH | Rebase requis |
-
----
-
-## Configuration
-
-`.claude/gitflow/config.json`:
-
-```json
-{
-  "efcore": {
-    "database": {
-      "configFile": "appsettings.Local.json",
-      "connectionStringName": "DefaultConnection"
-    },
-    "crossBranch": {
-      "enabled": true,
-      "blockOnConflict": true
-    }
-  }
-}
-```
-
----
-
-## Contact Support
-
-📧 **support@atlshub.ch**

package/templates/commands/efcore/conflicts.md

@@ -1,90 +0,0 @@
----
-description: Analyze conflicts before merge (BLOCKING if conflict detected)
-agent: efcore-conflicts
-model: sonnet
----
-
-# EF Core Conflicts
-
-> **Ref:** [_shared.md](_shared.md)
-> **MCP:** `mcp__smartstack__check_migrations`
-> **Comportement:** Exit code 1 si conflit (bloque merge/commit)
-
----
-
-## STEP 1: Invoquer MCP
-
-```json
-{
-  "tool": "mcp__smartstack__check_migrations",
-  "parameters": {
-    "branch": "<current_branch>",
-    "compareBranch": "develop"
-  }
-}
-```
-
----
-
-## STEP 2: Parser Réponse
-
-```typescript
-interface MigrationCheckResult {
-  hasConflicts: boolean;
-  migrations: MigrationInfo[];
-  conflicts: MigrationConflict[];
-  suggestions: string[];
-}
-```
-
----
-
-## STEP 3: Évaluer Niveau
-
-| Type Conflit | Niveau | Action |
-|--------------|--------|--------|
-| `naming` | LOW | Warning |
-| `order` | MEDIUM | Suggérer réordonnancement |
-| `dependency` | HIGH | Bloquer merge |
-| `snapshot` | CRITICAL | Bloquer, exiger rebase |
-
----
-
-## Résumé
-
-**Si aucun conflit:**
-```
-CONFLICTS - {branch}
-├── Cible: develop
-├── Résultat: ✓ Aucun conflit
-└── Prochains: /gitflow:3-commit, /gitflow:7-pull-request
-```
-
-**Si conflits:**
-```
-CONFLICTS - {branch} - BLOQUÉ
-├── Conflits: {N} trouvés
-├── Types: {snapshot/dependency/order}
-├── Action: /efcore:rebase-snapshot (OBLIGATOIRE)
-└── Force: /efcore:conflicts --force (non recommandé)
-```
-
----
-
-## Exit Codes
-
-| Code | Signification |
-|------|---------------|
-| 0 | Pas de conflit ou mineur |
-| 1 | Conflit détecté - merge bloqué |
-| 2 | Erreur connexion MCP |
-
----
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--force` | Ignorer conflit (non recommandé) |
-| `--target <branch>` | Comparer avec autre branche |
-| `--json` | Output JSON brut MCP |

package/templates/commands/efcore/db-deploy.md

@@ -1,109 +0,0 @@
----
-description: Deploy EF Core migrations to local database
-agent: efcore-db-deploy
-model: haiku
----
-
-# EF Core Database Deploy
-
-> **Ref:** [_shared.md](_shared.md)
-
----
-
-## STEP 0: Vérification Environnement
-
-```bash
-detect_environment
-block_production
-```
-
-Afficher: fichiers disponibles, environnement sélectionné, connexion cible.
-
----
-
-## STEP 1: Détecter Projet et DbContext
-
-```bash
-detect_efcore_project   # Appelle detect_dbcontext() automatiquement
-echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
-```
-
-**Si DbContext non détecté automatiquement :**
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "Quel DbContext déployer ?",
-    header: "DbContext",
-    options: [
-      { label: "CoreDbContext", description: "Migrations du schéma core" },
-      { label: "ExtensionsDbContext", description: "Migrations du schéma extensions" },
-      { label: "Les deux", description: "Déployer core puis extensions" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## STEP 2: Vérifier Migrations Pending
-
-```bash
-PENDING_COUNT=$(dotnet ef migrations list \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --json | grep -c '"applied": false')
-```
-
----
-
-## STEP 3: Appliquer
-
-```bash
-dotnet ef database update \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --verbose
-```
-
-> **Note :** Si "Les deux" sélectionné, exécuter pour CoreDbContext puis ExtensionsDbContext.
-
----
-
-## Résumé
-
-**Si succès:**
-```
-DEPLOY - {DATABASE_NAME}
-├── Environnement: {SELECTED_ENV}
-├── Serveur: {SERVER_NAME}
-├── Migrations appliquées: {N}
-└── Prochains: /efcore:db-status, /efcore:db-seed
-```
-
-**Si aucune pending:**
-```
-DEPLOY - À jour
-├── Aucune migration en attente
-└── Prochains: /efcore:migration, /efcore:scan
-```
-
-**Si erreur connexion:**
-```
-DEPLOY - Échec
-├── Vérifications: SQL Server démarré?, DB existe?, Credentials OK?
-└── Commandes: sqlcmd -S {SERVER} -E, /efcore:db-reset
-```
-
----
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--env {name}` | Utiliser appsettings.{name}.json |
-| `--verbose` | Afficher SQL |
-| `--context {name}` | Spécifier DbContext |