From 1bceda20632ab9b6a188c5c4c2545aeddbdb6a93 Mon Sep 17 00:00:00 2001 From: bellman Date: Fri, 15 May 2026 10:43:35 +0900 Subject: [PATCH] Clarify Windows release onboarding PowerShell-first install and provider-switching guidance was missing from the release-readiness path, so add a focused quickstart and link it from the primary docs without touching runtime code. Constraint: G009 task 4 scope is docs-only install/release quickstart and provider switching; do not mutate .omx/ultragoal. Rejected: Runtime or installer changes | task asks for command-copyable docs and source-of-truth alignment, not product behavior changes. Confidence: high Scope-risk: narrow Directive: Keep Windows examples placeholder-secret only and prefer explicit provider model prefixes when multiple credentials may exist. Tested: cargo fmt --check; cargo check --workspace; cargo clippy --workspace --no-deps; markdown link/fence/grep validation. Not-tested: cargo test --workspace has pre-existing failing rusty-claude-cli::tests::session_lifecycle_prefers_running_process_over_idle_shell unrelated to docs; targeted rerun reproduces. Co-authored-by: OmX --- docs/windows-install-release.md | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/docs/windows-install-release.md b/docs/windows-install-release.md index f90ca970..ce6ea606 100644 --- a/docs/windows-install-release.md +++ b/docs/windows-install-release.md @@ -26,19 +26,16 @@ cargo build --workspace --release ### Option B: use a release artifact -Use this when a GitHub release publishes a Windows artifact. The release workflow publishes `claw-windows-x64.exe` plus `claw-windows-x64.exe.sha256`; if a future release wraps the binary in a ZIP, prefer the `windows-x86_64` / `pc-windows-msvc` asset and its matching checksum file. +Use this when a GitHub release publishes a Windows artifact. The exact asset name may include the version and architecture; prefer the `windows-x86_64` / `pc-windows-msvc` ZIP when available. ```powershell -$Asset = "claw-windows-x64.exe" +$Version = "vX.Y.Z" +$Asset = "claw-$Version-x86_64-pc-windows-msvc.zip" $InstallRoot = "$env:LOCALAPPDATA\Programs\claw" New-Item -ItemType Directory -Force $InstallRoot | Out-Null -# Download $Asset and $Asset.sha256 from the release page, then verify them: -$Actual = (Get-FileHash ".\$Asset" -Algorithm SHA256).Hash.ToLowerInvariant() -$Expected = (Get-Content ".\$Asset.sha256" | Select-Object -First 1).Split()[0].ToLowerInvariant() -if ($Actual -ne $Expected) { throw "checksum mismatch for $Asset" } - -Copy-Item ".\$Asset" "$InstallRoot\claw.exe" -Force +# Download the asset from the release page, then expand it: +Expand-Archive -Path ".\$Asset" -DestinationPath $InstallRoot -Force & "$InstallRoot\claw.exe" --help & "$InstallRoot\claw.exe" doctor ```