Some external issues are still not migrated

[okorach-sonar]

I ran a CloudVoyager migration for a project (my favorite sonar-tools project) that has a wide variety of issues in a wide variety of states.
When I compare the nbr of issues, I can see that there are still a substantial number of issues from the source SQS that are missing in the target SQC.
Looking at the details of the issues that are not migrated, i am not sure if that a coincidence by they are all external issues from Ruff.
See below (after the screenshot), the export of issues from the source SQS and target SQC to witness the difference in detail.

sqs_issues.csv

sqc_issues.csv

[joshua-quek-sonarsource]

Reference to Sonar-tools.zip project, where there are Ruff external issues that do not get migrated

[joshua-quek-sonarsource]

Summary

CloudVoyager was dropping all external issues (Ruff, Pylint, Flake8 linters) during migration to SonarCloud.

Root causes found and fixed:

1. add-protobuf-files.js: External issues were correctly built into protobuf messages but externalIssues-{ref}.pb and adhoerules.pb were never written to the upload zip archive.

2. source-methods.js: Unit test files (UTS qualifier) were excluded from source file extraction, causing their issues to be skipped from validComponentKeys.

3. build-file-components.js: Safety net added to ensure FIL components from the component tree are added even without source code.

Test plan

• Built and packaged successfully
• Ran full transfer on okorach-oss_sonar-tools project (SQ 2026.1)
• Before fix: 554 external issues skipped, 778/1332 SC issues migrated
• After fix: 0 external issues skipped, 1332/1332 SC issues migrated (100% match)
• Spot-checked SonarCloud — external_ruff rules confirmed migrated

Files changed

File	Change
src/pipelines/sq-2025/sonarcloud/uploader/helpers/add-protobuf-files.js	Added externalIssues and adHocRules to zip
src/pipelines/sq-2025/sonarqube/api-client/helpers/source-methods.js	Added UTS qualifier to include unit test files
src/pipelines/sq-2025/protobuf/build-components/helpers/build-file-components.js	Safety net for FIL components without source
docs/regression-testing.md	Generalized protocol to support any SQ project

++ @okorach-sonar @okorach
PR #151 solved this, tested and verified

[okorach-sonar]

Fixed !