@atlashub/smartstack-cli 1.17.0 → 1.18.0

package/templates/skills/efcore/steps/migration/step-03-validate.md

@@ -0,0 +1,203 @@
+---
+name: step-03-validate
+description: Validate migration and optionally deploy
+next_step: null
+---
+
+# Step 3: Validate Migration
+
+## YOUR TASK:
+
+Validate the created migration and optionally apply it to the local database.
+
+**Previous step:** `step-02-create.md`
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Build Project
+
+```bash
+echo "Building project..."
+echo ""
+
+dotnet build "$INFRA_PROJECT" --no-restore
+
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "ERROR: Build failed"
+  echo "Please fix compilation errors and retry."
+  exit 1
+fi
+
+echo "Build: OK"
+```
+
+### 2. Show Migration Content Summary
+
+```bash
+echo ""
+echo "Migration content:"
+echo ""
+
+# Count operations in migration
+UP_TABLES=$(grep -c "CreateTable" "$MIGRATION_FILE" || echo "0")
+UP_COLUMNS=$(grep -c "AddColumn" "$MIGRATION_FILE" || echo "0")
+UP_INDEXES=$(grep -c "CreateIndex" "$MIGRATION_FILE" || echo "0")
+UP_FOREIGN=$(grep -c "AddForeignKey" "$MIGRATION_FILE" || echo "0")
+
+echo "  Tables:      $UP_TABLES"
+echo "  Columns:     $UP_COLUMNS"
+echo "  Indexes:     $UP_INDEXES"
+echo "  Foreign Keys:$UP_FOREIGN"
+```
+
+### 3. Ask User to Validate
+
+**If NOT auto mode:**
+
+```yaml
+AskUserQuestion:
+  header: "Validation"
+  question: "Migration created. What do you want to do?"
+  options:
+    - label: "Apply to local DB"
+      description: "Run /efcore db-deploy now"
+    - label: "Keep without applying"
+      description: "Apply later manually"
+    - label: "Delete and retry"
+      description: "Remove migration, start over"
+  multiSelect: false
+```
+
+### 4. Handle Response
+
+```javascript
+if (answer === "Apply to local DB") {
+  // Apply migration
+  ACTION = "deploy";
+} else if (answer === "Keep without applying") {
+  ACTION = "keep";
+} else {
+  // Delete and start over
+  ACTION = "delete";
+}
+```
+
+### 5. Execute Action
+
+**If deploy:**
+
+```bash
+echo ""
+echo "Applying migration..."
+
+dotnet ef database update \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --verbose
+
+if [ $? -eq 0 ]; then
+  echo ""
+  echo "Migration applied successfully."
+else
+  echo ""
+  echo "ERROR: Migration failed to apply."
+  echo "Database may need reset: /efcore db-reset"
+fi
+```
+
+**If delete:**
+
+```bash
+echo ""
+echo "Removing migration..."
+
+dotnet ef migrations remove \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --force
+
+echo "Migration removed. Run /efcore migration to start over."
+exit 0
+```
+
+### 6. Final Summary
+
+```bash
+echo ""
+echo "==========================================="
+echo "MIGRATION COMPLETE"
+echo "==========================================="
+echo ""
+echo "Branch:      $CURRENT_BRANCH"
+echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo ""
+echo "Migration:   $MIGRATION_NAME"
+echo "Files:"
+echo "  - ${MIGRATION_NAME}.cs"
+echo "  - ${MIGRATION_NAME}.Designer.cs"
+echo "  - ${DBCONTEXT}ModelSnapshot.cs (updated)"
+echo ""
+echo "Content:"
+echo "  Tables:      $UP_TABLES"
+echo "  Columns:     $UP_COLUMNS"
+echo "  Indexes:     $UP_INDEXES"
+echo "  Foreign Keys:$UP_FOREIGN"
+echo ""
+if [ "$ACTION" = "deploy" ]; then
+  echo "Status:      Applied to local database"
+else
+  echo "Status:      Created (not applied)"
+  echo "             Run /efcore db-deploy to apply"
+fi
+echo ""
+echo "==========================================="
+echo ""
+echo "Next steps:"
+echo "  /gitflow commit       # Commit changes"
+echo "  /efcore db-status     # Check database status"
+echo ""
+```
+
+---
+
+## OUTPUT FORMAT:
+
+```
+MIGRATION COMPLETE
+==================
+Branch:      {current_branch}
+DbContext:   {dbcontext} ({dbcontext_type})
+
+Migration:   {migration_name}
+Files:
+  - {migration_name}.cs
+  - {migration_name}.Designer.cs
+  - {dbcontext}ModelSnapshot.cs (updated)
+
+Content:
+  Tables:      {count}
+  Columns:     {count}
+  Indexes:     {count}
+  Foreign Keys:{count}
+
+Status:      {Applied | Created (not applied)}
+
+Next: /gitflow commit, /efcore db-status
+```
+
+---
+
+## SUCCESS CRITERIA:
+
+- Build passes
+- Migration content reviewed
+- User action executed
+
+## COMPLETION:
+
+Migration workflow complete.

package/templates/skills/efcore/steps/rebase-snapshot/step-00-init.md

@@ -0,0 +1,173 @@
+---
+name: step-00-init
+description: Initialize rebase-snapshot - verify prerequisites
+next_step: step-01-backup.md
+---
+
+# Step 0: Initialize Rebase-Snapshot
+
+## YOUR TASK:
+
+Verify prerequisites for rebase-snapshot operation.
+
+**Requires:** `steps/shared/step-00-init.md` completed (provides {dbcontext}, {base_branch}, etc.)
+
+---
+
+## WHEN TO USE:
+
+| Situation | Action |
+|-----------|--------|
+| `/efcore conflicts` shows HIGH | Use rebase-snapshot |
+| ModelSnapshot merge conflict | Use rebase-snapshot |
+| Multiple migrations to consolidate | Use rebase-snapshot |
+| Snapshot diverged from parent | Use rebase-snapshot |
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Verify Branch Type
+
+```bash
+case "$BRANCH_TYPE" in
+  feature|release|hotfix)
+    echo "Branch type: $BRANCH_TYPE (OK)"
+    ;;
+  develop|main|master)
+    echo "ERROR: Cannot rebase-snapshot on $BRANCH_TYPE branch"
+    exit 1
+    ;;
+  *)
+    echo "WARNING: Unknown branch type: $BRANCH_TYPE"
+    ;;
+esac
+```
+
+### 2. Verify Clean Working Directory
+
+```bash
+if [ -n "$(git status --porcelain)" ]; then
+  echo "ERROR: Working directory not clean"
+  git status --short
+  exit 1
+fi
+```
+
+### 3. Display Context
+
+```bash
+echo ""
+echo "Rebase-Snapshot Context"
+echo "======================="
+echo ""
+echo "Branch:     $CURRENT_BRANCH"
+echo "Parent:     $BASE_BRANCH"
+echo "DbContext:  $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Schema:     $SCHEMA"
+echo "Migrations: $MIGRATIONS_DIR"
+```
+
+### 4. Identify Branch Migrations
+
+```bash
+# Fetch parent
+git fetch origin "$BASE_BRANCH" --quiet
+
+# Get migrations from parent
+PARENT_MIGRATIONS=$(git ls-tree -r --name-only "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR" 2>/dev/null | grep "\.cs$" | grep -v "Designer\|Snapshot" || echo "")
+
+# Get local migrations
+LOCAL_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | xargs -I{} basename {} 2>/dev/null || echo "")
+
+# Find branch-only migrations
+BRANCH_MIGRATIONS=()
+for mig in $LOCAL_MIGRATIONS; do
+  if ! echo "$PARENT_MIGRATIONS" | grep -q "$(basename "$mig")"; then
+    BRANCH_MIGRATIONS+=("$mig")
+  fi
+done
+
+BRANCH_MIG_COUNT=${#BRANCH_MIGRATIONS[@]}
+
+echo ""
+echo "Branch migrations: $BRANCH_MIG_COUNT"
+for mig in "${BRANCH_MIGRATIONS[@]}"; do
+  echo "  - $mig"
+done
+```
+
+### 5. Check Snapshot Divergence
+
+```bash
+echo ""
+echo "Checking snapshot divergence..."
+
+PARENT_SNAPSHOT=$(git show "origin/$BASE_BRANCH:$MIGRATIONS_DIR/${DBCONTEXT}ModelSnapshot.cs" 2>/dev/null || echo "")
+LOCAL_SNAPSHOT=$(cat "$MIGRATIONS_DIR/${DBCONTEXT}ModelSnapshot.cs" 2>/dev/null || echo "")
+
+if [ -n "$PARENT_SNAPSHOT" ] && [ -n "$LOCAL_SNAPSHOT" ]; then
+  DIFF_LINES=$(diff <(echo "$PARENT_SNAPSHOT") <(echo "$LOCAL_SNAPSHOT") 2>/dev/null | wc -l)
+  echo "  Snapshot difference: $DIFF_LINES lines"
+
+  if [ "$DIFF_LINES" -eq 0 ]; then
+    echo ""
+    echo "Snapshot is already synchronized with $BASE_BRANCH."
+    echo "Nothing to do."
+
+    if [ "$FORCE_FLAG" != "true" ]; then
+      exit 0
+    fi
+  fi
+else
+  echo "  WARNING: Could not compare snapshots"
+  DIFF_LINES="unknown"
+fi
+```
+
+### 6. Confirmation
+
+**If NOT auto mode:**
+
+```yaml
+AskUserQuestion:
+  header: "Rebase"
+  question: "Rebase snapshot from {BASE_BRANCH}?
+
+This will:
+1. Backup all migration files
+2. Reset ModelSnapshot to {BASE_BRANCH}
+3. Delete {BRANCH_MIG_COUNT} branch migrations
+4. Create ONE consolidated migration
+
+Snapshot difference: {DIFF_LINES} lines"
+  options:
+    - label: "Yes, rebase"
+      description: "Proceed with rebase-snapshot"
+    - label: "Cancel"
+      description: "Do nothing"
+  multiSelect: false
+```
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Description |
+|----------|-------------|
+| `{branch_migrations}` | Array of migrations to remove |
+| `{branch_mig_count}` | Number of branch migrations |
+| `{diff_lines}` | Snapshot divergence (lines) |
+
+---
+
+## SUCCESS CRITERIA:
+
+- Branch type is feature/release/hotfix
+- Working directory clean
+- Branch migrations identified
+- User confirmed
+
+## NEXT STEP:
+
+→ `step-01-backup.md`

package/templates/skills/efcore/steps/rebase-snapshot/step-01-backup.md

@@ -0,0 +1,100 @@
+---
+name: step-01-backup
+description: Create backup of migration files
+next_step: step-02-fetch.md
+---
+
+# Step 1: Backup
+
+## YOUR TASK:
+
+Create a complete backup before modifying migration files.
+
+**Previous step:** `step-00-init.md`
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Create Backup Directory
+
+```bash
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR=".claude/gitflow/backup/migrations/rebase_${TIMESTAMP}"
+
+mkdir -p "$BACKUP_DIR"
+echo "Backup directory: $BACKUP_DIR"
+```
+
+### 2. Backup All Migration Files
+
+```bash
+cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/" 2>/dev/null || {
+  echo "ERROR: No migration files to backup"
+  exit 1
+}
+
+BACKUP_COUNT=$(ls -1 "$BACKUP_DIR"/*.cs 2>/dev/null | wc -l)
+echo "Backed up: $BACKUP_COUNT files"
+```
+
+### 3. Create Manifest
+
+```bash
+cat > "$BACKUP_DIR/MANIFEST.md" << EOF
+# Rebase-Snapshot Backup Manifest
+
+**Created:** $(date -Iseconds)
+**Branch:** $CURRENT_BRANCH
+**Parent:** $BASE_BRANCH
+**DbContext:** $DBCONTEXT
+
+## Branch Migrations (to be replaced)
+
+$(for mig in "${BRANCH_MIGRATIONS[@]}"; do echo "- $mig"; done)
+
+## Restore Command
+
+\`\`\`bash
+cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+\`\`\`
+EOF
+```
+
+### 4. Verify Backup
+
+```bash
+echo ""
+echo "Backup complete:"
+echo "  Directory: $BACKUP_DIR"
+echo "  Files: $BACKUP_COUNT"
+```
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Description |
+|----------|-------------|
+| `{backup_dir}` | Backup directory path |
+| `{backup_count}` | Number of files backed up |
+
+---
+
+## RECOVERY:
+
+```bash
+cp "{BACKUP_DIR}"/*.cs "{MIGRATIONS_DIR}/"
+```
+
+---
+
+## SUCCESS CRITERIA:
+
+- Backup directory created
+- All files copied
+- Manifest created
+
+## NEXT STEP:
+
+→ `step-02-fetch.md`

package/templates/skills/efcore/steps/rebase-snapshot/step-02-fetch.md

@@ -0,0 +1,115 @@
+---
+name: step-02-fetch
+description: Reset snapshot to parent and delete branch migrations
+next_step: step-03-create.md
+---
+
+# Step 2: Fetch Parent Snapshot
+
+## YOUR TASK:
+
+Reset the ModelSnapshot to the parent branch state and remove branch-specific migrations.
+
+**Previous step:** `step-01-backup.md`
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Fetch Latest Parent
+
+```bash
+echo "Fetching origin/$BASE_BRANCH..."
+git fetch origin "$BASE_BRANCH" --quiet
+```
+
+### 2. Reset ModelSnapshot
+
+```bash
+echo ""
+echo "Resetting ModelSnapshot from origin/$BASE_BRANCH..."
+
+SNAPSHOT_FILE="$MIGRATIONS_DIR/${DBCONTEXT}ModelSnapshot.cs"
+
+git checkout "origin/$BASE_BRANCH" -- "$SNAPSHOT_FILE" 2>/dev/null
+
+if [ $? -eq 0 ]; then
+  echo "  Snapshot reset to origin/$BASE_BRANCH"
+else
+  echo "  WARNING: Could not fetch snapshot from origin/$BASE_BRANCH"
+  echo "  Using local snapshot (may cause issues)"
+fi
+```
+
+### 3. Delete Branch Migrations
+
+```bash
+echo ""
+echo "Removing branch-specific migrations..."
+
+for mig in "${BRANCH_MIGRATIONS[@]}"; do
+  mig_name="${mig%.cs}"
+
+  rm -f "$MIGRATIONS_DIR/${mig_name}.cs"
+  rm -f "$MIGRATIONS_DIR/${mig_name}.Designer.cs"
+
+  echo "  Removed: $mig_name"
+done
+
+echo ""
+echo "Removed: ${#BRANCH_MIGRATIONS[@]} migration(s)"
+```
+
+### 4. Verify State
+
+```bash
+echo ""
+echo "Current migrations after reset:"
+
+REMAINING=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | wc -l)
+
+echo "  Remaining: $REMAINING (from $BASE_BRANCH)"
+```
+
+---
+
+## EXPECTED STATE:
+
+```
+After step-02-fetch:
+├── {parent_migration_1}.cs        ← From parent (unchanged)
+├── {parent_migration_1}.Designer.cs
+├── ...
+└── {DbContext}ModelSnapshot.cs    ← Reset to parent state
+
+Branch migrations: DELETED
+```
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Description |
+|----------|-------------|
+| `{snapshot_reset}` | true if reset successful |
+| `{remaining_migrations}` | Count after deletion |
+
+---
+
+## ERROR HANDLING:
+
+If snapshot fetch fails:
+- Continue with local snapshot
+- Migration may contain more changes than expected
+- Warn user
+
+---
+
+## SUCCESS CRITERIA:
+
+- Snapshot reset to parent
+- Branch migrations removed
+
+## NEXT STEP:
+
+→ `step-03-create.md`

package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md

@@ -0,0 +1,108 @@
+---
+name: step-03-create
+description: Create consolidated migration with MCP naming
+next_step: step-04-validate.md
+---
+
+# Step 3: Create Consolidated Migration
+
+## YOUR TASK:
+
+Generate a new consolidated migration capturing all branch changes.
+
+**MANDATORY:** Use MCP for naming. NEVER hardcode.
+
+**Previous step:** `step-02-fetch.md`
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Build Description
+
+```bash
+# Extract feature name from branch
+FEATURE_NAME=$(echo "$CURRENT_BRANCH" | sed 's|.*/||' | sed 's/-/ /g' | \
+  awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1' | \
+  tr -d ' ')
+
+DESCRIPTION="${FEATURE_NAME}Consolidated"
+
+echo "Description: $DESCRIPTION"
+```
+
+### 2. Call MCP for Migration Name (MANDATORY)
+
+```javascript
+// DESCRIPTION = from above (e.g., "UserAuthConsolidated")
+// DBCONTEXT_TYPE = "core" or "extensions" (from detect_dbcontext)
+
+const result = await mcp__smartstack__suggest_migration({
+  description: DESCRIPTION,
+  context: DBCONTEXT_TYPE    // NEVER hardcode!
+});
+
+// Result example: core_v1.7.0_001_UserAuthConsolidated
+MIGRATION_NAME = result.migrationName;
+```
+
+**FORBIDDEN:**
+- Manual name calculation
+- Hardcoding context
+
+### 3. Create Migration
+
+```bash
+echo ""
+echo "Creating migration: $MIGRATION_NAME"
+echo "Context: $DBCONTEXT"
+echo ""
+
+dotnet ef migrations add "$MIGRATION_NAME" \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  -o Persistence/Migrations \
+  --verbose
+```
+
+### 4. Verify Files Created
+
+```bash
+MIGRATION_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.cs"
+DESIGNER_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.Designer.cs"
+
+if [ ! -f "$MIGRATION_FILE" ]; then
+  echo "ERROR: Migration file not created"
+
+  # Restore backup
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  echo "Restored from backup"
+  exit 1
+fi
+
+echo ""
+echo "Migration created:"
+echo "  $MIGRATION_FILE"
+echo "  $DESIGNER_FILE"
+```
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Description |
+|----------|-------------|
+| `{migration_name}` | Name from MCP |
+| `{migration_file}` | Path to .cs file |
+
+---
+
+## SUCCESS CRITERIA:
+
+- MCP called successfully
+- Migration files created
+
+## NEXT STEP:
+
+→ `step-04-validate.md`