@atlashub/smartstack-cli 4.35.0 → 4.36.0

package/templates/skills/efcore/steps/migration/step-02-create.md

@@ -1,160 +0,0 @@
----
-name: step-02-create
-description: Create migration with MCP naming
-next_step: step-03-validate.md
----
-
-# Step 2: Create Migration
-
-## YOUR TASK:
-
-Get migration description from user, call MCP for compliant name, and create migration.
-
-**MANDATORY:** Use MCP `suggest_migration` for naming. NEVER hardcode.
-
-**Previous step:** `step-01-check.md`
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Get Description from User
-
-**If NOT force mode with predefined description:**
-
-```yaml
-AskUserQuestion:
-  header: "Description"
-  question: "Short description for the migration (e.g., 'Add User Roles'):"
-  options:
-    - label: "Add..."
-      description: "Adding tables/columns"
-    - label: "Update..."
-      description: "Modifying structure"
-    - label: "Fix..."
-      description: "Schema correction"
-    - label: "Remove..."
-      description: "Deleting elements"
-  multiSelect: false
-```
-
-**User can also provide free text (Other option).**
-
-```bash
-# DESCRIPTION = user response or predefined value
-# Examples: "Add User Roles", "Update Tenant Schema", "Fix Foreign Keys"
-
-echo ""
-echo "Description: $DESCRIPTION"
-```
-
-### 2. Verify MCP Availability
-
-```bash
-# Check MCP cache before calling suggest_migration
-MCP_STATUS_FILE=".claude/mcp-status.json"
-
-if [ -f "$MCP_STATUS_FILE" ]; then
-  MCP_STATUS=$(cat "$MCP_STATUS_FILE" | grep -o '"status":"[^"]*"' | head -1 | cut -d'"' -f4)
-  if [ "$MCP_STATUS" = "error" ]; then
-    echo "ERROR: MCP server is unavailable (status: error)"
-    echo "Run: /mcp healthcheck to diagnose"
-    exit 1
-  fi
-fi
-```
-
-### 3. Call MCP for Migration Name (MANDATORY)
-
-```javascript
-// DESCRIPTION = from user input (e.g., "Add User Roles")
-// 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.8.0_001_AddUserRoles
-MIGRATION_NAME = result.migrationName;
-```
-
-**FORBIDDEN:**
-- Calculating name manually
-- Hardcoding context as "core"
-- Using wrong version format
-
-### 4. Display Migration Name
-
-```bash
-echo ""
-echo "Migration name: $MIGRATION_NAME"
-echo "Context: $DBCONTEXT"
-echo ""
-```
-
-### 5. Create Migration
-
-```bash
-echo "Creating migration..."
-echo ""
-
-dotnet ef migrations add "$MIGRATION_NAME" \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  -o Persistence/Migrations \
-  --verbose
-```
-
-### 6. Verify Creation
-
-```bash
-# Check files were created
-MIGRATION_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.cs"
-DESIGNER_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.Designer.cs"
-
-if [ ! -f "$MIGRATION_FILE" ]; then
-  echo ""
-  echo "ERROR: Migration file not created"
-  echo "Expected: $MIGRATION_FILE"
-  exit 1
-fi
-
-echo ""
-echo "Migration created:"
-echo "  $MIGRATION_FILE"
-echo "  $DESIGNER_FILE"
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{description}` | User-provided description |
-| `{migration_name}` | Name from MCP |
-| `{migration_file}` | Path to .cs file |
-
----
-
-## ERROR HANDLING:
-
-| Error | Resolution |
-|-------|------------|
-| MCP unavailable | Check connection, retry |
-| Creation fails | Check dotnet ef output |
-| File not created | Verify paths and permissions |
-
----
-
-## SUCCESS CRITERIA:
-
-- Description captured
-- MCP called successfully
-- Migration files created
-
-## NEXT STEP:
-
-→ `step-03-validate.md`

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

@@ -1,168 +0,0 @@
----
-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"
-
-# Detect destructive operations
-DROP_COL=$(grep -c "DropColumn" "$MIGRATION_FILE" || echo "0")
-RENAME_COL=$(grep -c "RenameColumn" "$MIGRATION_FILE" || echo "0")
-ALTER_COL=$(grep -c "AlterColumn" "$MIGRATION_FILE" || echo "0")
-DROP_TABLE=$(grep -c "DropTable" "$MIGRATION_FILE" || echo "0")
-DESTRUCTIVE=$((DROP_COL + RENAME_COL + ALTER_COL + DROP_TABLE))
-
-if [ "$DESTRUCTIVE" -gt 0 ]; then
-  echo ""
-  echo "WARNING: Destructive operations detected:"
-  [ "$DROP_COL" -gt 0 ] && echo "  DropColumn:   $DROP_COL"
-  [ "$RENAME_COL" -gt 0 ] && echo "  RenameColumn: $RENAME_COL"
-  [ "$ALTER_COL" -gt 0 ] && echo "  AlterColumn:  $ALTER_COL"
-  [ "$DROP_TABLE" -gt 0 ] && echo "  DropTable:    $DROP_TABLE"
-  echo ""
-  echo "For production deployments, consider zero-downtime migration patterns."
-  echo "See: references/zero-downtime-patterns.md"
-fi
-```
-
-### 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
-```
-
-See: `references/destructive-operations.md` for zero-downtime patterns.
-
-### 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
-
-Create summary output showing:
-- Branch, DbContext, DbContext Type
-- Migration name and files
-- Content statistics (tables, columns, indexes, foreign keys)
-- Status (Applied or Created)
-- Next steps
-
----
-
-## 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

@@ -1,173 +0,0 @@
----
-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 (exact match, not substring)
-BRANCH_MIGRATIONS=()
-for mig in $LOCAL_MIGRATIONS; do
-  if ! echo "$PARENT_MIGRATIONS" | grep -qx "$(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

@@ -1,100 +0,0 @@
----
-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

@@ -1,115 +0,0 @@
----
-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`