@atlashub/smartstack-cli 4.35.0 → 4.36.0

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

@@ -1,112 +0,0 @@
----
-name: step-03-create
-description: Create consolidated migration with MCP naming
-next_step: step-04-validate.md
----
-
-# Step 3: Create Consolidated Migration
-
-## YOUR TASK:
-
-Generate a new consolidated migration capturing all branch changes.
-
-**MANDATORY:** Use MCP for naming. NEVER hardcode.
-
-**Previous step:** `step-02-fetch.md`
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Build Description
-
-```bash
-# Extract feature name from branch
-FEATURE_NAME=$(echo "$CURRENT_BRANCH" | sed 's|.*/||' | 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"
-
-echo "Description: $DESCRIPTION"
-```
-
-### 2. Call MCP for Migration Name (MANDATORY)
-
-```javascript
-// DESCRIPTION = from above (e.g., "UserAuthConsolidated")
-// 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.7.0_001_UserAuthConsolidated
-MIGRATION_NAME = result.migrationName;
-```
-
-**FORBIDDEN:**
-- Manual name calculation
-- Hardcoding context
-
-### 3. Create Migration
-
-```bash
-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 Files Created
-
-```bash
-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"
-
-  # Restore backup
-  cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
-  echo "Restored from backup"
-  exit 1
-fi
-
-echo ""
-echo "Migration created:"
-echo "  $MIGRATION_FILE"
-echo "  $DESIGNER_FILE"
-```
-
-### 5. Inject SQL Objects (Functions, Views, SP)
-
-Load: `references/sql-objects-injection.md`
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{migration_name}` | Name from MCP |
-| `{migration_file}` | Path to .cs file |
-
----
-
-## SUCCESS CRITERIA:
-
-- MCP called successfully
-- Migration files created
-
-## NEXT STEP:
-
-→ `step-04-validate.md`

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

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

@@ -1,131 +0,0 @@
----
-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:
-
-Load all helper functions from: `references/shared-init-functions.md`
-
-This includes:
-- `ensure_dotnet_ef()` - Platform-aware dotnet-ef PATH fix
-- `detect_efcore_project()` - Find EF Core project
-- `detect_dbcontext()` - Detect Core vs Extensions
-- `detect_environment()` - Load environment configuration
-- `determine_base_branch()` - Determine GitFlow branch
-- `block_production()` - Prevent production deployments
-- `run_for_contexts()` - Helper for dual context execution
-
-### User Prompt (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;
-}
-```
-
-### Display Summary
-
-```
-EF CORE CONTEXT
-├── Project:    {PROJECT_NAME}
-├── DbContext:  {DBCONTEXT} ({DBCONTEXT_TYPE})
-├── Run Both:   {RUN_BOTH} (Core → Extensions)
-├── 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 |
-| `{run_both}` | true |
-
----
-
-## 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

@@ -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`