Add client integration tests for codeql_query_run with Rust language

- rust_tools_print_ast: Tests PrintAST query with graphtext format
  interpretation, including expected graphtext output for AST visualization
- rust_call_graph_from_example1: Tests CallGraphFrom query with SARIF format
  interpretation and external predicates for source function selection

Agent-Logs-Url: https://github.com/advanced-security/codeql-development-mcp-server/sessions/ee9dfe2b-a152-4a44-88b9-6e9c2b7bc831

Co-authored-by: data-douser <70299490+data-douser@users.noreply.github.com>

Author: Copilot

client/integration-tests/primitives/tools/codeql_query_run/rust_call_graph_from_example1/README.md

@@ -0,0 +1,63 @@
+# Integration Test: codeql_query_run/rust_call_graph_from_example1
+
+## Purpose
+
+Tests the `codeql_query_run` tool with the CallGraphFrom query for Rust language, demonstrating external predicates for source function selection and SARIF format interpretation for call graph visualization.
+
+## Test Scenario
+
+This test validates that the `codeql_query_run` tool can:
+
+1. Accept `queryName` ("CallGraphFrom") and `queryLanguage` ("rust") parameters
+2. Accept `sourceFunction` parameter to specify which function's outbound calls to analyze
+3. Resolve the query path using `codeql resolve queries` to find the CallGraphFrom.ql query
+4. Automatically provide external predicates for the sourceFunction
+5. Execute the resolved query against a Rust test database with external predicate data
+6. Interpret the .bqrs results using native `codeql bqrs interpret --format=sarif-latest`
+7. Generate SARIF format output containing call graph results
+8. Return enhanced results confirming the interpretation succeeded
+
+## Required Inputs
+
+The test requires the following inputs in `before/monitoring-state.json`:
+
+- `queryName`: "CallGraphFrom" - Name of the query to resolve and execute
+- `queryLanguage`: "rust" - Programming language for query resolution
+- `database`: "server/ql/rust/tools/test/CallGraphFrom/CallGraphFrom.testproj" - Path to CodeQL test database
+- `sourceFunction`: "source_func" - Source function name to analyze (used as external predicate)
+- `output`: "query-results.bqrs" - Output file for binary query results
+- `format`: "sarif-latest" - SARIF format for interpreting @kind problem query results
+- `interpretedOutput`: "query-results.sarif" - Output file for SARIF format results
+- `timeout`: 300000 - Timeout in milliseconds (5 minutes)
+
+The test database is created by running `codeql test extract server/ql/rust/tools/test/CallGraphFrom`.
+
+## Expected Outputs
+
+The test expects the following behavior:
+
+- `monitoring-state.json`: Test execution state showing success
+- The tool generates `query-results.bqrs` (binary query results, not committed to repo)
+- The tool interprets results using `codeql bqrs interpret --format=sarif-latest`
+- The SARIF output contains call graph entries showing calls from `source_func` to `unrelated1` and `unrelated2`
+- The monitoring state confirms successful execution and interpretation
+
+## Expected Behavior
+
+The tool should:
+
+1. Resolve "CallGraphFrom" to the absolute path of `server/ql/rust/tools/src/CallGraphFrom/CallGraphFrom.ql`
+2. Automatically add external predicate: `sourceFunction=source_func`
+3. Execute the query against the provided database with the external predicate data
+4. Generate query results in BQRS format
+5. Call `codeql bqrs interpret` with format=sarif-latest
+6. Generate SARIF output showing calls from the source function
+7. Return enhanced output confirming the interpretation succeeded
+
+## External Predicates Integration
+
+This test demonstrates the integration between the MCP server's sourceFunction parameter and CodeQL's external predicates system. The CallGraphFrom query uses `external string sourceFunction()` to receive the function name, making it work with any Rust code database.
+
+## Format Parameter
+
+This test uses the `format` parameter which leverages native CodeQL tooling (`codeql bqrs interpret`) to produce SARIF output based on query metadata.

client/integration-tests/primitives/tools/codeql_query_run/rust_call_graph_from_example1/after/monitoring-state.json

@@ -0,0 +1,15 @@
+{
+  "toolName": "codeql_query_run",
+  "parameters": {
+    "queryName": "CallGraphFrom",
+    "queryLanguage": "rust",
+    "database": "server/ql/rust/tools/test/CallGraphFrom/CallGraphFrom.testproj",
+    "sourceFunction": "source_func",
+    "output": "query-results.bqrs",
+    "format": "sarif-latest",
+    "interpretedOutput": "query-results.sarif",
+    "timeout": 300000
+  },
+  "success": true,
+  "description": "Successfully executed CallGraphFrom (@kind problem) query using query name resolution with external predicates and SARIF format interpretation for Rust language"
+}

client/integration-tests/primitives/tools/codeql_query_run/rust_call_graph_from_example1/before/monitoring-state.json

@@ -0,0 +1,15 @@
+{
+  "toolName": "codeql_query_run",
+  "parameters": {
+    "queryName": "CallGraphFrom",
+    "queryLanguage": "rust",
+    "database": "server/ql/rust/tools/test/CallGraphFrom/CallGraphFrom.testproj",
+    "sourceFunction": "source_func",
+    "output": "query-results.bqrs",
+    "format": "sarif-latest",
+    "interpretedOutput": "query-results.sarif",
+    "timeout": 300000
+  },
+  "expectedSuccess": true,
+  "description": "Test codeql_query_run with queryName resolution for CallGraphFrom (@kind problem) query using external predicates and SARIF format interpretation for Rust language"
+}

client/integration-tests/primitives/tools/codeql_query_run/rust_tools_print_ast/README.md

@@ -0,0 +1,62 @@
+# Integration Test: codeql_query_run/rust_tools_print_ast
+
+## Purpose
+
+Tests the `codeql_query_run` tool with the PrintAST query for Rust language, demonstrating external predicates for source file selection and graphtext format interpretation for AST visualization.
+
+## Test Scenario
+
+This test validates that the `codeql_query_run` tool can:
+
+1. Accept `queryName` ("PrintAST") and `queryLanguage` ("rust") parameters
+2. Accept `sourceFiles` parameter to specify which source files to analyze
+3. Resolve the query path using `codeql resolve queries` to find the PrintAST.ql query
+4. Automatically provide external predicates for the selectedSourceFiles
+5. Execute the resolved query against a Rust test database with external predicate data
+6. Interpret the .bqrs results using native `codeql bqrs interpret -t kind=graph -t id=rust/tools/print-ast --format=graphtext`
+7. Generate graphtext format output representing the AST graph structure
+8. Return enhanced results confirming the interpretation succeeded
+
+## Required Inputs
+
+The test requires the following inputs in `before/monitoring-state.json`:
+
+- `queryName`: "PrintAST" - Name of the query to resolve and execute
+- `queryLanguage`: "rust" - Programming language for query resolution
+- `database`: "server/ql/rust/tools/test/PrintAST/PrintAST.testproj" - Path to CodeQL test database
+- `sourceFiles`: "server/ql/rust/tools/test/PrintAST/Example1.rs" - Source file(s) to analyze (used as external predicate)
+- `output`: "query-results.bqrs" - Output file for binary query results
+- `format`: "graphtext" - Native CodeQL format for interpreting @kind graph query results
+- `interpretedOutput`: "query-results" - Output directory for graphtext format results
+
+The test database should be pre-created at `server/ql/rust/tools/test/PrintAST/PrintAST.testproj` by running `codeql test extract server/ql/rust/tools/test/PrintAST`.
+
+## Expected Outputs
+
+The test expects the following behavior:
+
+- `monitoring-state.json`: Test execution state showing success
+- The tool generates `query-results.bqrs` (binary query results, not committed to repo)
+- The tool interprets results using `codeql bqrs interpret -t kind=graph -t id=rust/tools/print-ast --format=graphtext`
+- The interpreted output is written to a directory structure at `query-results/`
+- The monitoring state confirms successful execution and interpretation
+
+## Expected Behavior
+
+The tool should:
+
+1. Resolve "PrintAST" to the absolute path of `server/ql/rust/tools/src/PrintAST/PrintAST.ql`
+2. Automatically add external predicate: `selectedSourceFiles=Example1.rs`
+3. Execute the query against the provided database with the external predicate data
+4. Generate query results in BQRS format
+5. Call `codeql bqrs interpret` with format=graphtext and appropriate metadata (-t kind=graph -t id=rust/tools/print-ast)
+6. Generate graphtext format output showing the AST structure for the selected Rust source file
+7. Return enhanced output confirming the interpretation succeeded
+
+## External Predicates Integration
+
+This test demonstrates the integration between the MCP server's sourceFiles parameter and CodeQL's external predicates system. The PrintAST query uses `external string selectedSourceFiles()` to receive file paths, making it work with any Rust code database rather than being limited to test directories.
+
+## Format Parameter
+
+This test uses the `format` parameter which leverages native CodeQL tooling (`codeql bqrs interpret`) to produce properly formatted output based on query metadata, rather than custom post-processing.

client/integration-tests/primitives/tools/codeql_query_run/rust_tools_print_ast/after/monitoring-state.json

@@ -0,0 +1,14 @@
+{
+  "toolName": "codeql_query_run",
+  "parameters": {
+    "queryName": "PrintAST",
+    "queryLanguage": "rust",
+    "database": "server/ql/rust/tools/test/PrintAST/PrintAST.testproj",
+    "sourceFiles": "server/ql/rust/tools/test/PrintAST/Example1.rs",
+    "output": "query-results.bqrs",
+    "format": "graphtext",
+    "interpretedOutput": "query-results"
+  },
+  "success": true,
+  "description": "Successfully executed PrintAST query using query name resolution with external predicates and graphtext format interpretation for Rust language"
+}