@atlashub/smartstack-cli 3.38.0 → 3.39.0

package/templates/skills/business-analyse/templates/tpl-progress.md

@@ -72,7 +72,7 @@
     □ Create custom hook use{ModuleName}
     □ Implement pagination, filtering, sorting
     □ Validate all pages match their wireframe layout
-    □ ⚠️ Routes MUST be INSIDE Layout wrapper (AdminLayout/BusinessLayout/UserLayout)
+    □ ⚠️ Routes MUST be INSIDE the AppLayout wrapper
     Total: C tasks
 
   [I18N] Internationalization Keys

package/templates/skills/business-analyse/templates-frd.md

@@ -1,7 +1,7 @@
 # Templates Specification - Business Analysis
 
 > **Usage:** Templates for functional specification documents
-> **Context:** Application > Module > Section
+> **Hierarchy:** Application > Module > Section
 
 ---
 

package/templates/skills/efcore/SKILL.md

@@ -7,7 +7,7 @@ disable-model-invocation: true
 
 ## Current state (auto-injected)
 - Branch: !`git branch --show-current`
-- Recent migrations: !`find . -path "*/Migrations/*.cs" -not -name "*Designer*" -not -name "*Snapshot*" 2>/dev/null | sort | tail -5 || echo "none found"`
+- Recent migrations: _(detected in step-00-init)_
 
 <objective>
 Manage EF Core migrations and database operations with progressive step loading, MCP validation, and DbContext auto-detection.

package/templates/skills/efcore/steps/migration/step-02-create.md

@@ -107,20 +107,7 @@ dotnet ef migrations add "$MIGRATION_NAME" \
   --verbose
 ```
 
-### 6. Cleanup EF Core Design-Time Artifacts
-
-```bash
-# EF Core's Roslyn BuildHost creates corrupted bin folders on Windows (U+F05C instead of backslash)
-# Clean up any bin*Debug folders that are NOT the normal bin/Debug path
-for d in src/*/bin?Debug; do
-  if [ -d "$d" ]; then
-    echo "Removing corrupted EF Core artifact: $d"
-    rm -rf "$d"
-  fi
-done
-```
-
-### 7. Verify Creation
+### 6. Verify Creation
 
 ```bash
 # Check files were created

package/templates/skills/gitflow/SKILL.md

@@ -6,10 +6,11 @@ disable-model-invocation: true
 ---
 
 ## Current state (auto-injected)
-- Branch: !`git branch --show-current`
-- Status: !`git status --short`
-- Recent commits: !`git log --oneline -5`
-- Worktrees: !`git worktree list 2>/dev/null`
+- Preflight: !`if [ -f .git ] && grep -q '^gitdir: [A-Za-z]:' .git 2>/dev/null && grep -qi microsoft /proc/version 2>/dev/null; then p=$(sed 's/^gitdir: //' .git | tr -d '\r\n'); d=$(echo "${p:0:1}" | tr A-Z a-z); r="${p:2}"; r="${r//\\//}"; printf 'gitdir: %s\n' "$(realpath -m --relative-to="$(pwd)" "/mnt/$d$r")" > .git && echo "repaired"; else echo "ok"; fi`
+- Branch: !`git branch --show-current 2>/dev/null || echo "UNAVAILABLE"`
+- Status: !`git status --short 2>/dev/null || echo "UNAVAILABLE"`
+- Recent commits: !`git log --oneline -5 2>/dev/null || echo "UNAVAILABLE"`
+- Worktrees: !`git worktree list 2>/dev/null || echo "UNAVAILABLE (run preflight_git_check from _shared.md)"`
 - Config: !`cat .claude/gitflow/config.json 2>/dev/null || echo "no config found"`
 
 <objective>
@@ -316,6 +317,28 @@ Auto mode: {auto_mode}
 
 </task_agents>
 
+<worktree_repair>
+
+**MANDATORY PRE-FLIGHT:** Before routing to any step or agent, run `preflight_git_check` (from `_shared.md` PREFLIGHT_GIT_CHECK section). This ensures git is accessible and repairs cross-platform worktree paths (Windows ↔ WSL).
+
+**When to trigger:** If any auto-injected state shows "UNAVAILABLE", or if the Preflight line shows "repaired".
+
+**Execution:**
+```bash
+# 1. Detect platform
+detect_platform
+
+# 2. Run preflight (repairs .git file + .bare/worktrees/*/gitdir)
+preflight_git_check
+
+# 3. Verify
+git status --short
+```
+
+**This converts all paths to relative format (cross-platform safe).**
+
+</worktree_repair>
+
 <execution_rules>
 
 - **Single step mode**: Read the step file and execute inline

package/templates/skills/gitflow/_shared.md

@@ -143,6 +143,9 @@ Searches in: pwd, develop worktree, then git root.
 
 ```bash
 resolve_gitflow_config_path() {
+  # Ensure git is accessible (cross-platform worktree repair)
+  preflight_git_check 2>/dev/null
+
   # 1. Try current directory
   [ -f ".claude/gitflow/config.json" ] && { echo ".claude/gitflow/config.json"; return 0; }
 
@@ -341,7 +344,11 @@ validate_worktree_path() {
 
 ## REPAIR_WORKTREE_PATHS
 
-Repairs worktree metadata files that contain paths from a different platform (e.g., WSL paths `/mnt/d/...` on Windows, or Windows paths `D:/...` on WSL). Scans `.bare/worktrees/*/gitdir` and the corresponding `{worktree}/.git` files.
+Converts worktree metadata paths to **relative paths** for cross-platform compatibility (Windows + WSL).
+Absolute paths (Windows `D:/...` or POSIX `/mnt/d/...`) break when switching environments.
+Relative paths work everywhere without repair.
+
+Scans `.bare/worktrees/*/gitdir` and the corresponding `{worktree}/.git` files.
 
 ```bash
 repair_worktree_paths() {
@@ -356,24 +363,48 @@ repair_worktree_paths() {
     local gitdir_file="$wt_dir/gitdir"
     [ ! -f "$gitdir_file" ] && continue
 
-    # Fix .bare/worktrees/{name}/gitdir
+    # Read stored path (may be Windows absolute, POSIX absolute, or already relative)
     local stored_path=$(cat "$gitdir_file" | tr -d '\n\r')
-    local fixed_path=$(normalize_path_for_platform "$stored_path")
-    if [ "$stored_path" != "$fixed_path" ]; then
-      echo "$fixed_path" > "$gitdir_file"
-      echo "REPAIRED: $wt_name/gitdir → $fixed_path"
+
+    # Resolve to current platform absolute path for realpath computation
+    local resolved_path="$stored_path"
+    local is_abs=false
+    if [[ "$stored_path" =~ ^[A-Za-z]:[\\/] ]]; then
+      is_abs=true
+      resolved_path=$(normalize_path_for_platform "$stored_path")
+    elif [[ "$stored_path" =~ ^/ ]]; then
+      is_abs=true
+      resolved_path=$(normalize_path_for_platform "$stored_path")
+    fi
+    if [ "$is_abs" = "false" ]; then
+      # Already relative - resolve from gitdir_file location to get absolute
+      resolved_path=$(realpath -m "$wt_dir/$stored_path")
+    fi
+
+    # Get worktree real directory (parent of .git file)
+    local wt_real_dir=$(dirname "$resolved_path")
+    [ ! -d "$wt_real_dir" ] && continue
+
+    # Compute relative path: .bare/worktrees/{name}/ → worktree/.git
+    local bare_wt_abs=$(realpath -m "$wt_dir")
+    local wt_abs=$(realpath -m "$wt_real_dir")
+    local rel_gitdir=$(realpath -m --relative-to="$bare_wt_abs" "$wt_abs/.git")
+
+    if [ "$stored_path" != "$rel_gitdir" ]; then
+      printf '%s\n' "$rel_gitdir" > "$gitdir_file"
+      echo "REPAIRED: $wt_name/gitdir → $rel_gitdir"
       REPAIRED=$((REPAIRED + 1))
     fi
 
-    # Fix the worktree's .git file
-    local wt_real_dir=$(dirname "$fixed_path")
+    # Fix the worktree's .git pseudo-file → relative path to .bare/worktrees/{name}
     if [ -f "$wt_real_dir/.git" ]; then
       local git_content=$(cat "$wt_real_dir/.git" | tr -d '\n\r')
       local git_path="${git_content#gitdir: }"
-      local fixed_git_path=$(normalize_path_for_platform "$git_path")
-      if [ "$git_path" != "$fixed_git_path" ]; then
-        echo "gitdir: $fixed_git_path" > "$wt_real_dir/.git"
-        echo "REPAIRED: $wt_name/.git → $fixed_git_path"
+      local rel_bare=$(realpath -m --relative-to="$wt_abs" "$bare_wt_abs")
+
+      if [ "$git_path" != "$rel_bare" ]; then
+        printf 'gitdir: %s\n' "$rel_bare" > "$wt_real_dir/.git"
+        echo "REPAIRED: $wt_name/.git → $rel_bare"
         REPAIRED=$((REPAIRED + 1))
       fi
     fi
@@ -385,6 +416,49 @@ repair_worktree_paths() {
 
 ---
 
+## PREFLIGHT_GIT_CHECK
+
+Lightweight check to ensure git is accessible in the current worktree. If git fails (cross-platform path issue), locates `.bare` and calls `repair_worktree_paths`. Must be called before any git operation in agents that may run in worktrees created from a different environment (Windows vs WSL).
+
+```bash
+preflight_git_check() {
+  # Quick test: if git works, nothing to do
+  git rev-parse --git-dir >/dev/null 2>&1 && return 0
+
+  echo "Git inaccessible — attempting worktree path repair..."
+
+  # Find .bare directory by walking up
+  local BARE_DIR=""
+  local DIR="$(pwd)"
+  while [ "$DIR" != "/" ]; do
+    [ -d "$DIR/.bare" ] && { BARE_DIR="$DIR/.bare"; break; }
+    DIR=$(dirname "$DIR")
+  done
+
+  if [ -z "$BARE_DIR" ]; then
+    echo "ERROR: No .bare directory found. Not a GitFlow worktree."
+    return 1
+  fi
+
+  # Ensure platform is detected
+  [ -z "$GF_PLATFORM" ] && detect_platform
+
+  # Repair all worktree paths to relative format
+  repair_worktree_paths "$BARE_DIR"
+
+  # Verify repair
+  if git rev-parse --git-dir >/dev/null 2>&1; then
+    echo "Worktree paths repaired successfully."
+    return 0
+  else
+    echo "ERROR: Worktree repair failed. Run /gitflow init to reconfigure."
+    return 1
+  fi
+}
+```
+
+---
+
 ## RESOLVE_WORKSPACE
 
 Resolves the workspace JSON file by walking up the directory tree.

package/templates/skills/gitflow/phases/abort.md

@@ -67,6 +67,10 @@ BRANCH_TYPE=$(echo $CURRENT | cut -d'/' -f1)
 echo "⚠️ This will delete branch $CURRENT and its worktree"
 echo "All uncommitted changes will be LOST"
 
+# Repair cross-platform worktree paths (WSL ↔ Windows)
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
 # Find worktree
 WORKTREE=$(git worktree list | grep "$CURRENT" | awk '{print $1}')
 

package/templates/skills/gitflow/phases/cleanup.md

@@ -38,6 +38,10 @@ CURRENT=$(git rev-parse --abbrev-ref HEAD)
 ```bash
 echo "Scanning worktrees..."
 
+# Repair cross-platform worktree paths (WSL ↔ Windows)
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
 mkdir -p .claude/gitflow/cache
 git worktree list > .claude/gitflow/cache/worktrees.txt
 

package/templates/skills/gitflow/references/finish-cleanup.md

@@ -3,6 +3,10 @@
 ## Clean Up Worktree
 
 ```bash
+# Repair cross-platform worktree paths before cleanup (WSL ↔ Windows)
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
 # Find worktree for this branch (use --porcelain for reliable parsing)
 WORKTREE_PATH=$(git worktree list --porcelain | grep -B2 "branch refs/heads/$BRANCH" | grep "^worktree " | sed 's/^worktree //')
 

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

@@ -50,6 +50,10 @@ if [ "$WORKTREE_MODE" = "simple" ]; then
     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"

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

@@ -27,7 +27,7 @@ esac
 mkdir -p "$(dirname "$WORKTREE_PATH")"
 git worktree add -b "$FULL_BRANCH" "$WORKTREE_PATH" "origin/$BASE_BRANCH"
 
-# Fix cross-platform paths in worktree metadata (if created from different platform)
+# Convert worktree paths to relative format (cross-platform: Windows + WSL)
 repair_worktree_paths "$(git rev-parse --git-common-dir)"
 
 # POST-CREATION VALIDATION (BLOCKING)

package/templates/skills/ralph-loop/steps/step-04-check.md

@@ -34,8 +34,7 @@ const allDone = (tasksCompleted + tasksSkipped) === tasksTotal;
 # Quick build check (quiet mode)
 dotnet build --no-restore --verbosity quiet
 BUILD_RC=$?
-# Cleanup WSL Roslyn artifacts (literal bin\Debug folders)
-for d in src/*/bin?Debug bin?Debug; do [ -d "$d" ] && rm -rf "$d"; done
+# Note: WSL bin\Debug cleanup handled by PostToolUse hook (wsl-dotnet-cleanup.sh)
 if [ $BUILD_RC -ne 0 ]; then
   echo "BUILD REGRESSION detected between apex invocations"
   # Inject fix task — apex will handle the actual fix