docs: add cli.mode config documentation

Author: DeveshParagiri

docs/architecture.md

@@ -295,6 +295,12 @@ Agents and network edges are keyed by `scenario_id`, not `population_id`. This a
 
 Resolution order: programmatic > env vars > config file > defaults
 
+### CLI Zone
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `mode` | `human` | `human` = interactive prompts, rich output. `agent` = JSON output, exit codes, no prompts |
+
 ### Models Zone
 
 | Field | Default | Description |

docs/commands.md

@@ -313,6 +313,7 @@ extropy config reset
 | `simulation.rate_tier` | Rate limit tier (1-4) |
 | `simulation.rpm_override` | RPM override |
 | `simulation.tpm_override` | TPM override |
+| `cli.mode` | CLI mode: `human` (interactive) or `agent` (JSON output) |
 | `show_cost` | Show cost tracking |
 | `providers.<name>.base_url` | Custom provider base URL |
 | `providers.<name>.api_key_env` | Custom provider API key env var |
@@ -557,4 +558,6 @@ extropy validate scenario/congestion-tax/scenario.v1.yaml
 # Config
 extropy config show
 extropy config set simulation.strong anthropic/claude-sonnet-4.5
+extropy config set cli.mode agent  # for AI harnesses
+extropy config set cli.mode human  # for terminal users (default)
 ```