fix(desktop): add timeout guards to prevent Windows startup hang

[pengzha0]

Issue for this PR

Closes #631

Type of change

• Bug fix
• New feature
• Refactor / code improvement
• Documentation

What does this PR do?

The Electron desktop app hangs forever on "Just a moment..." loading screen on Windows when the sidecar is slow to start (e.g. in offline/intranet environments).

Two issues cause this:

1. sqliteFileExists() checks ~/.local/share/opencode/opencode.db — a Linux-only path that never exists on Windows. So needsMigration is always true on Windows, and the app waits for a sqlite-migration:done event from the sidecar.

2. Both sqliteDone?.promise and loadingComplete.promise are awaited with no timeout. When the sidecar blocks on network requests (models.dev fetch, plugin installs) before emitting the migration event, the app hangs indefinitely.

This is masked on internet-connected Windows because the sidecar finishes network init fast enough to emit the event. On macOS/Linux the path check is correct so needsMigration is false and the whole code path is skipped.

Fixes:

• sqliteFileExists() now uses %APPDATA%\opencode\opencode.db on Windows
• sqliteDone wait gets a 30s timeout
• loadingComplete wait gets a 10s timeout

How did you verify your code works?

Tested on Windows in an intranet environment (no internet access). Before the fix, the app hung permanently on loading screen. After the fix, the app starts within seconds.

Screenshots / recordings

N/A — not a UI change, fixes a startup hang.

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

The search results show PR #19281 itself and some related but different PRs:

Potential Related PRs (but not duplicates):

• PR fix: Windows CLI and deep link issues (#11657, #11666, #11674) #11724: "fix: Windows CLI and deep link issues" - Addresses other Windows-specific issues but not the startup hang or path problem
• PR fix(installation): guard startup package-manager probes with timeout #13287: "fix(installation): guard startup package-manager probes with timeout" - Similar timeout pattern fix, but for package manager probes, not SQLite migration

No duplicate PRs found

[github-actions]

Thanks for updating your PR! It now meets our contributing guidelines. 👍

[pengzha0]

The e2e (windows) failure is in session-model-persistence.spec.ts ("session model restore across workspaces"), which is unrelated to the changes in this PR. This PR only modifies packages/desktop-electron/src/main/index.ts. The test also has 2 other flaky tests, suggesting pre-existing instability.

[rekram1-node]

Automated PR Cleanup

Thank you for contributing to opencode.

Due to the high volume of PRs from users and AI agents, we periodically close older PRs using automated criteria so maintainers can focus review time on the most active and community-supported contributions.

This PR was closed because it matched the following cleanup criteria:

• The PR was created more than 1 month ago
• The PR had fewer than 2 positive reactions
• Positive reactions are counted as thumbs-up, heart, celebration, or rocket reactions on the PR

PRs created within the last month are not affected by this cleanup.

If you believe this PR was closed incorrectly, or if you are still actively working on it, please leave a comment explaining why it should be reopened. A maintainer can review and reopen it if appropriate.

Thanks again for taking the time to contribute.