Testing

Local Verification

Run the full local verification suite:

cargo fmt --check
cargo clippy --all-targets -- -D warnings
cargo test

Targeted Tests

Area	Command
Config parsing	cargo test --test config
Grok Responses payload and response adapters	cargo test --test adapter_grok_responses
Search orchestration	cargo test --test service_contract
Tavily parsing	cargo test --test tavily_parse
Source merge behavior	cargo test --test source_merge
Logging	cargo test --test logging

Live Smoke Testing

Live provider tests require real API keys and should not be committed as logs.

Recommended smoke matrix:

1. GROK_SEARCH_URL=https://api.x.ai or another compatible gateway root URL.
2. GROK_SEARCH_X_SEARCH=false for baseline Responses web_search only.
3. GROK_SEARCH_X_SEARCH=true only when the gateway is known to preserve x_search.
4. Tavily fallback by forcing an empty or source-less Grok response in tests.
5. web_fetch against a stable public URL, first with Tavily, then with Firecrawl fallback.
6. web_map with a small max_results value.

Store live logs under logs/; the directory is ignored by git.