feat(install): air-gapped / GHE env vars for install.ps1

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- **`install.ps1` (Windows)** now mirrors **`install.sh`**: `APM_INSTALL_DIR`, `GITHUB_URL`, `APM_REPO`, and `VERSION` environment variables; pinning `VERSION` skips the releases/latest API; `GITHUB_URL` selects GitHub.com (`api.github.com`) vs GHES (`{host}/api/v3`) for latest discovery. (#668)
 - Virtual subdirectory and raw-file packages now resolve from self-hosted Git services (Gitea, Gogs) via raw URL with API v1/v3 fallback. (#587)
 - `shared/apm.md` gh-aw shared workflow exposes a `target:` import input (default `all`) so consumer workflows can ship slim, single-harness bundles instead of always packing every layout. (#1184)
 - **GitLab host support:** `gitlab.com` and self-managed instances (via `GITLAB_HOST` / `APM_GITLAB_HOSTS`) use GitLab REST **v4** for `marketplace.json` and install-time raw file reads; nested GitLab group paths are disambiguated in dependency references with object-form `git:` + `path:` where shorthand is ambiguous. GitHub, GHES, Azure DevOps, and registry-proxy behavior remain unchanged. (#1149)

docs/src/content/docs/getting-started/installation.md

@@ -29,7 +29,7 @@ The installer automatically detects your platform (macOS/Linux/Windows, Intel/AR
 
 ### Installer options
 
-The Unix installer supports environment variables for custom environments:
+**macOS / Linux (`install.sh`):**
 
 ```bash
 # Install a specific version
@@ -42,15 +42,36 @@ curl -sSL https://aka.ms/apm-unix | APM_INSTALL_DIR=$HOME/.local/bin sh
 GITHUB_URL=https://github.corp.com VERSION=v1.2.3 sh install.sh
 ```
 
+**Windows (`install.ps1` in PowerShell):**
+
+```powershell
+# Pin a version (skips GitHub API — required for many air-gapped / GHES setups)
+$env:VERSION = "v1.2.3"; irm https://aka.ms/apm-windows | iex
+
+# Or pass a positional parameter when running a saved script:
+# .\install.ps1 v1.2.3
+
+# Custom directory for apm.cmd (default: %LOCALAPPDATA%\Programs\apm\bin)
+$env:APM_INSTALL_DIR = "$env:LOCALAPPDATA\Programs\apm\bin"; irm https://aka.ms/apm-windows | iex
+
+# Fork, enterprise host, or internal mirror
+$env:GITHUB_URL = "https://github.corp.com"
+$env:APM_REPO = "my-org/apm"
+$env:VERSION = "v1.2.3"
+irm https://aka.ms/apm-windows | iex
+```
+
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `APM_INSTALL_DIR` | `/usr/local/bin` | Directory for the `apm` symlink |
-| `APM_LIB_DIR` | `$(dirname APM_INSTALL_DIR)/lib/apm` | Directory for the full binary bundle |
-| `GITHUB_URL` | `https://github.com` | Base URL for downloads (mirrors, GHE) |
-| `APM_REPO` | `microsoft/apm` | GitHub repository |
-| `VERSION` | *(latest)* | Pin a specific release (skips GitHub API) |
-
-> **Note:** When using `GITHUB_URL` for a GitHub Enterprise or air-gapped mirror, set `VERSION` as well. The GitHub API call for latest-release discovery still targets `api.github.com`; `VERSION` bypasses it entirely.
+| `APM_INSTALL_DIR` | `/usr/local/bin` (Unix) / `%LOCALAPPDATA%\Programs\apm\bin` (Windows) | Directory for the `apm` symlink / `apm.cmd` shim |
+| `APM_LIB_DIR` | `$(dirname APM_INSTALL_DIR)/lib/apm` | *(Unix only)* Directory for the full binary bundle |
+| `GITHUB_URL` | `https://github.com` | Base URL for downloads (mirrors, GHES) |
+| `APM_REPO` | `microsoft/apm` | GitHub repository (`owner/name`) |
+| `VERSION` | *(latest)* | Pin a specific release tag (skips the **releases/latest** HTTP API) |
+
+> **Note — Unix (`install.sh`):** Latest-release discovery still calls `https://api.github.com/repos/.../releases/latest` unless `VERSION` is set. For GHES or mirrors with no access to `api.github.com`, pin `VERSION` so the script never hits that endpoint.
+>
+> **Note — Windows (`install.ps1`):** The **releases/latest** URL is derived from `GITHUB_URL`: `https://api.github.com` for GitHub.com, or `{GITHUB_URL}/api/v3` for GitHub Enterprise Server. Air-gapped runners should still set `VERSION` so the installer does not need the API at all.
 
 ## Package managers