Add a Public API to Engage the Scan Tool and Verify the Output

[MohamedSabthar]

Problem

Currently, the scan tool doesn't implement any public API for testing. We need a way to test domain-specific static code rules when they are added to the Ballerina library via a compiler plugin.

Related issue: ballerina-platform/ballerina-library#7293

Proposed Solution

Introduce a public API. Research is needed for the design and implementation.

Alternatives

No response

Version

No response

[MaryamZi]

Compiler plugins perform the scan tool related analysis only when the ScanContext is added to the CompilerContext, which isn't really straightforward to do, so implementing a TestScanContext and TestReported isn't an option either.

Atm, we'll have to do a bal scan to get the analysis to run.