@atlashub/smartstack-cli 3.18.0 → 3.20.0

package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md

@@ -607,7 +607,10 @@ Next Steps:
 
   3. When ready, launch development:
 
-     /ralph-loop -r
+     /ralph-loop
+
+     Note: Use /ralph-loop -r ONLY to resume an interrupted loop.
+           After a fresh /business-analyse, always use /ralph-loop (without -r).
 
   4. Ralph-loop will:
      - Process modules in topological order: [{module list}]

package/templates/skills/business-analyse/steps/step-06-review.md

@@ -262,7 +262,8 @@ Artifacts regenerated:
 
 NEXT STEPS:
 1. Open the new ba-interactive.html to verify corrections
-2. Run /ralph-loop -r to start development from the updated analysis
+2. Run /ralph-loop to start development from the updated analysis
+   (Use /ralph-loop -r ONLY to resume an interrupted loop)
 ═══════════════════════════════════════════════════════════════
 ```
 

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

@@ -12,7 +12,7 @@
 > **Version:** {version}
 > **Validated Specs:** feature.json (validation.decision = APPROVED)
 > **Source:** `docs/business/{app}/{module}/business-analyse/v{version}/feature.json`
-> **Implementation:** `/ralph-loop -r`
+> **Implementation:** `/ralph-loop`
 
 ## DEVELOPER INSTRUCTIONS
 
@@ -20,9 +20,10 @@ This document is a self-contained prompt for Claude Code.
 
 **Lancement:**
 ```
-/ralph-loop -r
+/ralph-loop
 ```
-> Pre-generated `.ralph/prd.json` with atomic task breakdown.
+> Ralph-loop auto-detects BA artifacts and derives PRD task breakdowns.
+> Use `/ralph-loop -r` only to resume an interrupted loop.
 
 ---
 
@@ -178,6 +179,6 @@ From: `feature.specification.seedDataCore` (5 core files), `feature.specificatio
 
 **Lancement:**
 ```bash
-/ralph-loop -r
+/ralph-loop
 ```
 ```

package/templates/skills/business-analyse/templates/tpl-launch-displays.md

@@ -34,7 +34,10 @@ Effort:    {total_days} days ({total_hours} hours)
   3. Si retours --> relancer /business-analyse pour une nouvelle itération
   4. Une fois validé, lancer le développement:
 
-     /ralph-loop -r
+     /ralph-loop
+
+     Note: /ralph-loop -r sert UNIQUEMENT à reprendre une boucle interrompue.
+           Après un /business-analyse, toujours utiliser /ralph-loop (sans -r).
 
 ═══════════════════════════════════════════════════════════════
 ```

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

@@ -353,7 +353,7 @@ Feature: {FEAT-XXX} {Feature Name}
 > **Module:** business/{application}/{module}
 > **Version:** 1.0
 > **Validated Specs:** Specification v1.0 (validation.json)
-> **Implementation:** `/ralph-loop -r`
+> **Implementation:** `/ralph-loop`
 
 ## DEVELOPER INSTRUCTIONS
 
@@ -361,9 +361,10 @@ This document is a self-contained prompt for Claude Code.
 
 **Lancement:**
 ```
-/ralph-loop -r
+/ralph-loop
 ```
-> Pre-generated `.ralph/prd.json` with atomic task breakdown.
+> Ralph-loop auto-detects BA artifacts and derives PRD task breakdowns.
+> Use `/ralph-loop -r` only to resume an interrupted loop.
 
 ---
 
@@ -459,7 +460,7 @@ FRONTEND:
 
 **Lancement:**
 ```bash
-/ralph-loop -r
+/ralph-loop
 ```
 ```
 

package/templates/skills/gitflow/_shared.md

@@ -57,32 +57,34 @@ normalize_path_for_platform() {
       fi
       ;;
     *)
-      # Normalize backslashes to forward slashes
-      echo "${input_path//\\//}"
-      ;;
-  esac
-}
-
-# Translates a path to storage-neutral format for config.json (forward slashes, drive letter)
-normalize_path_for_storage() {
-  local input_path="$1"
-  case "$GF_PLATFORM" in
-    wsl)
-      # WSL path → Windows-style for config: /mnt/d/foo/bar → D:/foo/bar
+      # WSL path → Windows path: /mnt/d/foo → D:/foo
       if [[ "$input_path" =~ ^/mnt/([a-z])/(.*) ]]; then
         local drive=$(echo "${BASH_REMATCH[1]}" | tr '[:lower:]' '[:upper:]')
         echo "${drive}:/${BASH_REMATCH[2]}"
       else
-        echo "$input_path"
+        # Normalize backslashes to forward slashes
+        echo "${input_path//\\//}"
       fi
       ;;
-    *)
-      # Normalize backslashes to forward slashes
-      echo "${input_path//\\//}"
-      ;;
   esac
 }
 
+# Translates a path to storage-neutral format for config.json (forward slashes, drive letter)
+# Always converts WSL paths to Windows-style, regardless of current platform
+normalize_path_for_storage() {
+  local input_path="$1"
+  # WSL path → Windows-style: /mnt/d/foo → D:/foo (always, regardless of platform)
+  if [[ "$input_path" =~ ^/mnt/([a-z])/(.*) ]]; then
+    local drive=$(echo "${BASH_REMATCH[1]}" | tr '[:lower:]' '[:upper:]')
+    echo "${drive}:/${BASH_REMATCH[2]}"
+  elif [[ "$input_path" =~ ^[A-Za-z]:[\\/] ]]; then
+    # Normalize backslashes only
+    echo "${input_path//\\//}"
+  else
+    echo "$input_path"
+  fi
+}
+
 # Returns current directory in platform-appropriate format
 get_current_dir() {
   local raw_pwd
@@ -314,6 +316,52 @@ cleanup_worktree_for_branch() {
 
 ---
 
+## 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.
+
+```bash
+repair_worktree_paths() {
+  local BARE_DIR="$1"  # Path to .bare directory
+  local WORKTREES_DIR="$BARE_DIR/worktrees"
+  [ ! -d "$WORKTREES_DIR" ] && return 0
+
+  local REPAIRED=0
+  for wt_dir in "$WORKTREES_DIR"/*/; do
+    [ ! -d "$wt_dir" ] && continue
+    local wt_name=$(basename "$wt_dir")
+    local gitdir_file="$wt_dir/gitdir"
+    [ ! -f "$gitdir_file" ] && continue
+
+    # Fix .bare/worktrees/{name}/gitdir
+    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"
+      REPAIRED=$((REPAIRED + 1))
+    fi
+
+    # Fix the worktree's .git file
+    local wt_real_dir=$(dirname "$fixed_path")
+    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"
+        REPAIRED=$((REPAIRED + 1))
+      fi
+    fi
+  done
+
+  [ "$REPAIRED" -gt 0 ] && echo "Worktree paths: $REPAIRED file(s) repaired"
+}
+```
+
+---
+
 ## RESOLVE_WORKSPACE
 
 Resolves the workspace JSON file by walking up the directory tree.

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

@@ -61,15 +61,20 @@ HOTFIXES=$(git branch -r | grep "origin/${GF_HOTFIX_PREFIX}" | sed 's/origin\///
 ### 4. Worktree Status
 
 ```bash
+# Repair cross-platform paths before listing (WSL ↔ Windows)
+detect_platform
+repair_worktree_paths "$(git rev-parse --git-common-dir 2>/dev/null || echo '.bare')"
+
 WORKTREES=$(git worktree list)
 WORKTREE_COUNT=$(echo "$WORKTREES" | wc -l)
 
-# Check for orphaned worktrees
+# Check for orphaned worktrees (normalize paths for cross-platform compatibility)
 ORPHANED=""
 while read -r line; do
-  PATH=$(echo "$line" | awk '{print $1}')
+  WT_PATH=$(echo "$line" | awk '{print $1}')
+  WT_PATH=$(normalize_path_for_platform "$WT_PATH")
   BRANCH=$(echo "$line" | awk '{print $3}' | tr -d '[]')
-  [ ! -d "$PATH" ] && ORPHANED="$ORPHANED\n$PATH ($BRANCH)"
+  [ ! -d "$WT_PATH" ] && ORPHANED="$ORPHANED\n$WT_PATH ($BRANCH)"
 done <<< "$WORKTREES"
 ```
 

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

@@ -50,11 +50,14 @@ EOF
 }
 ```
 
-## 7b. Frontend: .env.local + npm script
+## 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.local" << EOF
+  cat > "$WEB_DIR/.env.standalone" << EOF
 VITE_API_URL=http://localhost:${API_PORT}
 VITE_APP_ENV=local
 VITE_DEBUG=true
@@ -66,7 +69,7 @@ EOF
       const fs = require('fs');
       const pkg = JSON.parse(fs.readFileSync('$WEB_DIR/package.json', 'utf8'));
       if (!pkg.scripts.local) {
-        pkg.scripts.local = 'vite --mode local --port ${WEB_PORT}';
+        pkg.scripts.local = 'vite --mode standalone --port ${WEB_PORT}';
         fs.writeFileSync('$WEB_DIR/package.json', JSON.stringify(pkg, null, 2) + '\n');
       }
     "

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

@@ -158,6 +158,9 @@ 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)
+repair_worktree_paths "$(git rev-parse --git-common-dir)"
 ```
 
 **Mode: --no-worktree**
@@ -190,7 +193,7 @@ fi
 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.local` + `npm run local` script
+- **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
 
@@ -276,7 +279,7 @@ See [references/start-local-config.md](../references/start-local-config.md) for
 - 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.local` + `npm run local` script (if web project 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