release v0.12.0: Windows support

- Cross-platform config paths (os.UserHomeDir, %APPDATA%\aipack on Windows)
- Cline Documents folder resolved via Windows shell API for OneDrive support
- PowerShell installer (install.ps1) with AIPACK_VERSION pinning
- PowerShell shell completion, clip.exe clipboard support
- Windows self-update with locked-executable handling
- pack install --link falls back to directory junction on Windows
- WSL detection with doctor warning for Cline cross-filesystem paths
- Platform-aware git error hints (credential helper, winget suggestion)
- Symlink test guards for Windows without Developer Mode
- CI validates on both Ubuntu and Windows
- windows/amd64 and windows/arm64 release binaries

Author: dfoster-oracle

.github/workflows/ci.yml

@@ -10,7 +10,10 @@ on:
 
 jobs:
   validate:
-    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
     permissions:
       contents: read
     steps:
@@ -20,7 +23,9 @@ jobs:
           go-version-file: go.mod
           cache: true
       - run: make fmt-check
-      - run: make test
+        if: runner.os != 'Windows'
+      - name: Run tests
+        run: go test ./...
       - run: go vet ./...
 
   release:

CHANGELOG.md

@@ -6,6 +6,30 @@ The format is based on Keep a Changelog, and releases use semantic versioning ta
 
 ## Unreleased
 
+## [0.12.0]
+
+### Added
+
+- **Windows support (amd64 + arm64).** Cross-platform config paths (`%APPDATA%\aipack` on Windows, `~/.config/aipack` elsewhere), PowerShell installer (`install.ps1`) with `AIPACK_VERSION` support, PowerShell shell completion, Windows self-update with locked-executable handling, `clip.exe` clipboard support, and `windows/amd64` + `windows/arm64` release binaries.
+- **CI Windows test runner.** Tests now run on both Ubuntu and Windows in the validate pipeline.
+- **WSL detection.** `aipack doctor` warns when running in WSL with Cline configured, since global-scope Cline rules target the Windows filesystem which WSL cannot reach.
+- **Symlink test portability.** Tests that create symlinks skip gracefully on Windows without Developer Mode instead of failing.
+
+### Changed
+
+- Home directory resolution uses `os.UserHomeDir()` instead of `$HOME`, which works across all platforms (HOME on Unix, USERPROFILE on Windows).
+- Cline Documents folder is resolved via the Windows shell API (`SHGetKnownFolderPath`) to handle OneDrive folder redirection. Non-Windows platforms use the conventional `~/Documents` path.
+- `pack install --link` falls back to a directory junction (`mklink /J`) on Windows when symlinks require elevated privileges.
+- Git error hints are platform-aware: credential helper suggestions use `manager` on Windows, `store` on Linux, `osxkeychain` on macOS. Git-not-found on Windows suggests `winget install Git.Git`.
+- Cline global paths changed from a package-level variable to a `GlobalPathsFor(home)` function to support platform-dependent Documents folder resolution.
+- Ledger path encoding handles Windows drive letters and backslashes.
+- Test assertions use `filepath.Join` and `t.TempDir()` instead of hardcoded Unix path literals.
+
+### Known limitations
+
+- **WSL + Cline global scope:** aipack in WSL writes to the Linux filesystem, but Cline reads from the Windows filesystem. Use `aipack sync --scope project` in WSL, or run aipack natively on Windows for global scope.
+- **OpenCode harness:** Global paths still use `.config/opencode` (Unix convention). Windows-specific resolution is not yet implemented.
+
 ## [0.11.7]
 
 ### Added

Makefile

@@ -54,15 +54,18 @@ validate: ## Validate pack content (PACK_ROOT required)
 
 dist: ## Cross-compile for all platforms
 	@mkdir -p $(DIST)
-	@for platform in darwin/arm64 darwin/amd64 linux/amd64; do \
-		GOOS=$${platform%/*} GOARCH=$${platform#*/} \
+	@for platform in darwin/arm64 darwin/amd64 linux/amd64 windows/amd64 windows/arm64; do \
+		goos=$${platform%/*}; goarch=$${platform#*/}; \
+		ext=""; if [ "$$goos" = "windows" ]; then ext=".exe"; fi; \
+		outname=$(BINARY)-$${goos}-$${goarch}$${ext}; \
+		GOOS=$$goos GOARCH=$$goarch \
 		go build $(GO_TAGS) -ldflags "$(LDFLAGS)" \
-			-o $(DIST)/$(BINARY)-$${platform%/*}-$${platform#*/} ./cmd/aipack || exit 1; \
-		case "$${platform%/*}" in darwin) \
+			-o $(DIST)/$$outname ./cmd/aipack || exit 1; \
+		case "$$goos" in darwin) \
 			if [ "$$(uname)" = "Darwin" ] && command -v codesign >/dev/null 2>&1; then \
-				codesign -s - -f $(DIST)/$(BINARY)-$${platform%/*}-$${platform#*/} 2>/dev/null; \
+				codesign -s - -f $(DIST)/$$outname 2>/dev/null; \
 			fi ;; esac; \
-		echo "  $(DIST)/$(BINARY)-$${platform%/*}-$${platform#*/}"; \
+		echo "  $(DIST)/$$outname"; \
 	done
 
 clean: ## Remove build artifacts

README.md

@@ -53,10 +53,16 @@ On macOS and Linux, you can also use the release-backed installer script:
 curl -fsSL https://raw.githubusercontent.com/shrug-labs/aipack/main/install.sh | sh
 ```
 
-The installer detects your platform, downloads the matching release binary, verifies
-`SHA256SUMS`, installs `aipack`, and prints the installed version.
+On Windows (PowerShell):
 
-Useful overrides:
+```powershell
+irm https://raw.githubusercontent.com/shrug-labs/aipack/main/install.ps1 | iex
+```
+
+The installers detect your platform, download the matching release binary, verify
+`SHA256SUMS`, install `aipack`, and print the installed version.
+
+Useful overrides (macOS/Linux):
 
 ```bash
 # Pin a specific release tag
@@ -69,7 +75,13 @@ curl -fsSL https://raw.githubusercontent.com/shrug-labs/aipack/main/install.sh |
 curl -fsSL https://raw.githubusercontent.com/shrug-labs/aipack/main/install.sh | PREFIX=$HOME/.local sh
 ```
 
-Release binaries are published for `darwin/arm64`, `darwin/amd64`, and `linux/amd64`. Stable releases also update the Homebrew formula in `dfoster-oracle/homebrew-tap`. If you prefer a manual install, use the matching release asset from <https://github.com/shrug-labs/aipack/releases> together with `SHA256SUMS`.
+Windows override (PowerShell):
+
+```powershell
+$env:AIPACK_VERSION = "v0.12.0"; irm https://raw.githubusercontent.com/shrug-labs/aipack/main/install.ps1 | iex
+```
+
+Release binaries are published for `darwin/arm64`, `darwin/amd64`, `linux/amd64`, `windows/amd64`, and `windows/arm64`. Stable releases also update the Homebrew formula in `dfoster-oracle/homebrew-tap`. If you prefer a manual install, use the matching release asset from <https://github.com/shrug-labs/aipack/releases> together with `SHA256SUMS`.
 
 ### Build from source
 
@@ -194,7 +206,7 @@ make fmt-check # fail if formatting is stale
 make help       # show all targets
 make build      # build for current platform → dist/
 make test       # run Go tests
-make dist       # cross-compile for darwin/arm64, darwin/amd64, linux/amd64
+make dist       # cross-compile for darwin/arm64, darwin/amd64, linux/amd64, windows/amd64, windows/arm64
 make install    # build + copy to ~/.local/bin/
 make clean      # remove build artifacts
 ```

RELEASING.md

@@ -57,15 +57,15 @@ Examples:
 3. GitHub Actions will:
     - run formatting, test, and vet checks
     - verify the pushed tag matches `VERSION`
-    - build `darwin/arm64`, `darwin/amd64`, and `linux/amd64` binaries
+    - build `darwin/arm64`, `darwin/amd64`, `linux/amd64`, `windows/amd64`, and `windows/arm64` binaries
     - generate `SHA256SUMS`
     - publish GitHub Release assets
     - update `dfoster-oracle/homebrew-tap` for stable tags (requires `HOMEBREW_TAP_GITHUB_TOKEN`)
 
 ## After publish
 
 1. Confirm the release page contains:
-   - all three binaries
+   - all five binaries (darwin/arm64, darwin/amd64, linux/amd64, windows/amd64, windows/arm64)
    - `SHA256SUMS`
    - generated release notes
 2. Confirm the release is marked as a prerelease when the tag contains a prerelease suffix.
@@ -78,18 +78,25 @@ Examples:
    Then run the downloaded binary and confirm `aipack version` reports the
    published release line.
 
-4. Run the installer against the published release:
+4. Run the Unix installer against the published release:
 
    ```bash
    VERSION=vX.Y.Z BIN_DIR="$PWD/bin" ./install.sh
    ./bin/aipack version
    ```
 
-5. For stable tags, confirm the Homebrew tap updated to the published version:
+5. Run the Windows installer (PowerShell) against the published release:
+
+   ```powershell
+   $env:AIPACK_VERSION = "vX.Y.Z"; irm https://raw.githubusercontent.com/shrug-labs/aipack/main/install.ps1 | iex
+   aipack version
+   ```
+
+6. For stable tags, confirm the Homebrew tap updated to the published version:
 
    ```bash
    brew install dfoster-oracle/tap/aipack
    brew info dfoster-oracle/tap/aipack
    ```
 
-6. If install instructions changed, update `README.md` in the same release-prep change.
+7. If install instructions changed, update `README.md` in the same release-prep change.

VERSION

@@ -1 +1 @@
-0.11.7
+0.12.0

cmd/aipack/clean.go

@@ -53,7 +53,7 @@ func (c *CleanCmd) Validate() error {
 func (c *CleanCmd) Run(ctx context.Context, g *Globals) error {
 	// Load sync-config for scope and harness resolution.
 	var syncCfg config.SyncConfig
-	if cfgDir, err := cmdutil.ResolveConfigDir(c.ConfigDir, os.Getenv("HOME")); err == nil {
+	if cfgDir, err := cmdutil.ResolveConfigDir(c.ConfigDir, config.HomeDir()); err == nil {
 		if sc, serr := config.LoadSyncConfig(config.SyncConfigPath(cfgDir)); serr == nil {
 			syncCfg = sc
 		}
@@ -92,7 +92,7 @@ func (c *CleanCmd) Run(ctx context.Context, g *Globals) error {
 			Scope:      scope,
 			ProjectDir: projectAbs,
 			Harnesses:  harnesses,
-			Home:       os.Getenv("HOME"),
+			Home:       config.HomeDir(),
 		},
 		WipeLedger: c.Ledger,
 		Yes:        c.Yes,

cmd/aipack/completion.go

@@ -128,5 +128,5 @@ func predictResources(a complete.Args) []string {
 }
 
 func configBaseDir() (string, error) {
-	return config.DefaultConfigDir(os.Getenv("HOME"))
+	return config.DefaultConfigDir(config.HomeDir())
 }

cmd/aipack/completion_install.go

@@ -5,6 +5,7 @@ import (
 	"fmt"
 	"os"
 	"path/filepath"
+	"runtime"
 	"strings"
 )
 
@@ -134,10 +135,20 @@ func confirmPrompt(ctx context.Context, g *Globals) bool {
 
 func detectShell() string {
 	shell := os.Getenv("SHELL")
-	if shell == "" {
-		return "bash"
+	if shell != "" {
+		name := filepath.Base(shell)
+		// Strip .exe suffix on Windows (e.g. "bash.exe" → "bash").
+		name = strings.TrimSuffix(name, ".exe")
+		return name
 	}
-	return filepath.Base(shell)
+	// On Windows, $SHELL is not set. Detect PowerShell via PSModulePath
+	// (always set inside pwsh/powershell). Fall back to bash for Git Bash users.
+	if runtime.GOOS == "windows" {
+		if os.Getenv("PSModulePath") != "" {
+			return "powershell"
+		}
+	}
+	return "bash"
 }
 
 func defaultRCFile(shell string) string {
@@ -152,6 +163,8 @@ func defaultRCFile(shell string) string {
 		return filepath.Join(home, ".bashrc")
 	case "fish":
 		return filepath.Join(home, ".config", "fish", "config.fish")
+	case "powershell":
+		return filepath.Join(home, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1")
 	default:
 		return ""
 	}
@@ -175,6 +188,14 @@ func completionSnippet(shell, bin, cmd string) string {
 end
 complete -f -c %s -a "(__complete_%s)"
 `, cmd, bin, cmd, cmd)
+	case "powershell":
+		body = fmt.Sprintf(`Register-ArgumentCompleter -CommandName %s -Native -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    $env:COMP_LINE = $commandAst.ToString()
+    & %s | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    Remove-Item env:COMP_LINE
+}
+`, cmd, bin)
 	default:
 		return ""
 	}

cmd/aipack/completion_install_cmd_test.go

@@ -15,7 +15,8 @@ func TestInstallCompletions_Print(t *testing.T) {
 	if code != cmdutil.ExitOK {
 		t.Fatalf("exit=%d, want %d", code, cmdutil.ExitOK)
 	}
-	if !strings.Contains(stdout, "complete") {
+	// Bash/zsh snippets contain "complete"; PowerShell uses "Completer"/"Completion".
+	if !strings.Contains(strings.ToLower(stdout), "complet") {
 		t.Fatalf("expected completion snippet in stdout, got: %s", stdout)
 	}
 }