Skip to content

Sentry v1.0.1 — Windows Stable

Choose a tag to compare

@Mert1026 Mert1026 released this 15 Oct 20:13
6793a9c

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 sentry for 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 --verbose

If Ubuntu is already initialized with VERSION 2, continue to step 2. Otherwise, in PowerShell as Administrator:

wsl.exe --install -d Ubuntu

Restart Windows if requested. In normal PowerShell, initialize Ubuntu:

wsl.exe --set-version Ubuntu 2
wsl.exe -d Ubuntu

Complete 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 stop

Setup 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 open

If 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.