[quickbeard]

Summary

A user on Windows (npm 12.0.2) hit npm i -g codev-code ending with "It seems your package manager failed to install the right codev CLI package. Try manually installing …". Investigating that showed the message is reachable from three unrelated failures and the script gives no way to tell them apart, plus one path that cannot work on Windows at all.

• Diagnostics. installPackage and verifyBinary now report why they failed instead of returning false: the platform package was not installed by the package manager (with the resolve error), the fallback npm install could not start or exited non-zero, or the copied binary's --version failed (spawn error, exit code or signal, and the first stderr line — stderr is piped rather than ignored, because an antivirus or application-control block says so there). main collects one line per package and step and appends a What was tried list to the final error.
• Windows fallback actually runs. The fallback that fetches the platform package into a temp prefix spawned npm with no shell. On Windows that is npm.cmd, which Node has refused to spawn without a shell since 18.20.2 / 20.12.2 (CVE-2024-27980), so it failed instantly and silently on every supported Node. It now spawns cmd.exe /d /s /c npm … as the Node docs recommend; Node still quotes each argument, so a temp path with spaces is fine. Upstream opencode's script has the same bug.
• npm 12 hint. npm 12 blocks install scripts on global installs by default (verified: npx npm@12.0.2 install -g codev-code leaves the placeholder in place and warns). The placeholder stub's message now shows npm install -g codev-code --allow-scripts=codev-code.

Both scripts are upstream files; their DIVERGENCES.md rows are extended. CHANGELOG has an Install entry.

Test plan

• node --check and prettier on the script
• Scratch layout, package manager skipped the optional dep → fallback fetch of codev-code-darwin-arm64@1.18.23-2 succeeds, bin/codev.exe --version prints 1.18.23-2
• Scratch layout, unpublished version → error ends with What was tried: listing the resolve failure and npm install … exited with 1
• Scratch layout, installed binary that exits 3 with a stderr line → error reports installed, but … exited with code 3: <stderr line>
• bun typecheck in packages/opencode
• Windows: confirm the cmd.exe fallback path fetches the package when the optional dep is missing (npm i -g codev-code --omit=optional --allow-scripts=codev-code)

🤖 Generated with Claude Code

https://claude.ai/code/session_01UtPnKQ9ATvc9kd1v74zC4Y