Integration tests for read_database_source tool

Adds client integration tests for the new 'read_database_source'
MCP server tool.

Author: data-douser

client/integration-tests/primitives/tools/read_database_source/list_source_files/README.md

@@ -0,0 +1,17 @@
+# `read_database_source` - list_source_files
+
+## Purpose
+
+Tests the `read_database_source` tool in listing mode by omitting `filePath` to list all source files in a CodeQL database source archive.
+
+## Inputs
+
+- **database**: Path to the JavaScript example test database
+
+## Expected Behavior
+
+The tool should return a listing of all source files in the database's `src/` directory, including `totalEntries`, `returnedEntries`, and `truncated` metadata.
+
+## Static Files Referenced
+
+- `server/ql/javascript/examples/test/ExampleQuery1/ExampleQuery1.testproj`

client/integration-tests/primitives/tools/read_database_source/list_source_files/after/monitoring-state.json

@@ -0,0 +1,14 @@
+{
+  "sessions": [
+    {
+      "id": "integration_test_session",
+      "calls": [
+        {
+          "tool": "read_database_source",
+          "timestamp": "2025-09-25T16:06:00.000Z",
+          "status": "success"
+        }
+      ]
+    }
+  ]
+}

client/integration-tests/primitives/tools/read_database_source/list_source_files/before/monitoring-state.json

@@ -0,0 +1,6 @@
+{
+  "sessions": [],
+  "parameters": {
+    "databasePath": "server/ql/javascript/examples/test/ExampleQuery1/ExampleQuery1.testproj"
+  }
+}

client/integration-tests/primitives/tools/read_database_source/read_source_file/README.md

@@ -0,0 +1,18 @@
+# `read_database_source` - read_source_file
+
+## Purpose
+
+Tests the `read_database_source` tool in file-read mode by requesting a specific source file from a CodeQL database source archive.
+
+## Inputs
+
+- **database**: Path to the JavaScript example test database
+- **filePath**: Path to a source file within the database archive
+
+## Expected Behavior
+
+The tool should return the contents of the requested source file along with metadata including `entryPath`, `sourceType`, `totalLines`, `startLine`, and `endLine`.
+
+## Static Files Referenced
+
+- `server/ql/javascript/examples/test/ExampleQuery1/ExampleQuery1.testproj`

client/integration-tests/primitives/tools/read_database_source/read_source_file/after/monitoring-state.json

@@ -0,0 +1,14 @@
+{
+  "sessions": [
+    {
+      "id": "integration_test_session",
+      "calls": [
+        {
+          "tool": "read_database_source",
+          "timestamp": "2025-09-25T16:06:00.000Z",
+          "status": "success"
+        }
+      ]
+    }
+  ]
+}

client/integration-tests/primitives/tools/read_database_source/read_source_file/before/monitoring-state.json

@@ -0,0 +1,7 @@
+{
+  "sessions": [],
+  "parameters": {
+    "databasePath": "server/ql/javascript/examples/test/ExampleQuery1/ExampleQuery1.testproj",
+    "filePath": "ExampleQuery1.js"
+  }
+}

extensions/vscode/test/fixtures/multi-root-workspace/folder-a/codeql-storage/queries/SqlInjection.ql-def456/query.log

@@ -0,0 +1,2 @@
+[2026-01-20 15:00:00] [SPAMMY] execute query-server2> runQuery called with /workspace/src/SqlInjection.ql
+[2026-01-20 15:00:01] Calling plumbing command: codeql resolve upgrades --dbscheme=/databases/test-python-db/db-python/semmlecode.python.dbscheme --format=json