docs(actualbudget): record config precedence gotcha

This commit is contained in:
2026-08-10 22:24:08 -04:00
parent 0ea8390e96
commit 77a6b87ba0

View File

@@ -18,7 +18,7 @@ The domain model (Host, Module, Skeleton, Auto-loader, Enable convention, overla
## Gotchas
- Actual Budget's NixOS service runs `actual-server` with `WorkingDirectory = services.actual.settings.dataDir`, and `actual-server` prefers a `config.json` in that current directory over `ACTUAL_CONFIG_PATH`.
- Actual Budget's NixOS service runs `actual-server` with `WorkingDirectory = services.actual.settings.dataDir`, and the `actual-server` CLI wrapper sets `ACTUAL_CONFIG_PATH=./config.json` when that current directory contains `config.json`, overriding the NixOS module's generated config path before the server loads configuration.
When migrating old community-script state, either preserve the old in-guest data path or remove/update the copied `config.json`, otherwise stale absolute paths such as `/opt/actualbudget-data/server-files` override the declarative module settings.
- Subagent completion delivery is non-blocking through immediate spawn, milestone notifications, retained terminal entries, and `subagent_list` or `subagent_result` retrieval.
`subagent_wait` intentionally blocks the parent tool call until its condition or timeout, so do not use it merely to keep background work alive during an interactive workflow.