refactor: iac documentation url in outputs

Author: Almog Ben-David

src/cli/commands/test/iac-local-execution/results-formatter.ts

@@ -65,6 +65,7 @@ function formatScanResult(
       },
       severity: policy.severity,
       lineNumber,
+      documentation: `https://snyk.io/security-rules/${policy.publicId}`,
     };
   });
 

src/cli/commands/test/iac-output.ts

@@ -209,6 +209,7 @@ export function extractReportingDescriptor(
       },
       properties: {
         tags: ['security', `${issue.type}/${issue.subType}`],
+        documentation: issue.documentation,
       },
     };
   });

src/lib/snyk-test/iac-test-result.ts

@@ -10,6 +10,7 @@ export interface AnnotatedIacIssue {
   type: string;
   subType: string;
   path: string[];
+  documentation: string;
   // Legacy fields from Registry, unused.
   name?: string;
   from?: string[];

test/acceptance/cli-test/iac/cli-test.iac-utils.ts

@@ -303,6 +303,7 @@ function generateDummyIssue(severity): AnnotatedIacIssue {
     subType: 'Deployment',
     path: [],
     lineNumber: 1,
+    documentation: 'https://snyk.io/security-rules/SNYK-CC-K8S-1',
   };
 }
 

test/jest/unit/iac-unit-tests/results-formatter.fixtures.ts

@@ -80,6 +80,7 @@ export const expectedFormattedResults = {
         },
         severity: anotherPolicyStub.severity,
         lineNumber: 3,
+        documentation: `https://snyk.io/security-rules/${anotherPolicyStub.publicId}`,
       },
     ],
     projectType: 'k8sconfig',