@atlashub/smartstack-cli 1.13.2 → 1.14.1

package/templates/commands/check-version.md

@@ -0,0 +1,267 @@
+---
+description: Verify version alignment between package.json and documentation
+agent: action
+model: haiku
+---
+
+# /check-version - Version Alignment Validator
+
+Verifies that the version in `package.json` is aligned with all documentation files in `.documentation/`.
+
+**USAGE:** Run before releases or as part of release process to ensure documentation is up-to-date.
+
+**INTEGRATION:** Called automatically by `/gitflow:11-finish` for release branches.
+
+---
+
+## STEP 1: Read Package Version
+
+**EXECUTE:**
+
+```bash
+# Get version from package.json
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+echo "Package version: $PKG_VERSION"
+```
+
+---
+
+## STEP 2: Scan Documentation Files
+
+**EXECUTE:**
+
+```bash
+# Find all HTML files with version-badge
+echo ""
+echo "Scanning documentation files..."
+echo ""
+
+# Extract versions from all doc files
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      FILENAME=$(basename "$file")
+      # Remove 'v' prefix if present for comparison
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+
+      if [ "$DOC_VERSION_CLEAN" = "$PKG_VERSION" ]; then
+        echo "OK $FILENAME: v$DOC_VERSION_CLEAN"
+      else
+        echo "MISMATCH $FILENAME: v$DOC_VERSION_CLEAN (expected v$PKG_VERSION)"
+      fi
+    fi
+  fi
+done
+```
+
+---
+
+## STEP 3: Generate Report
+
+**EXECUTE:**
+
+```bash
+echo ""
+echo "====================================================================="
+echo "                    VERSION ALIGNMENT CHECK"
+echo "====================================================================="
+echo ""
+
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+MISMATCH_COUNT=0
+TOTAL_COUNT=0
+
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      TOTAL_COUNT=$((TOTAL_COUNT + 1))
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+      if [ "$DOC_VERSION_CLEAN" != "$PKG_VERSION" ]; then
+        MISMATCH_COUNT=$((MISMATCH_COUNT + 1))
+      fi
+    fi
+  fi
+done
+
+echo "Package version: v$PKG_VERSION"
+echo "Documentation files checked: $TOTAL_COUNT"
+echo "Mismatches found: $MISMATCH_COUNT"
+echo ""
+
+if [ "$MISMATCH_COUNT" -eq 0 ]; then
+  echo "STATUS: PASSED - All versions aligned"
+else
+  echo "STATUS: FAILED - Version mismatches detected"
+  echo ""
+  echo "Run /check-version:fix to auto-update documentation"
+fi
+echo ""
+echo "====================================================================="
+```
+
+---
+
+## Conditional: If Mismatches Detected
+
+**IF** `MISMATCH_COUNT > 0`:
+
+Use `AskUserQuestion` tool to ask:
+
+```json
+{
+  "questions": [{
+    "question": "Des fichiers de documentation ont des versions obsoletes. Voulez-vous les mettre a jour automatiquement ?",
+    "header": "Fix versions",
+    "options": [
+      {
+        "label": "Oui, mettre a jour (Recommended)",
+        "description": "Met a jour tous les fichiers avec la version actuelle"
+      },
+      {
+        "label": "Non, ignorer",
+        "description": "Continuer sans corriger les versions"
+      }
+    ],
+    "multiSelect": false
+  }]
+}
+```
+
+**IF** user selects "Oui":
+- Execute the fix command below
+
+---
+
+## /check-version:fix - Auto-Update Documentation Versions
+
+**EXECUTE:**
+
+```bash
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+
+echo "Updating documentation to v$PKG_VERSION..."
+echo ""
+
+UPDATED_COUNT=0
+
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+      if [ "$DOC_VERSION_CLEAN" != "$PKG_VERSION" ]; then
+        # Update version in file
+        sed -i "s/version-badge\">v[^<]*/version-badge\">v$PKG_VERSION/" "$file"
+        UPDATED_COUNT=$((UPDATED_COUNT + 1))
+        echo "UPDATED $(basename "$file"): v$DOC_VERSION_CLEAN -> v$PKG_VERSION"
+      fi
+    fi
+  fi
+done
+
+echo ""
+if [ "$UPDATED_COUNT" -gt 0 ]; then
+  echo "OK $UPDATED_COUNT file(s) updated"
+  echo ""
+  echo "Files modified:"
+  git status --porcelain .documentation/*.html | grep "^ M" | sed 's/^ M /  /'
+  echo ""
+  echo "Next steps:"
+  echo "  1. Review changes: git diff .documentation/"
+  echo "  2. Commit: /gitflow:commit"
+else
+  echo "OK No files needed updating"
+fi
+```
+
+---
+
+## /check-version:report - Detailed Report
+
+**EXECUTE:**
+
+```bash
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+
+echo "====================================================================="
+echo "         VERSION ALIGNMENT DETAILED REPORT"
+echo "====================================================================="
+echo ""
+echo "Package: @atlashub/smartstack-cli"
+echo "Current version: v$PKG_VERSION"
+echo ""
+echo "---------------------------------------------------------------------"
+echo "FILE                          | DOC VERSION | STATUS"
+echo "---------------------------------------------------------------------"
+
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      FILENAME=$(basename "$file")
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+
+      # Pad filename to 30 chars
+      PADDED_NAME=$(printf "%-28s" "$FILENAME")
+
+      if [ "$DOC_VERSION_CLEAN" = "$PKG_VERSION" ]; then
+        printf "%s | v%-10s | OK\n" "$PADDED_NAME" "$DOC_VERSION_CLEAN"
+      else
+        printf "%s | v%-10s | MISMATCH\n" "$PADDED_NAME" "$DOC_VERSION_CLEAN"
+      fi
+    fi
+  fi
+done
+
+echo "---------------------------------------------------------------------"
+```
+
+---
+
+## Integration with GitFlow Release
+
+This command is automatically called during `/gitflow:11-finish` for release branches.
+
+**In release finish workflow:**
+
+```bash
+# Before creating tag, verify versions are aligned
+if [[ "$TYPE" = "release" ]]; then
+  /check-version
+
+  # If mismatches, prompt to fix before continuing
+  if [ "$MISMATCH_COUNT" -gt 0 ]; then
+    echo "WARNING: Documentation versions not aligned"
+    echo "Fix with: /check-version:fix"
+    # Block release until fixed
+  fi
+fi
+```
+
+---
+
+## Usage Examples
+
+| Command | Description |
+|---------|-------------|
+| `/check-version` | Check version alignment (interactive) |
+| `/check-version:fix` | Auto-update all doc files |
+| `/check-version:report` | Detailed report without prompts |
+
+---
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | All versions aligned |
+| 1 | Mismatches detected (blocking for releases) |
+
+---
+
+## Files Checked
+
+- `.documentation/*.html` - All HTML documentation files
+- Looks for `<span class="version-badge">vX.Y.Z</span>` pattern

package/templates/commands/efcore/_shared.md

@@ -11,7 +11,7 @@ detect_efcore_project() {
   CSPROJ=$(find . -name "*.csproj" -exec grep -l "Microsoft.EntityFrameworkCore" {} \; | head -1)
   PROJECT_DIR=$(dirname "$CSPROJ")
   PROJECT_NAME=$(basename "$CSPROJ" .csproj)
-  MIGRATIONS_DIR="$PROJECT_DIR/Migrations"
+  MIGRATIONS_DIR="$PROJECT_DIR/Persistence/Migrations"
 
   STARTUP_PROJECT=$(find . -name "*.Api.csproj" -o -name "*Web.csproj" | head -1)
   INFRA_PROJECT=$(find . -name "*Infrastructure.csproj" | head -1)
@@ -63,6 +63,33 @@ block_production() {
 
 ---
 
+## Backup Base de Données
+
+```bash
+backup_database() {
+  BACKUP_DIR=".claude/gitflow/backup/database"
+  mkdir -p "$BACKUP_DIR"
+
+  BACKUP_FILE="${BACKUP_DIR}/${DATABASE_NAME}_$(date +%Y%m%d_%H%M%S).bak"
+
+  echo "Backup: $DATABASE_NAME → $BACKUP_FILE"
+
+  sqlcmd -S "$SERVER_NAME" -E -Q "BACKUP DATABASE [$DATABASE_NAME] TO DISK='$BACKUP_FILE' WITH FORMAT, INIT, COMPRESSION"
+
+  if [ $? -eq 0 ]; then
+    echo "✓ Backup créé: $BACKUP_FILE"
+    BACKUP_PATH="$BACKUP_FILE"
+  else
+    echo "⚠️ Backup échoué (sqlcmd non disponible ou erreur SQL)"
+    BACKUP_PATH="none"
+  fi
+}
+```
+
+**Prérequis:** `sqlcmd` doit être installé et accessible dans le PATH.
+
+---
+
 ## Détermination Branche Parente
 
 **Règle d'or:** Le ModelSnapshot de référence doit venir de la branche parente (état validé).
@@ -150,9 +177,11 @@ Pattern: `{context}_v{version}_{sequence}_{Description}`
 | ❌ INTERDIT | ✅ OBLIGATOIRE |
 |-------------|----------------|
 | Scripts SQL (.sql) dans le repo | `dotnet ef database update` |
-| `sqlcmd` avec SQL brut | `dotnet ef migrations add` |
+| `sqlcmd` pour DDL/DML | `dotnet ef migrations add` |
 | `migrationBuilder.Sql()` INSERT | `HasData()` pour seeding |
 
+**Exception:** `sqlcmd` est autorisé UNIQUEMENT pour `BACKUP DATABASE` (backup avant reset).
+
 ---
 
 ## MCP Tool Reference

package/templates/commands/efcore/db-reset.md

@@ -15,9 +15,11 @@ model: sonnet
 
 | ❌ INTERDIT | ✅ OBLIGATOIRE |
 |-------------|----------------|
-| `sqlcmd` avec SQL brut | `dotnet ef database drop` |
+| `sqlcmd` pour DDL/DML | `dotnet ef database drop` |
 | Scripts .sql dans repo | `dotnet ef database update` |
-| Backup via scripts | Backup via SSMS/Azure |
+| INSERT via scripts | `HasData()` pour seeding |
+
+**Exception:** `sqlcmd` est autorisé UNIQUEMENT pour `BACKUP DATABASE`.
 
 ---
 
@@ -50,23 +52,32 @@ AskUserQuestion({
 
 ---
 
-## STEP 2: Backup (optionnel)
+## STEP 2: Backup (automatique si configuré)
+
+Lire config: `.claude/gitflow/config.json` → `efcore.database.backupBeforeReset`
 
 ```javascript
 AskUserQuestion({
   questions: [{
-    question: "Backup nécessaire avant suppression?",
+    question: "Backup de la base '" + DATABASE_NAME + "' avant suppression?",
     header: "Backup",
     options: [
+      { label: "Oui, backup auto (Recommandé)", description: "Créer .bak via sqlcmd" },
       { label: "Non", description: "Données dev uniquement - continuer" },
-      { label: "Backup manuel", description: "Via SSMS/Azure Portal" }
+      { label: "Backup manuel", description: "Via SSMS/Azure Portal (stoppe ici)" }
     ],
     multiSelect: false
   }]
 })
 ```
 
-Si backup manuel: afficher instructions SSMS/Azure, stopper.
+**Si "Oui, backup auto":**
+
+```bash
+backup_database  # Fonction de _shared.md
+```
+
+**Si "Backup manuel":** Afficher instructions et stopper.
 
 ---
 
@@ -109,6 +120,7 @@ AskUserQuestion({
 ```
 RESET - {DATABASE_NAME}
 ├── Environnement: {SELECTED_ENV}
+├── Backup: {BACKUP_PATH|none}
 ├── Opérations: ✓ Drop, ✓ Create, ✓ {N} migrations
 ├── Conformité: ✓ EF Core CLI uniquement
 └── Prochains: /efcore:db-status, /efcore:db-seed

package/templates/commands/efcore/migration.md

@@ -93,7 +93,7 @@ AskUserQuestion({
 ## STEP 5: Création
 
 ```bash
-dotnet ef migrations add "$MIGRATION_NAME" --verbose
+dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
 ```
 
 ---

package/templates/commands/efcore/rebase-snapshot.md

@@ -71,7 +71,7 @@ done
 
 ```bash
 MIGRATION_NAME="${BRANCH_TYPE}_${VERSION}_${BRANCH_NAME}_Consolidated"
-dotnet ef migrations add "$MIGRATION_NAME" --verbose
+dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
 ```
 
 ---

package/templates/commands/efcore/squash.md

@@ -165,6 +165,7 @@ esac
 dotnet ef migrations add "$MIGRATION_NAME" \
   --project "$INFRA_PROJECT" \
   --startup-project "$STARTUP_PROJECT" \
+  -o Persistence/Migrations \
   --verbose
 ```
 

package/templates/commands/refactor.md

@@ -0,0 +1,164 @@
+---
+description: Refactor code by finding files, grouping them, and launching parallel Snipper agents
+argument-hint: <search-pattern-or-description>
+---
+
+<objective>
+Refactor code matching #$ARGUMENTS across the codebase using parallel Snipper agents for maximum speed.
+
+This command finds all relevant files, creates ONE instruction file, then launches Snipper agents in parallel with batches of max 3 files each.
+</objective>
+
+<process>
+
+## Phase 1: Discovery
+
+1. **Parse the refactor request**: Understand what #$ARGUMENTS means
+   - Could be: method name, component name, pattern, code smell, etc.
+   - Identify the search strategy (Grep for code patterns, Glob for file patterns)
+
+2. **Find all affected files**:
+   - Use Grep to search for the pattern in the codebase
+   - Use Glob if searching by file name patterns
+   - Exclude node_modules, .git, dist, build directories
+   - List all files that need refactoring
+
+3. **Analyze scope**:
+   - Count total files found
+   - If more than 15 files, ask user to confirm or narrow scope
+   - Show preview of files to refactor
+
+## Phase 2: Create Instructions
+
+4. **Create task folder**:
+   - Generate unique ID: `refactor-{timestamp}`
+   - Create folder: `.claude/tasks/refactor-{timestamp}/`
+
+5. **Create ONE instruction file**:
+   Create `.claude/tasks/refactor-{id}/instructions.md` with precise, adaptive instructions:
+
+   ```markdown
+   # Refactor Instructions
+
+   ## Objective
+   {Clear description of what to refactor based on #$ARGUMENTS}
+
+   ## What to Change
+   {Specific patterns/code to find and modify}
+
+   ## How to Change
+   {Step-by-step transformation rules}
+
+   ## Rules
+   - Follow existing codebase patterns
+   - No unnecessary comments
+   - Preserve functionality
+   - Only modify what's necessary for this refactor
+   ```
+
+   **IMPORTANT**: Make instructions adaptive - they should work for ANY file in the list.
+
+## Phase 3: Group and Execute
+
+6. **Group files into batches**:
+   - Maximum 3 files per batch
+   - Group by related functionality when possible
+
+7. **Launch Snipper agents in parallel**:
+   For EACH batch, use Task tool with subagent_type='Snipper':
+
+   ```
+   Using the instructions in .claude/tasks/refactor-{id}/instructions.md, refactor these files:
+   - {file_1}
+   - {file_2}
+   - {file_3}
+   ```
+
+   **CRITICAL**: Launch ALL batches in a SINGLE message with multiple Task calls.
+
+8. **Wait for completion**:
+   - All Snipper agents run in parallel
+   - Collect results from each
+
+## Phase 4: Verification
+
+9. **Validate changes**:
+   - Run `pnpm lint` or `npm run lint` to check for errors
+   - Run `pnpm tsc` or `npx tsc` if TypeScript project
+   - Report any failures
+
+10. **Summary report**:
+    - List all files modified
+    - Show any errors encountered
+    - Provide next steps if needed
+
+</process>
+
+<instructions_template>
+Create ONE file at `.claude/tasks/refactor-{id}/instructions.md`:
+
+```markdown
+# Refactor: {title}
+
+## Objective
+{What needs to be refactored - derived from #$ARGUMENTS}
+
+## Pattern to Find
+{Exact code pattern, method name, or structure to locate}
+
+## Transformation
+{How to transform the found pattern - be specific and adaptive}
+
+## Examples
+Before:
+```
+{example of current code}
+```
+
+After:
+```
+{example of refactored code}
+```
+
+## Constraints
+- Only modify code matching the pattern
+- Preserve all existing functionality
+- Follow codebase conventions
+- No comments unless necessary
+```
+</instructions_template>
+
+<snipper_prompt_template>
+For each batch, call Snipper with:
+
+```
+Using the instructions in .claude/tasks/refactor-{id}/instructions.md, refactor these files:
+- {file_path_1}
+- {file_path_2}
+- {file_path_3}
+
+Read the instructions file first, then apply the refactor to each file.
+```
+</snipper_prompt_template>
+
+<success_criteria>
+- All target files identified
+- ONE instruction file created in `.claude/tasks/refactor-{id}/instructions.md`
+- Snipper agents launched in parallel (max 3 files per agent)
+- All batches completed successfully
+- Lint/type checks pass
+- Summary provided to user
+</success_criteria>
+
+<example>
+User: `/refactor rename getUserData to fetchUserProfile`
+
+1. Grep finds 12 files containing "getUserData"
+2. Creates `.claude/tasks/refactor-1702489200/`
+3. Creates ONE file: `instructions.md` with rename rules
+4. Groups into 4 batches of 3 files
+5. Launches 4 Snipper agents in parallel, each with:
+   "Using instructions in .../instructions.md, refactor: file1, file2, file3"
+6. Waits for completion, runs lint
+7. Reports: "Refactored 12 files, renamed getUserData to fetchUserProfile"
+</example>

package/templates/project/DependencyInjection.Application.cs.template

@@ -0,0 +1,25 @@
+using Microsoft.Extensions.DependencyInjection;
+
+namespace {{ProjectName}}.Application;
+
+/// <summary>
+/// Dependency injection configuration for client Application layer.
+/// </summary>
+public static class DependencyInjection
+{
+    /// <summary>
+    /// Adds client-specific application services to the DI container.
+    ///
+    /// IMPORTANT: This must be called AFTER AddSmartStackApplication()
+    /// to ensure all Core services are available.
+    /// </summary>
+    public static IServiceCollection Add{{ProjectName}}Application(
+        this IServiceCollection services)
+    {
+        // TODO: Register your application services here
+        // Example:
+        // services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(DependencyInjection).Assembly));
+
+        return services;
+    }
+}

package/templates/project/DependencyInjection.Infrastructure.cs.template

@@ -0,0 +1,61 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Diagnostics;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using {{ProjectName}}.Application.Common.Interfaces;
+using {{ProjectName}}.Infrastructure.Persistence;
+using SmartStack.Infrastructure.Persistence.Configurations;
+
+namespace {{ProjectName}}.Infrastructure;
+
+/// <summary>
+/// Dependency injection configuration for client Infrastructure layer.
+/// </summary>
+public static class DependencyInjection
+{
+    /// <summary>
+    /// Adds client-specific infrastructure services to the DI container.
+    ///
+    /// IMPORTANT: This must be called AFTER AddSmartStackInfrastructure()
+    /// to ensure CoreDbContext is registered first.
+    /// </summary>
+    public static IServiceCollection Add{{ProjectName}}Infrastructure(
+        this IServiceCollection services,
+        IConfiguration configuration)
+    {
+        // ExtensionsDbContext with migrations in 'extensions' schema
+        services.AddDbContext<ExtensionsDbContext>(options =>
+        {
+            options.UseSqlServer(
+                configuration.GetConnectionString("DefaultConnection"),
+                sqlOptions =>
+                {
+                    sqlOptions.MigrationsAssembly(typeof(ExtensionsDbContext).Assembly.FullName);
+
+                    // Store migrations history in extensions schema (separate from Core)
+                    sqlOptions.MigrationsHistoryTable("__EFMigrationsHistory", SchemaConstants.Extensions);
+
+                    // Enable retry policy for transient failures
+                    sqlOptions.EnableRetryOnFailure(
+                        maxRetryCount: 5,
+                        maxRetryDelay: TimeSpan.FromSeconds(10),
+                        errorNumbersToAdd: null);
+
+                    // Set command timeout
+                    sqlOptions.CommandTimeout(60);
+                });
+
+            // Suppress false positive warning for static seed data
+            options.ConfigureWarnings(w => w.Ignore(RelationalEventId.PendingModelChangesWarning));
+        });
+
+        // Register the interface
+        services.AddScoped<IExtensionsDbContext>(provider =>
+            provider.GetRequiredService<ExtensionsDbContext>());
+
+        // TODO: Register your services here
+        // services.AddScoped<IOrderService, OrderService>();
+
+        return services;
+    }
+}