[Bug] ZCode version mismatch: App shows 3.7.3 but website has 3.6.5 + in-app update broken
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
Bug Description
Version mismatch between ZCode desktop app and website download page, combined with a broken in-app updater that prevents users from updating.
Problem Details
Version Mismatch:
| Location | Version Available |
|---|---|
| ZCode Desktop App (Windows) | Shows UPDATE button → 3.7.3 |
| zcode.ai Website | Only shows 3.6.5 for download |
The Conflict:
App says: "Update to 3.7.3 available!" ✅
↓
User clicks UPDATE button
↓
App starts downloading 3.7.3...
↓
BUT: Update fails with error!
↓
User goes to zcode.ai to download manually
↓
Website only has 3.6.5 (OLDER than what app wants!) ❌
Bug #1: In-App Updater Broken
Error Message:
⚠ Error: "Please close the app"
Behavior:
- User clicks green UPDATE button in ZCode app
- App begins downloading version 3.7.3
- During/after download, error appears: "Please close the app"
- Update cannot complete
- User is stuck - cannot update through app
Expected Behavior:
- Either: App closes itself and updates automatically
- Or: App prompts user to close, then continues update
- Or: App uses proper Windows installer that handles restart
Actual Behavior:
- Shows cryptic error message
- No auto-close or restart handling
- Update process dead-ends
Bug #2: Website Missing Latest Version
Current State:
- Desktop app knows about 3.7.3 (shows update prompt)
- Website (zcode.ai) only offers 3.6.5
- User cannot manually download 3.7.3 to work around broken updater
Impact:
In-app update: BROKEN (error)
Manual update: IMPOSSIBLE (version not on website)
User is: STUCK on old version forever 👿
User Frustration
"Do something please!!!" — TiltStable
User is caught in a catch-22:
- Cannot update via app (buggy updater)
- Cannot update via website (wrong version)
- No other update method available
Affected Platform
- OS: Windows
- Application: ZCode Desktop App
- Current Installed Version: Unknown (older)
- Target Version: 3.7.3
- Website Version: 3.6.5
Root Cause Hypotheses
| Possible Cause | Likelihood | Explanation |
|---|---|---|
| Website not updated | 🔴 High | 3.7.3 released but website still serves 3.6.5 |
| Updater released early | 🟠 Medium | App checks for updates, finds 3.7.3, but build not deployed to CDN/website |
| Installer permission issue | 🔴 High | Windows requires admin/close-app for updates, not handled properly |
| Version mismatch between teams | 🟠 Medium | App team released 3.7.3, web team did not update download page |
| CDN cache issue | 🟡 Low | New version exists but cached old version served |
Suggested Fixes
Immediate Fix (Urgent):
- Either upload 3.7.3 to website OR rollback app update prompt to 3.6.5
- Fix in-app updater error handling ("please close the app")
Proper Fix:
// In-app updater should:
1. Check if new version available
2. Download to temp location
3. Show user: "Update ready! Click to restart and install"
4. On click:
- Launch separate installer process
- Close main app gracefully
- Installer takes over (can replace files now)
5. Relaunch app after install completes
Process Improvement:
- Coordinate app releases with website updates
- Automated deployment pipeline that updates both simultaneously
- Version validation: ensure website has matching version before pushing update prompt
Reproduction Steps
- Install ZCode on Windows (version < 3.7.3)
- Wait for or trigger update check
- Observe: Green UPDATE button appears for 3.7.3
- Click UPDATE button
- Observe: Download starts but errors with "Please close the app"
- Go to https://zcode.ai
- Observe: Only version 3.6.5 available for download
- Result: Cannot update by any method
Severity: P0 Critical
- Users completely blocked from updating
- Affects all Windows users who see the update prompt
- No workaround available (both methods broken)
- Security risk if users stuck on old versions
Reporter Information
- Source: Discord
- Reporter: TiltStable (OP)
- Timestamp: 8/8/26, 1:12 PM
- Platform: Windows PC / ZCode Desktop App
- Website: zcode.ai
Labels Suggested:
bug, critical, updater, version-mismatch, windows, website, deployment
This bug completely blocks users from updating ZCode and needs immediate attention.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No source files, tests, or updater entry points are identified. Start by reproducing the Windows update flow for a version below 3.7.3, then verify the website download version and update artifact; done means the website and in-app prompt agree and the update completes without the “Please close the app” dead end.
Written by the indexing model from the issue text.
Assessment
- Domain
- desktop, release
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100