@atlashub/smartstack-cli 1.1.0

package/templates/commands/gitflow/3-commit.md

@@ -0,0 +1,194 @@
+---
+description: Phase 3 - Smart commit with EF Core migration validation
+agent: gitflow-commit
+model: sonnet
+args: [message]
+---
+
+# Phase 3: COMMIT - Migration-aware commits
+
+You are an expert in GitFlow and EF Core. Manage commits with validation of .NET migrations.
+
+> **CLAUDE INSTRUCTION:** The `AskUserQuestion({...})` blocks below are instructions for using the `AskUserQuestion` tool **interactively**. You MUST execute the tool with these parameters to get the user's response BEFORE continuing. DO NOT display this code - WAIT for the response.
+
+**Argument:** `$ARGUMENTS` = commit message (optional, generated if absent)
+
+---
+
+## Workflow
+
+### 1. Analyze files
+
+- Staged files
+- Modified files not staged
+- Untracked files
+- Detect migration files in each category
+
+### 2. Validate migrations
+
+A valid EF Core migration = **3 files** :
+- `{Timestamp}_{Name}.cs` - Main migration
+- `{Timestamp}_{Name}.Designer.cs` - Metadata
+- `{Context}ModelSnapshot.cs` - Model state
+
+**Checks:**
+- All 3 files are present
+- Build compiles (`dotnet build`)
+- No ModelSnapshot conflicts with develop
+
+### 3. ⚠️ SAFETY CHECK - Destructive operations
+
+**BLOCKING** - Scan migrations for dangerous operations :
+
+```bash
+# Patterns to detect in migration .cs files
+grep -n "DropTable\|DropColumn\|DropIndex\|DropForeignKey\|DeleteData" {migration}.cs
+grep -n "migrationBuilder.Sql" {migration}.cs | grep -i "DELETE\|DROP\|TRUNCATE"
+```
+
+**If detected :**
+
+```
+╔══════════════════════════════════════════════════════════╗
+║  ⛔ DESTRUCTIVE OPERATIONS DETECTED                       ║
+╠══════════════════════════════════════════════════════════╣
+║  File: {migration}.cs                                    ║
+║  Line {X}: DropTable("Users")                            ║
+║  Line {Y}: DropColumn("Email", "Customers")              ║
+╠══════════════════════════════════════════════════════════╣
+║  RISKS:                                                  ║
+║  - Irreversible data loss                                ║
+║  - Verify that you have a BACKUP                         ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+**Actions:**
+1. Display detailed alert (file, line, operation)
+2. Request explicit confirmation: "Do you confirm? (yes/no)"
+3. If "no" → Cancel commit
+4. If "yes" → Log in [.claude/gitflow/logs/](.claude/gitflow/logs/)`dangerous-migrations.json`
+5. Continue commit
+
+**Dangerous patterns:**
+
+| Pattern | Risk | Level |
+|---------|------|-------|
+| `DropTable` | Delete entire table | CRITICAL |
+| `DropColumn` | Data loss in column | CRITICAL |
+| `DeleteData` | Delete rows | CRITICAL |
+| `DropForeignKey` | Break integrity | HIGH |
+| `DropIndex` | Performance impact | MEDIUM |
+| `Sql("DELETE...")` | Raw destructive SQL | CRITICAL |
+| `Sql("DROP...")` | Raw destructive SQL | CRITICAL |
+| `Sql("TRUNCATE...")` | Empty table | CRITICAL |
+
+### 4. Classify commit
+
+| Files | Type | Prefix |
+|-------|------|--------|
+| Migrations only | migration | `db(migrations):` |
+| Migrations + code | mixed | `feat:` or `fix:` |
+| Code without migration | code | Based on branch type |
+| Config/docs | chore | `chore:` |
+
+### 5. Generate message (if absent)
+
+**Migration:**
+```
+db(migrations): {action} {description}
+
+Migration: {MigrationName}
+Tables: {CREATE|ALTER|DROP} {tables}
+Context: {DbContext}
+```
+
+**Mixed:**
+```
+feat({scope}): {description}
+
+- {changes}
+Migrations: {list}
+```
+
+### 6. Execute commit
+
+- Add missing migration files if necessary
+- Verify one last time
+- Commit with message
+
+### 7. Post-commit
+
+- Verify no migration files are left uncommitted
+- Display summary
+
+### 8. Automatic push (based on config)
+
+Read config: `.claude/gitflow/config.json` → `workflow.push.afterCommit`
+
+**Worktree detection:**
+```bash
+# If git-common-dir != .git → it's a worktree
+COMMON_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
+if [[ "$COMMON_DIR" != ".git" && "$COMMON_DIR" != "." ]]; then
+  IS_WORKTREE=true
+fi
+```
+
+**Push logic:**
+
+| Config `afterCommit` | Worktree | Action |
+|---------------------|----------|--------|
+| `worktree` | Yes | Automatic push |
+| `worktree` | No | Ask user |
+| `always` | - | Automatic push |
+| `ask` | - | Ask user |
+| `never` | - | Do not push |
+
+**If user is asked:**
+```
+AskUserQuestion({
+  questions: [{
+    question: "Do you want to push this commit?",
+    header: "Push",
+    options: [
+      { label: "Yes, push now", description: "git push origin <branch>" },
+      { label: "No, later", description: "Local commit only" }
+    ],
+    multiSelect: false
+  }]
+})
+```
+
+**Execute push:**
+```bash
+git push origin $(git branch --show-current)
+```
+
+**Push error handling:**
+- If remote not configured → Skip with message
+- If rebase necessary → Warn and suggest:
+  ```
+  /gitflow:4-plan rebase
+  ```
+- If branch protected → Warn (PR required)
+
+---
+
+## Common errors
+
+| Error | Solution |
+|-------|----------|
+| ModelSnapshot missing | Add the file |
+| Designer missing | Add the file |
+| Build fails | `dotnet ef migrations remove` + fix |
+| Conflict detected | Rebase first |
+| **Destructive operation** | Confirm or modify migration |
+
+## Modes
+
+| Command | Action |
+|---------|--------|
+| `/gitflow:3-commit {msg}` | Commit with message |
+| `/gitflow:3-commit` | Auto generate message |
+| `/gitflow:3-commit --validate` | Validate without commit |
+| `/gitflow:3-commit --dry-run` | Simulation |

package/templates/commands/gitflow/4-plan.md

@@ -0,0 +1,145 @@
+---
+description: Phase 4 - Generate integration plan with versioning and EF Core analysis
+agent: gitflow-plan
+model: sonnet
+---
+
+# Phase 4: PLAN - Integration Planning
+
+Tu es expert GitFlow et EF Core. Cree un plan d'integration pour la branche courante.
+
+---
+
+## Pre-validation (OBLIGATOIRE)
+
+**Verifier la branche courante AVANT toute action:**
+
+```bash
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Branches autorisees: feature/*, release/*, hotfix/*
+if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
+  echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
+  echo ""
+  echo "Branche actuelle: $BRANCH"
+  echo "Branches autorisees: feature/*, release/*, hotfix/*"
+  echo ""
+  echo "Pour creer une branche:"
+  echo "  /gitflow:10-start feature \"description\""
+  echo "  /gitflow:10-start release \"v1.x.0\""
+  echo "  /gitflow:10-start hotfix \"correctif\""
+  exit 1
+fi
+```
+
+**Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
+
+---
+
+## Workflow
+
+### 1. Analyser contexte
+
+**Git:**
+- Branche courante et type (feature/release/hotfix)
+- Commits depuis divergence avec develop/main
+- Fichiers modifies
+
+**Version:**
+- Lire depuis source configuree (csproj, VERSION, etc.)
+- Calculer nouvelle version selon type branche
+
+**EF Core:**
+- Migrations sur cette branche
+- Migrations sur develop (absentes ici)
+- Conflit ModelSnapshot? (modifie des deux cotes)
+
+### 2. Determiner strategie
+
+**Feature → Develop:**
+| Condition | Strategie |
+|-----------|-----------|
+| Pas de migrations | Rebase + Merge --no-ff |
+| Migrations sans conflit | Rebase + Merge --no-ff |
+| Conflit ModelSnapshot | Rebase + Remove migration + Re-add |
+
+**Release → Main + Develop:**
+| Condition | Strategie |
+|-----------|-----------|
+| Release stable | Tag v{VERSION} + Double merge |
+| Migrations pending | Script SQL idempotent |
+| Version | Auto-increment minor |
+
+**Hotfix → Main + Develop:**
+| Condition | Strategie |
+|-----------|-----------|
+| Migration urgente | Prefix `Hotfix_` + Script SQL |
+| Version | Auto-increment patch |
+
+### 3. Generate plan file
+
+Create plan in [.claude/gitflow/plans/](.claude/gitflow/plans/) named `{type}-{nom}_{date}.md`:
+
+````markdown
+# Plan: {BRANCH_NAME}
+
+## Meta
+- **Source**: {branch} → **Cible**: {target}
+- **Version**: {current} → {new}
+
+## Analyse
+| Git | EF Core |
+|-----|---------|
+| {n} commits | {n} migrations |
+| {n} fichiers | Conflit: {oui|non} |
+
+## Pre-requis
+- [ ] Working dir propre
+- [ ] Build OK
+- [ ] Tests OK
+
+## Etapes
+1. Preparation (fetch, backup)
+2. Migrations (si conflit: remove + rebase + re-add)
+3. Integration (rebase/merge selon strategie)
+4. Version (tag + update fichier source)
+5. Validation (build, tests, migrations list)
+
+## Rollback
+Reset au commit initial + restore migrations backup
+
+## Executer
+
+```
+/gitflow:5-exec {fichier_plan}
+```
+````
+
+### 4. Afficher resume
+
+````
+Plan genere: .claude/gitflow/plans/{name}.md
+
+Branche: {source} → {target}
+Version: {current} → {new}
+Strategie: {rebase|merge|remove+readd}
+
+Executez:
+
+```
+/gitflow:5-exec
+```
+````
+
+---
+
+## Cas speciaux
+
+**Migrations sur les deux branches:**
+- Merger develop d'abord
+- Resoudre conflits ModelSnapshot
+- `dotnet ef migrations add MergeSnapshot --force`
+
+**Hotfix avec migration:**
+- Prefix migration `Hotfix_`
+- Script SQL FROM derniere migration main

package/templates/commands/gitflow/5-exec.md

@@ -0,0 +1,147 @@
+---
+description: Phase 5 - Execute plan with versioning auto-increment
+agent: gitflow-exec
+model: sonnet
+args: [plan_file]
+---
+
+# Phase 5: EXEC - Plan Execution
+
+Tu es expert GitFlow et EF Core. Execute le plan d'integration de maniere securisee.
+
+**Argument:** `$ARGUMENTS` = chemin plan (optionnel, prend le plus recent)
+
+---
+
+## Pre-validation (OBLIGATOIRE)
+
+**Verifier la branche courante AVANT toute action:**
+
+```bash
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Branches autorisees: feature/*, release/*, hotfix/*
+if [[ ! $BRANCH =~ ^(feature|release|hotfix)/ ]]; then
+  echo "ERREUR: Cette commande ne peut etre executee que depuis une branche GitFlow"
+  echo ""
+  echo "Branche actuelle: $BRANCH"
+  echo "Branches autorisees: feature/*, release/*, hotfix/*"
+  echo ""
+  echo "Vous devez etre sur la branche source du plan pour l'executer."
+  echo "Utilisez: git checkout {branche-source}"
+  exit 1
+fi
+```
+
+**Si branche invalide:** Afficher l'erreur et STOPPER. Ne pas continuer le workflow.
+
+---
+
+## Workflow
+
+### 1. Load plan
+
+- Find plan file (argument or most recent in [.claude/gitflow/plans/](.claude/gitflow/plans/))
+- Extract: source branch, target, initial commit, version
+
+### 2. Verifier pre-requis
+
+- Working directory propre
+- Sur la bonne branche
+- Build OK
+- Plan valide
+
+### 3. Create checkpoint (on source branch)
+
+Save checkpoint in [.claude/gitflow/logs/](.claude/gitflow/logs/)`checkpoint_{timestamp}.json`:
+- Branch, commit, plan, status
+- Backup migrations if present
+- **IMPORTANT: Commit checkpoint on source branch BEFORE merge**
+
+```bash
+git add .claude/gitflow/logs/checkpoint_{timestamp}.json
+git commit -m "chore(gitflow): create integration checkpoint"
+```
+
+### 4. Executer etapes
+
+**Rebase (si necessaire):**
+- Fetch origin
+- Rebase sur target
+- Si conflit ModelSnapshot: accept theirs + regenerer migration
+
+**Merge:**
+- Checkout target (utiliser worktree si necessaire: `git -C {worktree_path}`)
+- Pull
+- Merge --no-ff source
+
+**Release/Hotfix - Version:**
+1. Lire version depuis source configuree (csproj, VERSION, etc.)
+2. Creer tag avec version actuelle
+3. Calculer nouvelle version (minor pour release, patch pour hotfix)
+4. Mettre a jour le fichier source
+5. Sync config.json
+
+**Release - Double merge:**
+- Merge sur main
+- Tag
+- Merge main sur develop
+
+### 5. Archiver plan (sur target branch)
+
+**IMPORTANT: Toujours archiver et commiter sur la branche cible AVANT le push**
+
+```bash
+# Sur target branch (develop)
+mv .claude/gitflow/plans/{plan}.md .claude/gitflow/plans/{plan}_DONE_{timestamp}.md
+# Mettre a jour checkpoint avec status "completed"
+git add .claude/gitflow/logs/ .claude/gitflow/plans/
+git commit -m "chore(gitflow): archive integration plan and checkpoint"
+```
+
+### 6. Push
+
+- Push target branch
+- Push tag(s)
+- Verifier CI/CD declenche
+
+### 7. Validation
+
+- Build OK
+- Tests OK (si disponibles)
+- Migrations list correcte
+- Historique git correct
+
+### 8. Finaliser
+
+- Afficher resume et prochaines etapes
+- Suggerer nettoyage branche source si applicable
+
+---
+
+## Gestion conflits ModelSnapshot
+
+Si conflit pendant rebase:
+1. Accepter version develop: `git checkout --theirs */Migrations/*ModelSnapshot.cs`
+2. Regenerer migration: `dotnet ef migrations add {NomMigration}`
+3. Continuer rebase: `git rebase --continue`
+
+---
+
+## Modes
+
+| Commande | Action |
+|----------|--------|
+| `/gitflow:5-exec` | Plan le plus recent |
+| `/gitflow:5-exec {plan}` | Plan specifie |
+| `/gitflow:5-exec --yes` | Sans confirmations |
+| `/gitflow:5-exec --dry-run` | Simulation |
+| `/gitflow:5-exec --resume` | Reprendre execution interrompue |
+
+## Rollback rapide
+
+Si echec:
+
+```
+/gitflow:6-abort --checkpoint
+```