@atlashub/smartstack-cli 4.81.0 → 5.0.0

package/templates/agents/gitflow/pr.md

@@ -1,191 +0,0 @@
----
-name: gitflow-pr
-description: GitFlow pull request creation - fast PR with auto-description
-color: purple
-model: haiku
-tools: Bash, Glob
----
-
-# GitFlow Pull Request Agent
-
-Create PR with auto-generated description, Azure DevOps and GitHub support.
-
-> **OPTIMISED:** haiku model, reduced tools. Access to current context.
-
-## EXECUTION SEQUENCE
-
-### 1. Load GitFlow Config (MANDATORY)
-
-```bash
-# Find and verify config exists
-CONFIG_FILE=""
-if [ -f ".claude/gitflow/config.json" ]; then
-  CONFIG_FILE=".claude/gitflow/config.json"
-else
-  # Repair cross-platform worktree paths before listing (WSL ↔ Windows)
-  # Source: _shared.md DETECT_PLATFORM + REPAIR_WORKTREE_PATHS
-  detect_platform
-  repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
-
-  # Try develop worktree
-  DEVELOP_PATH=$(git worktree list --porcelain 2>/dev/null | grep -A1 "branch refs/heads/develop" | grep "^worktree " | sed 's/^worktree //')
-  if [ -n "$DEVELOP_PATH" ] && [ -f "$DEVELOP_PATH/.claude/gitflow/config.json" ]; then
-    CONFIG_FILE="$DEVELOP_PATH/.claude/gitflow/config.json"
-  fi
-fi
-
-# CRITICAL: Block if no config
-if [ -z "$CONFIG_FILE" ] || [ ! -f "$CONFIG_FILE" ]; then
-  echo "❌ GitFlow config not found"
-  echo "→ Run: /gitflow init"
-  exit 1
-fi
-
-# Extract config values
-GF_PROVIDER=$(grep -oP '"provider":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-GF_MAIN_BRANCH=$(grep -oP '"main":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-GF_DEVELOP_BRANCH=$(grep -oP '"develop":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-GF_REMOTE_URL=$(grep -oP '"remoteUrl":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
-
-# Validate required values
-if [ -z "$GF_MAIN_BRANCH" ] || [ -z "$GF_DEVELOP_BRANCH" ]; then
-  echo "❌ Invalid GitFlow config (missing branches)"
-  exit 1
-fi
-```
-
-### 2. Detect Provider and Branch Context
-
-```bash
-# Detect provider from config or remote URL
-if [ -z "$GF_PROVIDER" ]; then
-  REMOTE_URL=$(git remote get-url origin 2>/dev/null)
-  if [[ "$REMOTE_URL" == *"dev.azure.com"* ]] || [[ "$REMOTE_URL" == *"visualstudio.com"* ]]; then
-    GIT_PROVIDER="azuredevops"
-  else
-    GIT_PROVIDER="github"
-  fi
-else
-  GIT_PROVIDER="$GF_PROVIDER"
-fi
-
-# Extract Azure DevOps details if needed
-if [ "$GIT_PROVIDER" = "azuredevops" ]; then
-  REMOTE_URL="${GF_REMOTE_URL:-$(git remote get-url origin 2>/dev/null)}"
-  [[ "$REMOTE_URL" =~ dev\.azure\.com/([^/]+)/([^/]+)/_git/([^/]+) ]] && {
-    AZURE_ORG="${BASH_REMATCH[1]}"
-    AZURE_PROJECT="${BASH_REMATCH[2]}"
-    AZURE_REPO="${BASH_REMATCH[3]}"
-  }
-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/.*\///')
-```
-
-### 3. Determine Target Branch
-
-```bash
-# Map branch type to target branch (using config values)
-case "$BRANCH_TYPE" in
-  feature) TARGET="$GF_DEVELOP_BRANCH" ;;
-  release) TARGET="$GF_MAIN_BRANCH" ;;
-  hotfix)  TARGET="$GF_MAIN_BRANCH" ;;
-  *)       TARGET="$GF_DEVELOP_BRANCH" ;;
-esac
-
-echo "✓ Config loaded: $CONFIG_FILE"
-echo "✓ Branch: $CURRENT (type: $BRANCH_TYPE)"
-echo "✓ Target: $TARGET"
-```
-
-| Type | Target | Reason |
-|------|--------|--------|
-| `feature/*` | develop | Continuous integration |
-| `release/*` | main | Production deployment |
-| `hotfix/*` | main | Urgent production fix |
-
-### 3. Check Prerequisites
-
-```bash
-# 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
-
-# Check for uncommitted changes → warn user to /gitflow commit first
-# Check if PR already exists → show existing PR and STOP
-```
-
-### 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
-```
-
-### 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')
-```
-
-**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"
-```
-
-### 7. Auto-complete with squash (Azure DevOps release/hotfix)
-
-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
-
-```
-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 created quickly with proper target.

package/templates/agents/gitflow/review.md

@@ -1,49 +0,0 @@
----
-name: gitflow-review
-description: GitFlow review checklist - fast PR review validation
-color: cyan
-model: haiku
-tools: Bash, Glob, Read
----
-
-# GitFlow Review Agent
-
-Checklist rapide de review avant merge.
-
-## Workflow
-
-1. **Lister**: Fichiers modifies
-2. **Verifier**: Build, tests, migrations
-3. **Afficher**: Checklist de validation
-4. **Recommander**: Approve ou Request changes
-
-## Checklist
-
-```
-REVIEW CHECKLIST
-────────────────────────────────────────
-[ ] Build: {pass|fail}
-[ ] Tests: {pass|fail|none}
-[ ] Migrations: {valid|invalid|none}
-[ ] Conflicts: {none|detected}
-[ ] Version: {bumped|not needed}
-────────────────────────────────────────
-RECOMMENDATION: {APPROVE|CHANGES NEEDED}
-```
-
-## Commandes
-
-```bash
-# Build
-dotnet build --no-restore
-
-# Tests
-dotnet test --no-build
-
-# Migrations valides
-dotnet ef migrations list --no-build
-```
-
-## Priority
-
-Speed > Detail. Checklist essentielle seulement.

package/templates/agents/gitflow/start.md

@@ -1,147 +0,0 @@
----
-name: gitflow-start
-description: GitFlow start - create feature/release/hotfix branch with worktree
-color: green
-model: sonnet
-tools: Bash, Read, Glob, Write
----
-
-# GitFlow Start Agent
-
-Create GitFlow branch with worktree and local environment configuration.
-
-## EXECUTION SEQUENCE
-
-### 1. Analyze Context
-
-```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
-# kebab-case, no accents, max 50 chars
-BRANCH_NAME=$(normalize "$input")
-FULL_BRANCH="${type}/${BRANCH_NAME}"
-
-# Check if already exists (local or remote)
-```
-
-### 4. Create Branch + Worktree
-
-> **FORBIDDEN — Numbered directories:**
-> - `03-Release`, `04-Feature`, `05-Hotfix` — NEVER create these
-> - Only `01-Main` and `02-Develop` are numbered (permanent worktrees created at init)
-> - Features go in `{root}/features/{name}`, releases in `{root}/releases/v{version}`, hotfixes in `{root}/hotfixes/{name}`
-> - The path MUST come from `config.json → worktrees.structure.{features|releases|hotfixes}`
-
-```bash
-# 1. Read config (MANDATORY — paths come from here, NEVER improvised)
-read_gitflow_config || { echo "ERROR: No config. Run /gitflow init"; exit 1; }
-
-# 2. Resolve path from CONFIG (NEVER improvise numbered directories)
-case "$branch_type" in
-  feature) WORKTREE_PATH="$GF_FEATURES_PATH/$BRANCH_NAME" ;;
-  release) WORKTREE_PATH="$GF_RELEASES_PATH/v$VERSION" ;;
-  hotfix)  WORKTREE_PATH="$GF_HOTFIXES_PATH/$BRANCH_NAME" ;;
-esac
-
-# 3. Create worktree
-mkdir -p "$(dirname "$WORKTREE_PATH")"
-git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
-
-# 4. POST-CREATION: Repair worktree paths FIRST, then validate
-# Uses repair_worktree_paths from _shared.md REPAIR_WORKTREE_PATHS section
-BARE_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
-[ -n "$BARE_DIR" ] && repair_worktree_paths "$BARE_DIR"
-
-CREATED_PATH=$(git worktree list | grep "$FULL_BRANCH" | awk '{print $1}')
-BASENAME=$(basename "$CREATED_PATH")
-if [[ "$BASENAME" =~ ^[0-9]{2}- ]] && [[ "$BASENAME" != "01-Main" ]] && [[ "$BASENAME" != "02-Develop" ]]; then
-  echo "BLOCKING ERROR: Worktree created with numbered prefix: $CREATED_PATH"
-  echo "Expected path: $WORKTREE_PATH"
-  git worktree remove "$CREATED_PATH" --force
-  git branch -D "$FULL_BRANCH" 2>/dev/null
-  echo "Removed invalid worktree. Recreating at correct path..."
-  git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
-  # Repair again after recreation
-  BARE_DIR=$(git rev-parse --git-common-dir 2>/dev/null)
-  [ -n "$BARE_DIR" ] && repair_worktree_paths "$BARE_DIR"
-fi
-```
-
-### 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
-```
-
-### 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.standalone` pointing to the API port (Vite 7+ forbids "local" as mode name)
-- Add `npm run local` script if missing (uses `--mode standalone`)
-
-**Port allocation:** Hash branch name for unique ports (API: 5200+, Web: 5300+)
-
-### 7. Version Bump (Release/Hotfix only)
-
-For `release/*` and `hotfix/*` branches, invoke the `/version-bump` skill to synchronize all version files:
-
-```bash
-# Extract version from branch name: release/2.8.0 → 2.8.0, hotfix/2.8.1 → 2.8.1
-VERSION=$(echo "$FULL_BRANCH" | sed 's|^[^/]*/||')
-```
-
-Then call: `/version-bump $VERSION`
-
-This updates **all** version sources in sync:
-- `Directory.Build.props` → `<VersionPrefix>X.Y.Z</VersionPrefix>`
-- `web/smartstack-web/package.json` → `"version": "X.Y.Z"`
-- `.claude/gitflow/config.json` → `versioning.current`
-
-> **IMPORTANT**: Do NOT use `npm version` or edit `.csproj` directly. Always use `/version-bump` for unified versioning.
-
-### 8. Summary
-
-```
-{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. Branch ready quickly with local environment configured.

package/templates/agents/gitflow/status.md

@@ -1,95 +0,0 @@
----
-name: gitflow-status
-description: GitFlow status check - fast repository state analysis
-color: cyan
-model: haiku
-tools: Bash, Read, Glob
----
-
-# GitFlow Status Agent
-
-Expert GitFlow. Display COMPLETE repository state with accessible vocabulary.
-
-## Workflow
-
-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
-
-## Commands to Execute
-
-```bash
-# 1. BRANCHES
-git fetch --all --quiet 2>/dev/null
-git for-each-ref --sort=-committerdate --format='%(refname:short)|%(objectname:short)|%(committerdate:short)|%(subject)' refs/heads refs/remotes/origin
-
-# Worktree list (normalize paths for cross-platform WSL/Windows compatibility)
-# Before listing, repair any cross-platform paths in worktree metadata
-detect_platform
-repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
-git worktree list
-
-git branch -vv
-
-# 2. TAGS
-git for-each-ref --sort=-v:refname --format='%(refname:short)|%(creatordate:short)|%(subject)' refs/tags
-git describe --tags --abbrev=0 main 2>/dev/null
-git describe --tags --abbrev=0 develop 2>/dev/null
-
-# 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
-```
-
-## Simplified Vocabulary (IMPORTANT)
-
-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"
-
-## ACTIONS TO DO Generation (CRITICAL)
-
-At the end, ALWAYS generate an "ACTIONS TO DO" section with READY-TO-COPY commands.
-
-### Detection Logic:
-
-| Detected Condition | Action to Propose |
-|--------------------|-------------------|
-| `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 TO DO
-==============================================================================
-
-  Retrieve 3 commits from main into develop
-git merge main
-
-  Clean up release/v1.5.1 (finished, 0 unique commits)
-/gitflow cleanup
-
-==============================================================================
-```
-
-## Priority
-
-Completeness + Clarity > Speed. User must understand the FULL repo state AND know exactly what to do next.

package/templates/agents/mcp-healthcheck.md

@@ -1,163 +0,0 @@
----
-name: mcp-healthcheck
-description: Verifies MCP server availability, version and configuration before operations
-color: cyan
-model: haiku
-tools: Bash, Read, Write, Glob
----
-
-# MCP Health Check Agent
-
-Validates that SmartStack MCP is properly configured and up-to-date before any operation.
-
-> **Note:** The MCP server is now bundled inside `@atlashub/smartstack-cli`. No separate package required.
-
-## Status File
-
-Location: `.claude/mcp-status.json`
-
-```json
-{
-  "lastCheck": "2024-01-15T10:30:00Z",
-  "mcpVersion": "2.0.0",
-  "bundled": true,
-  "status": "ok",
-  "tools": ["validate_conventions", "scaffold_extension", "check_migrations", "..."]
-}
-```
-
-## Workflow
-
-### 1. Check Status File Age
-
-```bash
-# Read last check timestamp
-cat .claude/mcp-status.json 2>/dev/null | grep lastCheck
-```
-
-**Decision:**
-- File missing → Full check required
-- Last check > 7 days → Full check required
-- Last check ≤ 7 days → Quick validation only
-
-### 2. Quick Validation (≤ 7 days)
-
-Test MCP connectivity with a lightweight call:
-
-```
-Call: mcp__smartstack__validate_conventions with checks=["tables"]
-Expected: Response without connection error
-```
-
-If fails → Run full check
-
-### 3. Full Check (> 7 days or missing)
-
-#### 3.1 Verify MCP Server Configuration
-
-```bash
-# Check Claude Code MCP config
-claude mcp list 2>/dev/null | grep -i smartstack
-```
-
-#### 3.2 Test MCP Tools Availability
-
-Call each critical tool to verify availability:
-
-| Tool | Test Call |
-|------|-----------|
-| `validate_conventions` | `checks=["tables"]` |
-| `suggest_migration` | `description="test"` |
-| `check_migrations` | (no params) |
-
-#### 3.3 Check MCP Version
-
-```bash
-# Read version from CLI package (MCP is bundled)
-smartstack --version 2>/dev/null || npx @atlashub/smartstack-cli --version
-```
-
-#### 3.4 Compare with Latest Release
-
-```bash
-# Check npm registry for latest version
-npm view @atlashub/smartstack-cli version 2>/dev/null || echo "Registry check failed"
-```
-
-### 4. Update Status File
-
-```javascript
-Write(".claude/mcp-status.json", {
-  lastCheck: new Date().toISOString(),
-  mcpVersion: "<detected_version>",
-  bundled: true,
-  status: "ok" | "error",
-  tools: ["<available_tools>"],
-  errors: ["<any_errors>"] // if status = error
-})
-```
-
-## Output Format
-
-### Success
-```
-MCP HEALTH CHECK
-  Status: ✓ OK
-  Version: 2.0.0 (bundled in CLI)
-  Last check: 2024-01-15
-  Tools available: 19/19
-```
-
-### Warning (outdated)
-```
-MCP HEALTH CHECK
-  Status: ⚠️ UPDATE AVAILABLE
-  Current: 1.38.0
-  Latest: 2.0.0
-  Action: npm update -g @atlashub/smartstack-cli
-```
-
-### Error
-```
-MCP HEALTH CHECK
-  Status: ❌ ERROR
-  Issue: MCP server not responding
-  Action: claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp
-```
-
-## Integration
-
-This agent should be called:
-1. **Before any MCP-dependent operation** (scaffold, validate, migrate)
-2. **On CLI installation/update**
-3. **Manually via `/mcp healthcheck`**
-
-## Caching Logic
-
-```
-┌─────────────────────┐
-│  Operation Start    │
-└──────────┬──────────┘
-           ▼
-┌─────────────────────┐
-│ Read mcp-status.json│
-└──────────┬──────────┘
-           ▼
-    ┌──────────────┐
-    │ File exists? │
-    └──────┬───────┘
-           │
-     No ───┼─── Yes
-           │     │
-           ▼     ▼
-    ┌──────────────────┐
-    │   > 7 days old?  │
-    └──────┬───────────┘
-           │
-     Yes ──┼─── No
-           │     │
-           ▼     ▼
-┌──────────────┐  ┌──────────────┐
-│  Full Check  │  │ Quick Check  │
-└──────────────┘  └──────────────┘
-```