@atlashub/smartstack-cli 4.35.0 → 4.36.0

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`

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

@@ -1,174 +0,0 @@
----
-name: step-04-validate
-description: Validate squash - build and generate script
-next_step: null
----
-
-# Step 4: Validate
-
-## YOUR TASK:
-
-Validate the squash by building the project and generating an idempotent script.
-
-**Previous step:** `step-03-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 ""
-  echo "Restoring from backup..."
-  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
-  echo "Restored. Please fix issues and retry."
-  exit 1
-fi
-
-echo ""
-echo "Build: OK"
-```
-
-### 2. List Migrations
-
-```bash
-echo ""
-echo "Migration list:"
-echo ""
-
-dotnet ef migrations list \
-  --context "$DBCONTEXT" \
-  --project "$INFRA_PROJECT" \
-  --startup-project "$STARTUP_PROJECT" \
-  --no-build
-```
-
-### 3. Generate Idempotent Script (Validation)
-
-```bash
-echo ""
-echo "Generating idempotent script..."
-echo ""
-
-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 ""
-  echo "This indicates a migration problem."
-  echo "Restoring from backup..."
-  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
-  exit 1
-fi
-
-echo "Script generated: $SCRIPT_FILE"
-```
-
-### 4. Final Summary
-
-```bash
-# Count final migrations
-FINAL_MIGRATION_COUNT=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | wc -l)
-
-echo ""
-echo "==========================================="
-echo "SQUASH COMPLETE"
-echo "==========================================="
-echo ""
-echo "Branch:      $CURRENT_BRANCH"
-echo "Parent:      $BASE_BRANCH"
-echo "DbContext:   $DBCONTEXT ($DBCONTEXT_TYPE)"
-echo ""
-echo "Recovered from $BASE_BRANCH:"
-echo "  - ModelSnapshot"
-echo "  - $BASE_MIGRATION_COUNT migrations"
-echo ""
-echo "Consolidated:"
-echo "  - Before: $MIGRATION_COUNT migrations (branch-specific)"
-echo "  - After:  1 migration ($MIGRATION_NAME)"
-echo ""
-echo "Total:       $FINAL_MIGRATION_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:
-
-```
-SQUASH COMPLETE
-===============
-Branch:      {current_branch}
-Parent:      {base_branch}
-DbContext:   {dbcontext} ({dbcontext_type})
-
-Recovered from {base_branch}:
-  - ModelSnapshot
-  - {base_migration_count} migrations
-
-Consolidated:
-  - Before: {migration_count} migrations (branch-specific)
-  - After:  1 migration ({migration_name})
-
-Total:       {final_migration_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, show errors |
-| Script fails | Restore backup, investigate |
-
-**Restore command:**
-```bash
-cp "{BACKUP_DIR}"/*.cs "{MIGRATIONS_DIR}/"
-```
-
----
-
-## SUCCESS CRITERIA:
-
-- Build passes
-- Migration list shows correct migrations
-- Idempotent script generates successfully
-- Summary displayed
-
-## COMPLETION:
-
-Squash workflow complete. Database not modified (use `/efcore db-deploy` to apply).