@atlashub/smartstack-cli 1.1.0

package/templates/commands/efcore/scan.md

@@ -0,0 +1,202 @@
+---
+description: Scan all branches for migrations with risk analysis
+agent: efcore-scan
+model: sonnet
+---
+
+# EF Core Scan - Cross-Branch Migration Scanner
+
+Scans all active branches to detect migrations and analyze conflict risks.
+
+**USAGE:** Before creating a migration or before a merge to check the status of other branches.
+
+**SECURITY:** Read-only - no modifications.
+
+---
+
+## STEP 1: List active worktrees
+
+```bash
+# Check that worktrees exist
+WORKTREE_BASE=$(git config --get gitflow.worktrees.basePath 2>/dev/null || echo "../worktrees")
+
+if [ ! -d "$WORKTREE_BASE" ]; then
+  echo "Worktrees structure not found: $WORKTREE_BASE"
+  echo "Run /gitflow:1-init to create structure"
+  exit 1
+fi
+
+# List all worktrees
+echo "DETECTED WORKTREES"
+echo "=================="
+git worktree list
+echo ""
+```
+
+---
+
+## STEP 2: Scan migrations per branch
+
+```bash
+# For each worktree
+for worktree in $(git worktree list --porcelain | grep "^worktree" | cut -d' ' -f2); do
+  BRANCH=$(git -C "$worktree" branch --show-current 2>/dev/null)
+
+  if [ -z "$BRANCH" ]; then
+    continue
+  fi
+
+  # Find Migrations folder
+  MIGRATIONS_DIR=$(find "$worktree" -type d -name "Migrations" 2>/dev/null | head -1)
+
+  if [ -n "$MIGRATIONS_DIR" ]; then
+    # Count migrations
+    MIGRATION_COUNT=$(find "$MIGRATIONS_DIR" -name "*.cs" | grep -v "Designer" | grep -v "Snapshot" | wc -l)
+
+    # ModelSnapshot hash
+    SNAPSHOT=$(find "$MIGRATIONS_DIR" -name "*ModelSnapshot.cs" 2>/dev/null | head -1)
+    if [ -n "$SNAPSHOT" ]; then
+      SNAPSHOT_HASH=$(md5sum "$SNAPSHOT" 2>/dev/null | cut -d' ' -f1 | head -c 8)
+    else
+      SNAPSHOT_HASH="N/A"
+    fi
+
+    echo "$BRANCH | $MIGRATION_COUNT migrations | Snapshot: $SNAPSHOT_HASH"
+  fi
+done
+```
+
+---
+
+## STEP 3: Compare with develop
+
+```bash
+# Get develop's ModelSnapshot hash
+DEVELOP_WORKTREE="$WORKTREE_BASE/develop"
+
+if [ -d "$DEVELOP_WORKTREE" ]; then
+  DEVELOP_SNAPSHOT=$(find "$DEVELOP_WORKTREE" -name "*ModelSnapshot.cs" 2>/dev/null | head -1)
+
+  if [ -n "$DEVELOP_SNAPSHOT" ]; then
+    DEVELOP_HASH=$(md5sum "$DEVELOP_SNAPSHOT" 2>/dev/null | cut -d' ' -f1)
+    echo ""
+    echo "REFERENCE: develop ModelSnapshot = ${DEVELOP_HASH:0:8}"
+  fi
+fi
+```
+
+---
+
+## STEP 4: Analyze conflict risks
+
+```bash
+echo ""
+echo "RISK ANALYSIS"
+echo "==================="
+
+# Compare each branch with develop
+for worktree in $(git worktree list --porcelain | grep "^worktree" | cut -d' ' -f2); do
+  BRANCH=$(git -C "$worktree" branch --show-current 2>/dev/null)
+
+  if [ "$BRANCH" = "develop" ] || [ "$BRANCH" = "main" ]; then
+    continue
+  fi
+
+  SNAPSHOT=$(find "$worktree" -name "*ModelSnapshot.cs" 2>/dev/null | head -1)
+
+  if [ -n "$SNAPSHOT" ] && [ -n "$DEVELOP_SNAPSHOT" ]; then
+    # Compare snapshots
+    if diff -q "$SNAPSHOT" "$DEVELOP_SNAPSHOT" > /dev/null 2>&1; then
+      RISK="NONE"
+    else
+      # Analyze differences
+      DIFF_LINES=$(diff "$DEVELOP_SNAPSHOT" "$SNAPSHOT" 2>/dev/null | wc -l)
+
+      if [ "$DIFF_LINES" -lt 50 ]; then
+        RISK="LOW"
+      elif [ "$DIFF_LINES" -lt 200 ]; then
+        RISK="MEDIUM"
+      else
+        RISK="HIGH"
+      fi
+    fi
+
+    echo "$BRANCH: $RISK"
+  fi
+done
+```
+
+---
+
+## STEP 5: Recommend merge order
+
+```bash
+echo ""
+echo "RECOMMENDED MERGE ORDER"
+echo "========================="
+echo "1. Branches with RISK=NONE (independent)"
+echo "2. Branches with RISK=LOW (minor modifications)"
+echo "3. Branches with RISK=MEDIUM (order matters)"
+echo "4. Branches with RISK=HIGH (rebase required before merge)"
+```
+
+---
+
+## Output Format
+
+```
+================================================================================
+                    EF CORE CROSS-BRANCH SCAN
+================================================================================
+
+DETECTED WORKTREES (5)
+  main/                    [main]
+  develop/                 [develop]
+  features/user-auth/      [feature/user-auth]
+  features/add-products/   [feature/add-products]
+  hotfixes/login-fix/      [hotfix/login-fix]
+
+MIGRATIONS PER BRANCH
+  develop               | 12 migrations | Snapshot: a1b2c3d4 (REFERENCE)
+  feature/user-auth     | 13 migrations | Snapshot: e5f6g7h8
+  feature/add-products  | 13 migrations | Snapshot: i9j0k1l2
+  hotfix/login-fix      | 12 migrations | Snapshot: a1b2c3d4
+
+RISK ANALYSIS
+  feature/user-auth     : LOW      (different table)
+  feature/add-products  : MEDIUM   (FK to same table)
+  hotfix/login-fix      : NONE     (snapshot = develop)
+
+RECOMMENDED MERGE ORDER
+  1. hotfix/login-fix      (NONE - direct merge)
+  2. feature/user-auth     (LOW - merge OK)
+  3. feature/add-products  (MEDIUM - after user-auth)
+
+================================================================================
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--json` | JSON output for CI/CD |
+| `--branch <name>` | Scan a specific branch |
+| `--verbose` | Display difference details |
+| `--no-recommend` | Don't display recommendations |
+
+---
+
+## CI/CD Usage
+
+```yaml
+# GitHub Actions
+- name: Scan EF Core migrations
+  run: |
+    OUTPUT=$(claude-code "/efcore:scan --json")
+    CONFLICTS=$(echo $OUTPUT | jq '.risks[] | select(.level == "HIGH") | length')
+    if [ "$CONFLICTS" -gt 0 ]; then
+      echo "::warning::High risk migration conflicts detected"
+    fi
+```

package/templates/commands/efcore/squash.md

@@ -0,0 +1,298 @@
+---
+description: Merge multiple migrations into one (for releases)
+agent: efcore-squash
+model: sonnet
+---
+
+# EF Core Squash - Consolidate Migrations
+
+Merges multiple migrations into a single consolidated migration using EF Core CLI only.
+
+**USAGE:** Before creating a release branch to clean up migration history.
+
+**WARNING:** This operation is **DESTRUCTIVE**. Migration history will be lost.
+
+---
+
+## RÈGLES DE CONFORMITÉ (OBLIGATOIRE)
+
+> **INTERDIT - Violations CLAUDE.md:**
+> - ❌ Génération de scripts SQL dans le repository (`./scripts/migrations/*.sql`)
+> - ❌ Fichiers .sql versionnés dans Git
+> - ❌ `migrationBuilder.Sql()` avec SQL brut
+>
+> **OBLIGATOIRE - Méthodes autorisées:**
+> - ✅ `dotnet ef migrations add` pour créer la migration consolidée
+> - ✅ `dotnet ef migrations remove` pour supprimer les anciennes
+> - ✅ Backup des fichiers .cs dans `.claude/gitflow/backup/` (non versionné)
+>
+> **Contact support:** support@atlshub.ch
+
+---
+
+## STEP 1: Check prerequisites
+
+```bash
+# Check branch
+CURRENT_BRANCH=$(git branch --show-current)
+echo "Current branch: $CURRENT_BRANCH"
+
+# Check clean state
+if [ -n "$(git status --porcelain)" ]; then
+  echo "ERROR: Working directory not clean"
+  exit 1
+fi
+
+# Find EF Core projects
+STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
+INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
+
+if [ -z "$INFRA_PROJECT" ]; then
+  INFRA_PROJECT=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
+fi
+
+PROJECT_DIR=$(dirname "$INFRA_PROJECT")
+MIGRATIONS_DIR="$PROJECT_DIR/Migrations"
+
+# List migrations
+ALL_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer" | grep -v "Snapshot" | sort)
+MIGRATION_COUNT=$(echo "$ALL_MIGRATIONS" | grep -c "." || echo "0")
+
+echo "Migrations found: $MIGRATION_COUNT"
+echo "Project directory: $PROJECT_DIR"
+```
+
+---
+
+## STEP 2: Request confirmation
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "You are about to merge " + MIGRATION_COUNT + " migrations into one. This operation is DESTRUCTIVE. Continue?",
+    header: "Squash",
+    options: [
+      { label: "Yes, squash all", description: "Merge all migrations into one" },
+      { label: "Cancel", description: "Do nothing" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+---
+
+## STEP 3: Full backup (local only - NOT in repository)
+
+```bash
+# Create backup in .claude directory (gitignored)
+BACKUP_DIR=".claude/gitflow/backup/migrations/squash_$(date +%Y%m%d_%H%M%S)"
+mkdir -p "$BACKUP_DIR"
+
+echo "Backup to $BACKUP_DIR (local only, not in Git)"
+cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/" 2>/dev/null
+echo "  $(ls -1 "$BACKUP_DIR" | wc -l) files backed up"
+
+# Keep ModelSnapshot for reference
+cp "$MIGRATIONS_DIR"/*ModelSnapshot.cs "$BACKUP_DIR/ModelSnapshot_backup.cs" 2>/dev/null
+```
+
+---
+
+## STEP 4: Delete all migrations
+
+```bash
+echo "Deleting migrations..."
+
+# Delete all migration files (except ModelSnapshot)
+for file in $(find "$MIGRATIONS_DIR" -name "*.cs" -not -name "*ModelSnapshot.cs" 2>/dev/null); do
+  rm -f "$file"
+  echo "  - $(basename "$file")"
+done
+
+# Also delete Designer files
+for file in $(find "$MIGRATIONS_DIR" -name "*.Designer.cs" 2>/dev/null); do
+  rm -f "$file"
+  echo "  - $(basename "$file")"
+done
+```
+
+---
+
+## STEP 5: Create consolidated migration
+
+```bash
+# Version
+VERSION=$(grep -oP '(?<=<Version>).*(?=</Version>)' "$INFRA_PROJECT" 2>/dev/null | head -1 || echo "1.0.0")
+VERSION_CLEAN=$(echo "$VERSION" | sed 's/\./_/g')
+
+# Migration name
+if [[ "$CURRENT_BRANCH" == release/* ]]; then
+  MIGRATION_NAME="Release_${VERSION_CLEAN}_Initial"
+else
+  MIGRATION_NAME="Consolidated_${VERSION_CLEAN}_AllMigrations"
+fi
+
+echo ""
+echo "Creating consolidated migration: $MIGRATION_NAME"
+
+dotnet ef migrations add "$MIGRATION_NAME" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --verbose
+
+if [ $? -eq 0 ]; then
+  echo "  Migration created successfully"
+else
+  echo "  ERROR - restoring backup"
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  exit 1
+fi
+```
+
+---
+
+## STEP 6: Validation (NO SQL script generation)
+
+```bash
+echo ""
+echo "Validation..."
+
+# Build
+dotnet build --no-restore
+if [ $? -ne 0 ]; then
+  echo "  ERROR: Build failed"
+  echo "  Restoring backup..."
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  exit 1
+fi
+echo "  Build OK"
+
+# Verify migration can be listed
+dotnet ef migrations list \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --no-build 2>/dev/null
+
+if [ $? -ne 0 ]; then
+  echo "  ERROR: Migration list failed"
+  exit 1
+fi
+echo "  Migration list OK"
+```
+
+---
+
+## STEP 7: Summary
+
+```
+================================================================================
+                    SQUASH COMPLETE
+================================================================================
+
+BRANCH:          {current_branch}
+BACKUP:          {backup_dir} (local only)
+
+BEFORE:
+  Migrations: {old_count}
+
+AFTER:
+  Migration:  {migration_name}
+
+COMPLIANT: ✓ EF Core CLI only (no SQL scripts in repository)
+
+================================================================================
+IMPORTANT - PRODUCTION DEPLOYMENT
+================================================================================
+
+Pour déployer en production, vous avez DEUX options:
+
+OPTION 1 - EF Core CLI (Recommandé):
+────────────────────────────────────────────────────────────────────────────────
+dotnet ef database update {migration_name} \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --connection "Server=...;Database=...;..."
+────────────────────────────────────────────────────────────────────────────────
+
+OPTION 2 - Si migrations déjà appliquées (mark as applied):
+────────────────────────────────────────────────────────────────────────────────
+# Insérer manuellement dans __EFMigrationsHistory via SSMS/Azure
+# INSERT INTO __EFMigrationsHistory (MigrationId, ProductVersion)
+# VALUES ('{migration_name}', '10.0.0')
+────────────────────────────────────────────────────────────────────────────────
+
+⚠️  NE PAS générer de scripts SQL dans le repository!
+    Utilisez toujours EF Core CLI pour les déploiements.
+
+================================================================================
+NEXT STEPS
+================================================================================
+
+1. Vérifier le contenu de la migration consolidée
+2. Tester sur dev DB: /efcore:db-reset && /efcore:db-deploy
+3. Commit: /gitflow:3-commit
+
+================================================================================
+RESTORE (if needed)
+================================================================================
+
+cp {backup_dir}/*.cs {migrations_dir}/
+
+================================================================================
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--no-backup` | Don't create backup (dangerous) |
+| `--name <name>` | Force a migration name |
+| `--keep-snapshot` | Keep current ModelSnapshot |
+| `--dry-run` | Show without executing |
+
+---
+
+## When to use Squash
+
+| Situation | Use Squash? |
+|-----------|-------------|
+| Before release | YES - clean up history |
+| After merging multiple features | YES - consolidate |
+| In production | NO - use EF Core CLI directly |
+| Feature branch in progress | CAUTION - prefer rebase-snapshot |
+
+---
+
+## Forbidden Patterns
+
+```
+❌ INTERDIT - Ne jamais faire:
+────────────────────────────────────────────────────────────────────────────────
+# Génération de script SQL dans le repo
+dotnet ef migrations script -o ./scripts/migrations/*.sql
+
+# Stockage de fichiers .sql versionnés
+./scripts/migrations/Release_1_0_0.sql
+./scripts/seed.sql
+────────────────────────────────────────────────────────────────────────────────
+
+✅ CORRECT - Toujours utiliser:
+────────────────────────────────────────────────────────────────────────────────
+# EF Core CLI pour déploiement
+dotnet ef database update
+
+# Backup local uniquement (gitignored)
+.claude/gitflow/backup/migrations/
+────────────────────────────────────────────────────────────────────────────────
+```
+
+---
+
+## Support
+
+> **Questions ou problèmes avec le squash EF Core?**
+>
+> 📧 **support@atlshub.ch**

package/templates/commands/efcore.md

@@ -0,0 +1,176 @@
+---
+description: EF Core Commands - Migration and database management
+---
+
+# EF Core Commands
+
+Set of commands to manage Entity Framework Core: migrations, database, and seeding.
+
+## Available Commands
+
+### Migrations
+
+| Command | Description | Risk |
+|---------|-------------|------|
+| `/efcore:migration` | Create/recreate migration (1 per feature) | Low |
+| `/efcore:db-status` | Show migration status | None (read-only) |
+| `/efcore:db-deploy` | Apply migrations | Low |
+| `/efcore:db-seed` | Populate with data | Low |
+| `/efcore:db-reset` | Drop + Recreate database | **HIGH** |
+
+### Cross-Branch (v1.2)
+
+| Command | Description | Risk |
+|---------|-------------|------|
+| `/efcore:scan` | Scan migrations across all branches | None (read-only) |
+| `/efcore:conflicts` | Analyze potential conflicts (BLOCKING) | None (read-only) |
+| `/efcore:rebase-snapshot` | Rebase ModelSnapshot on develop | Medium |
+| `/efcore:squash` | Merge multiple migrations into one | **HIGH** |
+
+## Golden Rule: 1 Migration per Feature
+
+**Never accumulate multiple migrations on a feature.** If you modify the model:
+1. Delete the existing migration
+2. Recreate it with `/efcore:migration`
+
+The `/efcore:migration` command handles this automatically.
+
+## Migration Naming
+
+Pattern: `{BranchType}_{Version}_{BranchName}_{Description}`
+
+| Branch | Version | Description | Generated Name |
+|--------|---------|-------------|----------------|
+| feature/user-auth | 1.2.0 | AddRolesTable | `Feature_1_2_0_UserAuth_AddRolesTable` |
+| hotfix/login-fix | 1.2.1 | FixNullEmail | `Hotfix_1_2_1_LoginFix_FixNullEmail` |
+| release/v1.3.0 | 1.3.0 | Initial | `Release_1_3_0_Initial` |
+
+## Typical Workflow
+
+```
+1. /gitflow:10-start feature xxx    → Create worktree + appsettings.Local.json
+2. /efcore:db-deploy                → Apply existing migrations
+3. ... model modifications ...
+4. /efcore:migration                → Create THE migration for this feature
+5. /efcore:db-deploy                → Apply to local DB
+6. /gitflow:3-commit                → Commit
+```
+
+## Cross-Branch Workflow (v1.2)
+
+With GitFlow worktrees, multiple branches can have migrations in parallel. To avoid conflicts:
+
+```
+1. /efcore:scan                → Scan all active branches
+2. /efcore:conflicts           → Check for conflicts (BLOCKING)
+3. /efcore:rebase-snapshot     → If conflict, rebase on develop
+4. /efcore:migration           → Create/recreate migration
+```
+
+### Recommended Merge Order
+
+The scan analyzes migrations and recommends a merge order:
+
+```
+ACTIVE BRANCHES (3)
+--------------------
+feature/user-roles    +1 migration    Conflict: NONE
+feature/add-products  +1 migration    Conflict: POTENTIAL
+feature/orders        +2 migrations   Conflict: HIGH
+
+RECOMMENDED MERGE ORDER:
+1. feature/user-roles (independent)
+2. feature/add-products (before orders)
+3. feature/orders (rebase required)
+```
+
+## Configuration
+
+Commands use configuration in `.claude/gitflow/config.json`:
+
+```json
+{
+  "efcore": {
+    "database": {
+      "configFile": "appsettings.Local.json",
+      "connectionStringName": "DefaultConnection",
+      "provider": "SqlServer"
+    },
+    "crossBranch": {
+      "enabled": true,
+      "scanOnMigrationCreate": true,
+      "blockOnConflict": true,
+      "cacheExpiry": 300
+    }
+  }
+}
+```
+
+### crossBranch Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `enabled` | Enable cross-branch validation | `true` |
+| `scanOnMigrationCreate` | Scan before `/efcore:migration` | `true` |
+| `blockOnConflict` | Block if conflict detected | `true` |
+| `cacheExpiry` | Scan cache duration (seconds) | `300` |
+
+## Environment Selection (NEW)
+
+All EF Core commands now display the target database BEFORE execution:
+
+```
+================================================================================
+                         EF CORE - DATABASE DEPLOY
+================================================================================
+
+FICHIERS DISPONIBLES:
+  - appsettings.json
+  - appsettings.Local.json
+  - appsettings.Development.json
+
+ENVIRONNEMENT: appsettings.Local.json
+
+CONNEXION CIBLE:
+  Server:   localhost
+  Database: SmartStack_Dev
+  String:   Server=localhost;Database=SmartStack_Dev;...
+
+================================================================================
+```
+
+### Override Environment
+
+Use `--env` flag to target a different environment:
+
+```bash
+# Deploy to Development environment
+/efcore:db-deploy --env Development
+
+# Reset Staging database
+/efcore:db-reset --env Staging
+```
+
+### Protection Production
+
+Commands that modify the database are **automatically blocked** if `appsettings.Production.json` is detected.
+
+## appsettings.Local.json File
+
+This file contains the local connection string and is **never committed**:
+
+```json
+{
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=localhost;Database=MyApp;Trusted_Connection=true;TrustServerCertificate=true"
+  }
+}
+```
+
+The file is automatically created by `/gitflow:10-start` and added to `.gitignore`.
+
+## Prerequisites
+
+- .NET SDK installed
+- EF Core Tools: `dotnet tool install --global dotnet-ef`
+- SQL Server (or other configured provider)