Skip to content

Houston v0.4.11

Choose a tag to compare

@github-actions github-actions released this 18 May 04:04
· 195 commits to main since this release
903e888

Houston 0.4.11

A hotfix release. 0.4.10 shipped a race condition that could leave your workspace index on disk with a few stray bytes at the end after two rapid actions on the same workspace, for example two provider changes back to back. Once that happened, Houston would fail to load workspaces and agents on next launch and drop you on the "start tutorial" screen with nothing reachable.

What this fixes

  • Self-healing workspace index. On launch, Houston now detects the corrupted shape, recovers the valid part, and rewrites the file cleanly. If you have been stuck on the start tutorial after a recent update, just install 0.4.11 and relaunch. Your workspaces and agents come back automatically. No manual file editing, no data loss.
  • No more race on the workspace index. The writer now uses a unique temp filename per save, so two concurrent updates can never stomp each other again.

Before you upgrade

  • Mac: quit Houston before installing. macOS does not always replace a running app cleanly. If in doubt, remove /Applications/Houston.app and drag the new copy in.

If you are currently stuck on the start tutorial

Auto-update should still reach you because the update notification lives outside the broken workspace surface. If for any reason it does not, download the 0.4.11 DMG from the GitHub release page and drag it over /Applications/Houston.app. The new app reads your existing ~/.houston/ and repairs the file on first launch.

Known limitations

  • If you manually edited ~/.houston/workspaces/workspaces.json to recover from this bug earlier, you do not need to do anything. Your file is already clean.
  • The self-healing only catches the specific "valid JSON + trailing bytes" pattern this bug produced. A file that is mangled in a different way will still surface a real error so you can see it.