Oleksandr Kozachuk
2.1 KiB
SPEC-008 — Configuration
TOML config per deployment (kroa.toml, ggg.toml — both untracked;
config.toml in the repo is the placeholder sample). Loaded by
FjerkroaBot.load_config, hot-reloaded by a watchdog observer
(defect D9 — reload race — is tracked in FDB-004 and will refine
these requirements).
CFG-01 — TOML config loads into a plain dict (coverage: test)
FjerkroaBot.load_config(path) parses the TOML file and returns its
top-level table as a dict; responders read raw keys from it.
CFG-02 — Per-channel system prompt override (coverage: test)
A responder bound to channel X uses config["X"] as its system
prompt when that key exists, else config["system"]. One deployment
can speak differently per channel.
CFG-03 — Missing news file degrades silently (coverage: test)
When news points to a non-existent file, the context suffix simply
carries no news section (no crash, no literal placeholder — revised
with ENV-20; previously the {news} placeholder stayed literal).
CFG-04 — Config hot-reload applies on the event loop (coverage: test)
The watchdog observer thread never mutates live config references
itself: a detected change is loaded, then the swap of bot.config
and all responder .config references is scheduled onto the event
loop (call_soon_threadsafe), so no request ever reads a
half-swapped config (D9). Before the loop runs (startup), the swap
applies directly — there are no concurrent readers yet.
CFG-05 — Hot-reload is rename-safe (coverage: test)
The watcher observes the config file's directory, not the file, and reacts to a modified, created, or moved event whose source or destination path is the config file. This catches atomic saves — write a temp file, then rename it over the target — which replace the inode and fire a move/create rather than a modify; watching the file directly would go deaf after the first such save. Open/close events are deliberately not handled: reloading re-opens the file to read it, so reacting to opens would feed back into an endless reload loop. Events for other files in the directory, and directory events themselves, are ignored.