@atlashub/smartstack-cli 1.23.0 → 1.25.0

package/templates/commands/efcore/rebase-snapshot.md

@@ -1,172 +0,0 @@
----
-description: Rebase ModelSnapshot on develop and regenerate migration
-agent: efcore-rebase-snapshot
-model: sonnet
----
-
-# EF Core Rebase-Snapshot
-
-> **Ref:** [_shared.md](_shared.md)
-> **Usage:** Après `/efcore:conflicts` HIGH
-> **WARNING:** Modifie fichiers migration. Backup automatique.
-
----
-
-## STEP 1: Vérifier Prérequis
-
-```bash
-CURRENT_BRANCH=$(git branch --show-current)
-[[ ! $CURRENT_BRANCH =~ ^(feature|release|hotfix)/ ]] && exit 1
-[ -n "$(git status --porcelain)" ] && { echo "Working directory non clean"; exit 1; }
-
-# Détecte projet ET DbContext (core vs extensions)
-detect_efcore_project   # Appelle detect_dbcontext() automatiquement
-determine_base_branch   # Détermine la branche parente
-
-echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
-echo "Branche parente: $BASE_BRANCH"
-```
-
-**Si DbContext non détecté automatiquement :**
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: "Quel DbContext utiliser ?",
-    header: "DbContext",
-    options: [
-      { label: "CoreDbContext", description: "Entités SmartStack" },
-      { label: "ExtensionsDbContext", description: "Entités client" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## STEP 2: Backup
-
-```bash
-BACKUP_DIR=".claude/gitflow/backup/migrations/rebase_$(date +%Y%m%d_%H%M%S)"
-mkdir -p "$BACKUP_DIR"
-cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/"
-```
-
----
-
-## STEP 3: Identifier Migrations de la Branche
-
-```bash
-# Migrations sur develop
-DEVELOP_MIGRATIONS=$(git show develop:$MIGRATIONS_DIR | grep "\.cs$")
-
-# Nouvelles migrations (cette branche seulement)
-for migration in $LOCAL_MIGRATIONS; do
-  echo "$DEVELOP_MIGRATIONS" | grep -q "$migration" || BRANCH_MIGRATIONS+=" $migration"
-done
-```
-
----
-
-## STEP 4: Reset ModelSnapshot sur Develop
-
-```bash
-git fetch origin develop
-git checkout origin/develop -- "$MIGRATIONS_DIR/*ModelSnapshot.cs"
-```
-
----
-
-## STEP 5: Supprimer Migrations de la Branche
-
-```bash
-for migration in $BRANCH_MIGRATIONS; do
-  rm -f "$MIGRATIONS_DIR/${migration%.cs}.cs"
-  rm -f "$MIGRATIONS_DIR/${migration%.cs}.Designer.cs"
-done
-```
-
----
-
-## STEP 6: Régénérer Migration Consolidée
-
-**OBLIGATOIRE : Utiliser le MCP pour le nommage conforme**
-
-```bash
-# Construire la description
-BRANCH_NAME_CLEAN=$(echo "$CURRENT_BRANCH" | sed 's|.*/||' | sed 's/-/ /g')
-DESCRIPTION="${BRANCH_NAME_CLEAN} Consolidated"
-```
-
-**Appel MCP OBLIGATOIRE :**
-
-```javascript
-// Obtenir le nom conforme via MCP
-mcp__smartstack__suggest_migration({
-  description: DESCRIPTION,           // Ex: "user auth Consolidated"
-  context: DBCONTEXT_TYPE             // "core" ou "extensions" (de detect_dbcontext)
-})
-
-// Résultat: core_v1.7.0_001_UserAuthConsolidated
-```
-
-**Puis créer la migration :**
-
-```bash
-# $MIGRATION_NAME = résultat du MCP
-# $DBCONTEXT = CoreDbContext ou ExtensionsDbContext
-
-dotnet ef migrations add "$MIGRATION_NAME" \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  -o Persistence/Migrations \
-  --verbose
-```
-
-> **Convention :** `{context}_v{version}_{sequence}_{Description}` - Jamais de nom hardcodé
-
----
-
-## STEP 7: Validation
-
-```bash
-dotnet build --no-restore
-dotnet ef migrations script --no-build > /dev/null
-```
-
----
-
-## Résumé
-
-```
-REBASE-SNAPSHOT - {branch}
-├── Backup: {backup_dir}
-├── Avant: {old_migrations}
-├── Après: {new_migration_name} (Snapshot = develop)
-├── Validations: ✓ Build, ✓ Script
-└── Prochains: /efcore:db-reset, /efcore:db-deploy, /gitflow:3-commit
-```
-
-**Si échec:** Backup restauré automatiquement.
-
----
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--no-backup` | Sans backup (dangereux) |
-| `--name <name>` | Forcer nom migration |
-| `--dry-run` | Afficher sans exécuter |
-
----
-
-## Quand utiliser
-
-| Situation | Action |
-|-----------|--------|
-| `/efcore:conflicts` HIGH | Utiliser rebase-snapshot |
-| Conflit merge sur ModelSnapshot | Utiliser rebase-snapshot |
-| Plusieurs migrations à consolider | Utiliser rebase-snapshot |

package/templates/commands/efcore/scan.md

@@ -1,94 +0,0 @@
----
-description: Scan all branches for migrations with risk analysis
-agent: efcore-scan
-model: sonnet
----
-
-# EF Core Scan
-
-> **Ref:** [_shared.md](_shared.md)
-> **MCP:** `mcp__smartstack__check_migrations` pour chaque branche
-> **Type:** Read-only, aucune modification
-
----
-
-## STEP 1: Détecter Worktrees Actifs
-
-```bash
-WORKTREES=$(git worktree list --porcelain | grep "^worktree" | cut -d' ' -f2)
-```
-
----
-
-## STEP 2: Invoquer MCP pour Chaque Branche
-
-```
-FOR each branch in [feature/*, hotfix/*, release/*]:
-  CALL mcp__smartstack__check_migrations WITH:
-    - branch: {branch}
-    - compareBranch: "develop"
-  STORE result in BRANCH_RESULTS[branch]
-```
-
----
-
-## STEP 3: Calculer Niveau Risque
-
-| Condition | Risque |
-|-----------|--------|
-| Snapshot = develop | NONE |
-| Tables différentes | LOW |
-| FK vers même table | MEDIUM |
-| Même tables/colonnes | HIGH |
-
----
-
-## STEP 4: Recommander Ordre Merge
-
-```
-1. Branches RISK=NONE (merge immédiat)
-2. Branches RISK=LOW (modifications mineures)
-3. Branches RISK=MEDIUM (ordre important)
-4. Branches RISK=HIGH (rebase requis)
-```
-
----
-
-## Résumé
-
-```
-SCAN CROSS-BRANCH
-├── Worktrees: {count}
-├── Branches avec migrations: {N}
-├── Conflits: {none/low/medium/high}
-│
-├── ORDRE MERGE RECOMMANDÉ
-│   1. {branch} - AUCUN risque - ✓ Merge OK
-│   2. {branch} - FAIBLE risque - ✓ Merge OK
-│   3. {branch} - MOYEN risque - ⚠ Après #{2}, puis rebase
-│
-└── Prochains: /gitflow:9-merge, /efcore:rebase-snapshot, /efcore:conflicts
-```
-
----
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--json` | Output JSON pour CI/CD |
-| `--branch <name>` | Scanner branche spécifique |
-| `--verbose` | Détails MCP |
-| `--no-recommend` | Sans recommandations |
-
----
-
-## CI/CD Usage
-
-```yaml
-- name: Scan EF Core migrations
-  run: |
-    OUTPUT=$(claude-code "/efcore:scan --json")
-    HIGH_RISK=$(echo $OUTPUT | jq '[.branches[] | select(.riskLevel == "HIGH")] | length')
-    [ "$HIGH_RISK" -gt 0 ] && echo "::warning::$HIGH_RISK branches HIGH risk"
-```

package/templates/commands/efcore/squash.md

@@ -1,329 +0,0 @@
----
-description: Merge multiple migrations into one (for releases)
-agent: efcore-squash
-model: sonnet
----
-
-# EF Core Squash
-
-> **Ref:** [_shared.md](_shared.md) - `determine_base_branch()`, `detect_efcore_project()`
-> **Usage:** Consolider migrations avant merge ou release
-> **WARNING:** DESTRUCTIF - historique migrations perdu
-
----
-
-## Conformité
-
-| INTERDIT | OBLIGATOIRE |
-|----------|-------------|
-| Scripts .sql dans repo | `dotnet ef migrations add` |
-| `migrationBuilder.Sql()` brut | `dotnet ef migrations remove` |
-| Squash sans récupérer snapshot parent | Backup dans `.claude/` (gitignored) |
-
----
-
-## STEP 0: Déterminer Branche Parente (CRITIQUE)
-
-```bash
-determine_base_branch  # Voir _shared.md
-
-# Résultat:
-# - BASE_BRANCH = branche parente (develop, main, etc.)
-# - BRANCH_TYPE = type de branche courante
-# - Exit si main/master (BLOQUÉ)
-```
-
-| Branche courante | BASE_BRANCH | Action |
-|------------------|-------------|--------|
-| `feature/*` | `develop` | Récupère snapshot develop |
-| `develop` | `main` | Récupère snapshot main |
-| `release/*` | `main` | Récupère snapshot main |
-| `hotfix/*` | `main` | Récupère snapshot main |
-| `main/master` | **BLOQUÉ** | Exit code 1 |
-
----
-
-## STEP 1: Vérifier Prérequis
-
-```bash
-CURRENT_BRANCH=$(git branch --show-current)
-[ -n "$(git status --porcelain)" ] && { echo "Working directory non propre"; exit 1; }
-detect_efcore_project   # Appelle detect_dbcontext() → $DBCONTEXT, $DBCONTEXT_TYPE, $SCHEMA
-
-echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
-echo "Schema: $SCHEMA"
-
-# Compter migrations LOCALES uniquement (pas celles héritées)
-git fetch origin "$BASE_BRANCH" --quiet
-BASE_MIGRATIONS=$(git ls-tree -r --name-only "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR" | grep "\.cs$" | grep -v "Designer\|Snapshot")
-LOCAL_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" | grep -v "Designer\|Snapshot" | xargs -I{} basename {})
-
-# Migrations propres à cette branche
-BRANCH_ONLY_MIGRATIONS=()
-for mig in $LOCAL_MIGRATIONS; do
-  echo "$BASE_MIGRATIONS" | grep -q "$mig" || BRANCH_ONLY_MIGRATIONS+=("$mig")
-done
-
-MIGRATION_COUNT=${#BRANCH_ONLY_MIGRATIONS[@]}
-echo "Migrations à consolider: $MIGRATION_COUNT (propres à $CURRENT_BRANCH)"
-echo "Branche parente: $BASE_BRANCH"
-```
-
----
-
-## STEP 2: Confirmation Utilisateur
-
-```javascript
-AskUserQuestion({
-  questions: [{
-    question: `Squash ${MIGRATION_COUNT} migrations de ${CURRENT_BRANCH}?
-
-Le ModelSnapshot de ${BASE_BRANCH} sera récupéré comme base.
-Vos migrations seront consolidées en UNE seule.
-
-Cette opération est DESTRUCTIVE et IRRÉVERSIBLE (sauf backup).`,
-    header: "Squash",
-    options: [
-      { label: "Oui, squash", description: `Consolider sur base de ${BASE_BRANCH}` },
-      { label: "Voir détails", description: "Afficher migrations concernées" },
-      { label: "Annuler", description: "Ne rien faire" }
-    ],
-    multiSelect: false
-  }]
-})
-```
-
----
-
-## STEP 3: Backup Local
-
-```bash
-BACKUP_DIR=".claude/gitflow/backup/migrations/squash_$(date +%Y%m%d_%H%M%S)"
-mkdir -p "$BACKUP_DIR"
-cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/"
-echo "Backup: $BACKUP_DIR"
-```
-
----
-
-## STEP 4: Récupérer Migrations ET Snapshot de la Branche Parente (CRUCIAL)
-
-```bash
-# Sauvegarder snapshot actuel
-cp "$MIGRATIONS_DIR"/*ModelSnapshot.cs "$BACKUP_DIR/"
-
-# Récupérer TOUTES les migrations de la branche parente
-git fetch origin "$BASE_BRANCH" --quiet
-
-# 1. Récupérer le ModelSnapshot
-git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR"/*ModelSnapshot.cs
-
-# 2. Récupérer les fichiers de migration de la branche parente
-# (pour ne pas perdre les migrations déjà présentes sur develop/main)
-for base_mig in $BASE_MIGRATIONS; do
-  base_file=$(basename "$base_mig")
-  base_name="${base_file%.cs}"
-
-  # Récupérer le fichier migration ET son Designer
-  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.cs" 2>/dev/null || true
-  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.Designer.cs" 2>/dev/null || true
-done
-
-echo "Récupéré depuis origin/$BASE_BRANCH:"
-echo "  - ModelSnapshot"
-echo "  - $(echo "$BASE_MIGRATIONS" | wc -l) migrations"
-```
-
-**Pourquoi c'est crucial:**
-- Le snapshot de `$BASE_BRANCH` contient l'état VALIDÉ et COMPLET
-- Les **migrations existantes** de `$BASE_BRANCH` doivent être conservées
-- Les migrations parallèles sur d'autres branches sont incluses
-- Évite la perte d'information de schéma (cf. [Bokio best practices](https://www.bokio.se/engineering-blog/how-to-squash-ef-core-migrations/))
-
-**Résultat attendu:**
-```
-feature/multitenant après squash:
-├── core_v1.8.0_001_InitialSchema.cs          ← De develop (conservé)
-├── core_v1.8.0_001_InitialSchema.Designer.cs
-├── core_v1.9.0_001_MultitenantConsolidated.cs     ← Squash de la feature (MCP)
-├── core_v1.9.0_001_MultitenantConsolidated.Designer.cs
-└── CoreDbContextModelSnapshot.cs             ← De develop
-```
-
-⚠️ **ATTENTION:** Si le résultat ne montre pas les migrations de develop, le squash a échoué!
-
----
-
-## STEP 5: Supprimer Migrations de la Branche (pas celles héritées)
-
-```bash
-# Supprimer UNIQUEMENT les migrations propres à cette branche
-for mig in "${BRANCH_ONLY_MIGRATIONS[@]}"; do
-  rm -f "$MIGRATIONS_DIR"/${mig%.cs}.cs
-  rm -f "$MIGRATIONS_DIR"/${mig%.cs}.Designer.cs
-done
-
-echo "Supprimé: ${#BRANCH_ONLY_MIGRATIONS[@]} migrations"
-```
-
----
-
-## STEP 6: Créer Migration Consolidée
-
-**OBLIGATOIRE: Utiliser le MCP pour le nommage conforme**
-
-```bash
-# Construire la description selon le contexte
-case "$BRANCH_TYPE" in
-  feature)
-    BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's|feature/||' | sed 's/-/ /g')
-    DESCRIPTION="${BRANCH_NAME} Consolidated"
-    ;;
-  release)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|release/||')
-    DESCRIPTION="Release ${VERSION} Initial"
-    ;;
-  hotfix)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|hotfix/||')
-    DESCRIPTION="Hotfix ${VERSION} Fix"
-    ;;
-  develop)
-    DESCRIPTION="Develop Consolidated"
-    ;;
-  *)
-    DESCRIPTION="Consolidated"
-    ;;
-esac
-```
-
-**Appel MCP OBLIGATOIRE:**
-
-```javascript
-// $DESCRIPTION = construit ci-dessus (ex: "multitenant Consolidated")
-// $DBCONTEXT_TYPE = "core" ou "extensions" (de detect_dbcontext)
-
-mcp__smartstack__suggest_migration({
-  description: DESCRIPTION,
-  context: DBCONTEXT_TYPE    // JAMAIS hardcodé!
-})
-
-// Résultat: core_v1.9.0_001_MultitenantConsolidated
-```
-
-> **INTERDIT :** Calculer le nom manuellement ou hardcoder le context.
-
-**Puis créer la migration:**
-
-```bash
-# MIGRATION_NAME = résultat du MCP (ex: core_v1.9.0_001_MultitenantConsolidated)
-# 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 \
-  --verbose
-```
-
-> **Convention:** `{context}_v{version}_{sequence}_{Description}` - Jamais de nom hardcodé
-
----
-
-## STEP 7: Validation
-
-```bash
-# Build
-dotnet build --no-restore
-[ $? -ne 0 ] && { echo "Build FAILED - restauration backup"; cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"; exit 1; }
-
-# Liste migrations
-dotnet ef migrations list --no-build
-
-# Générer script (validation)
-dotnet ef migrations script --no-build --idempotent > /dev/null
-[ $? -ne 0 ] && { echo "Script generation FAILED"; exit 1; }
-```
-
----
-
-## Résumé
-
-```
-SQUASH - {CURRENT_BRANCH}
-  Base:         {BASE_BRANCH}
-  Backup:       {BACKUP_DIR}
-
-  Récupéré de {BASE_BRANCH}:
-    - ModelSnapshot
-    - {BASE_MIGRATION_COUNT} migrations (conservées)
-
-  Consolidé:
-    - Avant:  {MIGRATION_COUNT} migrations (propres à la branche)
-    - Après:  1 migration ({MIGRATION_NAME})
-
-  Total final: {BASE_MIGRATION_COUNT + 1} migrations
-  Conformité:  MCP suggest_migration, EF Core CLI, Snapshot parent
-
-Prochains: /efcore:db-reset, /efcore:db-deploy, /gitflow:3-commit
-```
-
-**Si échec:** Restaurer avec `cp $BACKUP_DIR/*.cs $MIGRATIONS_DIR/`
-
----
-
-## Options
-
-| Option | Description |
-|--------|-------------|
-| `--no-backup` | Sans backup (dangereux) |
-| `--name <name>` | Forcer nom migration |
-| `--dry-run` | Afficher sans exécuter |
-| `--include-inherited` | Inclure migrations héritées (rare) |
-
----
-
-## Matrice d'Utilisation
-
-| Situation | Utiliser squash? | Alternative |
-|-----------|------------------|-------------|
-| Feature avec plusieurs migrations | OUI | `/efcore:rebase-snapshot` |
-| Avant merge feature vers develop | OUI (recommandé) | - |
-| Sur develop avant release | Créer release d'abord | `/gitflow:10-start release` |
-| Sur release avant tag | OUI (idéal) | - |
-| Hotfix urgent | OUI | - |
-| Sur main/master | **JAMAIS** | BLOQUÉ automatiquement |
-
----
-
-## Workflow Complet Recommandé
-
-```
-1. feature/* : développement avec N migrations
-
-2. Avant merge sur develop:
-   /efcore:squash
-   → Récupère snapshot develop
-   → Consolide en 1 migration
-
-3. Merge sur develop:
-   /gitflow:7-pull-request
-   /gitflow:9-merge
-
-4. Avant release:
-   /gitflow:10-start release vX.Y.Z
-   /efcore:squash (sur release/*)
-   → Récupère snapshot main
-   → Consolide TOUT en Release_X_Y_Z_Initial
-
-5. Finaliser:
-   /gitflow:11-finish
-```
-
----
-
-## Sources Best Practices
-
-- [Microsoft - Managing Migrations](https://learn.microsoft.com/en-us/ef/core/managing-schemas/migrations/managing)
-- [Bokio - How to squash EF Core migrations](https://www.bokio.se/engineering-blog/how-to-squash-ef-core-migrations/)
-- [Mitchel Sellers - Squashing EF Core Migrations Safely](https://www.mitchelsellers.com/blog/article/squashing-ef-core-migrations-safely)

package/templates/commands/efcore.md

@@ -1,96 +0,0 @@
----
-description: EF Core Commands - Migration and database management
----
-
-# EF Core Commands
-
-> **Ref:** Fonctions communes dans [efcore/_shared.md](efcore/_shared.md)
-> **MCP:** `mcp__smartstack__check_migrations` pour analyse conflits
-
----
-
-## Commandes Disponibles
-
-### Migrations
-
-| Commande | Description | Risque |
-|----------|-------------|--------|
-| `/efcore:migration` | Créer/recréer migration (1 par feature) | Low |
-| `/efcore:db-status` | Afficher statut migrations | None |
-| `/efcore:db-deploy` | Appliquer migrations | Low |
-| `/efcore:db-seed` | Peupler avec données | Low |
-| `/efcore:db-reset` | Drop + Recreate DB | **HIGH** |
-
-### Cross-Branch
-
-| Commande | Description | Risque |
-|----------|-------------|--------|
-| `/efcore:scan` | Scanner toutes les branches | None |
-| `/efcore:conflicts` | Analyser conflits (BLOQUANT) | None |
-| `/efcore:rebase-snapshot` | Rebaser ModelSnapshot sur develop | Medium |
-| `/efcore:squash` | Fusionner migrations | **HIGH** |
-
----
-
-## Règle d'Or: 1 Migration par Feature
-
-Si modification du modèle: supprimer et recréer la migration.
-
----
-
-## Workflow Typique
-
-```
-1. /gitflow:10-start feature xxx    → Worktree + appsettings.Local.json
-2. /efcore:db-deploy                → Appliquer migrations existantes
-3. ... modifications modèle ...
-4. /efcore:migration                → Créer LA migration
-5. /efcore:db-deploy                → Appliquer localement
-6. /gitflow:3-commit                → Commit
-```
-
----
-
-## Workflow Cross-Branch
-
-```
-1. /efcore:scan                → Scanner branches actives
-2. /efcore:conflicts           → Vérifier conflits (BLOQUANT)
-3. /efcore:rebase-snapshot     → Si conflit, rebaser sur develop
-4. /efcore:migration           → Créer/recréer migration
-```
-
----
-
-## Sélection Environnement
-
-Toutes les commandes affichent la base cible AVANT exécution.
-
-| Priorité | Fichier |
-|----------|---------|
-| 1 | `--env {Environment}` flag |
-| 2 | `appsettings.Local.json` (défaut) |
-
-**Protection:** Commandes destructives bloquées si Production détecté.
-
----
-
-## appsettings.Local.json
-
-```json
-{
-  "ConnectionStrings": {
-    "DefaultConnection": "Server=localhost;Database=MyApp;Trusted_Connection=true;TrustServerCertificate=true"
-  }
-}
-```
-
-Créé automatiquement par `/gitflow:10-start`, ajouté à `.gitignore`.
-
----
-
-## Prérequis
-
-- .NET SDK installé
-- EF Core Tools: `dotnet tool install --global dotnet-ef`
-- SQL Server (ou provider configuré)