[UPDATE PRIMITIVE] codeql_bqrs_decode tool support for singular file OR list of files

[Copilot]

This pull request improves the usability and robustness of the codeql_bqrs_decode tool by allowing it to accept both a singular file argument and a plural files array, addressing issues encountered by automated and LLM-based clients. It also adds clear error handling when neither argument is provided, updates the tool schema and documentation, and introduces regression and unit tests to ensure correct behavior.

Key changes:

Tool Input Handling & Validation

• Updated the codeql_bqrs_decode tool definition to accept either a singular file (string) or plural files (array) argument, with both being optional but at least one required. This improves compatibility with clients that naturally provide a single file path.
• Enhanced the CLI tool registry logic to normalize both file and files arguments and to throw a clear, actionable error naming both parameters if neither is supplied, instead of a generic schema error. Whitespace-only paths are treated as missing.

Testing & Regression Coverage

• Added comprehensive unit tests to verify that both file and files arguments are accepted, that missing or whitespace-only arguments produce clear errors, and that the correct positional arguments are passed to the CLI. [1] [2]
• Introduced a regression integration test (decode_singular_file) to ensure the tool correctly decodes a BQRS file when provided with a singular file argument. [1] [2] [3] [4]

Documentation & Changelog

• Updated the changelog to document the new support for the singular file argument and the improved error message, referencing the relevant issues and pull requests.
• Added documentation for the new regression test, explaining its purpose and expected behavior.

Miscellaneous

• Updated the tool schema test to verify the presence of both file and files properties and their correct validation in the input schema. [1] [2]

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[Copilot]

Pull request overview

This PR updates the codeql_bqrs_decode MCP server tool contract to accept a singular file argument (in addition to files), aligning the advertised schema with the existing registry normalization, and adds tests/docs plus a rebuilt server bundle.

Changes:

• Extend codeql_bqrs_decode input schema to support optional file and optional files.
• Add a runtime guard for codeql_bqrs_* tools to produce a clearer “file/files required” error when no BQRS path is provided.
• Add unit + integration test coverage and update CHANGELOG.md (plus rebuilt server/dist bundle).

Show a summary per file

File	Description
server/src/tools/codeql/bqrs-decode.ts	Advertises file (singular) alongside files (plural) in the tool input schema.
server/src/lib/cli-tool-registry.ts	Adds a BQRS-tool guard error when no positional BQRS path is provided.
server/test/src/tools/codeql/bqrs-decode.test.ts	Adds schema-level tests to ensure both file and files parse.
server/test/src/lib/cli-tool-registry.test.ts	Adds handler-level tests for file/files normalization and missing-path error behavior.
client/integration-tests/primitives/tools/codeql_bqrs_decode/decode_singular_file/test-config.json	New integration test config exercising the singular file argument path.
client/integration-tests/primitives/tools/codeql_bqrs_decode/decode_singular_file/README.md	Documents the new integration test’s purpose/inputs/outputs.
client/integration-tests/primitives/tools/codeql_bqrs_decode/decode_singular_file/before/monitoring-state.json	New fixture (legacy) for integration test directory structure.
client/integration-tests/primitives/tools/codeql_bqrs_decode/decode_singular_file/after/monitoring-state.json	New fixture (legacy) for integration test directory structure.
server/dist/codeql-development-mcp-server.js	Rebuilt bundled server output reflecting the TypeScript changes.
CHANGELOG.md	Adds an Unreleased “Fixed” entry for the file vs files schema mismatch.

Copilot's findings

• Files reviewed: 9/12 changed files
• Comments generated: 3

[Copilot]

Copilot's findings

• Files reviewed: 9/12 changed files
• Comments generated: 2

[Copilot]

Copilot's findings

• Files reviewed: 9/12 changed files
• Comments generated: 2