@atlashub/smartstack-cli 4.34.0 → 4.36.0

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

@@ -1,100 +0,0 @@
----
-name: step-01-backup
-description: Create backup of migration files
-next_step: step-02-fetch.md
----
-
-# Step 1: Backup
-
-## YOUR TASK:
-
-Create a complete backup before modifying migration files.
-
-**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/rebase_${TIMESTAMP}"
-
-mkdir -p "$BACKUP_DIR"
-echo "Backup directory: $BACKUP_DIR"
-```
-
-### 2. Backup All Migration Files
-
-```bash
-cp "$MIGRATIONS_DIR"/*.cs "$BACKUP_DIR/" 2>/dev/null || {
-  echo "ERROR: No migration files to backup"
-  exit 1
-}
-
-BACKUP_COUNT=$(ls -1 "$BACKUP_DIR"/*.cs 2>/dev/null | wc -l)
-echo "Backed up: $BACKUP_COUNT files"
-```
-
-### 3. Create Manifest
-
-```bash
-cat > "$BACKUP_DIR/MANIFEST.md" << EOF
-# Rebase-Snapshot Backup Manifest
-
-**Created:** $(date -Iseconds)
-**Branch:** $CURRENT_BRANCH
-**Parent:** $BASE_BRANCH
-**DbContext:** $DBCONTEXT
-
-## Branch Migrations (to be replaced)
-
-$(for mig in "${BRANCH_MIGRATIONS[@]}"; do echo "- $mig"; done)
-
-## Restore Command
-
-\`\`\`bash
-cp "$BACKUP_DIR"/*.cs "$MIGRATIONS_DIR/"
-\`\`\`
-EOF
-```
-
-### 4. Verify Backup
-
-```bash
-echo ""
-echo "Backup complete:"
-echo "  Directory: $BACKUP_DIR"
-echo "  Files: $BACKUP_COUNT"
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{backup_dir}` | Backup directory path |
-| `{backup_count}` | Number of files backed up |
-
----
-
-## RECOVERY:
-
-```bash
-cp "{BACKUP_DIR}"/*.cs "{MIGRATIONS_DIR}/"
-```
-
----
-
-## SUCCESS CRITERIA:
-
-- Backup directory created
-- All files copied
-- Manifest created
-
-## NEXT STEP:
-
-→ `step-02-fetch.md`

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

@@ -1,115 +0,0 @@
----
-name: step-02-fetch
-description: Reset snapshot to parent and delete branch migrations
-next_step: step-03-create.md
----
-
-# Step 2: Fetch Parent Snapshot
-
-## YOUR TASK:
-
-Reset the ModelSnapshot to the parent branch state and remove branch-specific migrations.
-
-**Previous step:** `step-01-backup.md`
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Fetch Latest Parent
-
-```bash
-echo "Fetching origin/$BASE_BRANCH..."
-git fetch origin "$BASE_BRANCH" --quiet
-```
-
-### 2. Reset ModelSnapshot
-
-```bash
-echo ""
-echo "Resetting ModelSnapshot from origin/$BASE_BRANCH..."
-
-SNAPSHOT_FILE="$MIGRATIONS_DIR/${DBCONTEXT}ModelSnapshot.cs"
-
-git checkout "origin/$BASE_BRANCH" -- "$SNAPSHOT_FILE" 2>/dev/null
-
-if [ $? -eq 0 ]; then
-  echo "  Snapshot reset to origin/$BASE_BRANCH"
-else
-  echo "  WARNING: Could not fetch snapshot from origin/$BASE_BRANCH"
-  echo "  Using local snapshot (may cause issues)"
-fi
-```
-
-### 3. Delete Branch Migrations
-
-```bash
-echo ""
-echo "Removing branch-specific migrations..."
-
-for mig in "${BRANCH_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_MIGRATIONS[@]} migration(s)"
-```
-
-### 4. Verify State
-
-```bash
-echo ""
-echo "Current migrations after reset:"
-
-REMAINING=$(find "$MIGRATIONS_DIR" -name "*.cs" 2>/dev/null | grep -v "Designer\|Snapshot" | wc -l)
-
-echo "  Remaining: $REMAINING (from $BASE_BRANCH)"
-```
-
----
-
-## EXPECTED STATE:
-
-```
-After step-02-fetch:
-├── {parent_migration_1}.cs        ← From parent (unchanged)
-├── {parent_migration_1}.Designer.cs
-├── ...
-└── {DbContext}ModelSnapshot.cs    ← Reset to parent state
-
-Branch migrations: DELETED
-```
-
----
-
-## STATE OUTPUT:
-
-| Variable | Description |
-|----------|-------------|
-| `{snapshot_reset}` | true if reset successful |
-| `{remaining_migrations}` | Count after deletion |
-
----
-
-## ERROR HANDLING:
-
-If snapshot fetch fails:
-- Continue with local snapshot
-- Migration may contain more changes than expected
-- Warn user
-
----
-
-## SUCCESS CRITERIA:
-
-- Snapshot reset to parent
-- Branch migrations removed
-
-## NEXT STEP:
-
-→ `step-03-create.md`

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