From ab9b1bf3a39100b07c23a71bdd52ce51e29fdc8f Mon Sep 17 00:00:00 2001
From: "Kevin T. Coughlin" <706967+KevinTCoughlin@users.noreply.github.com>
Date: Wed, 15 Jul 2026 11:18:52 -0700
Subject: [PATCH] Align Windows ARM docs and configs

- make WSL template the single source of truth by removing static dot_wslconfig
- make Git Bash Python PATH version-agnostic on Windows
- gate Scoop PATH prepend behind path existence in PowerShell profile
- refresh Windows ARM machine metadata and shell policy in CLAUDE docs

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 85b6627c-889d-4d98-afaf-af4c5f149fef
---
 CLAUDE-windows.md                             | 24 +++++++++----------
 CLAUDE.md                                     |  6 ++---
 .../Microsoft.PowerShell_profile.ps1          |  5 +++-
 dot_bashrc.tmpl                               |  8 ++++++-
 dot_wslconfig                                 | 17 -------------
 5 files changed, 26 insertions(+), 34 deletions(-)
 delete mode 100644 dot_wslconfig

diff --git a/CLAUDE-windows.md b/CLAUDE-windows.md
index ae7007c..d421755 100644
--- a/CLAUDE-windows.md
+++ b/CLAUDE-windows.md
@@ -9,7 +9,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working across
 ### kecovo (Current)
 **Type:** ARM Laptop
 **Hardware:** Snapdragon X Elite X1E78100 (12-core ARM), Qualcomm Adreno X1-85 GPU, 32GB RAM, 2TB NVMe
-**OS:** Windows 11 Pro (Insider, Build 29585)
+**OS:** Windows 11 Pro (Insider, Build 29617.1000)
 **Primary Use:** Development, AI/ML (ARM-native workloads)
 
 ### rogpop16redux
@@ -24,8 +24,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working across
 
 ### Shell Environment
 
-- **Primary Shell**: PowerShell 7.6.0-preview.6 (default `pwsh`) with Starship prompt
-- **Stable Shell**: PowerShell 7.5.4 (`"C:\Program Files\PowerShell\7\pwsh.exe"`)
+- **Primary Shells**: PowerShell and Git Bash (both first-class)
+- **PowerShell**: 7.6.3 (`pwsh`)
 - **Profile**: `~/OneDrive/Documents/PowerShell/Microsoft.PowerShell_profile.ps1`
 - **Profile Cache**: Cached init scripts at `$env:LOCALAPPDATA\powershell-cache` for faster startup
   - Run `Update-ShellCache` after updating Starship or Zoxide
@@ -166,15 +166,15 @@ winget upgrade --all  # Update all packages
 
 ### kecovo
 
-**Git Bash Environment** (audited 2026-02-25):
-- **Git**: 2.53.0
-- **Node**: 24.14.0 LTS via fnm 1.38.1 (`fnm install 24`, `fnm use 24`)
-- **Python**: 3.14.3 (`python`), 3.14.0 (`python3`)
-- **GitHub CLI**: 2.87.3
-- **Prompt**: starship 1.24.2
-- **History**: Atuin 18.12.1 (fuzzy `Ctrl-R`, up-arrow search)
+**Git Bash Environment** (audited 2026-07-15):
+- **Git**: 2.53.0.windows.3
+- **Node**: 24.18.0 LTS via fnm 1.39.0 (`fnm install 24`, `fnm use 24`)
+- **Python**: 3.13.14 (`python`), `python3` not configured
+- **GitHub CLI**: 2.96.0
+- **Prompt**: starship 1.26.0
+- **History**: Atuin 18.17.0 (fuzzy `Ctrl-R`, up-arrow search)
 - **Containers**: `wslc` (WSL built-in engine at `C:\Program Files\WSL\wslc.exe`) — Docker Desktop & Podman removed
-- **CLI tools**: eza 0.23.4, bat 0.26.1, fd 10.3.0, ripgrep 15.1.0, fzf 0.68.0 (not shell-integrated), zoxide 0.9.9, lazygit 0.59.0
+- **CLI tools**: bat 0.26.1, fd 10.4.2, ripgrep 15.1.0, zoxide 0.10.0, lazygit (current stable), fzf 0.68.0 (not shell-integrated)
 - **Policy**: even LTS Node only
 
 **WSL2**: Ubuntu available via WSL2
@@ -189,7 +189,7 @@ wslc container list             # running containers
 wslc image ls                   # local images
 ```
 - Binary: `C:\Program Files\WSL\wslc.exe` (open a fresh terminal so it lands on PATH)
-- WSL is on the **pre-release** channel (2.9.x); `wsl --update` stays on stable unless you pass `--pre-release`
+- WSL is on the **pre-release** channel (2.9.3.0); `wsl --update` stays on stable unless you pass `--pre-release`
 - Graphical Linux stays on the Hyper-V `Ubuntu-24.04.4-ARM64-LTS` VM
 
 **Maintenance**
diff --git a/CLAUDE.md b/CLAUDE.md
index 3ec567b..a80810a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -120,7 +120,7 @@ This system has two Windows workstations. The active machine is identified by `$
 
 **Type:** ARM Laptop (Lenovo, model 21N1001QUS)
 **Hardware:** Snapdragon X Elite X1E78100 (12-core ARM64), Qualcomm Adreno X1-85 GPU, 32GB RAM
-**OS:** Windows 11 Pro Insider Preview (Build 29585), ARM 64-bit
+**OS:** Windows 11 Pro Insider Preview (Build 29617.1000), ARM 64-bit
 **Primary Use:** Development, ARM-native workloads
 
 Notes:
@@ -136,8 +136,8 @@ Notes:
 
 ### Shell (both)
 
-- **Primary Shell**: Git Bash (bash) with Starship prompt
-- **PowerShell**: 7.6 (preview) available
+- **Primary Shells**: Git Bash and PowerShell (both first-class)
+- **PowerShell**: 7.6.3
 - **Terminal**: WezTerm (config at `~/.config/wezterm/`, git-tracked: `KevinTCoughlin/wezterm-config`)
 - **Package managers**: winget (primary), Chocolatey, pip, cargo, npm
 
diff --git a/Documents/PowerShell/Microsoft.PowerShell_profile.ps1 b/Documents/PowerShell/Microsoft.PowerShell_profile.ps1
index 52b24fb..9da7fe0 100644
--- a/Documents/PowerShell/Microsoft.PowerShell_profile.ps1
+++ b/Documents/PowerShell/Microsoft.PowerShell_profile.ps1
@@ -6,7 +6,10 @@
 # ---------------------------------------------------------------------------
 
 # Scoop shims first (user-installed tools take priority)
-$env:PATH = "$env:USERPROFILE\scoop\shims;$env:PATH"
+$scoopShims = "$env:USERPROFILE\scoop\shims"
+if (Test-Path $scoopShims) {
+    $env:PATH = "$scoopShims;$env:PATH"
+}
 
 # ---------------------------------------------------------------------------
 # PROMPT & SHELL TOOLS
diff --git a/dot_bashrc.tmpl b/dot_bashrc.tmpl
index ced85e3..957eacc 100644
--- a/dot_bashrc.tmpl
+++ b/dot_bashrc.tmpl
@@ -74,7 +74,13 @@ fi
 # ─────────────────────────────────────────────────────────────────────────────
 
 export PATH="$HOME/.local/bin:$PATH"
-export PATH="$HOME/AppData/Local/Programs/Python/Python314-arm64:$HOME/AppData/Local/Programs/Python/Python314-arm64/Scripts:$PATH"
+python_base="$HOME/AppData/Local/Programs/Python"
+if [[ -d "$python_base" ]]; then
+  python_dir="$(ls -d "$python_base"/Python*-arm64 "$python_base"/Python* 2>/dev/null | sort -V | tail -n 1)"
+  if [[ -n "$python_dir" && -d "$python_dir" ]]; then
+    export PATH="$python_dir:$python_dir/Scripts:$PATH"
+  fi
+fi
 
 # ─────────────────────────────────────────────────────────────────────────────
 # Environment
diff --git a/dot_wslconfig b/dot_wslconfig
deleted file mode 100644
index 01f8b4c..0000000
--- a/dot_wslconfig
+++ /dev/null
@@ -1,17 +0,0 @@
-[wsl2]
-# Allocate more memory for WSL2 (half of 32GB system)
-memory=16GB
-# Match current 12-core machine profile
-processors=12
-# Faster swap
-swap=8GB
-# Enable GPU passthrough (default but explicit)
-gpuSupport=true
-# Nested virtualization
-nestedVirtualization=true
-
-[experimental]
-# Sparse VHD for faster disk
-sparseVhd=true
-# Auto memory reclaim
-autoMemoryReclaim=dropcache