Add WSL wrapper and usage docs for EncodingFixTool

Author: MaxLogic

agent-skill/encodingfix-delphi-cleanup/SKILL.md

@@ -26,19 +26,43 @@ git status --short
 
 If unrelated user changes are dirty, avoid broad cleanup. Narrow `path=...`, override `ext=...`, or ask before touching files outside our work.
 
-2. In a Git worktree, prefer the AI cleanup preset:
+2. In a Git worktree, prefer the AI cleanup preset.
+
+From WSL, run the Bash wrapper so WSL paths are converted before the Windows executable receives them. If the repo `bin` directory is on `PATH`, prefer:
+
+```bash
+EncodingFixTool.sh path=. preset=delphi-ai scope=git-changed format=json
+```
+
+Otherwise, use the repo-local wrapper path:
+
+```bash
+./bin/EncodingFixTool.sh path=. preset=delphi-ai scope=git-changed format=json
+```
+
+From Windows PowerShell, run:
 
 ```powershell
 EncodingFixTool path=. preset=delphi-ai scope=git-changed format=json
 ```
 
-If the executable is not on `PATH`, use a local build such as:
+If the executable is not on `PATH`, use a local Windows build such as:
 
 ```powershell
 .\bin\EncodingFixTool.exe path=. preset=delphi-ai scope=git-changed format=json
 ```
 
-3. Outside Git, use an explicit path and dry run first:
+3. Outside Git, use an explicit path and dry run first.
+
+From WSL:
+
+```bash
+EncodingFixTool.sh path=./src preset=delphi-ai format=json dry
+```
+
+Use `./bin/EncodingFixTool.sh ...` instead if the wrapper is not on `PATH`.
+
+From Windows PowerShell:
 
 ```powershell
 EncodingFixTool path=.\src preset=delphi-ai format=json dry

bin/EncodingFixTool.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+exe_path="$script_dir/EncodingFixTool.exe"
+
+if [[ ! -f "$exe_path" ]]; then
+  printf 'EncodingFixTool.exe not found next to %s\n' "$0" >&2
+  exit 127
+fi
+
+is_windows_path() {
+  [[ "$1" =~ ^[A-Za-z]:[\\/].* || "$1" =~ ^\\\\.* ]]
+}
+
+to_windows_path() {
+  local value="$1"
+
+  if [[ -z "$value" ]] || is_windows_path "$value"; then
+    printf '%s' "$value"
+    return
+  fi
+
+  wslpath -aw -- "$value"
+}
+
+convert_arg() {
+  local arg="$1"
+
+  if [[ "$arg" =~ ^(-{0,2}|/)(path|config|bkp-dir)([:=])(.*)$ ]]; then
+    printf '%s%s%s%s' "${BASH_REMATCH[1]}" "${BASH_REMATCH[2]}" "${BASH_REMATCH[3]}" "$(to_windows_path "${BASH_REMATCH[4]}")"
+  else
+    printf '%s' "$arg"
+  fi
+}
+
+shopt -s nocasematch
+converted_args=()
+for arg in "$@"; do
+  converted_args+=("$(convert_arg "$arg")")
+done
+
+exec "$exe_path" "${converted_args[@]}"