Repository navigation
Sentry v1.0.1 — Windows Stable
Sentry v1.0.1 — Windows Stable
This patch fixes imports of projects containing unreadable generated caches and installs the Windows command during setup.
- Python caches/environments and Next/Nuxt build output are skipped before new imports and updates.
- Required unreadable paths report their permission error and path. Disk exhaustion provides storage guidance.
- Successful setup registers
sentryfor PowerShell and Command Prompt. Existing revision hashes remain compatible.
Supported: Windows 11 x64 + WSL2 + Ubuntu. This is an unsigned ZIP with online runtime bootstrap. Windows Node/pnpm/Git are not required. Internet is required for setup and provider tools. Native Linux Desktop is deferred.
1. WSL and Ubuntu — only if missing
Check from PowerShell:
wsl.exe --list --verboseIf Ubuntu is already initialized with VERSION 2, continue to step 2. Otherwise, in PowerShell as Administrator:
wsl.exe --install -d UbuntuRestart Windows if requested. In normal PowerShell, initialize Ubuntu:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete the Linux username/password prompts, then type exit to return to PowerShell. Existing Ubuntu installations do not need removal. See Microsoft's WSL installation guide.
2. Ubuntu prerequisites
Skip this block if Ubuntu already has Linux Node >=22, pnpm 9.12.3, systemd user services, bubblewrap and socat. Otherwise paste this into PowerShell. It changes packages inside Ubuntu, using root through WSL and the official NodeSource Node 22 repository when needed:
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}Current Ubuntu WSL installations enable systemd by default. If the block reports unavailable systemd user services, follow Microsoft's systemd guidance, preserving existing configuration, then rerun it.
3. Download, verify and install
Finish or cancel active QA before setup. Paste this entire block into normal PowerShell from any directory, including System32. It downloads both exact assets automatically, verifies the pinned checksum, manifest, source identity and every distribution file, installs the matching runtime and provider tools, then opens Desktop. Failures stop later steps. There is no manual download or cd requirement.
The archive is extracted into its own directory under %LOCALAPPDATA%\Sentry\releases. Keep that directory in place; it is the application installation. Existing matching files are verified and reused without overwriting them.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-1.0.1-6793a9c53a33-windows-x64'
$expectedHash = 'defb07406eac22096d63330a886bf4e340d98e2d6e0d13678b0300d4c6503675'
$expectedManifest = '54512588008a1ed93e3b3d8967e819fa803529ec75625df9cbba3babf6ae2a18'
$source = '6793a9c53a336d577ac4397735d0396f558b60f0'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v1.0.1'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v1.0.1/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '1.0.1' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environment is Connected. Provider requests can incur charges.'
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
Write-Host "Use sentry open, sentry status, sentry doctor or sentry version from any folder."
}Configure Settings → Providers and check Environment is Connected before importing a project. Provider accounts and usage charges are separate. Setup and diagnostics do not make paid QA requests.
4. Everyday commands — from any folder
sentry open
sentry status
sentry doctor
sentry version
# Stop after any active QA has settled:
sentry stopSetup registers the command in the user PATH. New terminals pick it up; the installation block refreshes it in the current PowerShell window too. If an older window cannot find it:
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
sentry openIf you move the installed archive directory, run .\sentry.ps1 register-command from its new location. Setup from a newer verified archive selects that archive for the command.
Upgrade and compatibility
Existing v1.0.0 users install this new archive using step 3. Keep the previous matched archive/runtime for recovery; never extract over an existing installation. There is no automatic updater. Product version is 1.0.1, protocol remains 1. Schemas/migrations, credential encryption, provider/model/tool pins and project-history formats are unchanged. OpenCode 1.18.32, DeepSeek SDK 0.1.5-rc.2 and Claude Code 2.1.270 remain pinned.
Source selection does not evaluate .gitignore; local data directories remain eligible. Import retains a managed copy and immutable revision, with copy fallback when reflinks are unavailable. WSL virtual free space does not guarantee Windows backing-drive capacity. Source files and permissions are not changed by import. Windows credentials retain same-account/machine DPAPI boundaries; no automatic downgrade or schema downgrade is authorized. See the recovery policy.
Verified artifact identity
- Source: 6793a9c53a336d577ac4397735d0396f558b60f0.
- Git tree:
2da44abef93a5b026d0f0c7530dd628b6a590850. - ZIP:
sentry-1.0.1-6793a9c53a33-windows-x64.zip. - ZIP SHA256:
defb07406eac22096d63330a886bf4e340d98e2d6e0d13678b0300d4c6503675. - Manifest SHA256:
54512588008a1ed93e3b3d8967e819fa803529ec75625df9cbba3babf6ae2a18. - Target:
windows-x64; runtime protocol:1; verified inventory: 334 files.
Verification covers CI quality/launchers/Windows packaging, independent archive integrity, actual packaged Desktop/preload/renderer/IPC and matching Linux runtime on a prepared Windows/WSL host, plus an isolated v1.0.0 → v1.0.1 project/profile upgrade with synthetic encrypted settings. Prepared-host acceptance does not establish clean-machine provisioning. No paid-provider campaign or actual elevated compaction is part of this release. The original v1.0.0 tag and asset bytes are unchanged.
See patch notes and the installation guide.