@atlashub/smartstack-cli 1.1.0

package/templates/commands/efcore/migration.md

@@ -0,0 +1,388 @@
+---
+description: Create or recreate the EF Core migration for the current branch (1 migration per feature)
+agent: efcore-migration
+model: sonnet
+---
+
+# EF Core Migration - 1 Migration per Feature
+
+Creates or recreates the unique migration for the current branch.
+
+**GOLDEN RULE: 1 single migration per feature/hotfix. If it already exists, delete and recreate it.**
+
+> **CLAUDE INSTRUCTION:** The `AskUserQuestion({...})` blocks are instructions to use the `AskUserQuestion` tool **interactively**. You MUST execute the tool with these parameters to get the user's response BEFORE continuing.
+
+---
+
+## STEP 0: Cross-Branch Validation (v1.2)
+
+**NEW:** Before creating a migration, check for conflicts with other branches.
+
+```bash
+# Check if cross-branch validation is enabled
+CROSS_BRANCH_ENABLED=$(git config --get efcore.crossBranch.enabled 2>/dev/null || echo "true")
+BLOCK_ON_CONFLICT=$(git config --get efcore.crossBranch.blockOnConflict 2>/dev/null || echo "true")
+
+if [ "$CROSS_BRANCH_ENABLED" = "true" ]; then
+  echo "Cross-branch validation..."
+
+  # Scan other branches via worktrees
+  WORKTREE_BASE=$(git config --get gitflow.worktrees.basePath 2>/dev/null || echo "../worktrees")
+
+  if [ -d "$WORKTREE_BASE/develop" ]; then
+    # Compare ModelSnapshot with develop
+    LOCAL_SNAPSHOT=$(find . -name "*ModelSnapshot.cs" -not -path "*/node_modules/*" | head -1)
+    DEVELOP_SNAPSHOT=$(find "$WORKTREE_BASE/develop" -name "*ModelSnapshot.cs" | head -1)
+
+    if [ -n "$LOCAL_SNAPSHOT" ] && [ -n "$DEVELOP_SNAPSHOT" ]; then
+      if ! diff -q "$LOCAL_SNAPSHOT" "$DEVELOP_SNAPSHOT" > /dev/null 2>&1; then
+        # Differences detected - analyze risk level
+        DIFF_LINES=$(diff "$DEVELOP_SNAPSHOT" "$LOCAL_SNAPSHOT" 2>/dev/null | wc -l)
+
+        if [ "$DIFF_LINES" -gt 100 ]; then
+          echo ""
+          echo "WARNING: CROSS-BRANCH CONFLICT DETECTED"
+          echo ""
+          echo "Your ModelSnapshot differs significantly from develop."
+          echo "Differences: $DIFF_LINES lines"
+          echo ""
+          echo "RESOLUTIONS:"
+          echo "  1. /efcore:rebase-snapshot    (recommended)"
+          echo "  2. /efcore:conflicts          (see details)"
+          echo "  3. /efcore:migration --force  (not recommended)"
+          echo ""
+
+          if [ "$BLOCK_ON_CONFLICT" = "true" ]; then
+            echo "BLOCKED: Use --force to ignore"
+            exit 1
+          fi
+        fi
+      fi
+    fi
+  fi
+
+  echo "Cross-branch validation: OK"
+fi
+```
+
+**Options to ignore:**
+- `--force` : Ignore cross-branch validation
+- `--no-cross-check` : Disable validation for this execution
+- `--rebase-first` : Run rebase-snapshot automatically if conflict
+
+---
+
+## STEP 1: Analyze Git Context
+
+```bash
+# Current branch
+CURRENT_BRANCH=$(git branch --show-current)
+
+# Extract type and name
+if [[ "$CURRENT_BRANCH" == feature/* ]]; then
+  BRANCH_TYPE="Feature"
+  BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's/feature\///' | sed 's/-/_/g' | sed 's/\b\w/\u&/g')
+elif [[ "$CURRENT_BRANCH" == hotfix/* ]]; then
+  BRANCH_TYPE="Hotfix"
+  BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's/hotfix\///' | sed 's/-/_/g' | sed 's/\b\w/\u&/g')
+elif [[ "$CURRENT_BRANCH" == release/* ]]; then
+  BRANCH_TYPE="Release"
+  BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's/release\///' | sed 's/v//')
+else
+  BRANCH_TYPE="Dev"
+  BRANCH_NAME="Manual"
+fi
+
+# Current version
+VERSION=$(grep -oP '"version":\s*"\K[^"]+' package.json 2>/dev/null || grep -oP '(?<=<Version>).*(?=</Version>)' *.csproj 2>/dev/null | head -1)
+VERSION_CLEAN=$(echo "$VERSION" | sed 's/\./_/g')
+```
+
+---
+
+## STEP 2: Detect EF Core Project et Environnement
+
+```bash
+# Find the project with EF Core
+CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
+PROJECT_DIR=$(dirname "$CSPROJ")
+PROJECT_NAME=$(basename "$CSPROJ" .csproj)
+
+# Migrations folder
+MIGRATIONS_DIR="$PROJECT_DIR/Migrations"
+
+# Detect API project for environment display
+API_DIR=$(find . -type d -name "*.Api" | head -1)
+[ -z "$API_DIR" ] && API_DIR="src/SmartStack.Api"
+
+# Detect appsettings to show which DB will be affected on deploy
+SELECTED_ENV="appsettings.Local.json"
+if [ -f "$API_DIR/$SELECTED_ENV" ]; then
+  CONNECTION_STRING=$(powershell -Command "
+    \$json = Get-Content '$API_DIR/$SELECTED_ENV' -ErrorAction SilentlyContinue | ConvertFrom-Json
+    \$json.ConnectionStrings.DefaultConnection
+  " 2>/dev/null)
+  DATABASE_NAME=$(echo "$CONNECTION_STRING" | grep -oP 'Database=\K[^;]+' 2>/dev/null)
+fi
+```
+
+**Afficher info environnement (informatif):**
+
+```
+NOTE: La migration sera appliquee sur: {DATABASE_NAME:-"(detecte au deploy)"}
+      Config: {SELECTED_ENV}
+```
+
+---
+
+## STEP 3: Search for Existing Migration for This Branch
+
+```bash
+# Search pattern based on branch name
+SEARCH_PATTERN="${BRANCH_TYPE}_.*_${BRANCH_NAME}"
+
+# Find matching migration files
+EXISTING_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" | grep -E "$SEARCH_PATTERN" | grep -v "Designer" | grep -v "Snapshot")
+MIGRATION_COUNT=$(echo "$EXISTING_MIGRATIONS" | grep -c "." || echo "0")
+```
+
+**Display context:**
+
+```
+================================================================================
+                    EF CORE MIGRATION - CONTEXT
+================================================================================
+
+BRANCH
+  Current:     {CURRENT_BRANCH}
+  Type:        {BRANCH_TYPE}
+  Name:        {BRANCH_NAME}
+
+VERSION:       {VERSION}
+
+EXISTING MIGRATIONS FOR THIS BRANCH:
+  {MIGRATION_COUNT} migration(s) found
+  {File list if > 0}
+
+================================================================================
+```
+
+---
+
+## STEP 4: Decision - Create or Recreate
+
+### If existing migration (MIGRATION_COUNT > 0):
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "A migration already exists for this branch. What to do?",
+    header: "Migration",
+    options: [
+      { label: "Recreate", description: "Delete and recreate the migration (Recommended)" },
+      { label: "Keep", description: "Keep existing, add a new one (Not recommended)" },
+      { label: "Cancel", description: "Do nothing" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**If Recreate:**
+
+```bash
+# 1. List migrations to delete
+echo "Migrations to delete:"
+for file in $EXISTING_MIGRATIONS; do
+  echo "  - $file"
+  # Find associated files (Designer, etc.)
+  BASE_NAME=$(basename "$file" .cs)
+  rm -f "$MIGRATIONS_DIR/${BASE_NAME}.cs"
+  rm -f "$MIGRATIONS_DIR/${BASE_NAME}.Designer.cs"
+done
+
+# 2. Rollback in DB if applied
+LAST_GOOD_MIGRATION=$(dotnet ef migrations list 2>/dev/null | grep -v "(Pending)" | tail -2 | head -1)
+if [ -n "$LAST_GOOD_MIGRATION" ]; then
+  dotnet ef database update "$LAST_GOOD_MIGRATION" --force
+fi
+```
+
+---
+
+## STEP 5: Request Description
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Short migration description (e.g., AddUserRoles, FixEmailIndex)",
+    header: "Description",
+    options: [
+      { label: "Add", description: "Adding tables/columns" },
+      { label: "Update", description: "Structure modification" },
+      { label: "Fix", description: "Schema correction" },
+      { label: "Remove", description: "Removing elements" }
+    ],
+    multiSelect: false
+  }]
+})
+
+// Then ask for specific name in free text
+// E.g., "AddUserRoles", "FixEmailNullable", "RemoveObsoleteTable"
+```
+
+---
+
+## STEP 6: Generate Migration Name
+
+```bash
+# Pattern: {BranchType}_{Version}_{BranchName}_{Description}
+# Example: Feature_1_2_0_UserAuth_AddRolesTable
+
+MIGRATION_NAME="${BRANCH_TYPE}_${VERSION_CLEAN}_${BRANCH_NAME}_${DESCRIPTION}"
+
+# Clean the name (no spaces, no special characters)
+MIGRATION_NAME=$(echo "$MIGRATION_NAME" | sed 's/[^a-zA-Z0-9_]//g')
+
+echo "Migration name: $MIGRATION_NAME"
+```
+
+**Generated name examples:**
+
+| Branch | Version | Description | Final 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 |
+
+---
+
+## STEP 7: Create Migration
+
+```bash
+cd "$PROJECT_DIR"
+
+# Create migration with generated name
+dotnet ef migrations add "$MIGRATION_NAME" --verbose
+
+# Verify creation
+if [ $? -eq 0 ]; then
+  echo "OK Migration created successfully"
+
+  # List created files
+  NEW_FILES=$(find "$MIGRATIONS_DIR" -name "*${MIGRATION_NAME}*" -type f)
+  echo ""
+  echo "Created files:"
+  for f in $NEW_FILES; do
+    echo "  - $f"
+  done
+else
+  echo "ERROR Failed to create migration"
+  exit 1
+fi
+```
+
+---
+
+## STEP 8: Content Validation
+
+```bash
+# Display migration preview
+MIGRATION_FILE=$(find "$MIGRATIONS_DIR" -name "*${MIGRATION_NAME}.cs" | grep -v "Designer" | head -1)
+
+echo ""
+echo "================================================================================
+                    MIGRATION PREVIEW
+================================================================================"
+echo ""
+
+# Display Up() and Down() methods
+grep -A 20 "protected override void Up" "$MIGRATION_FILE"
+echo ""
+echo "..."
+echo ""
+grep -A 10 "protected override void Down" "$MIGRATION_FILE"
+```
+
+**Verify operations:**
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Does the migration look correct?",
+    header: "Validation",
+    options: [
+      { label: "Yes, apply", description: "Deploy to local DB" },
+      { label: "Yes, not now", description: "Keep without applying" },
+      { label: "No, delete", description: "Cancel and start over" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+---
+
+## STEP 9: Summary
+
+```
+================================================================================
+                    MIGRATION CREATED
+================================================================================
+
+NAME:         {MIGRATION_NAME}
+BRANCH:       {CURRENT_BRANCH}
+VERSION:      {VERSION}
+
+FILES:
+  OK {timestamp}_{MIGRATION_NAME}.cs
+  OK {timestamp}_{MIGRATION_NAME}.Designer.cs
+  OK ApplicationDbContextModelSnapshot.cs (updated)
+
+RULES FOLLOWED:
+  OK 1 migration per feature
+  OK Standardized naming
+  OK Branch/version traceability
+
+================================================================================
+NEXT STEPS
+================================================================================
+
+1. Review generated code in Migrations/
+2. /efcore:db-deploy    -> Apply to local DB
+3. /gitflow:3-commit    -> Commit changes
+4. Before merge: rebase on develop + recreate if conflicts
+
+================================================================================
+```
+
+---
+
+## Migration Conflict Handling
+
+When you rebase on develop and there are conflicts on ModelSnapshot:
+
+```bash
+# 1. Accept develop version for ModelSnapshot
+git checkout --theirs Migrations/ApplicationDbContextModelSnapshot.cs
+
+# 2. Delete your migration
+rm Migrations/*_{MIGRATION_NAME}.*
+
+# 3. Recreate the migration
+/efcore:migration
+```
+
+This command will do it automatically if it detects a conflict.
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--name {name}` | Force a specific name |
+| `--no-apply` | Don't offer to apply |
+| `--force` | Delete existing without confirmation |
+| `--no-cross-check` | Disable cross-branch validation |
+| `--rebase-first` | Run rebase-snapshot automatically if conflict |

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

@@ -0,0 +1,264 @@
+---
+description: Rebase ModelSnapshot on develop and regenerate migration
+agent: efcore-rebase-snapshot
+model: sonnet
+---
+
+# EF Core Rebase-Snapshot - Resync with Develop
+
+Rebases the ModelSnapshot on develop and regenerates a consolidated migration. Used when conflict is detected.
+
+**USAGE:** After `/efcore:conflicts` signals a HIGH conflict.
+
+**WARNING:** This operation modifies migration files. A backup is created automatically.
+
+---
+
+## STEP 1: Check prerequisites
+
+```bash
+CURRENT_BRANCH=$(git branch --show-current)
+echo "Current branch: $CURRENT_BRANCH"
+
+# Check that it's a feature/release/hotfix branch
+if [[ ! $CURRENT_BRANCH =~ ^(feature|release|hotfix)/ ]]; then
+  echo "ERROR: This command can only be executed from a GitFlow branch"
+  exit 1
+fi
+
+# Check that working directory is clean
+if [ -n "$(git status --porcelain)" ]; then
+  echo "ERROR: Working directory not clean"
+  echo "Commit or stash your changes first"
+  exit 1
+fi
+
+# Find EF Core project
+CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; 2>/dev/null | head -1)
+if [ -z "$CSPROJ" ]; then
+  echo "ERROR: No EF Core project found"
+  exit 1
+fi
+
+PROJECT_DIR=$(dirname "$CSPROJ")
+MIGRATIONS_DIR="$PROJECT_DIR/Migrations"
+echo "Project: $PROJECT_DIR"
+echo "Migrations: $MIGRATIONS_DIR"
+```
+
+---
+
+## STEP 2: Backup current migrations
+
+```bash
+BACKUP_DIR=".claude/gitflow/backup/migrations/rebase_$(date +%Y%m%d_%H%M%S)"
+mkdir -p "$BACKUP_DIR"
+
+echo ""
+echo "BACKUP"
+echo "======"
+cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/" 2>/dev/null
+BACKUP_COUNT=$(ls -1 "$BACKUP_DIR" | wc -l)
+echo "  $BACKUP_COUNT files backed up to $BACKUP_DIR"
+```
+
+---
+
+## STEP 3: Identify this branch's migrations
+
+```bash
+# Find migrations added on this branch (not on develop)
+echo ""
+echo "THIS BRANCH'S MIGRATIONS"
+echo "==========================="
+
+# Get migration list on develop
+DEVELOP_MIGRATIONS=$(git show develop:$MIGRATIONS_DIR 2>/dev/null | grep "\.cs$" | grep -v "Designer" | grep -v "Snapshot")
+
+# Local migrations
+LOCAL_MIGRATIONS=$(ls -1 "$MIGRATIONS_DIR"/*.cs 2>/dev/null | xargs -n1 basename | grep -v "Designer" | grep -v "Snapshot")
+
+# New migrations (on this branch but not on develop)
+BRANCH_MIGRATIONS=""
+for migration in $LOCAL_MIGRATIONS; do
+  if ! echo "$DEVELOP_MIGRATIONS" | grep -q "$migration"; then
+    BRANCH_MIGRATIONS="$BRANCH_MIGRATIONS $migration"
+    echo "  + $migration"
+  fi
+done
+
+if [ -z "$BRANCH_MIGRATIONS" ]; then
+  echo "  No migration specific to this branch"
+  echo "  Nothing to rebase"
+  exit 0
+fi
+```
+
+---
+
+## STEP 4: Reset ModelSnapshot on develop
+
+```bash
+echo ""
+echo "RESET MODELSNAPSHOT"
+echo "==================="
+
+# Get develop's ModelSnapshot
+git fetch origin develop
+SNAPSHOT_FILE=$(find "$MIGRATIONS_DIR" -name "*ModelSnapshot.cs" | head -1)
+SNAPSHOT_NAME=$(basename "$SNAPSHOT_FILE")
+
+git checkout origin/develop -- "$MIGRATIONS_DIR/$SNAPSHOT_NAME"
+echo "  ModelSnapshot reset on develop"
+```
+
+---
+
+## STEP 5: Delete this branch's migrations
+
+```bash
+echo ""
+echo "DELETE BRANCH MIGRATIONS"
+echo "=============================="
+
+for migration in $BRANCH_MIGRATIONS; do
+  BASE_NAME="${migration%.cs}"
+  rm -f "$MIGRATIONS_DIR/$BASE_NAME.cs"
+  rm -f "$MIGRATIONS_DIR/$BASE_NAME.Designer.cs"
+  echo "  - $BASE_NAME"
+done
+```
+
+---
+
+## STEP 6: Regenerate consolidated migration
+
+```bash
+echo ""
+echo "REGENERATE MIGRATION"
+echo "======================"
+
+# Extract branch info for name
+BRANCH_TYPE=$(echo "$CURRENT_BRANCH" | cut -d'/' -f1)
+BRANCH_NAME=$(echo "$CURRENT_BRANCH" | cut -d'/' -f2 | sed 's/-/_/g' | sed 's/.*/\u&/')
+
+# Version
+VERSION=$(grep -oP '(?<=<Version>).*(?=</Version>)' "$CSPROJ" 2>/dev/null | head -1 || echo "1.0.0")
+VERSION_CLEAN=$(echo "$VERSION" | sed 's/\./_/g')
+
+# Migration name
+case $BRANCH_TYPE in
+  "feature")
+    MIGRATION_NAME="Feature_${VERSION_CLEAN}_${BRANCH_NAME}_Consolidated"
+    ;;
+  "hotfix")
+    MIGRATION_NAME="Hotfix_${VERSION_CLEAN}_${BRANCH_NAME}_Fix"
+    ;;
+  "release")
+    MIGRATION_NAME="Release_${VERSION_CLEAN}_Consolidated"
+    ;;
+  *)
+    MIGRATION_NAME="Branch_${VERSION_CLEAN}_${BRANCH_NAME}"
+    ;;
+esac
+
+echo "Name: $MIGRATION_NAME"
+
+cd "$PROJECT_DIR"
+dotnet ef migrations add "$MIGRATION_NAME" --verbose
+
+if [ $? -eq 0 ]; then
+  echo "  Migration created successfully"
+else
+  echo "  ERROR: Failed to create migration"
+  echo "  Restoring backup..."
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  exit 1
+fi
+```
+
+---
+
+## STEP 7: Validation
+
+```bash
+echo ""
+echo "VALIDATION"
+echo "=========="
+
+# 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"
+
+# Check that migration can generate script
+dotnet ef migrations script --no-build > /dev/null 2>&1
+if [ $? -ne 0 ]; then
+  echo "  ERROR: Script generation failed"
+  exit 1
+fi
+echo "  Script: OK"
+```
+
+---
+
+## STEP 8: Summary
+
+```
+================================================================================
+                    REBASE-SNAPSHOT COMPLETE
+================================================================================
+
+BRANCH:          {current_branch}
+BACKUP:          {backup_dir}
+
+BEFORE:
+  Migrations:    {old_migrations}
+  ModelSnapshot: {old_hash}
+
+AFTER:
+  Migration:     {new_migration_name}
+  ModelSnapshot: {new_hash} (= develop)
+
+================================================================================
+NEXT STEPS
+================================================================================
+
+1. Check migration content
+2. Test: /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 specific migration name |
+| `--dry-run` | Show what would be done without executing |
+
+---
+
+## When to use
+
+| Situation | Action |
+|-----------|--------|
+| `/efcore:conflicts` returns HIGH | Use rebase-snapshot |
+| Merge conflict on ModelSnapshot | Use rebase-snapshot |
+| Multiple migrations to consolidate | Use rebase-snapshot |
+| Broken migration | Use rebase-snapshot |