Add profile_codeql_query_from_logs tool & other

- Add `list_mrva_run_results` tool to discover Multi-Repository Variant
  Analysis run results from `CODEQL_MRVA_RUN_RESULTS_DIRS` directories
- Add `profile_codeql_query_from_logs` tool to parse evaluator logs into
  performance profiles (JSON + Mermaid) without re-running queries
- Add reusable evaluator log parser supporting both raw and summary formats
- Extend `codeql_database_analyze` with logDir, evaluator-log, and
  tuple-counting parameters, matching `codeql_query_run` logging support
- Generate evaluator log summaries post-execution for query run and
  database analyze commands
- Add `getMrvaRunResultsDirs` to discovery config for MRVA env var
- Add unit tests for all new tools and libraries

Author: data-douser

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/README.md

@@ -0,0 +1,25 @@
+# `profile_codeql_query_from_logs` - multi_query_raw_log
+
+## Purpose
+
+Tests the `profile_codeql_query_from_logs` tool with a multi-query raw
+evaluator log (`evaluator-log.jsonl`) produced by `codeql database analyze`.
+
+This validates that the parser correctly groups predicates by their
+`queryCausingWork` event ID reference, producing separate per-query profiles.
+
+## Inputs
+
+- `before/evaluator-log.jsonl` — Raw evaluator log containing two queries
+  (QueryA.ql and QueryB.ql) with distinct predicates grouped by
+  `queryCausingWork` event ID references.
+- `test-config.json` — Specifies `evaluatorLog`, `outputDir`, and `topN=10`.
+
+## Outputs
+
+- `after/query-evaluation-profile.json` — Structured profile with two queries:
+  QueryA (2 predicates, 1 cache hit, 200ms) and QueryB (3 predicates, 0 cache
+  hits, 300ms).
+- `after/query-evaluation-profile.md` — Mermaid diagram with multi-query
+  layout showing a root node branching to Q0 (QueryA) and Q1 (QueryB) with
+  their respective predicate nodes.

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/after/monitoring-state.json

@@ -0,0 +1,26 @@
+{
+  "sessions": [
+    {
+      "id": "integration_test_session",
+      "calls": [
+        {
+          "tool": "profile_codeql_query_from_logs",
+          "timestamp": "2025-10-08T21:00:00.000Z",
+          "status": "success",
+          "arguments": {
+            "evaluatorLog": "client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/before/evaluator-log.jsonl",
+            "outputDir": "client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/after",
+            "topN": 10
+          },
+          "response": {
+            "message": "Query log profiling completed successfully",
+            "filesGenerated": [
+              "query-evaluation-profile.json",
+              "query-evaluation-profile.md"
+            ]
+          }
+        }
+      ]
+    }
+  ]
+}

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/after/query-evaluation-profile.json

@@ -0,0 +1,75 @@
+{
+  "codeqlVersion": "2.23.1",
+  "logFormat": "raw",
+  "queries": [
+    {
+      "queryName": "/workspace/QueryA.ql",
+      "totalDurationMs": 200,
+      "predicateCount": 2,
+      "predicates": [
+        {
+          "predicateName": "QueryA::source/0#abc123",
+          "position": "/workspace/QueryA.ql:10,1-12,5",
+          "durationMs": 65,
+          "resultSize": 5,
+          "pipelineCount": 1,
+          "evaluationStrategy": "SIMPLE_INTENSIONAL",
+          "dependencies": []
+        },
+        {
+          "predicateName": "QueryA::sink/0#def456",
+          "position": "/workspace/QueryA.ql:14,1-16,5",
+          "durationMs": 45,
+          "resultSize": 3,
+          "pipelineCount": 1,
+          "evaluationStrategy": "SIMPLE_INTENSIONAL",
+          "dependencies": [
+            "QueryA::source/0#abc123"
+          ]
+        }
+      ],
+      "cacheHits": 1
+    },
+    {
+      "queryName": "/workspace/QueryB.ql",
+      "totalDurationMs": 300,
+      "predicateCount": 3,
+      "predicates": [
+        {
+          "predicateName": "QueryB::entryPoint/0#jkl012",
+          "position": "/workspace/QueryB.ql:8,1-10,3",
+          "durationMs": 95,
+          "resultSize": 8,
+          "pipelineCount": 1,
+          "evaluationStrategy": "EXTENSIONAL",
+          "dependencies": []
+        },
+        {
+          "predicateName": "QueryB::flowStep/2#mno345",
+          "position": "/workspace/QueryB.ql:12,1-18,5",
+          "durationMs": 95,
+          "resultSize": 12,
+          "pipelineCount": 1,
+          "evaluationStrategy": "SIMPLE_INTENSIONAL",
+          "dependencies": [
+            "QueryB::entryPoint/0#jkl012"
+          ]
+        },
+        {
+          "predicateName": "QueryB::result/3#pqr678",
+          "position": "/workspace/QueryB.ql:20,1-22,5",
+          "durationMs": 45,
+          "resultSize": 2,
+          "pipelineCount": 1,
+          "evaluationStrategy": "SIMPLE_INTENSIONAL",
+          "dependencies": [
+            "QueryB::flowStep/2#mno345",
+            "QueryB::entryPoint/0#jkl012"
+          ]
+        }
+      ],
+      "cacheHits": 0
+    }
+  ],
+  "totalEvents": 27
+}

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/after/query-evaluation-profile.md

@@ -0,0 +1,26 @@
+```mermaid
+graph TD
+
+  ROOT["Evaluation Log<br/>2 queries"]
+
+  Q0["QueryA.ql<br/>200.00ms<br/>Predicates: 2"]
+  ROOT --> Q0
+  Q0P0["QueryA::source/0#abc123<br/>65.00ms | 5 results"]
+  Q0 --> Q0P0
+  Q0P1["QueryA::sink/0#def456<br/>45.00ms | 3 results"]
+  Q0 --> Q0P1
+
+  Q1["QueryB.ql<br/>300.00ms<br/>Predicates: 3"]
+  ROOT --> Q1
+  Q1P0["QueryB::entryPoint/0#jkl012<br/>95.00ms | 8 results"]
+  Q1 --> Q1P0
+  Q1P1["QueryB::flowStep/2#mno345<br/>95.00ms | 12 results"]
+  Q1 --> Q1P1
+  Q1P2["QueryB::result/3#pqr678<br/>45.00ms | 2 results"]
+  Q1 --> Q1P2
+
+
+  classDef default fill:#e1f5ff,stroke:#333,stroke-width:2px
+  classDef query fill:#ffe1e1,stroke:#333,stroke-width:3px
+  class QUERY query
+```