feat: add network traffic capture for test runs

README.md

@@ -128,6 +128,7 @@ finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-
 - [CLI Reference](docs/cli-reference.md) — all commands, flags, and report tools
 - [Configuration](docs/configuration.md) — workspace config, app identity, `--app` flag, and per-environment overrides
 - [Environment & Secrets](docs/environment.md) — dotenv load order, provider keys, and platform prerequisites
+- [Network Logging](docs/network-logging.md) — capture HTTP/HTTPS traffic from test runs
 - [Troubleshooting](docs/troubleshooting.md) — common errors and fixes
 
 

docs/cli-reference.md

@@ -48,6 +48,16 @@ finalrun suite auth_smoke.yaml --platform ios --model anthropic/claude-sonnet-4-
 finalrun check --env dev --platform android
 ```
 
+## Network Capture
+
+| Command | Description |
+|---|---|
+| `finalrun log-network --platform <android\|ios>` | Set up and capture HTTP/HTTPS traffic from a device. Streams requests live to the terminal, writes a HAR file on Ctrl+C. |
+
+Options: `--device <serial>` to specify a device, `--out <path>` for custom HAR output path.
+
+See [Network Logging](network-logging.md) for setup and configuration.
+
 ## Report Commands
 
 | Command | Description |

docs/configuration.md

@@ -31,6 +31,7 @@ The workspace config defines defaults used by the CLI when flags are omitted.
 | `app.bundleId` | iOS bundle identifier (e.g. `com.example.myapp`) |
 | `env` | Default environment name (used when `--env` is omitted) |
 | `model` | Default AI model in `provider/model` format (used when `--model` is omitted) |
+| `network.capture` | Enable HTTP/HTTPS network capture during test runs (`true` / `false`, default `false`). Requires one-time setup — see [Network Logging](network-logging.md). |
 
 At least one of `app.packageName` or `app.bundleId` is required.