@atlashub/smartstack-cli 3.39.0 → 3.40.0

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

@@ -1,160 +1,160 @@
----
-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`
+---
+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 +1,168 @@
----
-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.
+---
+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.