@atlashub/smartstack-cli 1.17.0 → 1.19.0

package/templates/skills/efcore/steps/rebase-snapshot/step-04-validate.md

@@ -0,0 +1,157 @@
+---
+name: step-04-validate
+description: Validate rebase-snapshot - build and test
+next_step: null
+---
+
+# Step 4: Validate
+
+## YOUR TASK:
+
+Validate the rebased migration by building and generating a script.
+
+**Previous step:** `step-03-create.md`
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Build Project
+
+```bash
+echo "Building project..."
+
+dotnet build "$INFRA_PROJECT" --no-restore
+
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "ERROR: Build failed"
+  echo "Restoring from backup..."
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  exit 1
+fi
+
+echo "Build: OK"
+```
+
+### 2. Generate Script
+
+```bash
+echo ""
+echo "Generating migration script..."
+
+SCRIPT_FILE="$BACKUP_DIR/migration_script.sql"
+
+dotnet ef migrations script \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --idempotent \
+  --no-build \
+  -o "$SCRIPT_FILE"
+
+if [ $? -ne 0 ]; then
+  echo ""
+  echo "ERROR: Script generation failed"
+  echo "Restoring from backup..."
+  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+  exit 1
+fi
+
+echo "Script: $SCRIPT_FILE"
+```
+
+### 3. List Migrations
+
+```bash
+echo ""
+echo "Migration list:"
+
+dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  --no-build
+```
+
+### 4. Final Summary
+
+```bash
+FINAL_COUNT=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | wc -l)
+
+echo ""
+echo "==========================================="
+echo "REBASE-SNAPSHOT COMPLETE"
+echo "==========================================="
+echo ""
+echo "Branch:      $CURRENT_BRANCH"
+echo "Parent:      $BASE_BRANCH"
+echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo ""
+echo "Changes:"
+echo "  - Snapshot reset to $BASE_BRANCH"
+echo "  - Removed: ${#BRANCH_MIGRATIONS[@]} branch migrations"
+echo "  - Created: 1 consolidated migration"
+echo ""
+echo "Result:"
+echo "  Migration: $MIGRATION_NAME"
+echo "  Total:     $FINAL_COUNT migrations"
+echo ""
+echo "Backup:      $BACKUP_DIR"
+echo "Script:      $SCRIPT_FILE"
+echo ""
+echo "==========================================="
+echo ""
+echo "Next steps:"
+echo "  /efcore db-reset      # Reset local database"
+echo "  /efcore db-deploy     # Apply migrations"
+echo "  /gitflow commit       # Commit changes"
+echo ""
+```
+
+---
+
+## OUTPUT FORMAT:
+
+```
+REBASE-SNAPSHOT COMPLETE
+========================
+Branch:      {current_branch}
+Parent:      {base_branch}
+DbContext:   {dbcontext} ({dbcontext_type})
+
+Changes:
+  - Snapshot reset to {base_branch}
+  - Removed: {count} branch migrations
+  - Created: 1 consolidated migration
+
+Result:
+  Migration: {migration_name}
+  Total:     {final_count} migrations
+
+Backup:      {backup_dir}
+Script:      {backup_dir}/migration_script.sql
+
+Next: /efcore db-reset, /efcore db-deploy, /gitflow commit
+```
+
+---
+
+## ERROR HANDLING:
+
+| Error | Action |
+|-------|--------|
+| Build fails | Restore backup |
+| Script fails | Restore backup |
+
+---
+
+## SUCCESS CRITERIA:
+
+- Build passes
+- Script generates
+- Summary displayed
+
+## COMPLETION:
+
+Rebase-snapshot complete. Use `/efcore db-reset` then `/efcore db-deploy` to apply.

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

@@ -0,0 +1,266 @@
+---
+name: step-00-init
+description: Initialize EF Core context - detect project, DbContext, and environment
+next_step: null
+---
+
+# Step 0: Initialize EF Core Context
+
+## YOUR TASK:
+
+Detect EF Core project structure, identify DbContext (Core vs Extensions), and load environment configuration.
+
+**This step runs first for ALL EF Core commands.**
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Detect EF Core Project
+
+```bash
+detect_efcore_project() {
+  # Find project with EF Core reference
+  CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
+
+  if [ -z "$CSPROJ" ]; then
+    echo "ERROR: No EF Core project found"
+    exit 1
+  fi
+
+  PROJECT_DIR=$(dirname "$CSPROJ")
+  PROJECT_NAME=$(basename "$CSPROJ" .csproj)
+  MIGRATIONS_DIR="$PROJECT_DIR/Persistence/Migrations"
+
+  # Find startup and infrastructure projects
+  STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
+  INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
+  [ -z "$INFRA_PROJECT" ] && INFRA_PROJECT="$CSPROJ"
+
+  echo "Project: $PROJECT_NAME"
+  echo "Migrations: $MIGRATIONS_DIR"
+}
+```
+
+### 2. Detect DbContext (Core vs Extensions)
+
+```bash
+detect_dbcontext() {
+  # Priority 1: SmartStack.Domain exists → CoreDbContext
+  if find . -type d -name "SmartStack.Domain" | grep -q .; then
+    DBCONTEXT="CoreDbContext"
+    DBCONTEXT_TYPE="core"
+    SCHEMA="core"
+    echo "DbContext: CoreDbContext (SmartStack.Domain found)"
+    return
+  fi
+
+  # Priority 2: Client with SmartStack NuGet → ExtensionsDbContext
+  if find . -name "*.csproj" -exec grep -l "SmartStack\." {} \; | grep -qv "SmartStack\."; then
+    DBCONTEXT="ExtensionsDbContext"
+    DBCONTEXT_TYPE="extensions"
+    SCHEMA="extensions"
+    echo "DbContext: ExtensionsDbContext (SmartStack NuGet reference)"
+    return
+  fi
+
+  # Priority 3: Scan for DbContext in code
+  CORE_CTX=$(find . -name "*.cs" -exec grep -l "CoreDbContext" {} \; 2>/dev/null | head -1)
+  EXT_CTX=$(find . -name "*.cs" -exec grep -l "ExtensionsDbContext" {} \; 2>/dev/null | head -1)
+
+  if [ -n "$CORE_CTX" ] && [ -z "$EXT_CTX" ]; then
+    DBCONTEXT="CoreDbContext"
+    DBCONTEXT_TYPE="core"
+    SCHEMA="core"
+  elif [ -z "$CORE_CTX" ] && [ -n "$EXT_CTX" ]; then
+    DBCONTEXT="ExtensionsDbContext"
+    DBCONTEXT_TYPE="extensions"
+    SCHEMA="extensions"
+  else
+    # Priority 4: Ask user
+    DBCONTEXT=""
+    DBCONTEXT_TYPE=""
+    SCHEMA=""
+  fi
+}
+```
+
+### 3. Ask User if DbContext Unknown
+
+**If `{dbcontext}` is empty after detection:**
+
+```yaml
+AskUserQuestion:
+  header: "DbContext"
+  question: "Which DbContext to use?"
+  options:
+    - label: "CoreDbContext"
+      description: "SmartStack entities (User, Role, Navigation...)"
+    - label: "ExtensionsDbContext"
+      description: "Client-specific entities"
+    - label: "Both"
+      description: "Run for both contexts"
+  multiSelect: false
+```
+
+**Set variables based on response:**
+```javascript
+if (answer === "CoreDbContext") {
+  DBCONTEXT = "CoreDbContext";
+  DBCONTEXT_TYPE = "core";
+  SCHEMA = "core";
+} else if (answer === "ExtensionsDbContext") {
+  DBCONTEXT = "ExtensionsDbContext";
+  DBCONTEXT_TYPE = "extensions";
+  SCHEMA = "extensions";
+} else {
+  // Both - will run commands twice
+  RUN_BOTH = true;
+}
+```
+
+### 4. Detect Environment
+
+```bash
+detect_environment() {
+  API_DIR=$(find . -type d -name "*.Api" | head -1)
+  [ -z "$API_DIR" ] && API_DIR="src/SmartStack.Api"
+
+  # Priority: --env flag > appsettings.Local.json > error
+  if [ -n "$ENV_FLAG" ]; then
+    CONFIG_FILE="$API_DIR/appsettings.${ENV_FLAG}.json"
+  elif [ -f "$API_DIR/appsettings.Local.json" ]; then
+    CONFIG_FILE="$API_DIR/appsettings.Local.json"
+    SELECTED_ENV="Local"
+  else
+    echo "ERROR: No appsettings.Local.json found"
+    echo "Create one or use --env flag"
+    exit 1
+  fi
+
+  echo "Environment: $SELECTED_ENV"
+  echo "Config: $CONFIG_FILE"
+}
+```
+
+### 5. Determine Base Branch (for squash/rebase)
+
+```bash
+determine_base_branch() {
+  CURRENT_BRANCH=$(git branch --show-current)
+
+  case "$CURRENT_BRANCH" in
+    feature/*)
+      BASE_BRANCH="develop"
+      BRANCH_TYPE="feature"
+      ;;
+    release/*)
+      BASE_BRANCH="main"
+      BRANCH_TYPE="release"
+      ;;
+    hotfix/*)
+      BASE_BRANCH="main"
+      BRANCH_TYPE="hotfix"
+      ;;
+    develop)
+      BASE_BRANCH="main"
+      BRANCH_TYPE="develop"
+      ;;
+    main|master)
+      echo "ERROR: Cannot run on main/master branch"
+      exit 1
+      ;;
+    *)
+      BASE_BRANCH="develop"
+      BRANCH_TYPE="unknown"
+      ;;
+  esac
+
+  echo "Branch: $CURRENT_BRANCH ($BRANCH_TYPE)"
+  echo "Base: $BASE_BRANCH"
+}
+```
+
+### 6. Block Production
+
+```bash
+block_production() {
+  # Check for production indicators
+  if grep -q '"Production"' "$CONFIG_FILE" 2>/dev/null; then
+    echo "BLOCKED: Production environment detected"
+    exit 1
+  fi
+
+  if [[ "$DATABASE_NAME" == *"prod"* ]] || [[ "$DATABASE_NAME" == *"production"* ]]; then
+    echo "BLOCKED: Production database detected"
+    exit 1
+  fi
+}
+```
+
+### 7. Display Summary
+
+```
+EF CORE CONTEXT
+├── Project:    {PROJECT_NAME}
+├── DbContext:  {DBCONTEXT} ({DBCONTEXT_TYPE})
+├── Schema:     {SCHEMA}
+├── Migrations: {MIGRATIONS_DIR}
+├── Environment:{SELECTED_ENV}
+└── Branch:     {CURRENT_BRANCH} → {BASE_BRANCH}
+```
+
+---
+
+## STATE OUTPUT:
+
+After this step, these variables are available:
+
+| Variable | Example Value |
+|----------|---------------|
+| `{project_name}` | SmartStack.Infrastructure |
+| `{dbcontext}` | CoreDbContext |
+| `{dbcontext_type}` | core |
+| `{schema}` | core |
+| `{migrations_dir}` | src/SmartStack.Infrastructure/Persistence/Migrations |
+| `{infra_project}` | src/SmartStack.Infrastructure/SmartStack.Infrastructure.csproj |
+| `{startup_project}` | src/SmartStack.Api/SmartStack.Api.csproj |
+| `{base_branch}` | develop |
+| `{branch_type}` | feature |
+| `{current_branch}` | feature/multitenant |
+| `{selected_env}` | Local |
+
+---
+
+## SUCCESS CRITERIA:
+
+- EF Core project detected
+- DbContext identified (or user prompted)
+- Environment loaded
+- No production environment
+- All paths validated
+
+## FAILURE MODES:
+
+| Error | Resolution |
+|-------|------------|
+| No EF Core project | Check Microsoft.EntityFrameworkCore reference |
+| No appsettings.Local.json | Create file or use --env flag |
+| Production detected | Use different environment |
+| Both DbContexts found | User will be prompted |
+
+---
+
+## NEXT STEP:
+
+Route to command-specific step based on `{command}`:
+
+| Command | Next Step |
+|---------|-----------|
+| `db-status` | `../db/step-status.md` |
+| `db-deploy` | `../db/step-deploy.md` |
+| `db-reset` | `../db/step-reset.md` |
+| `db-seed` | `../db/step-seed.md` |
+| `migration` | `../migration/step-01-check.md` |
+| `squash` | `../squash/step-01-backup.md` |
+| `rebase-snapshot` | `../rebase-snapshot/step-01-backup.md` |

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

@@ -0,0 +1,141 @@
+---
+name: step-00-init
+description: Initialize squash - verify prerequisites and get confirmation
+next_step: step-01-backup.md
+---
+
+# Step 0: Initialize Squash
+
+## YOUR TASK:
+
+Verify prerequisites for squash operation and get user confirmation.
+
+**Requires:** `steps/shared/step-00-init.md` completed (provides {dbcontext}, {base_branch}, etc.)
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Verify Clean Working Directory
+
+```bash
+[ -n "$(git status --porcelain)" ] && {
+  echo "ERROR: Working directory not clean"
+  git status --short
+  exit 1
+}
+```
+
+### 2. Identify Branch-Only Migrations
+
+```bash
+# Fetch parent branch
+git fetch origin "$BASE_BRANCH" --quiet
+
+# Get migrations from parent branch
+BASE_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 migrations unique to this branch
+BRANCH_ONLY_MIGRATIONS=()
+for mig in $LOCAL_MIGRATIONS; do
+  if ! echo "$BASE_MIGRATIONS" | grep -q "$(basename "$mig")"; then
+    BRANCH_ONLY_MIGRATIONS+=("$mig")
+  fi
+done
+
+MIGRATION_COUNT=${#BRANCH_ONLY_MIGRATIONS[@]}
+BASE_MIGRATION_COUNT=$(echo "$BASE_MIGRATIONS" | grep -c "." || echo "0")
+
+echo "Branch: $CURRENT_BRANCH"
+echo "Parent: $BASE_BRANCH"
+echo "Migrations to squash: $MIGRATION_COUNT (branch-only)"
+echo "Migrations from parent: $BASE_MIGRATION_COUNT (preserved)"
+```
+
+### 3. Check If Squash Needed
+
+```bash
+if [ "$MIGRATION_COUNT" -eq 0 ]; then
+  echo "No branch-specific migrations to squash."
+  echo "Nothing to do."
+  exit 0
+fi
+
+if [ "$MIGRATION_COUNT" -eq 1 ]; then
+  echo "Only 1 migration on branch."
+  # Ask if user wants to continue anyway
+fi
+```
+
+### 4. Display Summary
+
+```
+SQUASH PREVIEW
+==============
+Branch:     {CURRENT_BRANCH}
+Parent:     {BASE_BRANCH}
+DbContext:  {DBCONTEXT} ({DBCONTEXT_TYPE})
+
+Migrations to squash ({MIGRATION_COUNT}):
+{for mig in BRANCH_ONLY_MIGRATIONS}
+  - {mig}
+{endfor}
+
+Migrations from parent ({BASE_MIGRATION_COUNT}):
+  (will be preserved)
+
+Result: {BASE_MIGRATION_COUNT + 1} migrations total
+```
+
+### 5. User Confirmation
+
+**If NOT auto_mode:**
+
+```yaml
+AskUserQuestion:
+  header: "Squash"
+  question: "Squash {MIGRATION_COUNT} migrations from {CURRENT_BRANCH}?
+
+The ModelSnapshot and migrations from {BASE_BRANCH} will be recovered.
+Your {MIGRATION_COUNT} migrations will be consolidated into ONE.
+
+This operation is DESTRUCTIVE but a backup will be created."
+  options:
+    - label: "Yes, squash"
+      description: "Consolidate on base of {BASE_BRANCH}"
+    - label: "View details"
+      description: "Show migrations to be squashed"
+    - label: "Cancel"
+      description: "Do nothing"
+  multiSelect: false
+```
+
+**Handle response:**
+- "Yes, squash" → Continue to next step
+- "View details" → Show full migration list, ask again
+- "Cancel" → Exit
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Description |
+|----------|-------------|
+| `{branch_only_migrations}` | Array of migrations to squash |
+| `{migration_count}` | Number of migrations to squash |
+| `{base_migration_count}` | Number of parent migrations |
+
+---
+
+## SUCCESS CRITERIA:
+
+- Working directory clean
+- At least 1 branch-specific migration
+- User confirmed (or auto_mode)
+
+## NEXT STEP:
+
+→ `step-01-backup.md`

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

@@ -0,0 +1,120 @@
+---
+name: step-01-backup
+description: Create backup of all migration files
+next_step: step-02-fetch.md
+---
+
+# Step 1: Backup
+
+## YOUR TASK:
+
+Create a complete backup of all migration files before destructive operations.
+
+**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/squash_${TIMESTAMP}"
+
+mkdir -p "$BACKUP_DIR"
+echo "Backup directory: $BACKUP_DIR"
+```
+
+### 2. Backup All Migration Files
+
+```bash
+# Backup all .cs files from migrations directory
+cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/" 2>/dev/null || {
+  echo "ERROR: No migration files found to backup"
+  exit 1
+}
+
+# Count backed up files
+BACKUP_COUNT=$(ls -1 "$BACKUP_DIR"/*.cs 2>/dev/null | wc -l)
+echo "Backed up: $BACKUP_COUNT files"
+```
+
+### 3. Create Backup Manifest
+
+```bash
+cat > "$BACKUP_DIR/MANIFEST.md" << EOF
+# Squash Backup Manifest
+
+**Created:** $(date -Iseconds)
+**Branch:** $CURRENT_BRANCH
+**Parent:** $BASE_BRANCH
+**DbContext:** $DBCONTEXT
+
+## Files Backed Up
+
+\`\`\`
+$(ls -la "$BACKUP_DIR"/*.cs)
+\`\`\`
+
+## Migrations to Squash
+
+$(for mig in "${BRANCH_ONLY_MIGRATIONS[@]}"; do echo "- $mig"; done)
+
+## Restore Command
+
+\`\`\`bash
+cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
+\`\`\`
+EOF
+
+echo "Manifest created: $BACKUP_DIR/MANIFEST.md"
+```
+
+### 4. Verify Backup
+
+```bash
+# Ensure critical files exist
+SNAPSHOT_BACKUP=$(ls "$BACKUP_DIR"/*ModelSnapshot.cs 2>/dev/null | head -1)
+
+if [ -z "$SNAPSHOT_BACKUP" ]; then
+  echo "WARNING: No ModelSnapshot in backup"
+fi
+
+echo ""
+echo "Backup complete:"
+echo "  Directory: $BACKUP_DIR"
+echo "  Files: $BACKUP_COUNT"
+echo "  Snapshot: $(basename "$SNAPSHOT_BACKUP" 2>/dev/null || echo 'N/A')"
+```
+
+---
+
+## STATE OUTPUT:
+
+| Variable | Value |
+|----------|-------|
+| `{backup_dir}` | `.claude/gitflow/backup/migrations/squash_{timestamp}` |
+| `{backup_count}` | Number of files backed up |
+
+---
+
+## RECOVERY:
+
+If squash fails, restore with:
+
+```bash
+cp "{BACKUP_DIR}"/*.cs "{MIGRATIONS_DIR}/"
+```
+
+---
+
+## SUCCESS CRITERIA:
+
+- Backup directory created
+- All migration files copied
+- Manifest created
+
+## NEXT STEP:
+
+→ `step-02-fetch.md`