@atlashub/smartstack-cli 2.8.0 → 3.0.0

package/templates/agents/gitflow/merge.md

@@ -8,55 +8,87 @@ tools: Bash, Read, Glob, Grep, Edit
 
 # GitFlow Merge Agent
 
-Merge securise avec validation complete.
+Safe PR merge with review checklist. Supports GitHub and Azure DevOps.
 
-## Workflow
+## EXECUTION SEQUENCE
 
-1. **Verifier**: PR approved, checks pass
-2. **Sync**: Fetch + rebase si necessaire
-3. **Merge**: Selon strategie configuree
-4. **Tag**: Si release/hotfix
-5. **Cleanup**: Supprimer branche si configure
+### 1. Detect Provider and Load PR Context
 
-## Strategies
+```bash
+REMOTE_URL=$(git remote get-url origin 2>/dev/null)
+if [[ "$REMOTE_URL" == *"dev.azure.com"* ]]; then
+  GIT_PROVIDER="azuredevops"
+else
+  GIT_PROVIDER="github"
+fi
+
+CURRENT=$(git rev-parse --abbrev-ref HEAD)
+BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
+
+# Find PR for current branch
+# GitHub: gh pr list --head "$CURRENT"
+# Azure DevOps: az repos pr list --source-branch "$CURRENT"
+```
+
+### 2. Determine Merge Strategy
 
-| Type | Strategie |
-|------|-----------|
-| Feature | Squash ou merge --no-ff |
-| Release | Merge --no-ff + tag + merge to develop |
-| Hotfix | Merge --no-ff + tag + cherry-pick to develop |
+| Type | Strategy | Delete Branch |
+|------|----------|---------------|
+| Feature | squash | yes |
+| Release | merge --no-ff | yes |
+| Hotfix | merge --no-ff | yes |
 
-## Validation Pre-Merge
+### 3. Review Checklist
 
-- PR approved
-- Checks pass (CI)
-- No conflicts
-- Version bumped (release/hotfix)
+Display review checklist:
+- Build status (pass/fail)
+- Tests (pass/fail/none)
+- Migrations (valid/invalid/none)
+- Conflicts (none/detected)
+- CI status (if available)
 
-## Commandes
+### 4. Execute Merge
 
+**GitHub:**
 ```bash
-# Merge avec strategie
-git merge --no-ff {branch} -m "Merge {type}/{name}"
+# Feature (squash)
+gh pr merge $PR_NUMBER --squash --delete-branch
 
-# Tag release
-git tag -a v{version} -m "Release {version}"
+# Release/Hotfix (merge commit)
+gh pr merge $PR_NUMBER --merge --delete-branch
+```
+
+**Azure DevOps:**
+```bash
+# Feature (squash)
+az repos pr update --id $PR_ID --status completed --squash true --delete-source-branch true
+
+# Release/Hotfix (merge commit)
+az repos pr update --id $PR_ID --status completed --squash false --delete-source-branch true
+```
+
+### 5. Verify Merge
+
+```bash
+# Force update tracking refs
+git fetch origin $TARGET:refs/remotes/origin/$TARGET --force --quiet
+git fetch origin --prune --quiet
 
-# Push
-git push origin {target} --tags
+# Verify branch is merged
+MERGED=$(git branch -r --merged origin/$TARGET | grep "$CURRENT" | wc -l)
 ```
 
-## Output Format
+### 6. Summary
 
 ```
-MERGE COMPLETE
-  Source: {branch}
-  Target: {target}
-  Strategy: {merge|squash}
-  Tag: {version|none}
-  Deleted: {branch|kept}
+PR MERGED
+  PR:       #{number}
+  Strategy: {squash|merge}
+  Target:   {target}
+  Branch:   deleted
+  NEXT: /gitflow finish
 ```
 
 ## Priority
 
-Safety > Correctness > Speed. Jamais merger si checks fail.
+Safety > Correctness > Speed. Never merge if checks fail.

package/templates/agents/gitflow/pr.md

@@ -8,78 +8,122 @@ tools: Bash, Glob
 
 # GitFlow Pull Request Agent
 
-Creation rapide de PR avec description auto-generee et detection automatique de la cible.
+Create PR with auto-generated description, Azure DevOps and GitHub support.
 
-## Workflow
+> **OPTIMISED:** haiku model, reduced tools. Access to current context.
 
-1. **Detecter**: Type de branche et cible automatique
-2. **Analyser**: Commits depuis branche base
-3. **Generer**: Titre et description
-4. **Creer**: `gh pr create`
-5. **Retourner**: URL de la PR
+## EXECUTION SEQUENCE
 
-## Detection Cible (GitFlow Standard)
+### 1. Detect Provider and Branch Context
 
 ```bash
-# Detection robuste de la branche courante (compatible worktrees)
-CURRENT=$(git branch --show-current 2>/dev/null)
-if [ -z "$CURRENT" ]; then
-  CURRENT=$(git symbolic-ref --short HEAD 2>/dev/null)
-fi
-if [ -z "$CURRENT" ]; then
-  CURRENT=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
-fi
-
-# Detection automatique selon le type de branche
-if [[ "$CURRENT" == hotfix/* ]]; then
-  TARGET="main"    # Hotfix → main
-elif [[ "$CURRENT" == release/* ]]; then
-  TARGET="main"    # Release → main
+# Detect provider from remote URL
+REMOTE_URL=$(git remote get-url origin 2>/dev/null)
+if [[ "$REMOTE_URL" == *"dev.azure.com"* ]] || [[ "$REMOTE_URL" == *"visualstudio.com"* ]]; then
+  GIT_PROVIDER="azuredevops"
+  # Extract Azure DevOps details
+  [[ "$REMOTE_URL" =~ dev\.azure\.com/([^/]+)/([^/]+)/_git/([^/]+) ]] && {
+    AZURE_ORG="${BASH_REMATCH[1]}"
+    AZURE_PROJECT="${BASH_REMATCH[2]}"
+    AZURE_REPO="${BASH_REMATCH[3]}"
+  }
 else
-  TARGET="develop" # Feature → develop
+  GIT_PROVIDER="github"
 fi
+
+# Get current branch (worktree-compatible)
+CURRENT=$(git branch --show-current 2>/dev/null || git rev-parse --abbrev-ref HEAD)
+BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
+BRANCH_NAME=$(echo $CURRENT | sed 's/.*\///')
 ```
 
-| Type | Cible | Raison |
-|------|-------|--------|
-| `feature/*` | develop | Integration continue |
-| `release/*` | main | Deploiement production |
-| `hotfix/*` | main | Correction urgente production |
+### 2. Determine Target Branch
+
+| Type | Target | Reason |
+|------|--------|--------|
+| `feature/*` | develop | Continuous integration |
+| `release/*` | main | Production deployment |
+| `hotfix/*` | main | Urgent production fix |
 
-## Commandes
+### 3. Check Prerequisites
 
 ```bash
-# Commits a inclure
-git log origin/{TARGET}..HEAD --oneline
+# Ensure branch is pushed
+git fetch origin
+REMOTE_EXISTS=$(git branch -r --list "origin/$CURRENT")
+if [ -z "$REMOTE_EXISTS" ]; then
+  git push -u origin $CURRENT
+  git fetch origin $CURRENT:refs/remotes/origin/$CURRENT --force --quiet
+fi
 
-# Creer PR vers la cible detectee
-gh pr create --base $TARGET --title "{title}" --body "{body}"
+# Check for uncommitted changes → warn user to /gitflow commit first
+# Check if PR already exists → show existing PR and STOP
 ```
 
-## Output Format
+### 4. Build Check
 
+```bash
+# .NET project
+if ls *.sln 2>/dev/null || ls src/*/*.csproj 2>/dev/null; then
+  dotnet build --no-restore || STOP "Build failed"
+
+# Node.js project
+elif [ -f "package.json" ]; then
+  npm run build || STOP "Build failed"
+fi
 ```
-PR CREATED
-  Branch: {branch} -> {base}
-  Commits: {n}
-  URL: {url}
+
+### 5. Generate PR Content
+
+**Title:**
+- feature → `feat: {branch-name}`
+- hotfix → `fix: {branch-name}`
+- release → `release: v{version}`
+
+**Body:** Auto-generate from `git log origin/{TARGET}..HEAD --oneline`
+
+### 6. Create Pull Request
+
+**GitHub:**
+```bash
+gh pr create --base $TARGET --title "$TITLE" --body "$(cat <<'EOF'
+{PR_BODY}
+EOF
+)"
+PR_URL=$(gh pr view --json url --jq '.url')
 ```
 
-## Template Description
+**Azure DevOps:**
+```bash
+az repos pr create \
+  --title "$TITLE" \
+  --description "{PR_BODY}" \
+  --source-branch "$CURRENT" \
+  --target-branch "$TARGET" \
+  --repository "$AZURE_REPO" \
+  --project "$AZURE_PROJECT" \
+  --org "https://dev.azure.com/$AZURE_ORG"
+```
 
-```markdown
-## Summary
-{liste des commits}
+### 7. Auto-complete with squash (Azure DevOps release/hotfix)
 
-## Type
-{feature|hotfix|release}
+For release/hotfix PRs on Azure DevOps, set auto-complete with squash merge:
+```bash
+az repos pr update --id $PR_ID --auto-complete true --squash true --delete-source-branch true
+```
+
+### 8. Summary
 
-## Checklist
-- [ ] Tests pass
-- [ ] Build OK
-- [ ] Migrations valid (si applicable)
+```
+PR CREATED
+  PR:     #{number}
+  Title:  {title}
+  URL:    {url}
+  Source: {branch} -> {target}
+  Provider: {github|azuredevops}
+  NEXT: Wait for review, then /gitflow merge
 ```
 
 ## Priority
 
-Speed > Detail. PR fonctionnelle rapidement.
+Speed > Detail. PR created quickly with proper target.

package/templates/agents/gitflow/start.md

@@ -8,55 +8,98 @@ tools: Bash, Read, Glob, Write
 
 # GitFlow Start Agent
 
-Creation rapide de branche GitFlow avec worktree.
+Create GitFlow branch with worktree and local environment configuration.
 
-## Workflow
+## EXECUTION SEQUENCE
 
-1. **Analyser**: Contexte (branche, version, ahead/behind)
-2. **Choisir**: Type (feature/release/hotfix)
-3. **Creer**: Worktree ou checkout
-4. **Configurer**: appsettings.Local.json + launchSettings.json Local profile si .NET
-5. **Configurer**: .env.local + npm run local si Web
-6. **Verifier ports**: Detecter conflits entre projets
-7. **Resume**: Prochaines etapes
+### 1. Analyze Context
 
-## Commandes
+```bash
+CURRENT_BRANCH=$(git branch --show-current)
+git fetch origin --quiet
+
+VERSION=$(git describe --tags --abbrev=0 2>/dev/null || echo "0.0.0")
+DEVELOP_AHEAD=$(git rev-list --count origin/main..origin/develop 2>/dev/null || echo "0")
+DIRTY=$(git status --porcelain | wc -l)
+```
+
+### 2. Parse Input
+
+| Flag | Type | Base | Target |
+|------|------|------|--------|
+| `-f` | feature | develop | develop |
+| `-r` | release | develop | main |
+| `-h` | hotfix | main | main |
+
+If branch_type or branch_name missing, ask user via AskUserQuestion.
+
+### 3. Normalize and Validate
 
 ```bash
-# Worktree (defaut) - Structure organisee par type
-WORKTREE_BASE="../worktrees"
-mkdir -p "${WORKTREE_BASE}/${TYPE}s"
-WORKTREE_PATH="${WORKTREE_BASE}/${TYPE}s/${NAME}"
+# kebab-case, no accents, max 50 chars
+BRANCH_NAME=$(normalize "$input")
+FULL_BRANCH="${type}/${BRANCH_NAME}"
 
-git worktree add -b {type}/{name} "$WORKTREE_PATH" origin/{base}
+# Check if already exists (local or remote)
+```
 
-# Checkout (--no-worktree)
-git checkout -b {type}/{name} origin/{base}
+### 4. Create Branch + Worktree
+
+```bash
+# Worktree paths from config or convention:
+# feature → ../features/{name}
+# release → ../releases/v{version}
+# hotfix  → ../hotfixes/{name}
+
+git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
+```
+
+### 5. Push Branch to Remote (AUTOMATIC)
+
+```bash
+# ALWAYS push immediately after creation
+cd "$WORKTREE_PATH"
+git push -u origin "$FULL_BRANCH"
+git fetch origin $FULL_BRANCH:refs/remotes/origin/$FULL_BRANCH --force --quiet
 ```
 
-## Detection Projet .NET
+### 6. Local Environment Config
+
+**Backend (.NET API detected):**
+- Create `appsettings.Local.json` with unique DB name + port per branch
+- Add `Local` profile to `launchSettings.json`
+
+**Frontend (web project detected):**
+- Create `.env.local` pointing to the API port
+- Add `npm run local` script if missing
+
+**Port allocation:** Hash branch name for unique ports (API: 5200+, Web: 5300+)
+
+### 7. Version Bump (Release only)
 
 ```bash
-# Si appsettings.json existe
-find . -name "appsettings.json" -not -path "*/bin/*"
+# For release: bump version in source files
+npm version $VERSION --no-git-tag-version  # if package.json
+# OR update .csproj <Version> tag
 ```
 
-## Output Format
+### 8. Summary
 
 ```
-BRANCH CREATED
-  Type: {feature|release|hotfix}
-  Name: {branch}
-  Base: {develop|main}
-  Worktree: ../worktrees/{type}s/{name}
-  Config: {appsettings.Local.json + launchSettings.json Local|skipped}
-  Ports: {✓ OK|⚠️ Conflicts resolved|⚠️ Conflicts ignored}
-
-NEXT STEPS:
-  cd ../worktrees/{type}s/{name}
-  /efcore:db-deploy
+{TYPE} CREATED
+  Branch:   {full_branch}
+  Base:     {base_branch}
+  Worktree: {worktree_path}
+  LOCAL ENVIRONMENT:
+    Database: {db_name}
+    API:      http://localhost:{api_port}
+    Web:      http://localhost:{web_port}
+  NEXT STEPS:
+    cd {worktree_path}
+    dotnet run --project src/{Project}.Api --launch-profile Local
+    /gitflow commit
 ```
 
 ## Priority
 
-Speed > Detail. Branche prete rapidement.
+Speed > Detail. Branch ready quickly with local environment configured.

package/templates/agents/gitflow/status.md

@@ -8,17 +8,17 @@ tools: Bash, Read, Glob
 
 # GitFlow Status Agent
 
-Expert GitFlow. Affiche l'etat COMPLET du repository avec vocabulaire accessible.
+Expert GitFlow. Display COMPLETE repository state with accessible vocabulary.
 
 ## Workflow
 
-1. **Branches**: Lister TOUTES les branches (locales + remote) avec dernier commit
-2. **Tags**: Lister TOUS les tags avec dates et branches associees
-3. **Comparaisons**: Analyser les differences entre develop, main et releases
-4. **EF Core**: Detecter migrations pending
-5. **Output**: Affichage complet et comprehensible
+1. **Branches**: List ALL branches (local + remote) with last commit
+2. **Tags**: List ALL tags with dates
+3. **Comparisons**: Analyze differences between develop, main and releases
+4. **EF Core**: Detect pending migrations
+5. **Output**: Complete and understandable display
 
-## Commandes a executer
+## Commands to Execute
 
 ```bash
 # 1. BRANCHES
@@ -32,88 +32,58 @@ git for-each-ref --sort=-v:refname --format='%(refname:short)|%(creatordate:shor
 git describe --tags --abbrev=0 main 2>/dev/null
 git describe --tags --abbrev=0 develop 2>/dev/null
 
-# 3. COMPARAISONS
-git rev-list --count main..develop 2>/dev/null    # commits sur develop a publier
-git rev-list --count develop..main 2>/dev/null    # commits sur main a recuperer
-git log develop..main --oneline 2>/dev/null       # si main > 0
-
-# Pour chaque release/*
-git branch -a | grep release/
-# Pour chaque: ahead/behind vs develop et main
+# 3. COMPARISONS
+git rev-list --count main..develop 2>/dev/null
+git rev-list --count develop..main 2>/dev/null
 
 # 4. STATUS
 git status --porcelain
 ```
 
-## Vocabulaire simplifie (IMPORTANT)
-
-Utiliser ces termes au lieu du jargon Git:
-- "ahead" → "a publier" ou "prets pour production"
-- "behind" → "a recuperer" ou "manquants"
-- "diverged" → "desynchronise"
-- "merge" → "fusionner" ou "integrer"
-- "branch" → "branche" (garder)
-- "commit" → "changement" ou "modification"
-- "tag" → "version" ou "etiquette de version"
-
-## Output Format
-
-Suivre le format defini dans la commande 2-status.md avec:
-- Tableaux clairs avec bordures
-- Legendes explicatives
-- Actions concretes a faire
-- Pas de jargon technique sans explication
-
-## Generation des ACTIONS A FAIRE (CRITIQUE)
+## Simplified Vocabulary (IMPORTANT)
 
-A la fin de l'affichage, TOUJOURS generer une section "ACTIONS A FAIRE" avec des commandes PRETES A COPIER-COLLER.
+Use these terms instead of Git jargon:
+- "ahead" -> "to publish" / "ready for production"
+- "behind" -> "to retrieve" / "missing"
+- "diverged" -> "desynchronized"
+- "merge" -> "integrate"
+- "commit" -> "change" / "modification"
+- "tag" -> "version"
 
-### Regles de generation:
+## ACTIONS TO DO Generation (CRITICAL)
 
-1. **Analyser l'etat** et generer UNIQUEMENT les actions pertinentes
-2. **Inclure le nom exact** de la branche/feature/release dans la commande
-3. **Format obligatoire** - UNE commande par ligne, facilement copiable:
+At the end, ALWAYS generate an "ACTIONS TO DO" section with READY-TO-COPY commands.
 
-```
-{emoji} {Description claire avec contexte}
-{commande complete prete a copier}
-```
-
-**IMPORTANT**: La commande doit etre sur SA PROPRE LIGNE, sans prefixe, pour etre copiable en un clic.
+### Detection Logic:
 
-### Logique de detection:
-
-| Condition detectee | Action a proposer |
+| Detected Condition | Action to Propose |
 |--------------------|-------------------|
-| `main → develop > 0` | `git merge main` |
-| `develop → main > 0` | `/gitflow:start release v{next_version}` |
-| `feature/* ahead > 0 && behind == 0` | `/gitflow:finish feature/{name}` |
-| `feature/* behind > 5` | `/gitflow:rebase feature/{name}` |
-| `release/* ahead == 0` | `/gitflow:cleanup release/{name}` |
-| `git status dirty` | `/gitflow:commit "{contexte}"` |
-| `local ahead of remote` | `/gitflow:sync {branch}` |
-| `local behind remote` | `/gitflow:sync {branch}` |
-| `migrations pending` | `/efcore:db-deploy` |
-
-### Exemple de sortie:
+| `main -> develop > 0` | `git merge main` |
+| `develop -> main > 0` | `/gitflow -r v{next_version}` |
+| `feature/* ahead > 0 && behind == 0` | `/gitflow finish` |
+| `feature/* behind > 5` | Rebase recommended |
+| `release/* ahead == 0` | `/gitflow cleanup` |
+| `git status dirty` | `/gitflow commit` |
+| `local ahead of remote` | Push recommended |
+| `local behind remote` | Pull recommended |
+| `migrations pending` | Database deploy recommended |
+
+### Example Output:
 
 ```
-══════════════════════════════════════════════════════════════════════════════
- ACTIONS A FAIRE
-══════════════════════════════════════════════════════════════════════════════
+==============================================================================
+ ACTIONS TO DO
+==============================================================================
 
-⚠️ Recuperer 3 commits de main dans develop
+  Retrieve 3 commits from main into develop
 git merge main
 
-🗑️ Nettoyer release/v1.5.1 (terminee, 0 commits uniques)
-/gitflow:cleanup release/v1.5.1
-
-🗑️ Nettoyer release/v1.4.2 (terminee, 0 commits uniques)
-/gitflow:cleanup release/v1.4.2
+  Clean up release/v1.5.1 (finished, 0 unique commits)
+/gitflow cleanup
 
-══════════════════════════════════════════════════════════════════════════════
+==============================================================================
 ```
 
 ## Priority
 
-Completude + Clarte > Vitesse. L'utilisateur doit comprendre TOUT l'etat du repo ET savoir exactement quoi faire ensuite.
+Completeness + Clarity > Speed. User must understand the FULL repo state AND know exactly what to do next.

package/templates/hooks/appsettings-guard.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+
+# Appsettings Guard - PreToolUse Hook
+# Blocks Write operations that would remove top-level sections from appsettings*.json
+# Uses node -e for JSON parsing (no jq dependency)
+
+set -euo pipefail
+
+# Read hook input from stdin
+HOOK_INPUT=$(cat)
+
+# Quick exit: only care about appsettings*.json files (~2ms for non-matching calls)
+case "$HOOK_INPUT" in
+  *appsettings*) ;; # proceed to full check
+  *) exit 0 ;;      # fast exit - not an appsettings file
+esac
+
+# Full check using node (guaranteed available in SmartStack projects)
+RESULT=$(echo "$HOOK_INPUT" | node -e "
+  const fs = require('fs');
+  const input = JSON.parse(fs.readFileSync(0, 'utf8'));
+
+  const toolName = input.tool_name || '';
+  const filePath = (input.tool_input && input.tool_input.file_path) || '';
+  const basename = require('path').basename(filePath);
+
+  // Only guard appsettings*.json files
+  if (!/^appsettings.*\.json$/i.test(basename)) {
+    process.exit(0);
+  }
+
+  // Allow creation of new files (e.g. appsettings.Local.json from /gitflow start)
+  if (!fs.existsSync(filePath)) {
+    process.exit(0);
+  }
+
+  // Only guard Write tool (Edit is safe by design - targeted replacement)
+  if (toolName !== 'Write') {
+    process.exit(0);
+  }
+
+  const newContent = (input.tool_input && input.tool_input.content) || '';
+
+  try {
+    const currentContent = fs.readFileSync(filePath, 'utf8');
+    const currentObj = JSON.parse(currentContent);
+    const newObj = JSON.parse(newContent);
+
+    const currentKeys = Object.keys(currentObj);
+    const newKeys = new Set(Object.keys(newObj));
+    const missing = currentKeys.filter(k => !newKeys.has(k));
+
+    if (missing.length > 0) {
+      const output = {
+        continue: true,
+        hookSpecificOutput: {
+          hookEventName: 'PreToolUse',
+          permissionDecision: 'block',
+          permissionDecisionReason: 'APPSETTINGS GUARD: Write supprimerait ' + missing.length + ' section(s) top-level: ' + missing.join(', ') + '. Utilise le tool Edit pour modifier des valeurs specifiques au lieu de reecrire le fichier entier. Si tu dois ajouter une section, utilise Edit pour inserer avant le } fermant.'
+        }
+      };
+      process.stdout.write(JSON.stringify(output));
+      process.exit(2);
+    }
+  } catch (e) {
+    // JSON parse error on current or new content - allow (tool will handle the error)
+    process.exit(0);
+  }
+" 2>/dev/null) || true
+
+if [ -n "$RESULT" ]; then
+  echo "$RESULT"
+  exit 2
+fi
+
+exit 0

package/templates/hooks/ef-migration-check.md

@@ -99,7 +99,7 @@ exit 0
 
 ## Integration Claude Code
 
-Dans le workflow `/gitflow:3-commit`, avant le commit :
+Dans le workflow `/gitflow commit`, avant le commit :
 
 ```
 1. Detecter migrations modifiees