@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/gitflow/references/init-structure-creation.md

@@ -1,75 +0,0 @@
-# Directory Structure Creation
-
-## Path Normalization for WSL
-
-```bash
-# If on WSL, translate Windows paths to /mnt/ format
-# normalize_path_for_platform() from _shared.md handles this
-# Example: D:/projects/MyApp → /mnt/d/projects/MyApp
-PROJECT_BASE="{ROOT_FOLDER}"  # Must be already normalized for current platform
-```
-
-## Create Complete Structure
-
-**⛔ CRITICAL: Use ABSOLUTE PATHS for ALL operations. NEVER use `cd` (it does not persist between Bash calls).**
-**⛔ Use `git -C <path>` or `GIT_DIR=<path>` instead of `cd` + `git`.**
-
-```bash
-PROJECT_BASE="{ROOT_FOLDER}"
-
-# Create subdirectories (absolute paths)
-mkdir -p "$PROJECT_BASE/features" "$PROJECT_BASE/releases" "$PROJECT_BASE/hotfixes"
-
-# Create bare repository if not exists (absolute path, no cd)
-if [ ! -d "$PROJECT_BASE/.bare" ]; then
-  git clone --bare "{REPO_URL}" "$PROJECT_BASE/.bare"
-
-  # Configure bare repo for worktrees (using git -C, no cd)
-  git -C "$PROJECT_BASE/.bare" config core.bare false
-  git -C "$PROJECT_BASE/.bare" config core.worktree ..
-fi
-
-# Create .git pseudo-file pointing to .bare
-echo "gitdir: ./.bare" > "$PROJECT_BASE/.git"
-
-# Organized mode: numbered main folders (absolute paths, GIT_DIR instead of cd)
-if [ "$WORKTREE_MODE" = "organized" ]; then
-  [ ! -d "$PROJECT_BASE/01-Main" ] && \
-    GIT_DIR="$PROJECT_BASE/.bare" git worktree add "$PROJECT_BASE/01-Main" main
-
-  [ ! -d "$PROJECT_BASE/02-Develop" ] && \
-    GIT_DIR="$PROJECT_BASE/.bare" git worktree add "$PROJECT_BASE/02-Develop" develop
-fi
-
-# Simple mode: named folders (absolute paths)
-if [ "$WORKTREE_MODE" = "simple" ]; then
-  [ ! -d "$PROJECT_BASE/main" ] && \
-    GIT_DIR="$PROJECT_BASE/.bare" git worktree add "$PROJECT_BASE/main" main
-
-  [ ! -d "$PROJECT_BASE/develop" ] && \
-    GIT_DIR="$PROJECT_BASE/.bare" git worktree add "$PROJECT_BASE/develop" develop
-fi
-
-# Convert worktree paths to relative format (cross-platform: Windows + WSL)
-detect_platform
-repair_worktree_paths "$PROJECT_BASE/.bare"
-
-# Create gitflow config directory (absolute paths)
-DEVELOP_DIR=$([ "$WORKTREE_MODE" = "organized" ] && echo "02-Develop" || echo "develop")
-mkdir -p "$PROJECT_BASE/$DEVELOP_DIR/.claude/gitflow/plans"
-mkdir -p "$PROJECT_BASE/$DEVELOP_DIR/.claude/gitflow/logs"
-mkdir -p "$PROJECT_BASE/$DEVELOP_DIR/.claude/gitflow/cache"
-mkdir -p "$PROJECT_BASE/$DEVELOP_DIR/.claude/gitflow/backup"
-```
-
-## Folder Structure to Create
-
-```
-{ROOT_FOLDER}/
-├── .bare/                 # Git bare repository (this repo only)
-├── 01-Main/               # Worktree: main branch
-├── 02-Develop/            # Worktree: develop branch
-├── features/              # Feature branch worktrees
-├── releases/              # Release branch worktrees
-└── hotfixes/              # Hotfix branch worktrees
-```

package/templates/skills/gitflow/references/init-version-detection.md

@@ -1,23 +0,0 @@
-# Version Detection
-
-## Detect Version (with Priority)
-
-**⛔ Use absolute paths with `git -C`, no `cd`.**
-
-```bash
-DEVELOP_FULL_PATH="$PROJECT_BASE/$DEVELOP_DIR"
-
-# Priority: csproj > Directory.Build.props > package.json > VERSION > tag
-VERSION=$(grep -oP '<Version>\K[^<]+' "$DEVELOP_FULL_PATH"/*.csproj 2>/dev/null | head -1)
-[ -z "$VERSION" ] && VERSION=$(grep -oP '<Version>\K[^<]+' "$DEVELOP_FULL_PATH/Directory.Build.props" 2>/dev/null)
-[ -z "$VERSION" ] && VERSION=$(grep -oP '"version":\s*"\K[^"]+' "$DEVELOP_FULL_PATH/package.json" 2>/dev/null)
-[ -z "$VERSION" ] && VERSION=$(cat "$DEVELOP_FULL_PATH/VERSION" 2>/dev/null)
-[ -z "$VERSION" ] && VERSION=$(git -C "$DEVELOP_FULL_PATH" describe --tags --abbrev=0 2>/dev/null | sed 's/^v//')
-[ -z "$VERSION" ] && VERSION="0.0.0"
-```
-
-**⛔ CRITICAL:** The version MUST come from one of the detection sources above. If NONE of them returns a value, use EXACTLY `0.0.0`. Do NOT invent, guess, or fabricate a version number (e.g., `0.1.0`, `1.0.0`). The fallback is `0.0.0` — nothing else.
-
-## Version will be stored in config.json
-
-The detected version is used in the GitFlow config template under `versioning.current`.

package/templates/skills/gitflow/references/init-workspace-detection.md

@@ -1,43 +0,0 @@
-# Workspace Detection
-
-## Scan for Sibling Projects
-
-```bash
-WORKSPACE_DIR=$(dirname "$(pwd)")
-SIBLING_PROJECTS=()
-
-for dir in "$WORKSPACE_DIR"/*/; do
-  [ -d "$dir/.bare" ] || [ -d "$dir/01-Main" ] || [ -d "$dir/02-Develop" ] && {
-    PROJECT_NAME_SIBLING=$(basename "$dir")
-    SIBLING_PROJECTS+=("$PROJECT_NAME_SIBLING")
-  }
-done
-```
-
-## Display Workspace Context
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  WORKSPACE: {WORKSPACE_DIR}                                  │
-├─────────────────────────────────────────────────────────────┤
-│  Each project has its OWN independent GitFlow configuration. │
-│  This init configures only: {DETECTED_NAME}                  │
-├─────────────────────────────────────────────────────────────┤
-{if SIBLING_PROJECTS not empty}
-│  Existing GitFlow projects:                                  │
-│  {for each SIBLING} ✅ {SIBLING_NAME}/                       │
-│     ├── .bare/  01-Main/  02-Develop/                        │
-│     └── features/  releases/  hotfixes/                      │
-│  {end for}                                                   │
-│                                                              │
-│  New project to initialize:                                  │
-│  ⬜ {DETECTED_NAME}/                                         │
-│     └── (same structure will be created)                     │
-{else}
-│  No existing GitFlow projects detected.                      │
-│  This will be the first project in this workspace.           │
-{endif}
-└─────────────────────────────────────────────────────────────┘
-```
-
-**Key principle:** GitFlow is **per-repository**. Each project has its own `config.json`, its own worktree structure, and its own version history. Projects do not share configuration.

package/templates/skills/gitflow/references/merge-ci-status.md

@@ -1,36 +0,0 @@
-# Check CI and Review Status
-
-## Check CI Status (GitHub)
-
-```bash
-if [ "$GIT_PROVIDER" = "github" ]; then
-  CI_STATUS=$(gh pr checks $PR_NUMBER --json state --jq '.[].state' | sort -u)
-
-  [[ "$CI_STATUS" == *"FAILURE"* ]] && {
-    echo "❌ CI checks failing"
-    gh pr checks $PR_NUMBER
-
-    if [ "$auto_mode" != true ]; then
-      AskUserQuestion:
-        header: "CI"
-        question: "CI checks are failing. Continue anyway?"
-        options:
-          - label: "Wait for fix"
-          - label: "Merge anyway (not recommended)"
-    fi
-  }
-fi
-```
-
-## Check Review Status (GitHub)
-
-```bash
-if [ "$GIT_PROVIDER" = "github" ]; then
-  REVIEWS=$(gh pr view $PR_NUMBER --json reviews --jq '.reviews | map(select(.state == "APPROVED")) | length')
-  REQUIRED_REVIEWS=$(gh api repos/:owner/:repo --jq '.default_branch_protection.required_pull_request_reviews.required_approving_review_count // 0')
-
-  [ "$REVIEWS" -lt "$REQUIRED_REVIEWS" ] && {
-    echo "⚠️ Needs $REQUIRED_REVIEWS approvals, has $REVIEWS"
-  }
-fi
-```

package/templates/skills/gitflow/references/merge-execution.md

@@ -1,62 +0,0 @@
-# Merge Execution and Verification
-
-## Determine Merge Strategy
-
-```bash
-BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
-
-case "$BRANCH_TYPE" in
-  feature)
-    MERGE_STRATEGY="squash"
-    DELETE_BRANCH=true
-    ;;
-  release|hotfix)
-    MERGE_STRATEGY="merge"
-    DELETE_BRANCH=true
-    MERGE_BACK="$GF_DEVELOP_BRANCH"
-    ;;
-esac
-```
-
-## Execute Merge
-
-**GitHub:**
-```bash
-case "$MERGE_STRATEGY" in
-  squash)
-    gh pr merge $PR_NUMBER --squash --delete-branch
-    ;;
-  merge)
-    gh pr merge $PR_NUMBER --merge --delete-branch
-    ;;
-esac
-```
-
-**Azure DevOps:**
-```bash
-case "$MERGE_STRATEGY" in
-  squash)
-    az repos pr update --id $PR_NUMBER --status completed --squash true --delete-source-branch true
-    ;;
-  merge)
-    az repos pr update --id $PR_NUMBER --status completed --squash false --delete-source-branch true
-    ;;
-esac
-```
-
-## Verify Merge
-
-```bash
-# CRITICAL: Force update tracking refs to get accurate state
-git fetch origin $TARGET_BRANCH:refs/remotes/origin/$TARGET_BRANCH --force --quiet
-git fetch origin --prune --quiet
-
-MERGED=$(git branch -r --merged origin/$TARGET_BRANCH | grep "$CURRENT" | wc -l)
-
-[ "$MERGED" -eq 0 ] && {
-  echo "⚠️ Merge verification failed - branch may not be merged"
-  echo "  → Check PR status on remote"
-} || {
-  echo "✅ Merge verified - branch merged to $TARGET_BRANCH"
-}
-```

package/templates/skills/gitflow/references/merge-pr-context.md

@@ -1,76 +0,0 @@
-# Load PR Context and Load Review Checklist
-
-## Load Config and PR Context
-
-```bash
-# Load GitFlow config (sets GF_* variables)
-read_gitflow_config || { echo "❌ Run /gitflow init first."; exit 1; }
-
-CURRENT=$(git rev-parse --abbrev-ref HEAD)
-GIT_PROVIDER="$GF_PROVIDER"
-
-# Try loading persisted PR state first
-CONFIG_DIR=$(dirname "$GF_CONFIG_FILE")
-PR_STATE_FILE="$CONFIG_DIR/cache/pr-state.json"
-if [ -f "$PR_STATE_FILE" ]; then
-  PR_NUMBER=$(grep -oP '"pr_number":\s*"\K[^"]+' "$PR_STATE_FILE" | head -1)
-  TARGET_BRANCH=$(grep -oP '"target_branch":\s*"\K[^"]+' "$PR_STATE_FILE" | head -1)
-  echo "✓ Loaded PR state from cache: PR #$PR_NUMBER → $TARGET_BRANCH"
-fi
-
-# Fallback: query provider if no cached state
-if [ -z "$PR_NUMBER" ]; then
-  if [ "$GIT_PROVIDER" = "github" ]; then
-    PR_NUMBER=$(gh pr list --head "$CURRENT" --json number --jq '.[0].number')
-    PR_STATUS=$(gh pr view $PR_NUMBER --json state,mergeable,reviews --jq '.')
-  elif [ "$GIT_PROVIDER" = "azuredevops" ]; then
-    PR_NUMBER=$(az repos pr list --source-branch "$CURRENT" --query "[0].pullRequestId" -o tsv)
-    PR_STATUS=$(az repos pr show --id $PR_NUMBER --query "{status:status,mergeStatus:mergeStatus}")
-  fi
-fi
-
-[ -z "$PR_NUMBER" ] && {
-  echo "❌ No PR found for branch $CURRENT"
-  echo "→ Run /gitflow pr first"
-  STOP
-}
-```
-
-## Display Review Checklist
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    PR REVIEW CHECKLIST                            ║
-╠══════════════════════════════════════════════════════════════════╣
-║  PR #${PR_NUMBER}: ${PR_TITLE}                                    ║
-╠══════════════════════════════════════════════════════════════════╣
-
-## Code Quality
-- [ ] Code follows project conventions
-- [ ] No unnecessary complexity
-- [ ] No code duplication
-- [ ] Variable/function names are clear
-
-## Security
-- [ ] No hardcoded secrets
-- [ ] Input validation present
-- [ ] Authentication/authorization correct
-- [ ] No SQL injection risks
-
-## Testing
-- [ ] Unit tests added/updated
-- [ ] Integration tests pass
-- [ ] Manual testing completed
-
-## EF Core (if applicable)
-- [ ] Migration files complete (3 files)
-- [ ] No destructive operations (or confirmed)
-- [ ] Snapshot synced with base
-
-## Documentation
-- [ ] Code comments where needed
-- [ ] API docs updated (if applicable)
-- [ ] README updated (if applicable)
-
-╚══════════════════════════════════════════════════════════════════╝
-```

package/templates/skills/gitflow/references/plan-template.md

@@ -1,69 +0,0 @@
-# Integration Plan Document Template
-
-> Referenced from `steps/step-plan.md` — Markdown template for generated plan documents.
-
-**Write to:** `.claude/gitflow/plans/{branch-name}_{date}.md`
-
----
-
-```markdown
-# Integration Plan: {CURRENT} → {BASE_BRANCH}
-
-**Generated:** {timestamp}
-**Status:** PENDING
-
-## Summary
-
-| Field | Value |
-|-------|-------|
-| Source | {CURRENT} |
-| Target | {BASE_BRANCH} |
-| Commits | {COMMITS} |
-| Strategy | {MERGE_STRATEGY} |
-| Merge Back | {MERGE_BACK or "N/A"} |
-
-## Commits to Integrate
-
-{COMMIT_LIST}
-
-## EF Core Analysis
-
-| Check | Status |
-|-------|--------|
-| Branch migrations | {count} |
-| Base migrations | {count} |
-| Snapshot diverged | {yes/no} |
-| Conflict type | {none/migration/code/both} |
-
-## Pre-Integration Steps
-
-{if migration conflict}
-1. [ ] Run `/efcore rebase-snapshot`
-2. [ ] Verify migration generates same schema
-3. [ ] Run `/gitflow sync`
-{endif}
-
-{if code conflict}
-1. [ ] Run `/gitflow sync` (includes rebase)
-2. [ ] Resolve conflicts manually
-3. [ ] Verify build passes
-{endif}
-
-## Integration Steps
-
-1. [ ] Create PR: `/gitflow pr`
-2. [ ] Review and approve
-3. [ ] Merge: `/gitflow merge`
-{if release or hotfix}
-4. [ ] Merge back to develop
-5. [ ] Create tag: v{VERSION}
-{endif}
-6. [ ] Cleanup: `/gitflow finish`
-
-## Post-Integration
-
-- [ ] Verify CI/CD passes
-- [ ] Verify migrations applied
-- [ ] Delete source branch
-- [ ] Remove worktree
-```

package/templates/skills/gitflow/references/pr-build-checks.md

@@ -1,60 +0,0 @@
-# Pre-PR Build Checks
-
-## Multi-Runtime Detection
-
-```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
-  }
-  # Migration check
-  echo "Checking migrations..."
-  dotnet ef migrations list 2>&1 || echo "No migrations or EF Core not configured"
-elif [ -f "package.json" ]; then
-  npm run build 2>&1 || {
-    echo "❌ npm build failed. Fix before creating PR."
-    STOP
-  }
-elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
-  echo "Python project detected — skipping build check"
-else
-  echo "⚠️ No known build system detected — skipping build check"
-fi
-```
-
-## Enforce Migration Squash (Feature Branches)
-
-**BLOCKING**: Feature branches must have at most 1 migration before creating a PR.
-
-```bash
-if [ "$BRANCH_TYPE" = "feature" ]; then
-  MIGRATION_DIR=$(find . -path "*/Persistence/Migrations" -type d 2>/dev/null | head -1)
-  if [ -n "$MIGRATION_DIR" ]; then
-    # Count migration .cs files added by this feature (not in target branch)
-    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
-```

package/templates/skills/gitflow/references/pr-generation.md

@@ -1,58 +0,0 @@
-# Pull Request Content Generation
-
-## Generate PR Title
-
-```bash
-BRANCH_NAME=$(echo $CURRENT | sed 's/.*\///')
-BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
-
-case "$BRANCH_TYPE" in
-  feature) TITLE="feat: $BRANCH_NAME" ;;
-  hotfix)  TITLE="fix: $BRANCH_NAME" ;;
-  release) TITLE="release: v$GF_VERSION" ;;
-esac
-```
-
-## Generate PR Body
-
-```markdown
-## Summary
-
-{Auto-generated from commit messages}
-
-## Changes
-
-{List of files changed with categories}
-
-## Testing
-
-- [ ] Build passes
-- [ ] Unit tests pass
-- [ ] Manual testing completed
-
-## EF Core Migrations
-
-{Migration status: None | Added | Modified}
-
----
-
-🤖 Generated with [Claude Code](https://claude.ai/code)
-```
-
-## Persist PR Info for Merge Step
-
-```bash
-# Persist PR info for merge step (uses config path for portability)
-CONFIG_DIR=$(dirname "$GF_CONFIG_FILE")
-cat > "$CONFIG_DIR/cache/pr-state.json" << EOF
-{
-  "pr_number": "$PR_NUMBER",
-  "pr_url": "$PR_URL",
-  "source_branch": "$CURRENT",
-  "target_branch": "$TARGET_BRANCH",
-  "git_provider": "$GIT_PROVIDER",
-  "created_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-}
-EOF
-echo "✓ PR state saved to $CONFIG_DIR/cache/pr-state.json"
-```

package/templates/skills/gitflow/references/start-branch-normalization.md

@@ -1,28 +0,0 @@
-# Branch Name Normalization and Validation
-
-## Normalize Branch Name
-
-```bash
-normalize_branch_name() {
-  echo "$1" | tr '[:upper:]' '[:lower:]' | \
-    sed 'y/àâäéèêëïîôùûüçœæ/aaaeeeeiioouucoa/' | \
-    sed "s/[ _']/-/g" | sed 's/[^a-z0-9-]//g' | \
-    sed 's/--*/-/g' | sed 's/^-//;s/-$//' | cut -c1-50
-}
-
-BRANCH_NAME=$(normalize_branch_name "$branch_name")
-FULL_BRANCH="${branch_type}/${BRANCH_NAME}"
-```
-
-## Check if Branch Already Exists
-
-```bash
-# Check if exists
-LOCAL_EXISTS=$(git branch --list "$FULL_BRANCH")
-REMOTE_EXISTS=$(git branch -r --list "origin/$FULL_BRANCH")
-
-[ -n "$LOCAL_EXISTS" ] || [ -n "$REMOTE_EXISTS" ] && {
-  echo "ERROR: Branch '$FULL_BRANCH' already exists"
-  # Options: Different name | Checkout existing | Delete and recreate
-}
-```

package/templates/skills/gitflow/references/start-efcore-preflight.md

@@ -1,70 +0,0 @@
-# Start: EF Core Migration Pre-flight
-
-> Reference for step-start.md — BLOCKING check for release/hotfix branches.
-
-## Migration Naming Validation
-
-```bash
-if [ "$branch_type" = "release" ] || [ "$branch_type" = "hotfix" ]; then
-  echo "EF CORE MIGRATION PRE-FLIGHT"
-  echo "─────────────────────────────"
-
-  MIGRATION_DIRS=$(find . -type d -name "Migrations" -path "*/src/*" 2>/dev/null)
-
-  if [ -n "$MIGRATION_DIRS" ]; then
-    BAD_MIGRATIONS=""
-    GOOD_COUNT=0
-    BAD_COUNT=0
-
-    for dir in $MIGRATION_DIRS; do
-      for file in $(find "$dir" -name "*.cs" ! -name "*Designer*" ! -name "*ModelSnapshot*" | sort); do
-        FILENAME=$(basename "$file" .cs)
-        # Strip EF Core 14-digit timestamp prefix (e.g., 20260128220215_)
-        NAME_PART=$(echo "$FILENAME" | sed 's/^[0-9]\{14\}_//')
-
-        # Validate: {context}_v{version}_{sequence}_{Description}
-        # Accepts both dot (v2.0.0) and underscore (v2_0_0) version separators
-        if echo "$NAME_PART" | grep -qE '^[a-zA-Z]+_v[0-9]+[._][0-9]+[._][0-9]+_[0-9]{3}_[A-Z]'; then
-          echo "  ✅ $FILENAME"
-          GOOD_COUNT=$((GOOD_COUNT + 1))
-        else
-          echo "  ❌ $FILENAME"
-          BAD_COUNT=$((BAD_COUNT + 1))
-          BAD_MIGRATIONS="$BAD_MIGRATIONS  - $FILENAME\n"
-        fi
-      done
-    done
-
-    echo ""
-    echo "Result: $GOOD_COUNT OK, $BAD_COUNT non-compliant"
-
-    if [ "$BAD_COUNT" -gt 0 ]; then
-      echo ""
-      echo "⛔ RELEASE BLOCKED - Non-compliant migration names detected"
-      echo "Expected format: {context}_v{version}_{sequence}_{Description}"
-      echo "  Example OK:  core_v2.0.0_001_InitialSchema"
-      echo "  Example NOK: AddApplicationAccessRequests"
-    fi
-  fi
-fi
-```
-
-## If Non-Compliant Migrations Found
-
-```yaml
-AskUserQuestion:
-  header: "Migrations"
-  question: "Non-compliant migration names block this release. How to proceed?"
-  options:
-    - label: "Run /efcore squash (Recommended)"
-      description: "Squash migrations on develop to fix naming via MCP, then retry release"
-    - label: "Abort release"
-      description: "Cancel release, fix manually on develop"
-    - label: "Continue anyway"
-      description: "Proceed despite naming issues (NOT recommended for production)"
-```
-
-**Actions:**
-- **"/efcore squash"** → Delegate to `efcore-squash` agent on develop, then re-run `/gitflow start release`
-- **"Abort release"** → STOP immediately
-- **"Continue anyway"** → Log warning to `.claude/gitflow/logs/audit.log` and proceed