feat(test): add support for folder-based query test cases

[cx-romeu-silva]

Reason for Proposed Changes

• The current Query File Tree structure looks like:

  - <technology>/
    |- <provider>/
    |  |- <queryfolder>/
    |  |  |- test/
    |  |  |  |- positive[1..]<.ext>
    |  |  |  |- negative[1..]<.ext>
    |  |  |  |- positive_expected_result.json
    |  |  |- metadata.json
    |  |  |- query.rego
  

• Limitation: Some queries access multiple resources, which can be located in different files but the current structure forces all related resources into the same file

Proposed Changes

• Update the KICS test framework to support organizing test cases in folders, enabling better structuring of complex test scenarios.
• The new Query File Tree structure extends on the existing one and looks like:

  - <technology>/
    |- <provider>/
    |  |- <queryfolder>/
    |  |  |- test/
    |  |  |  |- positive[1..]<.ext>
    |  |  |  |- negative[1..]<.ext>
    |  |  |  |- positive_expected_result.json
    |  |  |  |- positive[1..]/ (= <folder_name>/)
    |  |  |  |  |- <folder_name>_[1..]<.ext>
    |  |  |  |  |- positive_expected_result.json
    |  |  |  |- negative[1..]/ (= <folder_name>/)
    |  |  |  |  |- <folder_name>_[1..]<.ext>
    |  |  |- metadata.json
    |  |  |- query.rego
  

• Update documentation to reflect new folder-based test case organization.

I submit this contribution under the Apache-2.0 license.

[github-actions]

KICS version: v2.1.11

Category Results CRITICAL 0 HIGH 0 MEDIUM 0 LOW 0 INFO 0 TRACE 0 TOTAL 0	Metric Values Files scanned 1 Files parsed 1 Files failed to scan 0 Total executed queries 47 Queries failed to execute 0 Execution time 0

[cx-artur-ribeiro]

LGTM! Nice work Romeu, insane improvement to KICS, specially for Terraform related test cases.