@atlashub/smartstack-cli 1.17.0 → 1.19.0

package/templates/skills/efcore/steps/db/step-deploy.md

@@ -0,0 +1,208 @@
+---
+name: step-deploy
+description: Deploy pending migrations to database
+next_step: null
+---
+
+# Database Deploy
+
+## YOUR TASK:
+
+Apply pending EF Core migrations to the local database.
+
+**Requires:** `steps/shared/step-00-init.md` completed
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Environment Check
+
+```bash
+echo "Deploy Configuration"
+echo "===================="
+echo ""
+echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Environment: $SELECTED_ENV"
+echo "Database:    $DATABASE_NAME"
+echo "Server:      $SERVER_NAME"
+
+# Block production
+block_production
+```
+
+### 2. Check Pending Migrations
+
+```bash
+echo ""
+echo "Checking pending migrations..."
+
+PENDING=$(dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" 2>/dev/null | \
+  grep -c "(Pending)" || echo "0")
+
+echo "Pending: $PENDING migration(s)"
+
+if [ "$PENDING" -eq 0 ]; then
+  echo ""
+  echo "No pending migrations. Database is up to date."
+  echo ""
+  echo "Next steps:"
+  echo "  /efcore migration    # Create new migration"
+  echo "  /efcore db-status    # Check status"
+  exit 0
+fi
+```
+
+### 3. List Pending Migrations
+
+```bash
+echo ""
+echo "Migrations to apply:"
+
+dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" 2>/dev/null | \
+  grep "(Pending)" | while read line; do
+    echo "  - $line"
+  done
+```
+
+### 4. Confirmation (if not auto mode)
+
+```yaml
+AskUserQuestion:
+  header: "Deploy"
+  question: "Apply {PENDING} migration(s) to {DATABASE_NAME}?"
+  options:
+    - label: "Yes, apply"
+      description: "Deploy to {SELECTED_ENV} environment"
+    - label: "Cancel"
+      description: "Do not apply"
+  multiSelect: false
+```
+
+### 5. Apply Migrations
+
+```bash
+echo ""
+echo "Applying migrations..."
+echo ""
+
+dotnet ef database update \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --verbose
+
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "ERROR: Migration failed"
+  echo ""
+  echo "Troubleshooting:"
+  echo "  - Check database connection"
+  echo "  - Review migration content"
+  echo "  - Try: /efcore db-reset"
+  exit 1
+fi
+```
+
+### 6. Verify
+
+```bash
+echo ""
+echo "Verifying..."
+
+NEW_PENDING=$(dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" 2>/dev/null | \
+  grep -c "(Pending)" || echo "0")
+
+if [ "$NEW_PENDING" -eq 0 ]; then
+  echo "All migrations applied successfully."
+else
+  echo "WARNING: $NEW_PENDING migrations still pending"
+fi
+```
+
+### 7. Summary
+
+```bash
+echo ""
+echo "==========================================="
+echo "DEPLOY COMPLETE"
+echo "==========================================="
+echo ""
+echo "Database:    $DATABASE_NAME"
+echo "Environment: $SELECTED_ENV"
+echo "DbContext:   $DBCONTEXT"
+echo "Applied:     $PENDING migration(s)"
+echo ""
+echo "==========================================="
+echo ""
+echo "Next steps:"
+echo "  /efcore db-status    # Verify status"
+echo "  /efcore db-seed      # Add test data"
+echo ""
+```
+
+---
+
+## OUTPUT FORMAT:
+
+```
+DEPLOY COMPLETE
+===============
+Database:    {database_name}
+Environment: {env}
+DbContext:   {dbcontext}
+Applied:     {N} migration(s)
+
+Next: /efcore db-status, /efcore db-seed
+```
+
+---
+
+## ERROR HANDLING:
+
+| Error | Resolution |
+|-------|------------|
+| Connection failed | Check SQL Server, credentials |
+| Migration error | Review migration, consider reset |
+| Constraint violation | Check data, may need seed |
+
+---
+
+## OPTIONS:
+
+| Option | Description |
+|--------|-------------|
+| `--env {name}` | Use appsettings.{name}.json |
+| `--verbose` | Show SQL statements |
+| `--context {name}` | Specify DbContext |
+
+---
+
+## BOTH CONTEXTS:
+
+If "Both" selected for DbContext:
+
+```bash
+# Deploy CoreDbContext first
+DBCONTEXT="CoreDbContext"
+# ... run deploy ...
+
+# Then ExtensionsDbContext
+DBCONTEXT="ExtensionsDbContext"
+# ... run deploy ...
+```
+
+---
+
+## COMPLETION:
+
+Migrations applied. Use `/efcore db-status` to verify.

package/templates/skills/efcore/steps/db/step-reset.md

@@ -0,0 +1,259 @@
+---
+name: step-reset
+description: Reset database - drop and recreate
+next_step: null
+---
+
+# Database Reset
+
+## YOUR TASK:
+
+Completely reset the database: drop, recreate, and apply all migrations.
+
+**WARNING:** This is DESTRUCTIVE. All data will be lost!
+
+**Requires:** `steps/shared/step-00-init.md` completed
+
+---
+
+## COMPLIANCE:
+
+| FORBIDDEN | REQUIRED |
+|-----------|----------|
+| `sqlcmd` for DDL/DML | `dotnet ef database drop` |
+| SQL scripts in repo | `dotnet ef database update` |
+| INSERT via scripts | `HasData()` for seeding |
+
+**Exception:** `sqlcmd` allowed ONLY for `BACKUP DATABASE`.
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Environment Check
+
+```bash
+echo "Reset Configuration"
+echo "==================="
+echo ""
+echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Environment: $SELECTED_ENV"
+echo "Database:    $DATABASE_NAME"
+echo "Server:      $SERVER_NAME"
+echo ""
+echo "WARNING: ALL DATA WILL BE LOST!"
+
+# Block production
+block_production
+```
+
+### 2. Confirmation (MANDATORY)
+
+```yaml
+AskUserQuestion:
+  header: "Reset DB"
+  question: "DANGER: Permanently delete '{DATABASE_NAME}'?
+
+ALL DATA WILL BE LOST!
+
+This action is IRREVERSIBLE."
+  options:
+    - label: "Yes, delete {DATABASE_NAME}"
+      description: "Drop + Recreate (IRREVERSIBLE)"
+    - label: "No, cancel"
+      description: "Keep database"
+  multiSelect: false
+```
+
+### 3. Optional Backup
+
+```yaml
+AskUserQuestion:
+  header: "Backup"
+  question: "Backup database before deletion?"
+  options:
+    - label: "Yes, backup (Recommended)"
+      description: "Create .bak via sqlcmd"
+    - label: "No"
+      description: "Dev data only - continue"
+    - label: "Manual backup"
+      description: "Via SSMS/Azure Portal (stops here)"
+  multiSelect: false
+```
+
+**If backup requested:**
+
+```bash
+BACKUP_DIR=".claude/gitflow/backup/database"
+mkdir -p "$BACKUP_DIR"
+
+BACKUP_FILE="$BACKUP_DIR/${DATABASE_NAME}_$(date +%Y%m%d_%H%M%S).bak"
+
+echo "Creating backup: $BACKUP_FILE"
+
+sqlcmd -S "$SERVER_NAME" -E -Q "BACKUP DATABASE [$DATABASE_NAME] TO DISK='$BACKUP_FILE'"
+
+if [ $? -eq 0 ]; then
+  echo "Backup created: $BACKUP_FILE"
+else
+  echo "WARNING: Backup failed. Continue anyway?"
+fi
+```
+
+### 4. Drop Database
+
+```bash
+echo ""
+echo "Dropping database..."
+
+dotnet ef database drop \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --force
+
+if [ $? -ne 0 ]; then
+  echo "ERROR: Drop failed"
+  echo "Database may be in use. Close connections and retry."
+  exit 1
+fi
+
+echo "Database dropped."
+```
+
+### 5. Recreate + Apply Migrations
+
+```bash
+echo ""
+echo "Recreating database with migrations..."
+
+dotnet ef database update \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --verbose
+
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "ERROR: Recreation failed"
+  exit 1
+fi
+
+echo "Database recreated."
+```
+
+### 6. Optional Seed
+
+```yaml
+AskUserQuestion:
+  header: "Seed"
+  question: "Populate with test data (HasData)?"
+  options:
+    - label: "Yes (recommended)"
+      description: "Apply HasData configurations"
+    - label: "No"
+      description: "Empty database"
+  multiSelect: false
+```
+
+**If seed requested:**
+
+```bash
+echo ""
+echo "Running seed..."
+
+# HasData is already applied via migrations
+# For custom seeding:
+dotnet run --project "$STARTUP_PROJECT" -- --seed 2>/dev/null || echo "No --seed argument supported"
+```
+
+### 7. Summary
+
+```bash
+MIGRATION_COUNT=$(dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" 2>/dev/null | \
+  grep -c "^[0-9]" || echo "0")
+
+echo ""
+echo "==========================================="
+echo "RESET COMPLETE"
+echo "==========================================="
+echo ""
+echo "Database:    $DATABASE_NAME"
+echo "Environment: $SELECTED_ENV"
+echo "DbContext:   $DBCONTEXT"
+echo ""
+echo "Operations:"
+echo "  - Drop: OK"
+echo "  - Create: OK"
+echo "  - Migrations: $MIGRATION_COUNT applied"
+if [ -n "$BACKUP_FILE" ]; then
+echo "  - Backup: $BACKUP_FILE"
+fi
+echo ""
+echo "Compliance:  EF Core CLI only"
+echo ""
+echo "==========================================="
+echo ""
+echo "Next steps:"
+echo "  /efcore db-status    # Verify status"
+echo "  /efcore db-seed      # Add test data"
+echo ""
+```
+
+---
+
+## OUTPUT FORMAT:
+
+```
+RESET COMPLETE
+==============
+Database:    {database_name}
+Environment: {env}
+DbContext:   {dbcontext}
+
+Operations:
+  - Drop: OK
+  - Create: OK
+  - Migrations: {N} applied
+  - Backup: {path | none}
+
+Compliance:  EF Core CLI only
+
+Next: /efcore db-status, /efcore db-seed
+```
+
+---
+
+## PROTECTIONS:
+
+| Protection | Description |
+|------------|-------------|
+| Env Display | Shows database BEFORE confirmation |
+| Confirmation | Explicit request with database NAME |
+| Production Block | Blocks if Production detected |
+| EF Core Only | No raw SQL |
+
+---
+
+## BOTH CONTEXTS:
+
+If "Both" selected:
+
+```bash
+# Drop + Recreate CoreDbContext
+DBCONTEXT="CoreDbContext"
+# ... execute reset ...
+
+# Then ExtensionsDbContext
+DBCONTEXT="ExtensionsDbContext"
+# ... execute reset ...
+```
+
+---
+
+## COMPLETION:
+
+Database reset complete. Fresh state with all migrations applied.

package/templates/skills/efcore/steps/db/step-seed.md

@@ -0,0 +1,244 @@
+---
+name: step-seed
+description: Populate database with test data
+next_step: null
+---
+
+# Database Seed
+
+## YOUR TASK:
+
+Populate the database with test or initial data using EF Core conventions.
+
+**Requires:** `steps/shared/step-00-init.md` completed
+
+---
+
+## COMPLIANCE:
+
+| FORBIDDEN | REQUIRED |
+|-----------|----------|
+| SQL scripts in repo | `HasData()` in configurations |
+| `sqlcmd` with INSERT | `IDataSeeder` classes |
+| `migrationBuilder.Sql()` INSERT | EF Core typed migrations |
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Environment Check
+
+```bash
+echo "Seed Configuration"
+echo "=================="
+echo ""
+echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Environment: $SELECTED_ENV"
+echo "Database:    $DATABASE_NAME"
+
+# Block production
+block_production
+```
+
+### 2. Detect Available Seed Methods
+
+```bash
+echo ""
+echo "Detecting seed methods..."
+
+SEED_METHODS=""
+
+# HasData() in configurations (RECOMMENDED)
+if grep -rq "\.HasData(" . --include="*.cs" 2>/dev/null; then
+  SEED_METHODS+=" hasdata"
+  echo "  - HasData(): Found"
+fi
+
+# IDataSeeder classes
+if grep -rq "IDataSeeder\|class.*Seeder" . --include="*.cs" 2>/dev/null; then
+  SEED_METHODS+=" seeder-class"
+  echo "  - Seeder classes: Found"
+fi
+
+# --seed CLI argument
+if grep -q "\-\-seed" ./src/*/Program.cs 2>/dev/null; then
+  SEED_METHODS+=" cli-argument"
+  echo "  - CLI --seed: Found"
+fi
+
+# WARNING: SQL scripts detected
+if [ -f "./scripts/seed.sql" ] || find . -name "seed*.sql" 2>/dev/null | grep -q .; then
+  echo ""
+  echo "WARNING: SQL seed scripts detected - FORBIDDEN by conventions"
+  echo "Migrate to HasData() or IDataSeeder"
+fi
+
+if [ -z "$SEED_METHODS" ]; then
+  echo "  No seed methods found"
+fi
+```
+
+### 3. Select Method
+
+**If multiple methods available:**
+
+```yaml
+AskUserQuestion:
+  header: "Seed"
+  question: "Which seed method to use?"
+  options:
+    - label: "HasData (Recommended)"
+      description: "Via EF Core migrations"
+    - label: "Seeder Class"
+      description: "Run DbSeeder/DataSeeder"
+    - label: "CLI --seed"
+      description: "Launch app with --seed"
+  multiSelect: false
+```
+
+### 4. Execute Seed
+
+**HasData method:**
+
+```bash
+echo ""
+echo "HasData is applied via migrations."
+echo "Running database update to ensure all HasData is applied..."
+
+dotnet ef database update \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT"
+```
+
+**Seeder Class method:**
+
+```bash
+echo ""
+echo "Running seeder class..."
+
+dotnet run --project "$STARTUP_PROJECT" -- --seed
+
+if [ $? -ne 0 ]; then
+  echo "Seed command failed or not supported."
+  echo "Check if --seed argument is implemented in Program.cs"
+fi
+```
+
+**CLI argument method:**
+
+```bash
+echo ""
+echo "Running application with --seed..."
+
+dotnet run --project "$STARTUP_PROJECT" -- --seed
+```
+
+### 5. Verify (Optional)
+
+```bash
+echo ""
+echo "Verifying seed data..."
+
+# Quick check - count records in key tables
+# This is application-specific
+```
+
+### 6. Summary
+
+```bash
+echo ""
+echo "==========================================="
+echo "SEED COMPLETE"
+echo "==========================================="
+echo ""
+echo "Database:    $DATABASE_NAME"
+echo "Environment: $SELECTED_ENV"
+echo "Method:      $SEED_METHOD"
+echo ""
+echo "Compliance:  EF Core native, No raw SQL"
+echo ""
+echo "==========================================="
+echo ""
+echo "Next steps:"
+echo "  /efcore db-status    # Check status"
+echo "  dotnet run           # Start application"
+echo ""
+```
+
+---
+
+## OUTPUT FORMAT:
+
+```
+SEED COMPLETE
+=============
+Database:    {database_name}
+Environment: {env}
+Method:      {hasdata | seeder-class | cli-argument}
+
+Compliance:  EF Core native, No raw SQL
+
+Next: /efcore db-status, dotnet run
+```
+
+---
+
+## NO SEED METHODS FOUND:
+
+If no seed methods detected, display guide:
+
+```
+SEED SETUP GUIDE
+================
+
+Option 1: HasData() in Configuration (RECOMMENDED)
+--------------------------------------------------
+// In UserConfiguration.cs
+builder.HasData(new User {
+    Id = Guid.Parse("7f3c9a2e-8d1b-4e5f-a6c8-9b4d2f7e1a3c"),
+    Name = "Admin",
+    Email = "admin@example.com"
+});
+
+// Then run:
+dotnet ef migrations add SeedData
+
+Option 2: IDataSeeder Class
+---------------------------
+public class UserSeeder : IDataSeeder
+{
+    public async Task SeedAsync(DbContext context)
+    {
+        if (!await context.Users.AnyAsync())
+        {
+            context.Users.Add(new User { ... });
+            await context.SaveChangesAsync();
+        }
+    }
+}
+
+// Register in Program.cs and call via --seed argument
+```
+
+---
+
+## MIGRATION FROM SQL:
+
+```csharp
+// BEFORE (FORBIDDEN): scripts/seed.sql
+INSERT INTO Users (Id, Name) VALUES (1, 'Admin');
+
+// AFTER (CORRECT): UserConfiguration.cs
+builder.HasData(new User {
+    Id = Guid.Parse("7f3c9a2e-8d1b-4e5f-a6c8-9b4d2f7e1a3c"),
+    Name = "Admin"
+});
+// Then: dotnet ef migrations add SeedData
+```
+
+---
+
+## COMPLETION:
+
+Seed data applied. Use `/efcore db-status` to verify.