@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/gitflow/steps/step-pr.md

@@ -1,247 +0,0 @@
----
-name: step-pr
-description: Create pull request with auto-detection
-next_step: null
----
-
-# Step: PR - Create Pull Request
-
-## YOUR TASK:
-
-Create a pull request with proper target, title, and description based on branch type.
-
-**ULTRA THINK about PR requirements.**
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Load Config and Detect Provider
-
-```bash
-# Load GitFlow config (sets GF_* variables)
-read_gitflow_config || { echo "❌ Run /gitflow init first."; exit 1; }
-
-GIT_PROVIDER="$GF_PROVIDER"
-
-# Extract Azure DevOps details if needed
-if [ "$GIT_PROVIDER" = "azuredevops" ]; then
-  [[ "$GF_REMOTE_URL" =~ dev\.azure\.com/([^/]+)/([^/]+)/_git/([^/]+) ]] && {
-    AZURE_ORG="${BASH_REMATCH[1]}"
-    AZURE_PROJECT="${BASH_REMATCH[2]}"
-    AZURE_REPO="${BASH_REMATCH[3]}"
-  }
-fi
-```
-
-### 2. Determine PR Target
-
-```bash
-CURRENT=$(git rev-parse --abbrev-ref HEAD)
-BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
-
-# CRITICAL: Verify config was loaded
-if [ -z "$GF_MAIN_BRANCH" ] || [ -z "$GF_DEVELOP_BRANCH" ]; then
-  echo "❌ GitFlow config not loaded properly"
-  echo "→ Variables GF_MAIN_BRANCH and GF_DEVELOP_BRANCH are empty"
-  exit 1
-fi
-
-# Determine target branch based on type (using config values)
-case "$BRANCH_TYPE" in
-  feature) TARGET_BRANCH="$GF_DEVELOP_BRANCH" ;;
-  release) TARGET_BRANCH="$GF_MAIN_BRANCH" ;;
-  hotfix)  TARGET_BRANCH="$GF_MAIN_BRANCH" ;;
-  *)       TARGET_BRANCH="$GF_DEVELOP_BRANCH" ;;
-esac
-
-echo "✓ Branch: $CURRENT (type: $BRANCH_TYPE)"
-echo "✓ Target: $TARGET_BRANCH"
-```
-
-### 3. Check Prerequisites
-
-```bash
-# Ensure branch is pushed
-git fetch origin
-REMOTE_EXISTS=$(git branch -r --list "origin/$CURRENT")
-[ -z "$REMOTE_EXISTS" ] && {
-  echo "Branch not pushed to remote. Pushing..."
-  git push -u origin $CURRENT
-
-  # CRITICAL: Verify push and update tracking refs
-  git fetch origin $CURRENT:refs/remotes/origin/$CURRENT --force --quiet
-  LOCAL_SHA=$(git rev-parse HEAD)
-  REMOTE_SHA=$(git rev-parse origin/$CURRENT)
-  if [ "$LOCAL_SHA" != "$REMOTE_SHA" ]; then
-    echo "⚠️ Push verification failed - local/remote mismatch"
-    STOP
-  fi
-  echo "✅ Push verified - branch in sync"
-}
-
-# Check for uncommitted changes
-DIRTY=$(git status --porcelain | wc -l)
-[ "$DIRTY" -gt 0 ] && {
-  echo "⚠️ Uncommitted changes detected"
-  echo "→ Run /gitflow commit first"
-  STOP
-}
-
-# Check if PR already exists
-EXISTING_PR=$(gh pr list --head "$CURRENT" --json number --jq '.[0].number' 2>/dev/null)
-[ -n "$EXISTING_PR" ] && {
-  echo "PR #$EXISTING_PR already exists for this branch"
-  echo "→ View: gh pr view $EXISTING_PR"
-  STOP
-}
-```
-
-### 4. Run Pre-PR Checks (BLOCKING)
-
-**4.1 Build validation:**
-```bash
-# Build check (multi-runtime detection)
-echo "Running build check..."
-if [ -f "*.sln" ] || ls *.csproj 2>/dev/null | head -1 > /dev/null; then
-  dotnet build --no-restore 2>&1 || {
-    echo "❌ .NET build failed. Fix before creating PR."
-    STOP
-  }
-elif [ -f "package.json" ]; then
-  npm run build 2>&1 || {
-    echo "❌ npm build failed. Fix before creating PR."
-    STOP
-  }
-fi
-```
-
-**4.2 EF Core Migration Squash Enforcement (BLOCKING):**
-
-> **CRITICAL:** Feature branches MUST have at most 1 migration before creating a PR. This check is MANDATORY when `config.efcore.enabled` is true.
-
-```bash
-# Skip if EF Core is disabled in config
-if [ "$GF_EFCORE_ENABLED" = "true" ]; then
-  if [ "$BRANCH_TYPE" = "feature" ]; then
-    MIGRATION_DIR=$(find . -path "*/Persistence/Migrations" -type d 2>/dev/null | head -1)
-    if [ -n "$MIGRATION_DIR" ]; then
-      NEW_MIGRATIONS=$(git diff --name-only "origin/$TARGET_BRANCH...HEAD" -- "$MIGRATION_DIR" \
-        | grep -E '\.cs$' \
-        | grep -v 'Designer\|ModelSnapshot' \
-        | wc -l)
-
-      if [ "$NEW_MIGRATIONS" -gt 1 ]; then
-        echo ""
-        echo "❌ MULTIPLE MIGRATIONS DETECTED ($NEW_MIGRATIONS migrations)"
-        echo "→ Feature branches must have exactly 1 migration (squashed) before PR"
-        echo "→ Run: /efcore squash"
-        echo ""
-        echo "Migrations found:"
-        git diff --name-only "origin/$TARGET_BRANCH...HEAD" -- "$MIGRATION_DIR" \
-          | grep -E '\.cs$' \
-          | grep -v 'Designer\|ModelSnapshot'
-        STOP
-      elif [ "$NEW_MIGRATIONS" -eq 1 ]; then
-        echo "✓ Single migration detected (squashed)"
-      else
-        echo "✓ No migrations in this feature"
-      fi
-    fi
-  fi
-fi
-```
-
-### 5. Generate PR Content
-
-See [references/pr-generation.md](../references/pr-generation.md) for:
-- PR title generation (feat/fix/release format)
-- PR body template with summary, changes, testing, migrations
-
-### 6. Create Pull Request
-
-**GitHub:**
-```bash
-gh pr create \
-  --title "$TITLE" \
-  --body "$(cat <<'EOF'
-{PR_BODY}
-EOF
-)" \
-  --base "$TARGET_BRANCH" \
-  --head "$CURRENT"
-
-PR_URL=$(gh pr view --json url --jq '.url')
-PR_NUMBER=$(gh pr view --json number --jq '.number')
-```
-
-**Azure DevOps:**
-```bash
-az repos pr create \
-  --title "$TITLE" \
-  --description "{PR_BODY}" \
-  --source-branch "$CURRENT" \
-  --target-branch "$TARGET_BRANCH" \
-  --repository "$AZURE_REPO" \
-  --project "$AZURE_PROJECT" \
-  --org "https://dev.azure.com/$AZURE_ORG"
-
-PR_ID=$(az repos pr list --source-branch "$CURRENT" --query "[0].pullRequestId" -o tsv)
-```
-
-### 7. Add Labels (GitHub)
-
-Auto-label PRs (enhancement/bug/priority/release) based on branch type.
-
-### 8. Store PR Info
-
-See [references/pr-generation.md](../references/pr-generation.md) for:
-- PR state persistence to cache for merge step
-
-### 9. Summary
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    PULL REQUEST CREATED                           ║
-╠══════════════════════════════════════════════════════════════════╣
-║  PR:     #{PR_NUMBER}                                             ║
-║  Title:  {TITLE}                                                  ║
-║  URL:    {PR_URL}                                                 ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Source: {CURRENT}                                                ║
-║  Target: {TARGET_BRANCH}                                          ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Checks:                                                          ║
-║  - Build: ✅                                                      ║
-║  - Migrations: {status}                                           ║
-╠══════════════════════════════════════════════════════════════════╣
-║  NEXT STEPS:                                                      ║
-║  1. Wait for CI checks                                            ║
-║  2. Request review                                                ║
-║  3. After approval: /gitflow merge                                ║
-╚══════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## ERROR HANDLING:
-
-| Error | Solution |
-|-------|----------|
-| Branch not pushed | Auto-push before PR |
-| PR already exists | Show existing PR |
-| Build fails | Fix and re-run |
-| No git provider | Manual PR creation |
-
----
-
-## SUCCESS CRITERIA:
-
-- PR created with proper target
-- Title and body generated
-- Labels added (if GitHub)
-- PR number stored for merge step
-
-## NEXT STEP:
-
-Wait for review, then `/gitflow merge`.

package/templates/skills/gitflow/steps/step-start.md

@@ -1,195 +0,0 @@
----
-name: step-start
-description: Create new branch with worktree
-next_step: null
----
-
-# Step: START - Create Branch
-
-## YOUR TASK:
-
-Create a new feature/release/hotfix branch with optional worktree setup.
-
-**ULTRA THINK about branch naming and base selection.**
-
----
-
-## INPUT PARSING:
-
-```
-{branch_type} = feature | release | hotfix
-{branch_name} = normalized name (kebab-case)
-{no_worktree} = --no-worktree flag present
-```
-
-**From flags:**
-- `-f {name}` → branch_type=feature, branch_name={name}
-- `-r {name}` → branch_type=release, branch_name={name}
-- `-h {name}` → branch_type=hotfix, branch_name={name}
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Load Config and Analyze Context
-
-Load GitFlow config. Display current branch, version, tag, and dirty status.
-
-### 2. Interactive Questions (if no args)
-
-Ask for branch type (feature/release/hotfix) and name if not provided via args. Display suggested next version for releases.
-
-### 3. Normalize and Validate
-
-See [references/start-branch-normalization.md](../references/start-branch-normalization.md) for:
-- Branch name normalization (kebab-case)
-- Branch existence validation
-
-### 4. Determine Base Branch
-
-| Type | Base | Target |
-|------|------|--------|
-| feature | develop | develop |
-| release | develop | main |
-| hotfix | main | main |
-
-### 5. Handle Dirty Working Directory
-
-Offer user to stash, commit, or continue if working directory has changes.
-
-### 5b. EF Core Migration Pre-flight (Release/Hotfix only)
-
-**BLOCKING CHECK: Validate migration naming conventions BEFORE creating the release branch.**
-
-See [references/start-efcore-preflight.md](../references/start-efcore-preflight.md) for the full validation script and user choice handling.
-
-Expected format: `{context}_v{version}_{sequence}_{Description}` (e.g., `core_v2.0.0_001_InitialSchema`)
-
----
-
-### 6. Create Branch and Worktree
-
-See [references/start-worktree-creation.md](../references/start-worktree-creation.md) for:
-- Worktree path selection (organized mode)
-- Numbering rules (only 01-Main/02-Develop, no numbered feature/release/hotfix)
-- Cross-platform path repair
-- Worktree validation
-- No-worktree mode fallback
-
-### 6b. Push Branch to Remote (AUTOMATIC)
-
-**ALWAYS push immediately after branch creation:**
-```bash
-git push -u origin "$FULL_BRANCH"
-
-# CRITICAL: Verify push and update tracking refs
-git fetch origin $FULL_BRANCH:refs/remotes/origin/$FULL_BRANCH --force --quiet
-LOCAL_SHA=$(git rev-parse HEAD)
-REMOTE_SHA=$(git rev-parse origin/$FULL_BRANCH)
-if [ "$LOCAL_SHA" = "$REMOTE_SHA" ]; then
-  echo "✅ Branch pushed and verified - origin/$FULL_BRANCH in sync"
-else
-  echo "⚠️ Push verification failed"
-  echo "  Local:  $LOCAL_SHA"
-  echo "  Remote: $REMOTE_SHA"
-fi
-```
-
-### 7. Create Local Environment Config (Backend + Frontend)
-
-See [references/start-local-config.md](../references/start-local-config.md) for the full configuration:
-- **Port generation:** Unique ports per branch (API: 5200+, Web: 5300+) based on branch name hash
-- **7a. Backend:** `appsettings.Local.json` (DB connection, SmartStack config, Kestrel port)
-- **7b. Frontend:** `.env.standalone` + `npm run local` script (Vite mode=standalone, not "local" which conflicts with .env.local in Vite 7+)
-- **7c. Backend:** `launchSettings.json` Local profile with unique port
-- **7d. Summary:** Display configured DB name, API port, Web port
-
-### 8. Store State
-
-```bash
-# Save to state for next steps
-{
-  "branch_type": "{branch_type}",
-  "branch_name": "{FULL_BRANCH}",
-  "base_branch": "{BASE_BRANCH}",
-  "target_branch": "{TARGET}",
-  "worktree_path": "{WORKTREE_PATH}",
-  "version_current": "{VERSION}",
-  "local_config": {
-    "database": "{DB_NAME}",
-    "api_port": "{API_PORT}",
-    "web_port": "{WEB_PORT}",
-    "api_dir": "{API_DIR}",
-    "web_dir": "{WEB_DIR}"
-  }
-}
-```
-
-### 9. Summary
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    {BRANCH_TYPE} CREATED                          ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Branch:   {FULL_BRANCH}                                          ║
-║  Base:     {BASE_BRANCH}                                          ║
-║  Target:   {TARGET}                                               ║
-║  Worktree: {WORKTREE_PATH}                                        ║
-╠══════════════════════════════════════════════════════════════════╣
-║  LOCAL ENVIRONMENT:                                               ║
-║  Database: {DB_NAME}                                              ║
-║  API:      http://localhost:{API_PORT}                            ║
-║  Web:      http://localhost:{WEB_PORT}                            ║
-╠══════════════════════════════════════════════════════════════════╣
-║  NEXT STEPS:                                                      ║
-║                                                                    ║
-║  1. Go to worktree:                                               ║
-║     cd {WORKTREE_PATH}                                            ║
-║                                                                    ║
-║  2. Start backend (auto-migrates Core + Extensions DB):           ║
-║     dotnet run --project src/{Project}.Api --launch-profile Local ║
-║                                                                    ║
-║  3. Reset admin password:                                         ║
-║     ss admin reset                                                ║
-║                                                                    ║
-║  4. Start frontend (other terminal):                              ║
-║     cd web/{project}-web && npm run local                         ║
-║                                                                    ║
-║  5. Make changes and commit:                                      ║
-║     /gitflow commit                                               ║
-║                                                                    ║
-║  6. Create pull request:                                          ║
-║     /gitflow pr                                                   ║
-║                                                                    ║
-║  7. After PR merged, finalize:                                    ║
-║     /gitflow finish                                               ║
-╚══════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## ERROR HANDLING:
-
-| Error | Solution |
-|-------|----------|
-| Branch exists | Offer: rename, checkout, or delete |
-| Dirty working directory | Offer: stash, commit, or continue |
-| Worktree path exists | Remove orphan or use different path |
-| Base branch behind remote | Pull before creating |
-
----
-
-## SUCCESS CRITERIA:
-
-- Branch created from correct base
-- **Branch pushed to remote (AUTOMATIC)**
-- Worktree set up (if enabled)
-- Backend local config created: `appsettings.Local.json` (if .NET API detected)
-- Backend launch profile created: `launchSettings.json` Local profile with unique port (if .NET API detected)
-- Frontend local config created: `.env.standalone` + `npm run local` script (if web project detected)
-- Ports synchronized between backend and frontend (unique per branch)
-- State stored for subsequent steps
-
-## NEXT STEP:
-
-User works on code, then runs `/gitflow commit`.

package/templates/skills/gitflow/steps/step-sync.md

@@ -1,161 +0,0 @@
----
-name: step-sync
-description: Sync with remote and rebase if behind
-next_step: null
----
-
-# Step: SYNC - Synchronize with Remote
-
-## YOUR TASK:
-
-Fetch from remote, detect divergence, push local commits, and rebase if behind base branch.
-
-**ULTRA THINK about merge conflicts.**
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Fetch Remote State
-
-```bash
-git fetch origin --quiet
-CURRENT=$(git rev-parse --abbrev-ref HEAD)
-
-# Determine base branch
-case "$CURRENT" in
-  feature/*) BASE_BRANCH="develop" ;;
-  release/*) BASE_BRANCH="develop" ;;
-  hotfix/*)  BASE_BRANCH="main" ;;
-  *)         BASE_BRANCH="develop" ;;
-esac
-```
-
-### 2. Analyze Divergence
-
-```bash
-# Current branch vs remote
-AHEAD=$(git rev-list --count origin/$CURRENT..HEAD 2>/dev/null || echo "0")
-BEHIND=$(git rev-list --count HEAD..origin/$CURRENT 2>/dev/null || echo "0")
-
-# Current branch vs base branch
-BASE_AHEAD=$(git rev-list --count origin/$BASE_BRANCH..HEAD 2>/dev/null || echo "0")
-BASE_BEHIND=$(git rev-list --count HEAD..origin/$BASE_BRANCH 2>/dev/null || echo "0")
-```
-
-**State matrix:**
-
-| Ahead | Behind | State | Action |
-|-------|--------|-------|--------|
-| 0 | 0 | Synced | Nothing to do |
-| >0 | 0 | Ahead | Push |
-| 0 | >0 | Behind | Pull |
-| >0 | >0 | Diverged | Pull --rebase + Push |
-
-### 3. Display Status
-
-```
-Sync Status: {CURRENT}
-
-| Remote | Ahead | Behind | Status |
-|--------|-------|--------|--------|
-| origin/{CURRENT} | {AHEAD} | {BEHIND} | {state} |
-| origin/{BASE_BRANCH} | {BASE_AHEAD} | {BASE_BEHIND} | {state} |
-```
-
-### 4. Push Local Commits
-
-See [references/sync-push-verify.md](../references/sync-push-verify.md) for push with verification.
-
-### 5. Pull Remote Commits
-
-```bash
-[ "$BEHIND" -gt 0 ] && {
-  echo "Pulling $BEHIND commit(s) from origin/$CURRENT..."
-
-  # Check for uncommitted changes
-  DIRTY=$(git status --porcelain | wc -l)
-  [ "$DIRTY" -gt 0 ] && {
-    git stash push -m "sync-stash-$(date +%s)"
-    STASHED=true
-  }
-
-  git pull --rebase origin $CURRENT
-
-  [ "$STASHED" = true ] && git stash pop
-}
-```
-
-### 6. Rebase on Base Branch (if behind)
-
-```bash
-[ "$BASE_BEHIND" -gt 0 ] && {
-  echo "Branch is $BASE_BEHIND commits behind $BASE_BRANCH"
-
-  if [ "$auto_mode" = true ]; then
-    # Auto rebase
-    git rebase origin/$BASE_BRANCH
-  else
-    # Ask user
-    AskUserQuestion:
-      header: "Rebase"
-      question: "Rebase on $BASE_BRANCH? ($BASE_BEHIND commits behind)"
-      options:
-        - label: "Yes (Recommended)"
-          description: "Rebase to include latest changes"
-        - label: "No"
-          description: "Keep current base"
-  fi
-}
-```
-
-### 7-8. Handle Rebase Conflicts and Force Push
-
-See [references/sync-rebase-conflicts.md](../references/sync-rebase-conflicts.md) for:
-- Conflict detection and migration conflict handling
-- User options (resolve, abort, accept theirs)
-
-See [references/sync-push-verify.md](../references/sync-push-verify.md) for force push with verification.
-
-### 9. Summary
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    SYNC COMPLETE                                  ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Branch: {CURRENT}                                                ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Actions:                                                         ║
-║  {✅ Pushed {N} commits | ⬜ Nothing to push}                     ║
-║  {✅ Pulled {N} commits | ⬜ Nothing to pull}                     ║
-║  {✅ Rebased on {BASE_BRANCH} | ⬜ No rebase needed}              ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Status: In sync with remote                                      ║
-╠══════════════════════════════════════════════════════════════════╣
-║  NEXT: /gitflow pr                                                ║
-╚══════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## ERROR HANDLING:
-
-| Error | Solution |
-|-------|----------|
-| Push rejected | Pull first, then push |
-| Rebase conflict | Resolve or abort |
-| Migration conflict | Use /efcore rebase-snapshot |
-| Force push blocked | Check branch protection |
-
----
-
-## SUCCESS CRITERIA:
-
-- All local commits pushed
-- All remote commits pulled
-- Rebased on base branch (if needed)
-- No conflicts remaining
-
-## NEXT STEP:
-
-User runs `/gitflow pr` to create pull request.

package/templates/skills/gitflow/templates/config.json

@@ -1,72 +0,0 @@
-{
-  "version": "2.1.0",
-  "platform": {
-    "detected": "",
-    "shell": "",
-    "detectedAt": ""
-  },
-  "workspace": {
-    "path": "",
-    "name": ""
-  },
-  "repository": {
-    "name": "",
-    "rootFolder": "",
-    "nameVariants": {
-      "pascalCaseDot": "",
-      "pascalCase": "",
-      "kebabCase": "",
-      "snakeCase": "",
-      "displayName": ""
-    },
-    "defaultBranch": "main",
-    "remoteUrl": ""
-  },
-  "git": {
-    "provider": "",
-    "branches": {
-      "main": "main",
-      "develop": "develop"
-    },
-    "prefixes": {
-      "feature": "feature/",
-      "release": "release/",
-      "hotfix": "hotfix/"
-    }
-  },
-  "worktrees": {
-    "enabled": true,
-    "mode": "organized",
-    "structure": {
-      "main": "",
-      "develop": "",
-      "features": "",
-      "releases": "",
-      "hotfixes": ""
-    }
-  },
-  "versioning": {
-    "strategy": "semver",
-    "current": "0.0.0",
-    "tagPrefix": "v",
-    "sources": ["csproj", "package.json", "VERSION"]
-  },
-  "efcore": {
-    "enabled": true,
-    "validateOnCommit": true,
-    "blockDestructive": true,
-    "migrationNaming": "{context}_v{version}_{sequence}_{Description}"
-  },
-  "workflow": {
-    "push": {
-      "afterCommit": "worktree"
-    },
-    "pr": {
-      "autoLabels": true,
-      "requireReview": true
-    }
-  },
-  "language": {
-    "code": "en"
-  }
-}