test(search): cover flag_overrides and align regression test with schema

- Add test_search_api_query_flag_override: asserts api_query key emits
  --query (not --api-query) via the flag_overrides mapping.
- Add test_search_api_natural_query_key: asserts the client-friendly
  "query" key also produces --query naturally.
- Update regression test to use api_query (matching the published
  schema name from dest) instead of the natural query key.

Signed-off-by: Eric Hackathorn <erichackathorn@gmail.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Hackshaven

tests/api/test_cli_run_search_stage.py

@@ -24,7 +24,7 @@ def test_cli_run_accepts_search_stage():
             json={
                 "stage": "search",
                 "command": "api",
-                "args": {"url": "https://example.com/api", "query": "temperature"},
+                "args": {"url": "https://example.com/api", "api_query": "temperature"},
             },
         )
     assert r.status_code == 200, f"unexpected status: {r.json()}"

tests/cli/test_api_args.py

@@ -56,3 +56,30 @@ def test_aliases_dest_target_and_src():
     assert argv[:2] == ["decimate", "local"]
     # path should be positional at the end
     assert argv[-1] == "./out.bin"
+
+
+def test_search_api_query_flag_override():
+    """api_query key must emit --query (not --api-query)."""
+    argv = _args_dict_to_argv(
+        "search",
+        "api",
+        {"url": "https://example.com/api", "api_query": "temperature"},
+    )
+    assert argv[:2] == ["search", "api"]
+    assert "--query" in argv
+    assert "--api-query" not in argv
+    i = argv.index("--query")
+    assert argv[i + 1] == "temperature"
+
+
+def test_search_api_natural_query_key():
+    """Client-friendly 'query' key must also produce --query."""
+    argv = _args_dict_to_argv(
+        "search",
+        "api",
+        {"url": "https://example.com/api", "query": "temperature"},
+    )
+    assert argv[:2] == ["search", "api"]
+    assert "--query" in argv
+    i = argv.index("--query")
+    assert argv[i + 1] == "temperature"