feat: add VulnScanOutput data model with comprehensive test coverage

- Add VulnScanOutput class with structured vulnerability scan results
- Include core scan fields: scan_success, return_code, scan_results_file_path
- Add performance/timing data: scan_time, results_file_size
- Include vulnerability counts by severity: critical, high, medium, low, other
- Add structured error handling with error_message field

Author: bluesentinelsec

entrypoint/entrypoint/data_model.py

@@ -118,3 +118,45 @@ def __init__(self,
         self.generation_time = generation_time
         self.file_size = file_size
         self.error_message = error_message
+
+
+class VulnScanOutput:
+    def __init__(self,
+                 # Core scan results
+                 scan_success=False,
+                 return_code=None,
+                 scan_results_file_path=None,
+                 
+                 # Performance/timing data  
+                 scan_time=None,
+                 results_file_size=None,
+                 
+                 # Vulnerability counts
+                 total_vulnerabilities=None,
+                 critical_count=None,
+                 high_count=None,
+                 medium_count=None,
+                 low_count=None,
+                 other_count=None,
+                 
+                 # Error handling
+                 error_message=None):
+        # Core scan results
+        self.scan_success = scan_success
+        self.return_code = return_code
+        self.scan_results_file_path = scan_results_file_path
+        
+        # Performance/timing data
+        self.scan_time = scan_time
+        self.results_file_size = results_file_size
+        
+        # Vulnerability counts
+        self.total_vulnerabilities = total_vulnerabilities
+        self.critical_count = critical_count
+        self.high_count = high_count
+        self.medium_count = medium_count
+        self.low_count = low_count
+        self.other_count = other_count
+        
+        # Error handling
+        self.error_message = error_message

entrypoint/tests/test_data_model.py

@@ -1,5 +1,5 @@
 import unittest
-from entrypoint.data_model import ArtifactType, ScanConfig, OutputConfig, SBOMOutput, parse_comma_list
+from entrypoint.data_model import ArtifactType, ScanConfig, OutputConfig, SBOMOutput, VulnScanOutput, parse_comma_list
 
 
 class MockArgs:
@@ -387,3 +387,102 @@ def test_sbom_output_failure_scenario(self):
         self.assertEqual(output.error_message, "Timeout exceeded")
         self.assertIsNone(output.file_path)
         self.assertIsNone(output.generation_time)
+
+    def test_vuln_scan_output_can_be_created(self):
+        output = VulnScanOutput()
+        self.assertIsNotNone(output)
+
+    def test_vuln_scan_output_has_scan_success(self):
+        output = VulnScanOutput(scan_success=True)
+        self.assertEqual(output.scan_success, True)
+
+    def test_vuln_scan_output_has_return_code(self):
+        output = VulnScanOutput(return_code=0)
+        self.assertEqual(output.return_code, 0)
+
+    def test_vuln_scan_output_has_scan_results_file_path(self):
+        output = VulnScanOutput(scan_results_file_path="/tmp/scan.json")
+        self.assertEqual(output.scan_results_file_path, "/tmp/scan.json")
+
+    def test_vuln_scan_output_has_scan_time(self):
+        output = VulnScanOutput(scan_time=12.5)
+        self.assertEqual(output.scan_time, 12.5)
+
+    def test_vuln_scan_output_has_results_file_size(self):
+        output = VulnScanOutput(results_file_size=4096)
+        self.assertEqual(output.results_file_size, 4096)
+
+    def test_vuln_scan_output_has_vulnerability_counts(self):
+        output = VulnScanOutput(
+            total_vulnerabilities=25,
+            critical_count=5,
+            high_count=8,
+            medium_count=7,
+            low_count=3,
+            other_count=2
+        )
+        self.assertEqual(output.total_vulnerabilities, 25)
+        self.assertEqual(output.critical_count, 5)
+        self.assertEqual(output.high_count, 8)
+        self.assertEqual(output.medium_count, 7)
+        self.assertEqual(output.low_count, 3)
+        self.assertEqual(output.other_count, 2)
+
+    def test_vuln_scan_output_has_error_message(self):
+        output = VulnScanOutput(error_message="API timeout")
+        self.assertEqual(output.error_message, "API timeout")
+
+    def test_vuln_scan_output_defaults(self):
+        output = VulnScanOutput()
+        self.assertEqual(output.scan_success, False)
+        self.assertIsNone(output.return_code)
+        self.assertIsNone(output.scan_results_file_path)
+        self.assertIsNone(output.scan_time)
+        self.assertIsNone(output.results_file_size)
+        self.assertIsNone(output.total_vulnerabilities)
+        self.assertIsNone(output.critical_count)
+        self.assertIsNone(output.high_count)
+        self.assertIsNone(output.medium_count)
+        self.assertIsNone(output.low_count)
+        self.assertIsNone(output.other_count)
+        self.assertIsNone(output.error_message)
+
+    def test_vuln_scan_output_success_scenario(self):
+        output = VulnScanOutput(
+            scan_success=True,
+            return_code=0,
+            scan_results_file_path="/tmp/results.json",
+            scan_time=8.3,
+            results_file_size=2048,
+            total_vulnerabilities=15,
+            critical_count=2,
+            high_count=5,
+            medium_count=6,
+            low_count=2,
+            other_count=0
+        )
+        self.assertEqual(output.scan_success, True)
+        self.assertEqual(output.return_code, 0)
+        self.assertEqual(output.scan_results_file_path, "/tmp/results.json")
+        self.assertEqual(output.scan_time, 8.3)
+        self.assertEqual(output.results_file_size, 2048)
+        self.assertEqual(output.total_vulnerabilities, 15)
+        self.assertEqual(output.critical_count, 2)
+        self.assertEqual(output.high_count, 5)
+        self.assertEqual(output.medium_count, 6)
+        self.assertEqual(output.low_count, 2)
+        self.assertEqual(output.other_count, 0)
+        self.assertIsNone(output.error_message)
+
+    def test_vuln_scan_output_failure_scenario(self):
+        output = VulnScanOutput(
+            scan_success=False,
+            return_code=1,
+            error_message="Inspector API unavailable"
+        )
+        self.assertEqual(output.scan_success, False)
+        self.assertEqual(output.return_code, 1)
+        self.assertEqual(output.error_message, "Inspector API unavailable")
+        self.assertIsNone(output.scan_results_file_path)
+        self.assertIsNone(output.scan_time)
+        self.assertIsNone(output.total_vulnerabilities)