GhostQA

Run behavioral tests against a product. Args: product: Product name (must match a YAML file in .specterqa/products/). journey: Specific journey/scenario ID to run. Omit to run all journeys. level: Test level -- "smoke" (quick, 1 scenario), "standard" (all), or "thorough" (all + extra coverage). budget: Maximum spend for this run in USD. Default: $5.00. headless: Run browser in headless mode. Default: true. directory: Working directory to search for .specterqa/ project. Defaults to the server's working directory. Returns: JSON string with run results including pass/fail, findings, and cost.

List available products and their journeys. Args: directory: Working directory to search for .specterqa/ project. Defaults to the server's working directory. Returns: JSON array of products with their journeys.

Get results from a previous SpecterQA run. Args: run_id: The run ID (e.g., "GQA-RUN-20260222-143052-a1b2"). directory: Working directory to search for .specterqa/ project. Defaults to the server's working directory. Returns: JSON string with the full run result, or an error.

Initialize a SpecterQA project. Args: directory: Parent directory for .specterqa/ project. Default: current directory. url: Optional base URL for the product. If provided, the sample product config will be updated with this URL. Returns: JSON with success status and list of created files.

Check cumulative budget status without running tests. Args: directory: Working directory to search for .specterqa/ project. Defaults to the server's working directory. per_day_usd: Daily spend limit in USD. 0.0 means no limit. per_month_usd: Monthly spend limit in USD. 0.0 means no limit. Returns: JSON string with current budget status including daily/monthly spend, limits, and whether a run can proceed.