Repository navigation
Clearer tool descriptions for AI assistants: every tool now says when to use it, what it changes and what it returns, every parameter is documented, and tools carry read-only / destructive hints. No change to simulator behaviour.