feat: add native Linux64 support

Build and run EncodingFixTool as a native Linux64 executable. Make process, path, config, encoding, and Git handling platform-aware, and cover native Linux behavior including Unicode and rename/copy porcelain records.

Author: MaxLogic

.gitignore

@@ -83,6 +83,8 @@ modules/
 .aider*
 .agents/
 /bin/*.cmds
+/bin/Linux64/
+/src/dcu/
 /dist/
 *.log
 /issues/

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [Unreleased]
+
+### Added
+
+- Added a native Delphi Linux64 build at `bin/Linux64/EncodingFixTool`, including native regression coverage for encoding repair, CRLF normalization, backups, XDG configuration, Git-changed scope, shell quoting, and case-sensitive paths.
+
+### Changed
+
+- Changed `EncodingFixTool.sh` to launch the native Linux64 executable directly instead of invoking the Windows EXE through WSL interoperability.
+- Made Git execution, shell quoting, user config discovery, and path containment platform-correct; Linux avoids treating its UTF-8 default encoding as a legacy ANSI candidate while Windows retains active-code-page compatibility.
+
 ## [v1.5] - 2026-06-24
 
 ### Fixed

README.md

@@ -1,7 +1,7 @@
 # EncodingFixTool
 
 A fast, parallel, command-line fixer for Delphi source file encodings.
-It scans a directory tree or one explicit file; detects UTF-8/ASCII vs. legacy single-byte encodings; repairs mixed lines (Windows-1250/1252/ANSI), and writes clean UTF-8 with an optional BOM. Line endings are preserved by default, or normalized to Windows CRLF when requested.
+It scans a directory tree or one explicit file; detects UTF-8/ASCII vs. legacy single-byte encodings; repairs mixed lines (Windows-1250/1252, plus the active ANSI code page on Windows), and writes clean UTF-8 with an optional BOM. Line endings are preserved by default, or normalized to Windows CRLF when requested.
 
 ---
 
@@ -43,6 +43,17 @@ EncodingFixTool ext="*.pas,*.dpr, .dfm"
 
 > Tip: Parameters accept `key=value` or `key:value`. You can prefix flags with `-` (and `/` on Windows), e.g. `-v`, `-dry`.
 
+### Windows and Linux
+
+The Windows build is `bin\EncodingFixTool.exe`. The native Linux64 build is `bin/Linux64/EncodingFixTool`.
+From Linux or WSL, use the thin launcher so arguments remain native Linux paths:
+
+```bash
+./bin/EncodingFixTool.sh path=./src preset=delphi-ai format=json
+```
+
+The launcher executes the Linux64 ELF binary directly. It does not start a Windows process and does not require WSL Windows interoperability or `wslpath`.
+
 ---
 
 ## Parameters
@@ -97,7 +108,7 @@ C:\bkp\src\foo\bar\Main.pas
    * For each line, try:
 
      * **UTF-8 (strict)** — if it round-trips, use it.
-     * **Windows-1250** (Central Europe/PL), **Windows-1252** (Western/DE), and **ANSI** — decode and **score**:
+     * **Windows-1250** (Central Europe/PL) and **Windows-1252** (Western/DE) — decode and **score**. Windows builds also score the active system ANSI code page; Linux does not treat its UTF-8 default encoding as ANSI:
 
        * +2 for valid Polish/German diacritics,
        * +1 for typical source characters (letters/digits/whitespace/common punctuation),
@@ -165,6 +176,12 @@ For AI coding agents working in Delphi projects, run the cleanup from the reposi
 EncodingFixTool path=. preset=delphi-ai scope=git-changed format=json
 ```
 
+From Linux or WSL:
+
+```bash
+EncodingFixTool.sh path=. preset=delphi-ai scope=git-changed format=json
+```
+
 This command is intentionally compact for agent workflows:
 
 * `preset=delphi-ai` applies the Delphi cleanup defaults.
@@ -206,7 +223,7 @@ Example prompt:
 After editing Delphi files, use the EncodingFix Delphi cleanup skill before running the build.
 ```
 
-The skill itself is self-contained, but the `EncodingFixTool` executable must be available on `PATH` or via a repo-local path such as `.\bin\EncodingFixTool.exe`.
+The skill itself is self-contained, but the platform executable must be available on `PATH` or through the repo-local Windows EXE / Linux shell launcher.
 
 ### Use with Claude Code
 
@@ -227,7 +244,8 @@ User-defined presets are JSON objects under a top-level `presets` key. Configura
 Recommended locations:
 
 * Repo-local: `.encodingfix.json`, discovered from `path` upward.
-* User-global: `%APPDATA%\MaxLogic\EncodingFixTool\config.json`.
+* User-global on Windows: `%APPDATA%\MaxLogic\EncodingFixTool\config.json`.
+* User-global on Linux: `$XDG_CONFIG_HOME/MaxLogic/EncodingFixTool/config.json`, falling back to `$HOME/.config/MaxLogic/EncodingFixTool/config.json`.
 * Explicit one-off: pass `config=path\to\config.json`.
 
 Precedence is conservative and predictable:

TASKS.md

@@ -1,10 +1,10 @@
 # Tasks
 
-Next task ID: T-008
+Next task ID: T-010
 
 ## Summary
-Open tasks: 0 (In Progress: 0, Next Today: 0, Next This Week: 0, Next Later: 0, Blocked: 0)
-Done tasks: 7
+Open tasks: 1 (In Progress: 0, Next Today: 0, Next This Week: 0, Next Later: 1, Blocked: 0)
+Done tasks: 8
 
 ## In Progress
 
@@ -14,10 +14,48 @@ Done tasks: 7
 
 ## Next - Later
 
+### T-009 [CLI] Bound POSIX child-process execution
+Outcome:
+- Linux command execution enforces the same 30-second upper bound as Windows without depending on an optional external `timeout` command.
+- Timeout cleanup terminates and reaps the child process without leaving Git processes behind.
+- Native Linux regression coverage verifies successful commands and timeout behavior.
+Proof:
+- Run: `wsl.exe -e bash tests/Invoke-EncodingFixTool.Linux64.Tests.sh`
+  Expect: exit=0, timeout regression passes, and no test-owned child process remains.
+- Run: `& $env:DAK_EXE build --project src\EncodingFixTool.dproj --delphi 23.0 --platform Linux64 --config Release --target Rebuild --ai --show-warnings`
+  Expect: exit=0, zero warnings, zero errors.
+Touches: src/EncodingFixToolCore.pas, tests/Invoke-EncodingFixTool.Linux64.Tests.sh
+Verify: integration-test, build-only
+
 ## Blocked
 
 ## Done
 
+### T-008 [CLI] Add native Linux64 support
+Completed: 2026-07-10
+Outcome:
+- `EncodingFixTool.dproj` builds a native Linux64 executable at `bin/Linux64/EncodingFixTool` while preserving Win32 and Win64 builds.
+- Platform-sensitive process execution, Git integration, shell quoting, user config lookup, paths, encodings, and line endings behave correctly on Windows and Linux.
+- `EncodingFixTool.sh` launches the native Linux64 binary directly without `wslpath` or Windows executable interop.
+- Native Linux regression coverage verifies ELF execution, CRLF cleanup, legacy encoding conversion, config lookup, backups, case-sensitive paths, and Git paths including Unicode, rename, and copy records.
+- README, agent-skill guidance, and CHANGELOG document the native Linux workflow.
+Proof:
+- PASS: `& $env:DAK_EXE build --project src\EncodingFixTool.dproj --delphi 23.0 --platform Linux64 --config Release --target Rebuild --ai --show-warnings`
+  Result: exit=0, zero warnings, zero errors, ELF artifact exists, and the Windows resource hash is preserved.
+- PASS: `wsl.exe -e bash tests/Invoke-EncodingFixTool.Linux64.Tests.sh`
+  Result: exit=0, output contains `EncodingFixTool Linux64 tests passed.`
+- PASS: `.\bin\EncodingFixTool.Tests.exe`
+  Result: exit=0, 31 passed, 0 failed, 0 ignored.
+- PASS: `powershell -NoProfile -ExecutionPolicy Bypass -File tests\Invoke-EncodingFixTool.Tests.ps1`
+  Result: exit=0, output contains `EncodingFixTool CLI tests passed.`
+- PASS: Win32 and Win64 Release rebuilds through DelphiAIKit with warnings enabled.
+  Result: exit=0, zero warnings, zero errors for both platforms.
+- PASS: PowerShell Script Analyzer, ShellCheck, Bash syntax, project XML parsing, and `git diff --check`.
+  Result: no findings.
+Touches: src/EncodingFixTool.dpr, src/EncodingFixTool.dproj, src/EncodingFixTool.res, src/EncodingFixToolCore.pas, bin/EncodingFixTool.sh, tests/Invoke-EncodingFixTool.Linux64.Tests.sh, README.md, agent-skill/encodingfix-delphi-cleanup/SKILL.md, agent-skill/encodingfix-delphi-cleanup/references/encodingfix-tool.md, CHANGELOG.md
+Verify: integration-test, cli-proof, build-only
+Notes: The approved design keeps `sLineBreak` for platform-native console help and explicit `#13#10` for `eol=crlf`. Linux user config follows XDG with `$HOME/.config` fallback. RED/GREEN was strict for native artifact, Linux path containment, and Unicode Git paths; supplementary platform and rename/copy coverage was completed under GREEN.
+
 ### T-007 [CLI] Support single-file path targets
 Completed: 2026-06-16
 Outcome:

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

@@ -28,7 +28,7 @@ If unrelated user changes are dirty, avoid broad cleanup. Narrow `path=...`, ove
 
 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:
+From Linux or WSL, run the Bash wrapper. It launches the native Linux64 binary directly, so Linux paths are passed through unchanged and WSL Windows interoperability is not involved. If the repo `bin` directory is on `PATH`, prefer:
 
 ```bash
 EncodingFixTool.sh path=. preset=delphi-ai scope=git-changed format=json

agent-skill/encodingfix-delphi-cleanup/references/encodingfix-tool.md

@@ -4,7 +4,7 @@ Use this reference when the standard `preset=delphi-ai scope=git-changed` workfl
 
 ## Runtime Dependency
 
-Prefer `EncodingFixTool` from `PATH`. If unavailable, use a repo-local executable such as `.\bin\EncodingFixTool.exe`.
+Prefer `EncodingFixTool` from `PATH` on Windows or `EncodingFixTool.sh` on Linux/WSL. Repo-local paths are `.\bin\EncodingFixTool.exe` on Windows and `./bin/EncodingFixTool.sh` on Linux/WSL. The shell launcher executes `bin/Linux64/EncodingFixTool` directly and does not use Windows interoperability.
 
 ## Delphi AI Preset
 
@@ -55,6 +55,8 @@ Repo presets may live in `.encodingfix.json`; user presets may live in:
 
 ```text
 %APPDATA%\MaxLogic\EncodingFixTool\config.json
+$XDG_CONFIG_HOME/MaxLogic/EncodingFixTool/config.json
+$HOME/.config/MaxLogic/EncodingFixTool/config.json
 ```
 
 Preset precedence:

bin/EncodingFixTool.sh

@@ -2,42 +2,11 @@
 set -euo pipefail
 
 script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
-exe_path="$script_dir/EncodingFixTool.exe"
+tool_path="$script_dir/Linux64/EncodingFixTool"
 
-if [[ ! -f "$exe_path" ]]; then
-  printf 'EncodingFixTool.exe not found next to %s\n' "$0" >&2
+if [[ ! -x "$tool_path" ]]; then
+  printf 'EncodingFixTool Linux64 executable not found or not executable: %s\n' "$tool_path" >&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[@]}"
+exec "$tool_path" "$@"

src/EncodingFixTool.dpr

@@ -1,7 +1,9 @@
 program EncodingFixTool;
 
 {$APPTYPE CONSOLE}
+{$IFDEF MSWINDOWS}
 {$R *.res}
+{$ENDIF}
 
 uses
   System.SysUtils,

src/EncodingFixTool.dproj

@@ -5,7 +5,7 @@
         <Base>True</Base>
         <Config Condition="'$(Config)'==''">Release</Config>
         <ProjectName Condition="'$(ProjectName)'==''">EncodingFixTool</ProjectName>
-        <TargetedPlatforms>693377</TargetedPlatforms>
+        <TargetedPlatforms>131</TargetedPlatforms>
         <AppType>Console</AppType>
         <FrameworkType>None</FrameworkType>
         <ProjectVersion>20.2</ProjectVersion>
@@ -29,6 +29,11 @@
         <CfgParent>Base</CfgParent>
         <Base>true</Base>
     </PropertyGroup>
+    <PropertyGroup Condition="('$(Platform)'=='Linux64' and '$(Base)'=='true') or '$(Base_Linux64)'!=''">
+        <Base_Linux64>true</Base_Linux64>
+        <CfgParent>Base</CfgParent>
+        <Base>true</Base>
+    </PropertyGroup>
     <PropertyGroup Condition="('$(Platform)'=='Win32' and '$(Base)'=='true') or '$(Base_Win32)'!=''">
         <Base_Win32>true</Base_Win32>
         <CfgParent>Base</CfgParent>
@@ -87,7 +92,6 @@
         <DCC_N>false</DCC_N>
         <DCC_S>false</DCC_S>
         <DCC_ImageBase>00400000</DCC_ImageBase>
-        <SanitizedProjectName>EncodingFixTool</SanitizedProjectName>
         <VerInfo_IncludeVerInfo>true</VerInfo_IncludeVerInfo>
         <VerInfo_MajorVer>1</VerInfo_MajorVer>
         <VerInfo_MinorVer>5</VerInfo_MinorVer>
@@ -150,6 +154,14 @@
         <VerInfo_Keys>CompanyName=;FileDescription=$(MSBuildProjectName);FileVersion=1.5.0.0;InternalName=;LegalCopyright=;LegalTrademarks=;OriginalFilename=;ProductName=$(MSBuildProjectName);ProductVersion=1.5.0.0;Comments=;ProgramID=com.embarcadero.$(MSBuildProjectName)</VerInfo_Keys>
         <VerInfo_Locale>1033</VerInfo_Locale>
     </PropertyGroup>
+    <PropertyGroup Condition="'$(Base_Linux64)'!=''">
+        <BRCC_OutputDir>.\dcu\Linux64\$(Config)</BRCC_OutputDir>
+        <DCC_ExeOutput>..\bin\Linux64</DCC_ExeOutput>
+        <DCC_Namespace>Posix;System.Posix;$(DCC_Namespace)</DCC_Namespace>
+        <Icon_MainIcon></Icon_MainIcon>
+        <Icns_MainIcns></Icns_MainIcns>
+        <VerInfo_IncludeVerInfo>false</VerInfo_IncludeVerInfo>
+    </PropertyGroup>
     <PropertyGroup Condition="'$(Cfg_1)'!=''">
         <DCC_Define>RELEASE;$(DCC_Define)</DCC_Define>
         <DCC_DebugInformation>0</DCC_DebugInformation>
@@ -207,27 +219,20 @@
                 <Source>
                     <Source Name="MainSource">EncodingFixTool.dpr</Source>
                 </Source>
-                <Excluded_Packages>
-                    <Excluded_Packages Name="C:\Users\Public\Documents\Embarcadero\Studio\23.0\Bpl\wPDF5_DX14_Pack.bpl">File C:\Users\Public\Documents\Embarcadero\Studio\23.0\Bpl\wPDF5_DX14_Pack.bpl not found</Excluded_Packages>
-                    <Excluded_Packages Name="$(BDSBIN)\dcloffice2k290.bpl">Microsoft Office 2000 Sample Automation Server Wrapper Components</Excluded_Packages>
-                    <Excluded_Packages Name="$(BDSBIN)\dclofficexp290.bpl">Microsoft Office XP Sample Automation Server Wrapper Components</Excluded_Packages>
-                    <Excluded_Packages Name="F:\TMS-SmartSetUp\.tmssetup\build\bpl\Win32\VCL_TMSVCLGridExcelBridge_DESIGN290.bpl">TMS VCL Grid Excel Bridge (Design)</Excluded_Packages>
-                </Excluded_Packages>
             </Delphi.Personality>
             <Platforms>
                 <Platform value="Android">False</Platform>
-                <Platform value="Android64">True</Platform>
-                <Platform value="iOSDevice64">True</Platform>
-                <Platform value="iOSSimARM64">True</Platform>
+                <Platform value="Android64">False</Platform>
+                <Platform value="iOSDevice64">False</Platform>
+                <Platform value="iOSSimARM64">False</Platform>
                 <Platform value="Linux64">True</Platform>
-                <Platform value="OSX64">True</Platform>
-                <Platform value="OSXARM64">True</Platform>
+                <Platform value="OSX64">False</Platform>
+                <Platform value="OSXARM64">False</Platform>
                 <Platform value="Win32">True</Platform>
                 <Platform value="Win64">True</Platform>
             </Platforms>
         </BorlandProject>
         <ProjectFileVersion>12</ProjectFileVersion>
     </ProjectExtensions>
     <Import Project="$(BDS)\Bin\CodeGear.Delphi.Targets" Condition="Exists('$(BDS)\Bin\CodeGear.Delphi.Targets')"/>
-    <Import Project="$(APPDATA)\Embarcadero\$(BDSAPPDATABASEDIR)\$(PRODUCTVERSION)\UserTools.proj" Condition="Exists('$(APPDATA)\Embarcadero\$(BDSAPPDATABASEDIR)\$(PRODUCTVERSION)\UserTools.proj')"/>
 </Project>