Files
wehub-resource-sync acf542cac6
Sync SKILL.md and rules / sync (push) Failing after 1s
chore: import upstream snapshot with attribution
2026-07-13 12:07:10 +08:00

79 lines
2.7 KiB
PowerShell

# caveman — installer shim (Windows / PowerShell).
#
# Thin wrapper around bin/install.js (the unified Node installer). Every flag
# you'd pass to bin/install.js can be passed here; we just forward them.
#
# One-line install:
# irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex
#
# Local clone:
# pwsh install.ps1 [flags]
#
# Why a Node installer? install.sh + install.ps1 used to be parallel sources of
# truth and constantly drifted (issue #249 was a `node -e "..."` quoting bug
# that silently dropped the JSON merge step on every Windows install). One
# Node script works everywhere without quoting bugs.
#
# Why no top-level param() and everything inside a function? `irm | iex`
# executes this file as a string: script-path variables ($PSCommandPath,
# $MyInvocation.MyCommand.Path) are $null and a top-level param block cannot
# receive arguments through a pipe anyway (issue #565). Wrapping the logic in
# a function and forwarding $args keeps one script working for both the pipe
# path (no args, no script path) and the local-clone path.
function Install-Caveman {
param(
[string[]]$InstallerArgs = @()
)
$ErrorActionPreference = "Stop"
$Repo = "JuliusBrussee/caveman"
# Require Node ≥18.
$node = Get-Command node -ErrorAction SilentlyContinue
if (-not $node) {
Write-Error @"
caveman: Node.js (>=18) required. Install:
- winget install OpenJS.NodeJS.LTS
- or download from https://nodejs.org
"@
exit 1
}
$nodeMajor = [int](& node -p "process.versions.node.split('.')[0]")
if ($nodeMajor -lt 18) {
Write-Error "caveman: Node $nodeMajor too old. Need Node >=18. Upgrade: https://nodejs.org"
exit 1
}
# If we're inside the repo clone, run the local installer directly.
# $PSCommandPath is $null when piped to iex (#565) — the old unguarded
# Split-Path on it was the "Cannot bind argument to parameter 'Path'
# because it is null" crash.
if ($PSCommandPath) {
$here = Split-Path -Parent $PSCommandPath
$local = Join-Path $here "bin/install.js"
if (Test-Path $local) {
& node $local @InstallerArgs
exit $LASTEXITCODE
}
}
# Curl-pipe path: delegate to npx.
$npx = Get-Command npx -ErrorAction SilentlyContinue
if (-not $npx) {
Write-Error "caveman: npx required (ships with Node >=18). Reinstall Node.js."
exit 1
}
# Do NOT pass `--` here — npm 7+ npx already forwards trailing args to the
# package, and a literal `--` was tripping bin/install.js's parseArgs as an
# unknown flag.
& npx -y "github:$Repo" @InstallerArgs
exit $LASTEXITCODE
}
# $args is the automatic variable: populated when run as a file
# (`pwsh install.ps1 --force`), empty under `irm | iex`.
Install-Caveman -InstallerArgs $args