From 10150ae9f59729700b20288c97eed860099b0df8 Mon Sep 17 00:00:00 2001 From: didericis Date: Thu, 23 Jul 2026 19:40:20 -0400 Subject: [PATCH] docs(paths): correct root docstring after SQLite queue migration The module docstring still listed "queue" and "audit logs" as things living under the app data root, which read as directories. Both have been tables in the shared SQLite DB since PRD 0067; the legacy `queue/` directory was unplumbed in 29904609 and nothing has written there since. Lists what the root actually holds and points at the stores that own the queue/audit rows, so the next reader doesn't go looking for a directory that isn't there. Co-Authored-By: Claude Opus 4.8 --- bot_bottle/paths.py | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/bot_bottle/paths.py b/bot_bottle/paths.py index 74c24de..a64179c 100644 --- a/bot_bottle/paths.py +++ b/bot_bottle/paths.py @@ -1,8 +1,14 @@ """Foundational filesystem paths for bot-bottle. -`bot_bottle_root()` is the app data root — state, queue, audit logs, -git-gate keys, and the shared DB all live under it. It defaults to -`~/.bot-bottle` and is overridable with the **`BOT_BOTTLE_ROOT`** env var. +`bot_bottle_root()` is the app data root — per-bottle state, git-gate +keys, the gateway CA, and the shared SQLite DB all live under it. It +defaults to `~/.bot-bottle` and is overridable with the +**`BOT_BOTTLE_ROOT`** env var. + +Note that the supervise queue and the audit log are *tables in the shared +DB*, not directories under the root — see `queue_store.py` / `audit_store.py`. +The root held a `queue/` directory before the SQLite migration (PRD 0067); +nothing writes there now. The env override is the single knob for redirecting the root: the test suite points it at a throwaway dir instead of monkey-patching the function