feat(windows): add native Windows support

.github/workflows/build-wheels.yml

@@ -32,6 +32,9 @@ jobs:
           - os: macos-latest
             target: aarch64-apple-darwin
             manylinux: auto
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            manylinux: auto
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v6

.github/workflows/ci.yml

@@ -15,6 +15,30 @@ jobs:
       - run: cargo clippy --all-targets --locked -- -D warnings
       - run: cargo test --locked
 
+  # Fast native Windows gate. The pinned real-tool lifecycle has its own matrix
+  # below because it is slower and needs Node-installed external binaries.
+  windows-build:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - uses: Swatinem/rust-cache@v2.9.1
+      - run: cargo fmt --all -- --check
+      - run: cargo clippy --all-targets --locked -- -D warnings
+      - run: cargo test --all-targets --locked
+      - run: cargo build --release --locked
+      - name: Smoke-test distributable Windows binary
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force target/package-smoke | Out-Null
+          Copy-Item target/release/hcom.exe target/package-smoke/hcom-windows-x86_64.exe
+          $version = & target/package-smoke/hcom-windows-x86_64.exe --version
+          if ($LASTEXITCODE -ne 0 -or $version -notmatch '^hcom ') {
+            throw "Packaged binary smoke test failed: $version"
+          }
+
   typecheck:
     runs-on: ubuntu-latest
     permissions:
@@ -30,24 +54,42 @@ jobs:
       - run: bash ./scripts/typecheck.sh
 
   real-tool-tests:
-    name: Real tool (${{ matrix.tool }})
-    runs-on: ubuntu-latest
+    name: Real tool (${{ matrix.tool }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
     timeout-minutes: 25
     permissions:
       contents: read
     strategy:
       fail-fast: false
       matrix:
         include:
-          - tool: codex
+          - os: ubuntu-latest
+            tool: codex
+            package: "@openai/codex@0.141.0"
+            cache: codex-0.141.0
+            test: real_tool_codex
+          - os: ubuntu-latest
+            tool: claude
+            package: "@anthropic-ai/claude-code@2.1.185"
+            cache: claude-2.1.185
+            test: real_tool_claude
+          - os: ubuntu-latest
+            tool: relay
+            package: "@anthropic-ai/claude-code@2.1.185"
+            cache: relay-claude-2.1.185
+            test: test_relay_roundtrip
+          - os: windows-latest
+            tool: codex
             package: "@openai/codex@0.141.0"
             cache: codex-0.141.0
             test: real_tool_codex
-          - tool: claude
+          - os: windows-latest
+            tool: claude
             package: "@anthropic-ai/claude-code@2.1.185"
             cache: claude-2.1.185
             test: real_tool_claude
-          - tool: relay
+          - os: windows-latest
+            tool: relay
             package: "@anthropic-ai/claude-code@2.1.185"
             cache: relay-claude-2.1.185
             test: test_relay_roundtrip
@@ -66,6 +108,23 @@ jobs:
             target/mock-tools
             target/npm-cache
           key: ${{ runner.os }}-mock-tools-${{ matrix.cache }}
-      - run: ./scripts/install-mock-tools.sh '${{ matrix.package }}'
-      - run: echo "$PWD/target/mock-tools/bin" >> "$GITHUB_PATH"
-      - run: cargo test --locked --test '${{ matrix.test }}' -- --ignored --nocapture --test-threads=1
+      - name: Install pinned tool (Unix)
+        if: runner.os != 'Windows'
+        run: ./scripts/install-mock-tools.sh '${{ matrix.package }}'
+      - name: Add pinned tool to PATH (Unix)
+        if: runner.os != 'Windows'
+        run: echo "$PWD/target/mock-tools/bin" >> "$GITHUB_PATH"
+      - name: Install pinned tool (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: ./scripts/install-mock-tools.ps1 '${{ matrix.package }}'
+      - name: Add pinned tool to PATH (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: (Resolve-Path target/mock-tools).Path | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+      - shell: bash
+        if: runner.os != 'Windows'
+        run: cargo test --locked --test '${{ matrix.test }}' -- --ignored --nocapture --test-threads=1
+      - shell: pwsh
+        if: runner.os == 'Windows'
+        run: cargo test --locked --test '${{ matrix.test }}' -- --ignored --nocapture --test-threads=1