@atlashub/smartstack-cli 3.39.0 → 3.40.0

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

@@ -1,69 +1,69 @@
-# 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
-```
+# 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 +1,60 @@
-# 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
-```
+# 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 +1,58 @@
-# 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"
-```
+# 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 +1,28 @@
-# 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
-}
-```
+# 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 +1,70 @@
-# 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
+# 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