From ead48cd39961e0a1f6982089bea7ecbac1037f26 Mon Sep 17 00:00:00 2001
From: Seth <seth@sethfreiberg.com>
Date: Sun, 15 Mar 2026 21:16:14 -0400
Subject: [PATCH] Docs: expand bundled sudo agent behavior

- Document sudo history context (last 10 actions)
- Document whitelist scope and syntax auto-repair
- Clarify sudo must be typed in chat without slash
- Add additional sudo usage example
---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 39af29d..fb080d2 100644
--- a/README.md
+++ b/README.md
@@ -152,6 +152,10 @@ sudo <request>       — command translator mode (authorized user only)
 - Model: uses `command_model`
 - Output: JSON commands only, then executes via same whitelist validator
 - No divine speech generated
+- Uses rolling sudo memory: last 10 sudo actions (request + translated + executed commands)
+- Uses strict command-family whitelist (`give`, `effect`, `xp`, `tp`, `time`, `weather`, `execute`, `kill`, `summon`, `tellraw`, `worldborder`)
+- Includes syntax repair for common model mistakes (e.g., `give player 64 item`, missing `minecraft:`)
+- Must be typed in chat as `sudo ...` (no slash)
 
 Example:
 ```
@@ -162,6 +166,15 @@ Best-effort translation:
 give slingshooter08 minecraft:oak_log 500
 ```
 
+Another example:
+```
+sudo give me 10 doors
+```
+Best-effort translation (can be multiple commands):
+```
+give slingshooter08 minecraft:oak_door 10
+```
+
 On login players see:
 ```
 [GOD] GOD ENABLED — Type "bible" in chat for guidance. Type "pray <message>" to pray.