add spec system: sdd/bdd/tdd loops, trace enforcement, envelope+config specs

2026-07-13 12:53:38 +02:00
parent 1879992b22
commit f1578cbd99
11 changed files with 682 additions and 0 deletions
@@ -0,0 +1,23 @@
+# 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 leaves the placeholder untouched (coverage: test)
+
+When `news` points to a non-existent file, the `{news}` placeholder
+stays literal in the system prompt (no crash, no empty substitution).