@atlashub/smartstack-cli 1.11.0 → 1.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "1.11.0",
+  "version": "1.13.1",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",
@@ -61,7 +61,13 @@
     "install:local": "npm run build && node dist/index.js install --local --force",
     "install:global": "npm run build && node dist/index.js install --force",
     "status:local": "node dist/index.js status --local --verbose",
-    "status:global": "node dist/index.js status --verbose"
+    "status:global": "node dist/index.js status --verbose",
+    "doctor": "node dist/index.js doctor",
+    "check-mcp": "node dist/index.js check-mcp",
+    "ralph:start": "node dist/index.js ralph start",
+    "ralph:status": "node dist/index.js ralph status",
+    "ralph:logs": "node dist/index.js ralph logs",
+    "health": "node dist/index.js doctor --json"
   },
   "dependencies": {
     "chalk": "^5.3.0",

package/templates/agents/efcore/squash.md

@@ -8,60 +8,96 @@ tools: Bash, Glob, Read
 
 # EF Core Squash Agent
 
-Merges multiple migrations into one. For releases.
+Consolide plusieurs migrations en une seule, en récupérant le ModelSnapshot de la branche parente.
+
+## Principe Fondamental
+
+```
+RÈGLE D'OR: Toujours récupérer le snapshot de la branche PARENTE
+
+feature/* → snapshot de develop
+develop   → snapshot de main
+release/* → snapshot de main
+hotfix/*  → snapshot de main
+main      → BLOQUÉ (jamais squash)
+```
 
 ## Workflow
 
-1. **List**: All migrations
-2. **Confirm**: Request user validation
-3. **Backup**: Save all files
-4. **Delete**: Old migrations
-5. **Create**: Consolidated migration
-6. **Script**: Generate idempotent SQL
-7. **Validate**: Build OK
+1. **Determine**: Identifier branche parente (`determine_base_branch`)
+2. **List**: Migrations propres à cette branche (pas héritées)
+3. **Confirm**: Demander validation utilisateur
+4. **Backup**: Sauvegarder tous les fichiers
+5. **Fetch**: Récupérer ModelSnapshot de branche parente
+6. **Delete**: Supprimer migrations de la branche
+7. **Create**: Créer migration consolidée
+8. **Validate**: Build + script OK
 
-## Key Commands
+## Commandes Clés
 
 ```bash
+# Déterminer branche parente
+determine_base_branch  # → BASE_BRANCH, BRANCH_TYPE
+
+# Identifier migrations propres à la branche
+BASE_MIGS=$(git ls-tree -r --name-only "origin/$BASE_BRANCH" -- Migrations/)
+LOCAL_MIGS=$(find Migrations -name "*.cs" | grep -v Designer | grep -v Snapshot)
+
 # Backup
 BACKUP_DIR=".claude/gitflow/backup/migrations/squash_$(date +%Y%m%d_%H%M%S)"
-mkdir -p "$BACKUP_DIR"
-cp Migrations/*.cs "$BACKUP_DIR/"
+mkdir -p "$BACKUP_DIR" && cp Migrations/*.cs "$BACKUP_DIR/"
 
-# Delete (except snapshot)
-find Migrations -name "*.cs" -not -name "*Snapshot*" -delete
+# CRUCIAL: Récupérer snapshot parent
+git fetch origin "$BASE_BRANCH"
+git checkout "origin/$BASE_BRANCH" -- Migrations/*ModelSnapshot.cs
 
-# Create consolidated
-dotnet ef migrations add Release_${VERSION}_Initial
+# Supprimer migrations de la branche uniquement
+for mig in $BRANCH_ONLY_MIGRATIONS; do
+  rm -f "Migrations/${mig}"*
+done
 
-# SQL Script
-dotnet ef migrations script --idempotent -o scripts/migrations/release.sql
+# Créer migration consolidée
+dotnet ef migrations add "${BRANCH_TYPE}_${NAME}_Consolidated"
+
+# Valider
+dotnet build && dotnet ef migrations script --idempotent > /dev/null
 ```
 
 ## Safety Checks
 
-- [ ] User confirmation
-- [ ] Backup created
-- [ ] Build OK after squash
-- [ ] SQL script generated
+- [ ] Branche parente identifiée
+- [ ] main/master = BLOQUÉ
+- [ ] User confirmation obtenue
+- [ ] Backup créé
+- [ ] Snapshot parent récupéré
+- [ ] Build OK après squash
+- [ ] Script générable
 
 ## Output Format
 
 ```
-SQUASH
-  Before:  12 migrations
-  After:   1 migration
-  Backup:  .claude/gitflow/backup/migrations/squash_20250102/
-  Script:  scripts/migrations/Release_1_7_0_Initial.sql
+SQUASH - {current_branch}
+  Base:   {BASE_BRANCH} (snapshot récupéré)
+  Avant:  {N} migrations (propres à cette branche)
+  Apres:  1 migration consolidée
+  Backup: .claude/gitflow/backup/migrations/squash_{timestamp}/
 
-WARNING: Production DB - use SQL script
+Prochains: /efcore:db-reset, /efcore:db-deploy
 ```
 
-## Production Warning
+## Cas Particuliers
 
-Never apply directly to a DB that already has migrations.
-Use idempotent SQL script or `--skip-apply`.
+| Situation | Action |
+|-----------|--------|
+| 0 migrations propres | "Rien à squash" - exit |
+| Snapshot identique | Migration vide créée - warning |
+| Build fail | Restaurer backup automatiquement |
+| Sur main/master | BLOQUÉ - exit code 1 |
 
 ## Priority
 
-Safety > Correctness > Speed. Backup mandatory.
+Safety > Correctness > Speed.
+
+1. Backup OBLIGATOIRE (sauf --no-backup)
+2. Snapshot parent OBLIGATOIRE (jamais optionnel)
+3. Restauration auto si échec

package/templates/agents/gitflow/finish.md

@@ -10,81 +10,93 @@ tools: Bash, Read, Glob, Grep, Edit, Write
 
 Finalisation complete de branche GitFlow.
 
+## MODE D'EXÉCUTION
+
+**CRITIQUE:** Tu dois EXECUTER chaque commande git avec l'outil Bash.
+
+- **NE PAS** afficher les commandes a l'utilisateur
+- **EXECUTER** directement via l'outil Bash
+- **AFFICHER** uniquement le resume final
+
 ## Workflow
 
-1. **Verifier**: Branche valide, PR merged, build OK
-2. **Version**: Auto-increment selon type (PATCH pour hotfix)
-3. **Tag**: Creer tag annote avec nouvelle version
-4. **Merge**: Double merge si release/hotfix (main + develop)
-5. **Cleanup**: Supprimer branche + worktree
-6. **Push**: Tags + branches
+1. **Detecter contexte**: Aller au repo principal si dans un worktree
+2. **Verifier PR**: Confirmer que la PR est mergee (via GitHub ou `gh pr list --state merged`)
+3. **Executer selon type**: Feature/Release/Hotfix ont des workflows differents
+4. **Cleanup**: Supprimer branche + worktree
+5. **Resume**: Afficher le resultat final
+
+## Detection PR Mergee
+
+```bash
+# Verifier si PR mergee
+PR_INFO=$(gh pr list --head "$BRANCH" --state merged --json number --jq '.[0]')
+
+# Si pas trouve, verifier si main a ete mis a jour (merge manuel via GitHub)
+if [ -z "$PR_INFO" ]; then
+  git checkout main && git pull origin main
+  # Continuer si les commits sont presents
+fi
+```
 
 ## Actions par Type
 
-| Type | Version | Tag | Merge to |
-|------|---------|-----|----------|
-| Feature | - | - | develop |
-| Release | bump (manual) | vX.Y.Z | main + develop |
-| Hotfix | **AUTO patch** | vX.Y.Z | main + develop |
+| Type | Version | Tag | Merge to | Cleanup |
+|------|---------|-----|----------|---------|
+| Feature | - | - | develop (via PR) | branche + worktree |
+| Release | bump MINOR sur develop | vX.Y.Z | main + develop | branche + worktree |
+| Hotfix | AUTO PATCH | vX.Y.Z | main + develop | branche + worktree |
 
-### Hotfix Versioning (IMPORTANT)
+### Feature Workflow
 
-Pour les hotfixes, le versioning est **AUTOMATIQUE**:
-- Lecture de la version actuelle depuis `package.json`
-- Increment du PATCH: `1.7.1` → `1.7.2`
-- Mise a jour de `package.json`
-- Commit du bump
-- Creation du tag avec la nouvelle version
-- Push main + tag
-- Merge back vers develop
+```bash
+git checkout develop && git pull origin develop
+git branch -d feature/xxx
+git push origin --delete feature/xxx
+git worktree remove ../features/xxx --force
+```
 
-## Commandes
+### Release Workflow
 
 ```bash
-# IMPORTANT: Detecter et revenir au repo principal si dans un worktree
-MAIN_WORKTREE=$(git worktree list --porcelain | grep -m1 "^worktree " | sed 's/worktree //')
-cd "$MAIN_WORKTREE"
-
-# Tag annote
-git tag -a v{version} -m "Release {version}
-
-Changes:
-- {liste commits}"
-
-# Double merge release
-git checkout main && git merge --no-ff release/{version}
-git checkout develop && git merge --no-ff release/{version}
-
-# Cleanup worktree (nouvelle structure organisee)
-WORKTREE_BASE="../worktrees"
-# Feature: ../worktrees/features/{name}
-# Release: ../worktrees/releases/v{version}
-# Hotfix:  ../worktrees/hotfixes/{name}
-git worktree remove "${WORKTREE_BASE}/{type}s/{name}" --force
-git branch -d {branch}
+git checkout main && git pull origin main
+git tag -a "v$VERSION" -m "Release v$VERSION"
+git push origin "v$VERSION"
+git checkout develop && git pull origin develop
+git merge main --no-ff -m "chore: merge release back to develop"
+# Bump MINOR version
+npm version X.Y+1.0 --no-git-tag-version
+git commit -m "chore: bump develop to vX.Y+1.0"
+git push origin develop
+# Cleanup
 ```
 
-## Generation Script SQL (Release/Hotfix)
+### Hotfix Workflow
 
 ```bash
-dotnet ef migrations script --idempotent -o ./scripts/migrations/{type}_{version}.sql
+git checkout main && git pull origin main
+# Auto-increment PATCH
+npm version X.Y.Z+1 --no-git-tag-version
+git commit -m "chore: bump version"
+git tag -a "v$NEW_VERSION" -m "Hotfix v$NEW_VERSION"
+git push origin main "v$NEW_VERSION"
+git checkout develop && git merge main --no-ff
+git push origin develop
+# Cleanup
 ```
 
 ## Output Format
 
+A la fin, afficher UNIQUEMENT:
+
 ```
-BRANCH FINISHED
-  Type: {type}
-  Version: {version}
-  Tag: v{version}
-  Script: ./scripts/migrations/{file}.sql
-  Merged: main, develop
-  Deleted: {branch}
-  Worktree: ../worktrees/{type}s/{name} (supprime)
-
-DEPLOYED TO: (manual steps)
-  1. Push tags: git push --tags
-  2. Deploy script to production
+{TYPE} FINALISÉ ✓
+- Branche: {branch}
+- Tag: v{version} (ou N/A)
+- Merge back: develop ✓ (ou N/A)
+- Worktree: nettoyé ✓
+
+→ Prochain: /gitflow:10-start feature {name}
 ```
 
 ## Priority