@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/gitflow/references/start-local-config.md

@@ -1,113 +0,0 @@
-# Start: Local Environment Configuration
-
-> Reference for step-start.md — auto-generated local config for each worktree.
-
-## Port Generation
-
-```bash
-# Generate unique ports based on branch name hash (to avoid conflicts between worktrees)
-HASH=$(echo "$BRANCH_NAME" | shasum 2>/dev/null || echo "$BRANCH_NAME" | md5sum 2>/dev/null || echo "$BRANCH_NAME" | cksum)
-HASH=$(echo "$HASH" | cut -c1-4)
-HASH_NUM=$((16#$HASH % 100))
-API_PORT=$((5200 + HASH_NUM))
-WEB_PORT=$((5300 + HASH_NUM))
-
-PROJECT_NAME=$(echo "$GF_PROJECT_NAME" | tr '[:upper:]' '[:lower:]')
-DB_NAME=$(echo "${PROJECT_NAME}_${branch_type}_${BRANCH_NAME}" | cut -c1-63)
-```
-
-## 7a. Backend: appsettings.Local.json
-
-```bash
-[ -n "$API_DIR" ] && [ -f "$API_DIR/appsettings.json" ] && {
-  cat > "$API_DIR/appsettings.Local.json" << EOF
-{
-  "ConnectionStrings": {
-    "DefaultConnection": "Server=localhost;Database=${DB_NAME};Trusted_Connection=true;TrustServerCertificate=true"
-  },
-  "SmartStack": {
-    "AutoMigrate": true,
-    "FailOnMigrationError": true,
-    "EnableDevSeeding": true
-  },
-  "Authentication": {
-    "FrontendUrl": "http://localhost:${WEB_PORT}"
-  },
-  "Kestrel": {
-    "Endpoints": {
-      "Http": {
-        "Url": "http://localhost:${API_PORT}"
-      }
-    }
-  },
-  "Serilog": {
-    "MinimumLevel": {
-      "Default": "Debug"
-    }
-  }
-}
-EOF
-}
-```
-
-## 7b. Frontend: .env.standalone + npm script
-
-> **IMPORTANT**: Vite 7+ forbids `"local"` as a mode name (conflicts with `.env.local` suffix).
-> The Vite mode is `standalone`, but the npm script stays `local` for user convenience.
-
-```bash
-[ -n "$WEB_DIR" ] && [ -f "$WEB_DIR/package.json" ] && {
-  cat > "$WEB_DIR/.env.standalone" << EOF
-VITE_API_URL=http://localhost:${API_PORT}
-VITE_APP_ENV=local
-VITE_DEBUG=true
-EOF
-
-  # Add "local" script to package.json if not exists
-  if ! grep -q '"local"' "$WEB_DIR/package.json"; then
-    node -e "
-      const fs = require('fs');
-      const pkg = JSON.parse(fs.readFileSync('$WEB_DIR/package.json', 'utf8'));
-      if (!pkg.scripts.local) {
-        pkg.scripts.local = 'vite --mode standalone --port ${WEB_PORT}';
-        fs.writeFileSync('$WEB_DIR/package.json', JSON.stringify(pkg, null, 2) + '\n');
-      }
-    "
-  fi
-}
-```
-
-## 7c. Backend: launchSettings.json Local Profile
-
-```bash
-LAUNCH_SETTINGS="$API_DIR/Properties/launchSettings.json"
-[ -n "$API_DIR" ] && [ -f "$LAUNCH_SETTINGS" ] && {
-  node -e "
-    const fs = require('fs');
-    const ls = JSON.parse(fs.readFileSync('$LAUNCH_SETTINGS', 'utf8'));
-    ls.profiles = ls.profiles || {};
-    ls.profiles.Local = {
-      commandName: 'Project',
-      dotnetRunMessages: true,
-      launchBrowser: false,
-      applicationUrl: 'http://localhost:${API_PORT}',
-      environmentVariables: {
-        ASPNETCORE_ENVIRONMENT: 'Local'
-      }
-    };
-    fs.writeFileSync('$LAUNCH_SETTINGS', JSON.stringify(ls, null, 2) + '\n');
-  "
-}
-```
-
-## 7d. Summary Display
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  LOCAL ENVIRONMENT CONFIGURED                               │
-├─────────────────────────────────────────────────────────────┤
-│  Database:  ${DB_NAME}                                      │
-│  API Port:  ${API_PORT}  →  dotnet run --launch-profile Local│
-│  Web Port:  ${WEB_PORT}  →  npm run local                   │
-└─────────────────────────────────────────────────────────────┘
-```

package/templates/skills/gitflow/references/start-worktree-creation.md

@@ -1,50 +0,0 @@
-# Worktree Creation and Validation
-
-## Determine Worktree Path
-
-**Read worktree mode from config (already loaded by read_gitflow_config):**
-```bash
-WORKTREE_MODE="$GF_WORKTREE_MODE"
-```
-
-## Worktree Path Selection (Organized Mode)
-
-> **FORBIDDEN — Numbered directories:**
-> NEVER create directories like `03-Release`, `04-Feature`, `05-Hotfix`.
-> Only `01-Main` and `02-Develop` use numbers (they are permanent, created at init).
-> All other worktrees MUST use the paths from `config.json → worktrees.structure`:
-> - `$GF_FEATURES_PATH/{name}` (e.g., `features/my-feature`, NOT `04-Feature`)
-> - `$GF_RELEASES_PATH/v{version}` (e.g., `releases/v2.15.0`, NOT `03-Release`)
-> - `$GF_HOTFIXES_PATH/{name}` (e.g., `hotfixes/fix-bug`, NOT `05-Hotfix`)
-
-```bash
-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
-
-mkdir -p "$(dirname "$WORKTREE_PATH")"
-git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
-
-# Convert worktree paths to relative format (cross-platform: Windows + WSL)
-repair_worktree_paths "$(git rev-parse --git-common-dir)"
-
-# POST-CREATION VALIDATION (BLOCKING)
-# Detect if worktree was accidentally created with a numbered prefix
-CREATED_PATH=$(git worktree list | grep "$FULL_BRANCH" | awk '{print $1}')
-validate_worktree_path "$CREATED_PATH" || {
-  echo "BLOCKING: Recreating worktree at correct path..."
-  git worktree remove "$CREATED_PATH" --force
-  git branch -D "$FULL_BRANCH" 2>/dev/null
-  git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
-  repair_worktree_paths "$(git rev-parse --git-common-dir)"
-}
-```
-
-## No-Worktree Mode
-
-```bash
-git checkout "$BASE_BRANCH" && git pull origin "$BASE_BRANCH"
-git checkout -b "$FULL_BRANCH"
-```

package/templates/skills/gitflow/references/sync-push-verify.md

@@ -1,44 +0,0 @@
-# Push and Force Push with Verification
-
-## Push Local Commits
-
-```bash
-[ "$AHEAD" -gt 0 ] && {
-  echo "Pushing $AHEAD commit(s) to origin/$CURRENT..."
-  git push 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 verified - local/remote in sync"
-  else
-    echo "⚠️ Push verification FAILED - refs may be stale"
-    echo "  Local:  $LOCAL_SHA"
-    echo "  Remote: $REMOTE_SHA"
-  fi
-}
-```
-
-## Force Push After Rebase
-
-```bash
-# After successful rebase
-if [ "$REBASED" = true ]; then
-  echo "Rebase complete. Force pushing..."
-  git push --force-with-lease 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 "✅ Force push verified - local/remote in sync"
-  else
-    echo "⚠️ Force push verification FAILED"
-    echo "  Local:  $LOCAL_SHA"
-    echo "  Remote: $REMOTE_SHA"
-  fi
-fi
-```

package/templates/skills/gitflow/references/sync-rebase-conflicts.md

@@ -1,38 +0,0 @@
-# Rebase Conflict Handling
-
-## Handle Rebase Conflicts
-
-```bash
-# If rebase has conflicts
-if [ -d ".git/rebase-merge" ] || [ -d ".git/rebase-apply" ]; then
-  echo "⚠️ REBASE CONFLICT DETECTED"
-
-  CONFLICTS=$(git diff --name-only --diff-filter=U)
-  echo "Conflicting files:"
-  echo "$CONFLICTS"
-
-  # Check for migration conflicts
-  MIGRATION_CONFLICTS=$(echo "$CONFLICTS" | grep "Migrations/")
-  [ -n "$MIGRATION_CONFLICTS" ] && {
-    echo "⚠️ Migration conflicts detected!"
-    echo "Recommend: /efcore rebase-snapshot"
-  }
-
-  # Options
-  AskUserQuestion:
-    header: "Conflict"
-    question: "How to handle conflicts?"
-    options:
-      - label: "Resolve manually"
-        description: "I'll fix conflicts and continue"
-      - label: "Abort rebase"
-        description: "Cancel and return to previous state"
-      - label: "Accept theirs (migrations)"
-        description: "Use base branch migrations, regenerate ours"
-fi
-```
-
-**User actions:**
-- **Resolve manually**: Fix conflicts in editor, then `git rebase --continue`
-- **Abort rebase**: `git rebase --abort`
-- **Accept theirs**: `git checkout --theirs -- {files}`, then `git rebase --continue`

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

@@ -1,199 +0,0 @@
----
-name: step-commit
-description: Commit with EF Core migration validation
-next_step: null
----
-
-# Step: COMMIT - Migration-Aware Commits
-
-## YOUR TASK:
-
-Validate changes, check EF Core migrations, and create commit with proper message.
-
-**ULTRA THINK about migration safety.**
-
----
-
-## INPUT PARSING:
-
-```
-{commit_message} = optional message from args
-{validate_only} = --validate flag (check without committing)
-{dry_run} = --dry-run flag (simulate)
-```
-
----
-
-## EXECUTION SEQUENCE:
-
-### 0. Pre-commit Guards
-
-**0.0 Load Config:**
-```bash
-# Load GitFlow config (sets GF_* variables)
-read_gitflow_config || { echo "❌ Run /gitflow init first."; exit 1; }
-```
-
-**0.1 Branch Protection:**
-```bash
-CURRENT=$(git rev-parse --abbrev-ref HEAD)
-
-# BLOCK: main
-[[ "$CURRENT" == "$GF_MAIN_BRANCH" ]] && {
-  echo "⛔ COMMIT BLOCKED - $GF_MAIN_BRANCH is protected"
-  echo "→ Use: /gitflow start hotfix <name>"
-  STOP
-}
-
-# WARNING: develop
-[[ "$CURRENT" == "$GF_DEVELOP_BRANCH" ]] && {
-  echo "⚠️ Direct commits to $GF_DEVELOP_BRANCH are discouraged"
-  # Offer RESCUE TO FEATURE
-}
-```
-
-**0.2 Rescue to Feature (if on develop):**
-```bash
-git fetch origin --quiet
-STAGED=$(git diff --cached --name-only | wc -l)
-MODIFIED=$(git diff --name-only | wc -l)
-UNTRACKED=$(git ls-files --others --exclude-standard | wc -l)
-LOCAL_COMMITS=$(git rev-list --count origin/$GF_DEVELOP_BRANCH..HEAD 2>/dev/null || echo "0")
-
-# If there are changes or commits, offer rescue
-[ "$STAGED" -gt 0 ] || [ "$MODIFIED" -gt 0 ] || [ "$LOCAL_COMMITS" -gt 0 ] && {
-  # Ask to rescue to feature branch
-  RESCUE_BRANCH="feature/rescue-$(date +%Y%m%d-%H%M%S)"
-  # Execute rescue flow...
-}
-```
-
-**0.3 Check Sync Status:**
-```bash
-BEHIND=$(git rev-list --count HEAD..origin/$CURRENT 2>/dev/null || echo "0")
-[ "$BEHIND" -gt 0 ] && echo "⚠️ Branch is $BEHIND commits behind → /gitflow sync"
-```
-
-### 1. Analyze Changes
-
-```bash
-STAGED=$(git diff --cached --name-only)
-MODIFIED=$(git diff --name-only)
-UNTRACKED=$(git ls-files --others --exclude-standard)
-
-# Nothing to commit?
-[ -z "$STAGED" ] && [ -z "$MODIFIED" ] && [ -z "$UNTRACKED" ] && {
-  echo "✓ Nothing to commit"
-  exit 0
-}
-```
-
-### 2. Detect and Validate EF Core Migrations
-
-See [references/commit-migration-validation.md](../references/commit-migration-validation.md) for:
-- Migration file detection (3-file requirement)
-- Destructive operation detection (DropTable, DropColumn, DeleteData)
-- User confirmation for destructive changes
-- Audit trail logging
-
-### 4. Stage All Changes
-
-```bash
-# Stage all changes
-git add -A
-
-# Show what will be committed
-echo "Files to commit:"
-git diff --cached --stat
-```
-
-### 5-6. Generate and Create Commit
-
-See [references/commit-message-generation.md](../references/commit-message-generation.md) for:
-- Commit type determination (feat/fix/chore/db)
-- Scope extraction from branch name
-- Message format with CHANGE block
-- Stage all and commit
-
-### 7. Push to Remote (ALWAYS ASK USER)
-
-**MANDATORY: Always ask user before pushing commits:**
-
-```yaml
-AskUserQuestion:
-  header: "Push"
-  question: "Push commit to origin/$CURRENT?"
-  options:
-    - label: "Yes, push now"
-      description: "git push origin $CURRENT"
-    - label: "No, later"
-      description: "Keep commit local for now"
-```
-
-**If user chooses "Yes":**
-```bash
-git push 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
-  PUSHED="yes"
-  echo "✅ Pushed and verified - origin/$CURRENT in sync"
-else
-  PUSHED="partial"
-  echo "⚠️ Push may have failed - refs mismatch"
-  echo "  Local:  $LOCAL_SHA"
-  echo "  Remote: $REMOTE_SHA"
-fi
-```
-
-**If user chooses "No":**
-```bash
-PUSHED="no"
-echo "⏸️ Commit kept local. Push later with: git push origin $CURRENT"
-```
-
-### 8. Summary
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    COMMIT CREATED                                 ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Branch:  {CURRENT}                                               ║
-║  Commit:  {COMMIT_HASH}                                           ║
-║  Message: {first line of message}                                 ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Files:   {N} changed                                             ║
-║  EF Core: {✅ Valid | ⚠️ Destructive confirmed | N/A}             ║
-║  Pushed:  {yes | no | pending}                                    ║
-╠══════════════════════════════════════════════════════════════════╣
-║  NEXT: /gitflow pr                                                ║
-╚══════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## ERROR HANDLING:
-
-| Error | Solution |
-|-------|----------|
-| Incomplete migration | Add missing files |
-| Build fails | `dotnet ef migrations remove` + fix |
-| Pre-commit hook fails | Fix issues, stage again, NEW commit |
-| Destructive operation | Confirm or modify migration |
-
----
-
-## SUCCESS CRITERIA:
-
-- All files staged
-- Migrations validated (if present)
-- Destructive operations confirmed
-- Commit created with proper message
-- **Push: ALWAYS ask user (never automatic)**
-
-## NEXT STEP:
-
-User continues coding or runs `/gitflow pr`.

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

@@ -1,147 +0,0 @@
----
-name: step-finish
-description: Finalize branch - tag, merge back, cleanup
-next_step: null
----
-
-# Step: FINISH - Finalize Branch
-
-## YOUR TASK:
-
-Create tags for releases/hotfixes, merge back to develop, clean up worktree and branch.
-
-**ULTRA THINK about version tagging.**
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Load Config and Determine Branch Context
-
-```bash
-# Load GitFlow config (sets GF_* variables)
-read_gitflow_config || { echo "❌ Run /gitflow init first."; exit 1; }
-
-# Get current or specified branch
-BRANCH=${1:-$(git rev-parse --abbrev-ref HEAD)}
-BRANCH_TYPE=$(echo $BRANCH | cut -d'/' -f1)
-BRANCH_NAME=$(echo $BRANCH | cut -d'/' -f2)
-
-# Validate branch type
-case "$BRANCH_TYPE" in
-  feature|release|hotfix) ;;
-  $GF_MAIN_BRANCH|$GF_DEVELOP_BRANCH)
-    echo "❌ Cannot finish $GF_MAIN_BRANCH or $GF_DEVELOP_BRANCH branch"
-    STOP
-    ;;
-  *)
-    echo "❌ Unknown branch type: $BRANCH_TYPE"
-    STOP
-    ;;
-esac
-```
-
-### 2. Verify Merge Status
-
-```bash
-git fetch origin
-
-# Check if branch was merged
-case "$BRANCH_TYPE" in
-  feature)
-    MERGED=$(git branch -r --merged origin/$GF_DEVELOP_BRANCH | grep "$BRANCH" | wc -l)
-    TARGET="$GF_DEVELOP_BRANCH"
-    ;;
-  release|hotfix)
-    MERGED=$(git branch -r --merged origin/$GF_MAIN_BRANCH | grep "$BRANCH" | wc -l)
-    TARGET="$GF_MAIN_BRANCH"
-    ;;
-esac
-
-[ "$MERGED" -eq 0 ] && {
-  echo "⚠️ Branch $BRANCH not yet merged to $TARGET"
-  echo "→ Run /gitflow merge first"
-
-  if [ "$auto_mode" != true ]; then
-    AskUserQuestion:
-      header: "Continue"
-      question: "Branch not merged. Continue anyway?"
-      options:
-        - label: "No, merge first"
-        - label: "Yes, finish anyway"
-  fi
-}
-```
-
-### 3-4. Create Tag and Merge Back to Develop
-
-**For release/hotfix only:**
-- Create annotated tag on main branch (format: v{VERSION})
-- Merge main back to develop with merge commit
-- Handle merge conflicts
-- Push and verify sync
-
-### 5. Update Version (Release and Hotfix)
-
-See [references/finish-version-bumping.md](../references/finish-version-bumping.md) for:
-- Version increment logic (release: minor+1.0, hotfix: patch+2)
-- Config and source file updates
-- Push verification
-
-### 6-8. Clean Up Worktree, Delete Branches, Archive Plan
-
-See [references/finish-cleanup.md](../references/finish-cleanup.md) for:
-- Worktree removal with fallback
-- Remote and local branch deletion
-- Plan file archival
-
-### 9. Summary
-
-```
-╔══════════════════════════════════════════════════════════════════╗
-║                    BRANCH FINALIZED                               ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Branch: {BRANCH}                                                 ║
-║  Type:   {BRANCH_TYPE}                                            ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Actions:                                                         ║
-{if release or hotfix}
-║  ✅ Tag created: {TAG_NAME}                                       ║
-║  ✅ Merged back to develop                                        ║
-{endif}
-{if release}
-║  ✅ Version bumped to {NEXT_VERSION}                              ║
-{endif}
-║  ✅ Worktree removed                                              ║
-║  ✅ Branch deleted (local + remote)                               ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Current branch: {main|develop}                                   ║
-╠══════════════════════════════════════════════════════════════════╣
-║  Ready for next: /gitflow start feature <name>                    ║
-╚══════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## ERROR HANDLING:
-
-| Error | Solution |
-|-------|----------|
-| Branch not merged | Merge first or force finish |
-| Tag exists | Overwrite or use different version |
-| Merge back conflicts | Resolve manually |
-| Worktree in use | Exit worktree first |
-
----
-
-## SUCCESS CRITERIA:
-
-- Tag created (for release/hotfix)
-- Merged back to develop (for release/hotfix)
-- Worktree removed
-- Branch deleted
-- Plan archived
-
-## COMPLETION:
-
-GitFlow cycle complete. Ready for next feature/release/hotfix.