@atlashub/smartstack-cli 4.34.0 → 4.36.0

package/templates/skills/efcore/steps/migration/step-01-check.md

@@ -1,164 +0,0 @@
----
-name: step-01-check
-description: Check for existing migration and decide action
-next_step: step-02-create.md
----
-
-# Step 1: Check Existing Migration
-
-## YOUR TASK:
-
-Search for existing migrations for this branch and decide whether to recreate or skip.
-
-**Previous step:** `step-00-init.md`
-
----
-
-## EXECUTION SEQUENCE:
-
-### 0. Validate Required Variables
-
-```bash
-# Validate required variables from step-00-init
-for VAR_NAME in DBCONTEXT DBCONTEXT_TYPE MIGRATIONS_DIR INFRA_PROJECT STARTUP_PROJECT CURRENT_BRANCH BRANCH_TYPE; do
-  eval VAR_VALUE=\$$VAR_NAME
-  if [ -z "$VAR_VALUE" ]; then
-    echo "ERROR: Required variable $VAR_NAME is not set"
-    echo "Run step-00-init first"
-    exit 1
-  fi
-done
-```
-
-### 1. Build Search Pattern
-
-```bash
-# Extract branch name for pattern
-case "$BRANCH_TYPE" in
-  feature)
-    BRANCH_SHORT=$(echo "$CURRENT_BRANCH" | sed 's|feature/||' | tr '-' '_')
-    ;;
-  release)
-    BRANCH_SHORT=$(echo "$CURRENT_BRANCH" | sed 's|release/||' | tr '.' '_')
-    ;;
-  hotfix)
-    BRANCH_SHORT=$(echo "$CURRENT_BRANCH" | sed 's|hotfix/||' | tr '.' '_')
-    ;;
-  *)
-    BRANCH_SHORT=""
-    ;;
-esac
-
-echo "Searching for existing migrations..."
-echo "  Pattern: *${BRANCH_SHORT}*"
-```
-
-### 2. Find Existing Migrations
-
-```bash
-# Sanitize branch name: only allow alphanumeric, underscore (prevent regex/shell injection)
-BRANCH_SHORT_SAFE=$(echo "$BRANCH_SHORT" | sed 's/[^a-zA-Z0-9_]//g')
-if [ -z "$BRANCH_SHORT_SAFE" ]; then
-  echo "ERROR: Invalid branch name (no alphanumeric characters after sanitization)"
-  exit 1
-fi
-
-# Search for migrations matching this branch (-F = fixed-string, prevents regex injection)
-EXISTING_MIGRATIONS=$(find "$MIGRATIONS_DIR" -name "*.cs" ! -name "*Designer.cs" ! -name "*Snapshot.cs" -type f 2>/dev/null | \
-  xargs -I{} basename {} | \
-  grep -iF "$BRANCH_SHORT_SAFE" || echo "")
-
-EXISTING_COUNT=$(echo "$EXISTING_MIGRATIONS" | grep -c "^[^ ]" 2>/dev/null || echo "0")
-
-echo ""
-if [ "$EXISTING_COUNT" -gt 0 ]; then
-  echo "Found $EXISTING_COUNT existing migration(s):"
-  echo "$EXISTING_MIGRATIONS" | while read mig; do
-    echo "  - $mig"
-  done
-else
-  echo "No existing migration for this branch."
-fi
-```
-
-### 3. Decide Action
-
-**If migrations exist and NOT force mode:**
-
-```yaml
-AskUserQuestion:
-  header: "Migration"
-  question: "Found {EXISTING_COUNT} existing migration(s). What do you want to do?"
-  options:
-    - label: "Recreate (Recommended)"
-      description: "Delete existing and create new"
-    - label: "Keep and add new"
-      description: "Add another migration (not recommended)"
-    - label: "Cancel"
-      description: "Do nothing"
-  multiSelect: false
-```
-
-**Handle response:**
-
-```javascript
-if (answer === "Recreate (Recommended)" || force_mode) {
-  // Delete existing migrations
-  ACTION = "recreate";
-} else if (answer === "Keep and add new") {
-  ACTION = "add";
-  // Warning: violates 1-migration-per-feature rule
-} else {
-  // Cancel
-  exit(0);
-}
-```
-
-### 4. Delete Existing (If Recreate)
-
-```bash
-if [ "$ACTION" = "recreate" ]; then
-  echo ""
-  echo "Removing existing migrations..."
-
-  for mig in $EXISTING_MIGRATIONS; do
-    mig_name="${mig%.cs}"
-
-    rm -f "$MIGRATIONS_DIR/${mig_name}.cs"
-    rm -f "$MIGRATIONS_DIR/${mig_name}.Designer.cs"
-
-    # Verify deletion succeeded
-    if [ -f "$MIGRATIONS_DIR/${mig_name}.cs" ]; then
-      echo "  ERROR: Failed to delete ${mig_name}.cs"
-      exit 1
-    fi
-
-    echo "  Removed: $mig_name"
-  done
-
-  echo ""
-  echo "Existing migrations removed."
-fi
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{existing_migrations}` | List of existing migrations |
-| `{existing_count}` | Number found |
-| `{action}` | "recreate", "add", or "cancel" |
-
----
-
-## SUCCESS CRITERIA:
-
-- Existing migrations identified
-- User decision captured
-- Old migrations removed (if recreate)
-
-## NEXT STEP:
-
-→ `step-02-create.md`

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`