Fix multi-agent CLI invocation and clean docs

Author: pfahlr

run_rag_verification.py

@@ -610,13 +610,17 @@ def script_help_text(script: Path) -> str:
 def determine_flag(script: Path, candidates: Sequence[str]) -> str | None:
     help_text = script_help_text(script)
     advertised = _advertised_flags(help_text)
+    for flag in candidates:
+        if flag and flag in advertised:
+            return flag
+
     try:
         source = script.read_text(encoding="utf-8")
     except (OSError, UnicodeDecodeError):
-        return None
+        source = ""
     for flag in candidates:
         if flag and flag in source:
-          return flag
+            return flag
     return None
 
 
@@ -861,15 +865,12 @@ def build_question_invocation(
     if script is None:
         raise RuntimeError("No asker script available")
     route = "multi" if use_multi else "asker"
-    def _append_flag(script_path: Path, args: list[str], candidates: list[str], value: str) -> None:
+    def _append_flag(
+        script_path: Path, args: list[str], candidates: list[str], value: str
+    ) -> None:
         flag = determine_flag(script_path, candidates)
-        if not flag:
-            # Typer-based CLIs such as multi_agent.py require running via ``-m`` to
-            # expose subcommand help. When invoked as a script from the harness the
-            # ``--help`` probe used by ``determine_flag`` fails, so fall back to the
-            # primary candidate.
-            flag = candidates[0]
-        args.extend([flag, value])
+        if flag:
+            args.extend([flag, value])
 
     if not use_multi:
         base_args: List[str] = []

src/research/clients/docs/arxiv_api.md

@@ -1,4 +1,3 @@
-<<<<<<< ours
 # arXiv API Documentation
 
 [See the entire API documentation site here](https://info.arxiv.org/help/api/user-manual.html)
@@ -219,14 +218,14 @@ print_r($response);
 * Use `id_list=cond-mat/0207270` for latest version
 * Use `id_list=cond-mat/0207270v1` for specific version
 
-=======
-# ArXiv API
+---
+
+## 🔄 Integration Notes
 
-The metadata scanner uses the [ArXiv API](https://arxiv.org/help/api/user-manual) as a fallback
-when a DOI cannot be resolved via Crossref. The API is queried at
-`https://export.arxiv.org/api/query` with the `id_list` parameter set to the
-arXiv identifier extracted from a DOI like `10.48550/arXiv.XXXX`.
+The metadata scanner uses the [arXiv API](https://arxiv.org/help/api/user-manual)
+as a fallback when a DOI cannot be resolved via Crossref. The API is queried at
+`https://export.arxiv.org/api/query` with the `id_list` parameter set to the arXiv
+identifier extracted from a DOI such as `10.48550/arXiv.XXXX`.
 
 The response is an Atom feed. The scanner parses the first entry to obtain
 fields such as title, authors, publication date, and DOI.
->>>>>>> theirs