278 lines
11 KiB
Batchfile
278 lines
11 KiB
Batchfile
@echo off
|
|
setlocal
|
|
rem Impeccable launcher (Windows). Runs bin\windows-<arch>\impeccable.exe next
|
|
rem to this file, else a cached or freshly downloaded engine binary.
|
|
rem
|
|
rem Structure notes (this file is exercised by dry parsing and string-level
|
|
rem tests, not yet on a real Windows machine):
|
|
rem - No multi-line parenthesized blocks: cmd expands %var% at block parse
|
|
rem time, which made the old download path read back empty %url%/%cached%.
|
|
rem Linear goto flow keeps every expansion on its own line, and avoids
|
|
rem delayed expansion eating ! characters in user arguments.
|
|
rem - The unversioned user binary and the PATH candidate are validated with
|
|
rem the engine-probe handshake (see :probe) so the retired 3.x npm CLI,
|
|
rem whose bin is also named impeccable, is never exec'd. IMPECCABLE_BIN,
|
|
rem the sibling binary, and the version-pinned cache stay trusted.
|
|
rem - Downloads and the version-pinned cache are verified via certutil
|
|
rem against engine-checksums.txt next to this file, and fail closed; a
|
|
rem .verified stamp lets later runs skip hashing the cache. On ARM64 the
|
|
rem arm64 asset is tried first and the x64 asset is the fallback (Windows on
|
|
rem ARM runs x64 binaries), each only when the manifest has a line for it.
|
|
if not defined IMPECCABLE_SKILL_DIR set "IMPECCABLE_SKILL_DIR=%~dp0.."
|
|
if not defined IMPECCABLE_SELF set "IMPECCABLE_SELF=%~f0"
|
|
set "arch=x64"
|
|
if /I "%PROCESSOR_ARCHITECTURE%"=="ARM64" set "arch=arm64"
|
|
|
|
if not defined IMPECCABLE_BIN goto no_env_bin
|
|
if not exist "%IMPECCABLE_BIN%" goto no_env_bin
|
|
set "run=%IMPECCABLE_BIN%"
|
|
goto run
|
|
:no_env_bin
|
|
|
|
set "bin=%~dp0bin\windows-%arch%\impeccable.exe"
|
|
if not exist "%bin%" goto no_sibling
|
|
set "run=%bin%"
|
|
goto run
|
|
:no_sibling
|
|
|
|
set "home_bin=%USERPROFILE%\.impeccable\bin\impeccable.exe"
|
|
if not exist "%home_bin%" goto no_home_bin
|
|
if defined IMPECCABLE_LAUNCHER_PROBE goto no_home_bin
|
|
call :probe "%home_bin%"
|
|
if not "%probe_ok%"=="1" goto no_home_bin
|
|
set "run=%home_bin%"
|
|
goto run
|
|
:no_home_bin
|
|
|
|
set "version="
|
|
if exist "%~dp0VERSION" set /p version=<"%~dp0VERSION"
|
|
if not defined IMPECCABLE_HOME set "IMPECCABLE_HOME=%USERPROFILE%\.impeccable"
|
|
set "cached=%IMPECCABLE_HOME%\bin\%version%\impeccable.exe"
|
|
set "asset=impeccable-windows-%arch%.exe"
|
|
set "manifest=%~dp0engine-checksums.txt"
|
|
if not defined version goto no_cache
|
|
if not exist "%cached%" goto no_cache
|
|
if exist "%cached%.verified" goto cache_trusted
|
|
call :read_expected
|
|
call :sha256 "%cached%" "%TEMP%\impeccable-hash-%RANDOM%%RANDOM%.txt"
|
|
if not defined actual goto cache_unverified
|
|
if /I "%actual%"=="%expected%" goto cache_verified
|
|
if /I "%actual%"=="%expected_x64%" goto cache_verified
|
|
:cache_unverified
|
|
echo impeccable: cannot verify the cached engine "%cached%" against "%manifest%"; not using it 1>&2
|
|
goto no_cache
|
|
:cache_verified
|
|
(>"%cached%.verified" echo %actual%) 2>nul
|
|
:cache_trusted
|
|
set "run=%cached%"
|
|
goto run
|
|
:no_cache
|
|
|
|
if defined IMPECCABLE_LAUNCHER_PROBE goto download
|
|
where impeccable >nul 2>nul
|
|
if errorlevel 1 goto download
|
|
call :probe impeccable
|
|
if not "%probe_ok%"=="1" goto download
|
|
impeccable %*
|
|
exit /b %errorlevel%
|
|
|
|
:download
|
|
rem Last resort: fetch this version's binary from the release channel into
|
|
rem the version-pinned user cache, verify it, then run it. Never inside
|
|
rem another launcher's probe: fail fast and quiet instead.
|
|
if defined IMPECCABLE_LAUNCHER_PROBE exit /b 127
|
|
if not defined version goto fail
|
|
call :read_expected
|
|
if not defined expected if not defined expected_x64 goto no_checksum
|
|
where curl.exe >nul 2>nul
|
|
if errorlevel 1 goto curl_missing
|
|
if not defined IMPECCABLE_DOWNLOAD_BASE set "IMPECCABLE_DOWNLOAD_BASE=https://github.com/pbakaus/impeccable/releases/download"
|
|
if exist "%IMPECCABLE_HOME%\bin\%version%\" goto cache_ready
|
|
mkdir "%IMPECCABLE_HOME%\bin\%version%" >nul 2>nul
|
|
if errorlevel 1 goto cache_directory_failed
|
|
:cache_ready
|
|
rem Stage the download in a directory only this run owns, as the sh launcher
|
|
rem does with .impeccable.part.$$: concurrent first runs (parallel hooks, two
|
|
rem agents) must never write, hash or move each other's files. mkdir fails
|
|
rem when the name exists, so it claims the name atomically. RANDOM alone is
|
|
rem not enough because cmd seeds it from the clock in whole seconds; the
|
|
rem timestamp and the retry on collision keep same-second runs apart. A cache
|
|
rem directory that refuses every mkdir is reported as unwritable.
|
|
set "attempt=0"
|
|
:claim_staging
|
|
set /a attempt+=1
|
|
if %attempt% GTR 20 goto cache_write_failed
|
|
set "stamp=%TIME: =0%"
|
|
set "stamp=%stamp::=%"
|
|
set "stamp=%stamp:.=%"
|
|
set "stamp=%stamp:,=%"
|
|
set "staging=%IMPECCABLE_HOME%\bin\%version%\.impeccable.part.%stamp%-%RANDOM%%RANDOM%"
|
|
mkdir "%staging%" >nul 2>nul
|
|
if errorlevel 1 goto claim_staging
|
|
set "part=%staging%\impeccable.exe"
|
|
rem Redirection failures do not reliably update ERRORLEVEL in cmd.exe;
|
|
rem branch on the command's failure directly.
|
|
(type nul >"%part%") 2>nul || goto staging_write_failed
|
|
set "url=%IMPECCABLE_DOWNLOAD_BASE%/engine-v%version%/%asset%"
|
|
if not defined expected goto fetch_x64
|
|
curl.exe -fsSL -o "%part%" "%url%" >nul 2>nul
|
|
if not errorlevel 1 goto verify
|
|
:fetch_x64
|
|
if not defined expected_x64 goto download_failed
|
|
set "asset=impeccable-windows-x64.exe"
|
|
set "expected=%expected_x64%"
|
|
set "url=%IMPECCABLE_DOWNLOAD_BASE%/engine-v%version%/%asset%"
|
|
curl.exe -fsSL -o "%part%" "%url%" >nul 2>nul
|
|
if errorlevel 1 goto download_failed
|
|
|
|
:verify
|
|
call :check_download
|
|
if errorlevel 1 exit /b 127
|
|
rem Mirrors the sh launcher and fails closed: a freshly downloaded binary
|
|
rem runs only after its hash matches the digest read from engine-checksums.txt.
|
|
rem An empty certutil result refuses the download instead of running an
|
|
rem unverified binary.
|
|
call :sha256 "%part%" "%staging%\hash.txt"
|
|
call :check_download
|
|
if errorlevel 1 exit /b 127
|
|
if not defined actual goto verify_refuse
|
|
if /I "%actual%"=="%expected%" goto place
|
|
call :discard_staging
|
|
echo impeccable: checksum mismatch downloading %url% 1>&2
|
|
exit /b 127
|
|
|
|
:verify_refuse
|
|
call :check_download
|
|
if errorlevel 1 exit /b 127
|
|
call :discard_staging
|
|
echo impeccable: cannot verify %url% (certutil could not hash it); refusing the unverified download 1>&2
|
|
exit /b 127
|
|
|
|
:read_expected
|
|
rem Sets expected (and, on ARM64, expected_x64: Windows on ARM runs x64
|
|
rem binaries) from engine-checksums.txt. Only called off the stamped path:
|
|
rem hooks run this launcher on every edit.
|
|
call :manifest_digest "%asset%" expected
|
|
set "expected_x64="
|
|
if "%arch%"=="arm64" call :manifest_digest impeccable-windows-x64.exe expected_x64
|
|
exit /b 0
|
|
|
|
:manifest_digest
|
|
rem Sets the variable named %2 to the digest the first engine-checksums.txt
|
|
rem line for this version and asset %1 records, empty when there is none.
|
|
set "%~2="
|
|
if not exist "%manifest%" exit /b 0
|
|
for /f "usebackq tokens=1-3" %%a in ("%manifest%") do if "%%a"=="%version%" if /I "%%b"=="%~1" if not defined %~2 set "%~2=%%c"
|
|
exit /b 0
|
|
|
|
:sha256
|
|
rem Sets actual to the sha256 of %~1, empty when certutil fails. %~2 is the
|
|
rem scratch file for its output. Check certutil's status before parsing: its
|
|
rem error text on stdout is not a digest.
|
|
set "actual="
|
|
certutil -hashfile "%~1" SHA256 >"%~2" 2>nul
|
|
if errorlevel 1 goto sha256_done
|
|
for /f "usebackq skip=1 delims=" %%h in ("%~2") do if not defined actual set "actual=%%h"
|
|
if not defined actual goto sha256_done
|
|
set "actual=%actual: =%"
|
|
:sha256_done
|
|
del "%~2" >nul 2>nul
|
|
exit /b 0
|
|
|
|
:check_download
|
|
set "download_file=%~1"
|
|
if not defined download_file set "download_file=%part%"
|
|
if not exist "%download_file%" goto download_missing
|
|
for %%f in ("%download_file%") do if %%~zf==0 goto download_empty
|
|
exit /b 0
|
|
|
|
:download_missing
|
|
call :discard_staging
|
|
echo impeccable: download completed but the file was removed before execution: %url%; check your antivirus quarantine or logs. Refusing to continue; do not disable protection. 1>&2
|
|
exit /b 127
|
|
|
|
:download_empty
|
|
del "%download_file%" >nul 2>nul
|
|
call :discard_staging
|
|
echo impeccable: downloaded file is empty: %url%; refusing the unverified download 1>&2
|
|
exit /b 127
|
|
|
|
:discard_staging
|
|
rem Removes this run's staging directory and whatever is left in it. Never
|
|
rem touches another run's staging directory or the cached binary.
|
|
if defined staging rd /s /q "%staging%" >nul 2>nul
|
|
exit /b 0
|
|
|
|
:place
|
|
call :check_download
|
|
if errorlevel 1 exit /b 127
|
|
move /y "%part%" "%cached%" >nul 2>nul
|
|
if errorlevel 1 goto place_failed
|
|
call :discard_staging
|
|
call :check_download "%cached%"
|
|
if errorlevel 1 exit /b 127
|
|
(>"%cached%.verified" echo %actual%) 2>nul
|
|
set "run=%cached%"
|
|
goto run
|
|
|
|
:place_failed
|
|
call :check_download
|
|
if errorlevel 1 exit /b 127
|
|
call :discard_staging
|
|
echo impeccable: could not cache the verified download: %url% 1>&2
|
|
exit /b 127
|
|
|
|
:run
|
|
"%run%" %*
|
|
exit /b %errorlevel%
|
|
|
|
:probe
|
|
rem Sets probe_ok=1 when %1 answers the engine handshake: prints
|
|
rem "impeccable-engine <version>" and exits 0. The 3.x npm CLI answers any
|
|
rem unknown verb with "Unknown command", exit 1, so it never passes.
|
|
set "probe_ok="
|
|
set "probe_tmp=%TEMP%\impeccable-probe-%RANDOM%%RANDOM%.txt"
|
|
set "IMPECCABLE_LAUNCHER_PROBE=1"
|
|
"%~1" engine-probe >"%probe_tmp%" 2>nul
|
|
set "probe_err=%ERRORLEVEL%"
|
|
set "IMPECCABLE_LAUNCHER_PROBE="
|
|
if not "%probe_err%"=="0" goto probe_done
|
|
findstr /b /c:"impeccable-engine" "%probe_tmp%" >nul 2>nul
|
|
if not errorlevel 1 set "probe_ok=1"
|
|
:probe_done
|
|
del "%probe_tmp%" >nul 2>nul
|
|
exit /b 0
|
|
|
|
:no_checksum
|
|
echo impeccable: no checksum for engine %version% (%asset%) in "%manifest%"; refusing the unverified download 1>&2
|
|
exit /b 127
|
|
|
|
:cache_directory_failed
|
|
echo impeccable: engine %version% is not installed; cannot create cache directory: "%IMPECCABLE_HOME%\bin\%version%" 1>&2
|
|
goto setup_failed
|
|
|
|
:staging_write_failed
|
|
call :discard_staging
|
|
|
|
:cache_write_failed
|
|
echo impeccable: engine %version% is not installed; cannot write to cache directory: "%IMPECCABLE_HOME%\bin\%version%" 1>&2
|
|
goto setup_failed
|
|
|
|
:curl_missing
|
|
echo impeccable: cannot download engine %version%; curl.exe is unavailable. 1>&2
|
|
goto setup_failed
|
|
|
|
:download_failed
|
|
call :discard_staging
|
|
echo impeccable: could not download engine %version% from %url%; check network access and the release URL. 1>&2
|
|
|
|
:setup_failed
|
|
echo Engine %version% setup needs network access and write permission to "%IMPECCABLE_HOME%\bin\%version%". 1>&2
|
|
echo Run this launcher ("%~f0") with engine-probe in a terminal that has those permissions, then retry the original command. 1>&2
|
|
echo Alternatively, set IMPECCABLE_HOME to a writable cache location, or IMPECCABLE_BIN to a preinstalled engine binary. 1>&2
|
|
exit /b 127
|
|
|
|
:fail
|
|
echo impeccable: no engine binary found (looked in %bin%, %cached%, PATH). 1>&2
|
|
echo Download impeccable-windows-%arch%.exe from https://github.com/pbakaus/impeccable/releases (tag engine-v%version%) and save it as %cached%, or set IMPECCABLE_BIN to a preinstalled engine binary. Docs: https://impeccable.style 1>&2
|
|
exit /b 127
|