@atlashub/smartstack-cli 4.34.0 → 4.36.0

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

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

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

package/templates/skills/efcore/steps/squash/step-02-fetch.md

@@ -1,168 +0,0 @@
----
-name: step-02-fetch
-description: Fetch ModelSnapshot AND migrations from parent branch (CRITICAL)
-next_step: step-03-create.md
----
-
-# Step 2: Fetch Parent State (CRITICAL)
-
-## YOUR TASK:
-
-Recover BOTH the ModelSnapshot AND all migrations from the parent branch.
-
-**THIS IS THE MOST CRITICAL STEP.** Recovering only the snapshot loses parent migrations!
-
-**Previous step:** `step-01-backup.md`
-
----
-
-## PRINCIPLE:
-
-```
-GOLDEN RULE: Fetch SNAPSHOT + MIGRATIONS from PARENT branch
-
-feature/* → snapshot + migrations from develop
-develop   → snapshot + migrations from main
-release/* → snapshot + migrations from main
-hotfix/*  → snapshot + migrations from main
-
-NEVER fetch only the snapshot without migrations!
-```
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Fetch Parent Branch
-
-```bash
-echo "Fetching origin/$BASE_BRANCH..."
-git fetch origin "$BASE_BRANCH" --quiet
-```
-
-### 2. Recover ModelSnapshot
-
-```bash
-echo ""
-echo "Recovering ModelSnapshot from origin/$BASE_BRANCH..."
-
-SNAPSHOT_FILE=$(git ls-tree -r --name-only "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR" | grep "ModelSnapshot.cs$" | head -1)
-
-if [ -n "$SNAPSHOT_FILE" ]; then
-  git checkout "origin/$BASE_BRANCH" -- "$SNAPSHOT_FILE"
-  echo "  Snapshot: $(basename "$SNAPSHOT_FILE")"
-else
-  echo "  WARNING: No snapshot found on origin/$BASE_BRANCH"
-fi
-```
-
-### 3. Recover ALL Parent Migrations (CRUCIAL!)
-
-```bash
-echo ""
-echo "Recovering migrations from origin/$BASE_BRANCH..."
-
-RECOVERED_COUNT=0
-
-for base_mig in $BASE_MIGRATIONS; do
-  base_name=$(basename "${base_mig%.cs}")
-
-  # Recover migration file
-  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.cs" 2>/dev/null && {
-    echo "  ${base_name}.cs"
-    RECOVERED_COUNT=$((RECOVERED_COUNT + 1))
-  }
-
-  # Recover Designer file
-  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.Designer.cs" 2>/dev/null && {
-    echo "  ${base_name}.Designer.cs"
-  }
-done
-
-echo ""
-echo "Recovered: $RECOVERED_COUNT migrations from origin/$BASE_BRANCH"
-```
-
-### 4. Delete Branch-Only Migrations
-
-```bash
-echo ""
-echo "Removing branch-specific migrations..."
-
-for mig in "${BRANCH_ONLY_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_ONLY_MIGRATIONS[@]} branch-specific migrations"
-```
-
-### 5. Verify State
-
-```bash
-echo ""
-echo "Current state after fetch:"
-echo ""
-
-ls -la "$MIGRATIONS_DIR"/*.cs 2>/dev/null | while read line; do
-  echo "  $line"
-done
-
-CURRENT_MIGS=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | wc -l)
-echo ""
-echo "Migrations remaining: $CURRENT_MIGS (all from $BASE_BRANCH)"
-```
-
----
-
-## EXPECTED RESULT:
-
-```
-After step-02-fetch:
-├── {base_migration_1}.cs              ← From parent (preserved)
-├── {base_migration_1}.Designer.cs
-├── {base_migration_N}.cs              ← From parent (preserved)
-├── {base_migration_N}.Designer.cs
-└── {DbContext}ModelSnapshot.cs        ← From parent (recovered)
-
-Branch-specific migrations: DELETED (will be recreated consolidated)
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{recovered_count}` | Number of parent migrations recovered |
-| `{snapshot_recovered}` | true if snapshot was recovered |
-
----
-
-## FAILURE HANDLING:
-
-If this step fails:
-
-```bash
-# Restore from backup
-cp "{BACKUP_DIR}"/*.cs "{MIGRATIONS_DIR}/"
-echo "Restored from backup"
-```
-
----
-
-## SUCCESS CRITERIA:
-
-- ModelSnapshot recovered from parent
-- ALL parent migrations recovered
-- Branch-specific migrations removed
-- No migration loss from parent
-
-## NEXT STEP:
-
-→ `step-03-create.md`

package/templates/skills/efcore/steps/squash/step-03-create.md

@@ -1,184 +0,0 @@
----
-name: step-03-create
-description: Create consolidated migration using MCP for naming
-next_step: step-04-validate.md
----
-
-# Step 3: Create Consolidated Migration
-
-## YOUR TASK:
-
-Create a single consolidated migration that captures all changes from the branch.
-
-**MANDATORY:** Use MCP `suggest_migration` for compliant naming. NEVER hardcode names.
-
-**Previous step:** `step-02-fetch.md`
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Build Description from Branch Context
-
-```bash
-case "$BRANCH_TYPE" in
-  feature)
-    # Extract feature name: feature/user-auth → UserAuth
-    FEATURE_NAME=$(echo "$CURRENT_BRANCH" | sed 's|feature/||' | sed 's/-/ /g' | awk '{for(i=1;i<=NF;i++) $i=toupper(substr($i,1,1)) tolower(substr($i,2))}1' | tr -d ' ')
-    DESCRIPTION="${FEATURE_NAME}Consolidated"
-    ;;
-  release)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|release/v\?||')
-    DESCRIPTION="Release${VERSION}Initial"
-    ;;
-  hotfix)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|hotfix/v\?||')
-    DESCRIPTION="Hotfix${VERSION}Fix"
-    ;;
-  develop)
-    DESCRIPTION="DevelopConsolidated"
-    ;;
-  *)
-    DESCRIPTION="Consolidated"
-    ;;
-esac
-
-echo "Description: $DESCRIPTION"
-echo "DbContext Type: $DBCONTEXT_TYPE"
-```
-
-### 2. Get Migration Name from MCP (MANDATORY)
-
-```javascript
-// DBCONTEXT_TYPE = "core" or "extensions" (from detect_dbcontext)
-// DESCRIPTION = built above (e.g., "MultitenantConsolidated")
-
-const result = await mcp__smartstack__suggest_migration({
-  description: DESCRIPTION,
-  context: DBCONTEXT_TYPE,   // NEVER hardcode!
-  squash: true               // Squash format: {context}_v{version} (no sequence/description)
-});
-
-// Result example: core_v1.9.0 (squash — just version, no _001_Description)
-MIGRATION_NAME = result.migrationName;
-```
-
-**FORBIDDEN:**
-- Calculating name manually
-- Hardcoding context as "core"
-- Using underscores instead of dots in version
-- Adding sequence/description to squash migrations
-
-### 3. Create Migration with EF Core
-
-```bash
-# MIGRATION_NAME = result from MCP (e.g., core_v1.9.0)
-# DBCONTEXT = CoreDbContext or ExtensionsDbContext (from detect_dbcontext)
-
-echo ""
-echo "Creating migration: $MIGRATION_NAME"
-echo "Context: $DBCONTEXT"
-echo ""
-
-dotnet ef migrations add "$MIGRATION_NAME" \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  -o Persistence/Migrations \
-  --verbose
-```
-
-### 4. Verify Migration Created
-
-```bash
-# Check migration files exist
-MIGRATION_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.cs"
-DESIGNER_FILE="$MIGRATIONS_DIR/${MIGRATION_NAME}.Designer.cs"
-
-if [ ! -f "$MIGRATION_FILE" ]; then
-  echo "ERROR: Migration file not created"
-  echo "Expected: $MIGRATION_FILE"
-
-  # Restore from backup
-  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
-  echo "Restored from backup"
-  exit 1
-fi
-
-if [ ! -f "$DESIGNER_FILE" ]; then
-  echo "ERROR: Designer file not created"
-  exit 1
-fi
-
-echo ""
-echo "Migration created:"
-echo "  $MIGRATION_FILE"
-echo "  $DESIGNER_FILE"
-```
-
-### 5. Check Migration Content
-
-```bash
-# Verify migration has content (not empty)
-UP_METHODS=$(grep -c "protected override void Up" "$MIGRATION_FILE" || echo "0")
-DOWN_METHODS=$(grep -c "protected override void Down" "$MIGRATION_FILE" || echo "0")
-
-if [ "$UP_METHODS" -eq 0 ]; then
-  echo "WARNING: Migration may be empty (no Up method found)"
-fi
-
-echo ""
-echo "Migration content:"
-echo "  Up methods: $UP_METHODS"
-echo "  Down methods: $DOWN_METHODS"
-```
-
-### 6. Inject SQL Objects (Functions, Views, SP)
-
-Load: `references/sql-objects-injection.md`
-
----
-
-## EXPECTED RESULT:
-
-```
-After step-03-create:
-├── {base_migration_1}.cs              ← From parent (preserved)
-├── {base_migration_1}.Designer.cs
-├── {NEW_MIGRATION_NAME}.cs            ← NEW: Consolidated migration
-├── {NEW_MIGRATION_NAME}.Designer.cs   ← NEW: Designer file
-└── {DbContext}ModelSnapshot.cs        ← Updated with new migration
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{migration_name}` | Name from MCP (e.g., core_v1.9.0) |
-| `{migration_file}` | Full path to .cs file |
-| `{designer_file}` | Full path to .Designer.cs file |
-
----
-
-## ERROR HANDLING:
-
-| Error | Resolution |
-|-------|------------|
-| MCP fails | Check MCP connectivity, retry |
-| Migration creation fails | Restore from backup, check errors |
-| Empty migration | Warning only, may be valid |
-
----
-
-## SUCCESS CRITERIA:
-
-- MCP called for migration name
-- Migration file created
-- Designer file created
-- Snapshot updated
-
-## NEXT STEP:
-
-→ `step-04-validate.md`