Repository navigation
Commit f52a3e3
committed
docs(sandbox): document opencode.db image-upgrade remediation
Follow-up to agent-of-empires#2650 (fix agent-of-empires#2605). Reviewer Seluj78 flagged an acknowledged
trade-off in the merged fix: emptying clean_files for the opencode
data-dir mount also drops the container-image-update reset the struct
doc originally described. If a future image bump ships an opencode
release whose drizzle migrations are not forward-compatible with the
pre-existing sandbox DB, opencode aborts on boot. This is not
hypothetical - the same failure class is observed upstream on
standalone opencode CLI upgrades (anomalyco/opencode#31119, #16678).
Add a Troubleshooting entry to docs/guides/sandbox.md following the
existing Symptoms/Cause/Fix shape (matches the OOM entry), with:
- The failing scenario symptoms
- Root cause chain: sandbox DB persists (agent-of-empires#2605) -> drizzle forward-only
-> incompatible migration on old DB -> boot abort
- One-line remediation: rm -f ~/.local/share/opencode/sandbox/opencode.db{,-wal,-shm}
- Reactive framing (rare event, most upgrades migrate cleanly)
- Upstream anomalyco/opencode issue references so the entry ages with
evidence rather than speculation
Docs-only, no code impact, no test impact.1 parent 83d110c commit f52a3e3
1 file changed
Lines changed: 14 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
265 | 265 | | |
266 | 266 | | |
267 | 267 | | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
| 271 | + | |
| 272 | + | |
| 273 | + | |
| 274 | + | |
| 275 | + | |
| 276 | + | |
| 277 | + | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
| 281 | + | |
0 commit comments