Add retrieval-grounded sudo flow and execution feedback loop

README.md

@@ -53,6 +53,10 @@ Gateway hardening currently included:
 - SQLite-backed session persistence across gateway restarts
 - Command sanitization at gateway return time (strips leading `/`, rejects prose/non-command lines)
 - Mode-specific command family filtering and command dedupe/cap
+- Localized knowledge retrieval for tool mode:
+  - local corpus under `/var/lib/mc-langgraph-gateway/knowledge`
+  - indexed search + document snippet retrieval (`local.search` -> `local.read`)
+  - optional bootstrap download of Minecraft/Paper/WorldEdit docs at startup
 
 ---
 
@@ -115,6 +119,8 @@ Info lookup mode via sudo:
 
 Lookup mode is information-only (wiki/web retrieval + optional justification), and does not execute game commands.
 
+For normal `sudo` translation, the gateway now also runs localized retrieval before command generation, so the model can ground command synthesis in local indexed docs rather than relying only on prompt memory.
+
 These trigger multi-command `fill/setblock/give` sequences near the player and are optimized for Paper performance.
 
 ---
@@ -130,6 +136,10 @@ Important keys:
 - `sudo_max_commands`: default `12` (higher for build bursts)
 - `interventions_per_day`: default `24`
 - `first_login_benevolence_max_commands`: default `12`
+- `bug_log_path`: default `/var/log/mc_aigod_paper_bug.log`
+- `bug_log_service_lines`: recent AI action lines attached to each bug entry
+- `tp_safety_enabled`: auto-wrap risky vertical teleports with fall protection
+- `tp_safety_vertical_delta`: relative Y threshold for teleport safety wrapper
 
 ---