Upload 2 files

app.py

@@ -180,6 +180,11 @@ def format_hts(hts_value):
     return s
 
 
+def bool_to_symbol(value: bool) -> str:
+    """Convert boolean to check/cross symbol"""
+    return "Y" if value else "N"
+
+
 def results_to_dataframe(results):
     """Convert validation results to DataFrame"""
     data = []
@@ -196,6 +201,19 @@ def results_to_dataframe(results):
             "Full Description": r.description,
             "Primary HTS": format_hts(r.primary_hts),
             "Additional HTS": additional_hts_str,
+            # HTS membership indicators
+            "Steel HTS": bool_to_symbol(r.in_steel_hts),
+            "Alum HTS": bool_to_symbol(r.in_aluminum_hts),
+            "Copper HTS": bool_to_symbol(r.in_copper_hts),
+            "Computer HTS": bool_to_symbol(r.in_computer_hts),
+            "Auto HTS": bool_to_symbol(r.in_auto_hts),
+            # Keyword indicators
+            "Metal KW": bool_to_symbol(r.has_metal_keyword),
+            "Alum KW": bool_to_symbol(r.has_aluminum_keyword),
+            "Copper KW": bool_to_symbol(r.has_copper_keyword),
+            "Zinc KW": bool_to_symbol(r.has_zinc_keyword),
+            "Plastics KW": bool_to_symbol(r.has_plastics_keyword),
+            # Validation results
             "Scenario": r.scenario_id,
             "Scenario Summary": r.scenario_summary,
             "Status": r.status,
@@ -434,7 +452,13 @@ with tab2:
             # Select columns to display
             display_columns = [
                 "Entry Number", "Description", "Primary HTS",
-                "Additional HTS", "Scenario", "Status", "Issue"
+                "Additional HTS",
+                # HTS indicators
+                "Steel HTS", "Alum HTS", "Copper HTS", "Computer HTS", "Auto HTS",
+                # Keyword indicators
+                "Metal KW", "Alum KW", "Copper KW", "Zinc KW", "Plastics KW",
+                # Validation
+                "Scenario", "Status", "Issue"
             ]
 
             # Interactive filtering section
@@ -621,6 +645,19 @@ with tab2b:
             ).agg({
                 "Entry Number": "count",  # Count occurrences
                 "Additional HTS": "first",  # Take first (should be same for same HTS+desc)
+                # HTS indicators
+                "Steel HTS": "first",
+                "Alum HTS": "first",
+                "Copper HTS": "first",
+                "Computer HTS": "first",
+                "Auto HTS": "first",
+                # Keyword indicators
+                "Metal KW": "first",
+                "Alum KW": "first",
+                "Copper KW": "first",
+                "Zinc KW": "first",
+                "Plastics KW": "first",
+                # Validation
                 "Scenario": "first",
                 "Scenario Summary": "first",
                 "Status": "first",
@@ -682,6 +719,11 @@ with tab2b:
             # Display columns
             display_cols = [
                 "Primary HTS", "Description", "Additional HTS",
+                # HTS indicators
+                "Steel HTS", "Alum HTS", "Copper HTS", "Computer HTS", "Auto HTS",
+                # Keyword indicators
+                "Metal KW", "Alum KW", "Copper KW", "Zinc KW", "Plastics KW",
+                # Validation
                 "Scenario", "Status", "Count", "Issue"
             ]
 

hts_validator.py

@@ -1,6 +1,15 @@
 """
 HTS Validator - Core validation logic for HTS tariff auditing
 Validates primary HTS codes against additional HTS and description keywords
+
+Logic Flow:
+1. Check Override Keywords (Zinc, Plastics) - highest priority
+2. Check Special HTS (Computer Parts, Auto Parts)
+3. Check Primary HTS membership:
+   a. If in 2+ HTS categories -> Dual HTS logic
+   b. If in 1 HTS category -> Single HTS logic
+   c. If in 0 HTS categories -> Keyword-only logic
+4. Within each HTS category, check description keywords
 """
 
 import re
@@ -17,26 +26,86 @@ COPPER_CODES = {"99037801", "99037802"}
 GENERAL_301_CODE = "99030133"
 MISMATCH_CODE = "99030125"
 
-# Scenario summaries
+# All 232/tariff codes for checking forbidden
+ALL_232_CODES = STEEL_232_CODES | ALUMINUM_232_CODES | COPPER_CODES
+
+# Scenario summaries - updated for new case IDs
 SCENARIO_SUMMARIES = {
-    "S1": "Steel HTS + 232 tariff applied - verify 99030133 present, no 99030125",
-    "S2": "Metal keyword but NOT steel HTS - should apply 99030125, no 232 tariffs",
-    "S4": "Aluminum HTS + 232 tariff applied - verify 99030133 present, no 99030125",
-    "S5": "Aluminum keyword but NOT aluminum HTS - should apply 99030125, no 232 tariffs",
-    "S7": "Dual Steel+Aluminum HTS - matches keyword, apply corresponding 232, no 99030125",
-    "S7a": "Dual Steel+Aluminum HTS + BOTH keywords - flag for manual review",
-    "S8": "Dual Steel+Aluminum HTS + NO keywords - flag for manual review",
-    "S9": "Copper keyword but NOT copper HTS - should apply 99030125, no 232 tariffs",
-    "S11": "Dual Aluminum+Copper HTS + copper keyword - apply 99030133 + copper tariffs, no 99030125",
-    "S12": "Dual Aluminum+Copper HTS + aluminum keyword - apply 99030133 + aluminum 232, no 99030125",
-    "S13": "Zinc keyword - should ONLY apply 99030125, no 232 tariffs allowed",
-    "S14": "Plastics keyword + metal HTS - override, should ONLY apply 99030125",
-    "S15": "Steel HTS + aluminum keyword - should apply 99030125, no 99030133 or 232 tariffs",
-    "S16": "Aluminum HTS + steel keyword - should apply 99030125, no 99030133 or 232 tariffs",
-    "S17": "Copper HTS but NO copper keyword - should apply copper tariffs + 99030133, no 99030125",
-    "COPPER_OK": "Copper HTS + copper keyword - verify copper tariffs applied",
-    "S18": "Computer Parts HTS - flag for manual review",
-    "S19": "Auto Parts HTS - flag for manual review",
+    # Level 0: Override
+    "Z1": "Zinc keyword - only 99030125, no 232/copper tariffs",
+    "P1": "Plastics + Steel HTS - only 99030125, no 232",
+    "P2": "Plastics + Aluminum HTS - only 99030125, no 232",
+    "P3": "Plastics + Steel+Alum HTS - only 99030125, no 232",
+    "P4": "Plastics + no metal HTS - no action",
+    "P5": "Plastics + Copper HTS - only 99030125, no copper tariff",
+    "P6": "Plastics + Alum+Copper HTS - only 99030125, no 232/copper",
+    # Level 1: Special HTS
+    "C1": "Computer Parts HTS - FLAG for manual review",
+    "A1": "Auto Parts HTS - FLAG for manual review",
+    # Level 2: Dual HTS - Steel + Aluminum
+    "D1": "Steel+Alum HTS, no keyword - FLAG",
+    "D2": "Steel+Alum HTS + metal keyword - Steel 232 + 99030133",
+    "D3": "Steel+Alum HTS + aluminum keyword - Alum 232 + 99030133",
+    "D4": "Steel+Alum HTS + copper keyword - 99030125 (mismatch)",
+    "D5": "Steel+Alum HTS + metal+alum keywords - FLAG ambiguous",
+    "D6": "Steel+Alum HTS + metal+copper keywords - Steel 232 + 99030133",
+    "D7": "Steel+Alum HTS + alum+copper keywords - Alum 232 + 99030133",
+    "D8": "Steel+Alum HTS + all keywords - FLAG ambiguous",
+    # Level 2: Dual HTS - Aluminum + Copper
+    "E1": "Alum+Copper HTS, no keyword - FLAG",
+    "E2": "Alum+Copper HTS + metal keyword - 99030125 (mismatch)",
+    "E3": "Alum+Copper HTS + aluminum keyword - Alum 232 + 99030133",
+    "E4": "Alum+Copper HTS + copper keyword - Copper + 99030133",
+    "E5": "Alum+Copper HTS + metal+alum keywords - Alum 232 + 99030133",
+    "E6": "Alum+Copper HTS + metal+copper keywords - Copper + 99030133",
+    "E7": "Alum+Copper HTS + alum+copper keywords - FLAG ambiguous",
+    "E8": "Alum+Copper HTS + all keywords - FLAG ambiguous",
+    # Level 2: Dual HTS - Steel + Copper
+    "F1": "Steel+Copper HTS, no keyword - FLAG",
+    "F2": "Steel+Copper HTS + metal keyword - Steel 232 + 99030133",
+    "F3": "Steel+Copper HTS + aluminum keyword - 99030125 (mismatch)",
+    "F4": "Steel+Copper HTS + copper keyword - Copper + 99030133",
+    "F5": "Steel+Copper HTS + metal+alum keywords - Steel 232 + 99030133",
+    "F6": "Steel+Copper HTS + metal+copper keywords - FLAG ambiguous",
+    "F7": "Steel+Copper HTS + alum+copper keywords - Copper + 99030133",
+    "F8": "Steel+Copper HTS + all keywords - FLAG ambiguous",
+    # Level 3: Single HTS - Steel
+    "S1": "Steel HTS, no keyword - Steel 232 + 99030133",
+    "S2": "Steel HTS + metal keyword - Steel 232 + 99030133",
+    "S3": "Steel HTS + aluminum keyword - 99030125 (mismatch)",
+    "S4": "Steel HTS + copper keyword - 99030125 (mismatch)",
+    "S5": "Steel HTS + metal+alum keywords - Steel 232 + 99030133",
+    "S6": "Steel HTS + metal+copper keywords - Steel 232 + 99030133",
+    "S7": "Steel HTS + alum+copper keywords - 99030125 (mismatch)",
+    "S8": "Steel HTS + all keywords - Steel 232 + 99030133",
+    # Level 3: Single HTS - Aluminum
+    "L1": "Aluminum HTS, no keyword - Alum 232 + 99030133",
+    "L2": "Aluminum HTS + metal keyword - 99030125 (mismatch)",
+    "L3": "Aluminum HTS + aluminum keyword - Alum 232 + 99030133",
+    "L4": "Aluminum HTS + copper keyword - 99030125 (mismatch)",
+    "L5": "Aluminum HTS + metal+alum keywords - Alum 232 + 99030133",
+    "L6": "Aluminum HTS + metal+copper keywords - 99030125 (mismatch)",
+    "L7": "Aluminum HTS + alum+copper keywords - Alum 232 + 99030133",
+    "L8": "Aluminum HTS + all keywords - Alum 232 + 99030133",
+    # Level 3: Single HTS - Copper
+    "U1": "Copper HTS, no keyword - Copper + 99030133",
+    "U2": "Copper HTS + metal keyword - 99030125 (mismatch)",
+    "U3": "Copper HTS + aluminum keyword - 99030125 (mismatch)",
+    "U4": "Copper HTS + copper keyword - Copper tariff",
+    "U5": "Copper HTS + metal+alum keywords - 99030125 (mismatch)",
+    "U6": "Copper HTS + metal+copper keywords - Copper tariff",
+    "U7": "Copper HTS + alum+copper keywords - Copper tariff",
+    "U8": "Copper HTS + all keywords - Copper tariff",
+    # Level 4: No HTS Match
+    "N1": "No metal HTS, no keyword - no action",
+    "N2": "No metal HTS + metal keyword - 99030125",
+    "N3": "No metal HTS + aluminum keyword - 99030125",
+    "N4": "No metal HTS + copper keyword - 99030125",
+    "N5": "No metal HTS + metal+alum keywords - 99030125",
+    "N6": "No metal HTS + metal+copper keywords - 99030125",
+    "N7": "No metal HTS + alum+copper keywords - 99030125",
+    "N8": "No metal HTS + all keywords - 99030125",
+    # Legacy
     "NONE": "No applicable scenario - entry does not match any validation rules",
 }
 
@@ -50,11 +119,23 @@ class ValidationResult:
     additional_hts: List[str]
     scenario_id: str
     scenario_summary: str
-    status: str  # PASS, FAIL, FLAG
+    status: str  # PASS, FLAG
     expected_hts: List[str]
     missing_hts: List[str]
     unexpected_hts: List[str]
     issue: str
+    # HTS membership indicators
+    in_steel_hts: bool = False
+    in_aluminum_hts: bool = False
+    in_copper_hts: bool = False
+    in_computer_hts: bool = False
+    in_auto_hts: bool = False
+    # Keyword indicators
+    has_metal_keyword: bool = False
+    has_aluminum_keyword: bool = False
+    has_copper_keyword: bool = False
+    has_zinc_keyword: bool = False
+    has_plastics_keyword: bool = False
 
 
 class HTSValidator:
@@ -151,6 +232,25 @@ class HTSValidator:
         """Check if any of the HTS codes are present"""
         return bool(hts_codes & additional_set)
 
+    def _get_keyword_category(self, has_metal: bool, has_aluminum: bool, has_copper: bool) -> str:
+        """Determine keyword category code (K0-K7)"""
+        if has_metal and has_aluminum and has_copper:
+            return "K7"
+        elif has_aluminum and has_copper:
+            return "K6"
+        elif has_metal and has_copper:
+            return "K5"
+        elif has_metal and has_aluminum:
+            return "K4"
+        elif has_copper:
+            return "K3"
+        elif has_aluminum:
+            return "K2"
+        elif has_metal:
+            return "K1"
+        else:
+            return "K0"
+
     def validate_entry(self, entry_number: str, description: str,
                        primary_hts: str, additional_hts: List[str]) -> ValidationResult:
         """Validate a single entry against all scenarios"""
@@ -181,7 +281,10 @@ class HTSValidator:
         has_301 = self._check_hts_present(GENERAL_301_CODE, additional_set)
         has_mismatch = self._check_hts_present(MISMATCH_CODE, additional_set)
 
-        # Apply validation rules in priority order
+        # Get keyword category
+        keyword_cat = self._get_keyword_category(has_metal_kw, has_aluminum_kw, has_copper_kw)
+
+        # Apply validation rules in level order
         return self._apply_validation_rules(
             entry_number=entry_number,
             description=desc,
@@ -202,7 +305,123 @@ class HTSValidator:
             has_copper_tariff=has_copper_tariff,
             has_301=has_301,
             has_mismatch=has_mismatch,
-            additional_set=additional_set
+            additional_set=additional_set,
+            keyword_cat=keyword_cat
+        )
+
+    def _create_result(self, entry_number: str, description: str, primary_hts: str,
+                       additional_hts: List[str], scenario_id: str,
+                       expected_codes: List[str], forbidden_codes: Set[str],
+                       additional_set: Set[str], always_flag: bool = False,
+                       flag_reason: str = "",
+                       # Indicators
+                       in_steel: bool = False, in_aluminum: bool = False, in_copper: bool = False,
+                       in_computer: bool = False, in_auto: bool = False,
+                       has_metal_kw: bool = False, has_aluminum_kw: bool = False,
+                       has_copper_kw: bool = False, has_zinc_kw: bool = False,
+                       has_plastics_kw: bool = False) -> ValidationResult:
+        """Create validation result by checking expected vs actual
+
+        For tariff code groups (Steel 232, Aluminum 232, Copper), we check if ANY is present.
+        For individual codes (99030125, 99030133), we check if that specific code is present.
+        """
+
+        if always_flag:
+            return ValidationResult(
+                entry_number=entry_number,
+                description=description,
+                primary_hts=primary_hts,
+                additional_hts=additional_hts,
+                scenario_id=scenario_id,
+                scenario_summary=SCENARIO_SUMMARIES.get(scenario_id, ""),
+                status="FLAG",
+                expected_hts=[],
+                missing_hts=[],
+                unexpected_hts=[],
+                issue=flag_reason or "Manual review required",
+                in_steel_hts=in_steel,
+                in_aluminum_hts=in_aluminum,
+                in_copper_hts=in_copper,
+                in_computer_hts=in_computer,
+                in_auto_hts=in_auto,
+                has_metal_keyword=has_metal_kw,
+                has_aluminum_keyword=has_aluminum_kw,
+                has_copper_keyword=has_copper_kw,
+                has_zinc_keyword=has_zinc_kw,
+                has_plastics_keyword=has_plastics_kw
+            )
+
+        # Group expected codes by tariff type
+        # Check if ANY code from each group is present
+        missing = []
+        expected_display = []
+
+        # Check Steel 232 group
+        steel_232_expected = [c for c in expected_codes if c in STEEL_232_CODES]
+        if steel_232_expected:
+            expected_display.append("Steel 232")
+            if not (STEEL_232_CODES & additional_set):
+                missing.append("Steel 232 (99038190/91)")
+
+        # Check Aluminum 232 group
+        alum_232_expected = [c for c in expected_codes if c in ALUMINUM_232_CODES]
+        if alum_232_expected:
+            expected_display.append("Alum 232")
+            if not (ALUMINUM_232_CODES & additional_set):
+                missing.append("Alum 232 (99038507/08)")
+
+        # Check Copper group
+        copper_expected = [c for c in expected_codes if c in COPPER_CODES]
+        if copper_expected:
+            expected_display.append("Copper")
+            if not (COPPER_CODES & additional_set):
+                missing.append("Copper (99037801/02)")
+
+        # Check individual codes (99030133, 99030125)
+        for code in expected_codes:
+            if code not in STEEL_232_CODES and code not in ALUMINUM_232_CODES and code not in COPPER_CODES:
+                expected_display.append(code)
+                if code not in additional_set:
+                    missing.append(code)
+
+        # Check for forbidden codes present
+        unexpected = list(forbidden_codes & additional_set)
+
+        # Determine status
+        if not missing and not unexpected:
+            status = "PASS"
+            issue = "Correct tariff application"
+        else:
+            status = "FLAG"
+            issues = []
+            if missing:
+                issues.append(f"Missing: {', '.join(missing)}")
+            if unexpected:
+                issues.append(f"Unexpected: {', '.join(unexpected)}")
+            issue = "; ".join(issues)
+
+        return ValidationResult(
+            entry_number=entry_number,
+            description=description,
+            primary_hts=primary_hts,
+            additional_hts=additional_hts,
+            scenario_id=scenario_id,
+            scenario_summary=SCENARIO_SUMMARIES.get(scenario_id, ""),
+            status=status,
+            expected_hts=expected_display,
+            missing_hts=missing,
+            unexpected_hts=unexpected,
+            issue=issue,
+            in_steel_hts=in_steel,
+            in_aluminum_hts=in_aluminum,
+            in_copper_hts=in_copper,
+            in_computer_hts=in_computer,
+            in_auto_hts=in_auto,
+            has_metal_keyword=has_metal_kw,
+            has_aluminum_keyword=has_aluminum_kw,
+            has_copper_keyword=has_copper_kw,
+            has_zinc_keyword=has_zinc_kw,
+            has_plastics_keyword=has_plastics_kw
         )
 
     def _apply_validation_rules(self, entry_number: str, description: str,
@@ -214,527 +433,675 @@ class HTSValidator:
                                  has_plastics_kw: bool, has_steel_232: bool,
                                  has_aluminum_232: bool, has_copper_tariff: bool,
                                  has_301: bool, has_mismatch: bool,
-                                 additional_set: Set[str]) -> ValidationResult:
-        """Apply all validation rules and return result"""
-
-        # Priority 1: Special overrides (zinc, plastics)
-
-        # S13: Zinc keyword - only 99030125, no 232 tariffs
+                                 additional_set: Set[str], keyword_cat: str) -> ValidationResult:
+        """Apply all validation rules in level order"""
+
+        # Common indicator parameters for all _create_result calls
+        indicators = {
+            "in_steel": in_steel,
+            "in_aluminum": in_aluminum,
+            "in_copper": in_copper,
+            "in_computer": in_computer_parts,
+            "in_auto": in_auto_parts,
+            "has_metal_kw": has_metal_kw,
+            "has_aluminum_kw": has_aluminum_kw,
+            "has_copper_kw": has_copper_kw,
+            "has_zinc_kw": has_zinc_kw,
+            "has_plastics_kw": has_plastics_kw,
+        }
+
+        # =====================================================================
+        # LEVEL 0: Override Cases (Highest Priority)
+        # =====================================================================
+
+        # Z1: Zinc keyword - only 99030125, no 232/copper tariffs
         if has_zinc_kw:
-            expected = [MISMATCH_CODE]
-            issues = []
-
-            if not has_mismatch:
-                issues.append("Missing 99030125")
-            if has_steel_232 or has_aluminum_232 or has_copper_tariff:
-                issues.append("Should NOT have 232/copper tariffs with zinc")
-
-            status = "PASS" if not issues else "FAIL"
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S13",
-                scenario_summary=SCENARIO_SUMMARIES["S13"],
-                status=status,
-                expected_hts=expected,
-                missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                unexpected_hts=self._get_unexpected_232(additional_set),
-                issue="; ".join(issues) if issues else "Correct - zinc with only 99030125"
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="Z1",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=ALL_232_CODES,
+                additional_set=additional_set,
+                **indicators
             )
 
-        # S14: Plastics keyword + metal HTS - only 99030125
-        if has_plastics_kw and (in_steel or in_aluminum):
-            expected = [MISMATCH_CODE]
-            issues = []
-
-            if not has_mismatch:
-                issues.append("Missing 99030125")
-            if has_steel_232 or has_aluminum_232:
-                issues.append("Should NOT have 232 tariffs with plastics material")
-
-            status = "PASS" if not issues else "FAIL"
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S14",
-                scenario_summary=SCENARIO_SUMMARIES["S14"],
-                status=status,
-                expected_hts=expected,
-                missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                unexpected_hts=self._get_unexpected_232(additional_set),
-                issue="; ".join(issues) if issues else "Correct - plastics with only 99030125"
-            )
+        # Plastics override cases
+        if has_plastics_kw:
+            if in_steel and not in_aluminum and not in_copper:
+                # P1: Plastics + Steel HTS
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P1",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif in_aluminum and not in_steel and not in_copper:
+                # P2: Plastics + Aluminum HTS
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P2",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif in_steel and in_aluminum and not in_copper:
+                # P3: Plastics + Steel+Alum HTS
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P3",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif in_copper and not in_steel and not in_aluminum:
+                # P5: Plastics + Copper HTS
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P5",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=COPPER_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif in_aluminum and in_copper:
+                # P6: Plastics + Alum+Copper HTS
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P6",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALUMINUM_232_CODES | COPPER_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            else:
+                # P4: Plastics + no metal HTS - no action needed
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="P4",
+                    expected_codes=[],
+                    forbidden_codes=set(),
+                    additional_set=additional_set,
+                **indicators
+                )
 
-        # Priority 2: Computer Parts and Auto Parts - FLAG for review
+        # =====================================================================
+        # LEVEL 1: Special HTS Categories
+        # =====================================================================
 
-        # S18: Computer Parts HTS - flag for manual review
+        # C1: Computer Parts HTS - always FLAG
         if in_computer_parts:
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S18",
-                scenario_summary=SCENARIO_SUMMARIES["S18"],
-                status="FLAG",
-                expected_hts=[],
-                missing_hts=[],
-                unexpected_hts=[],
-                issue="Computer parts HTS - manual review required for tariff verification"
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="C1",
+                expected_codes=[], forbidden_codes=set(),
+                additional_set=additional_set,
+                **indicators,
+                always_flag=True,
+                flag_reason="Computer parts HTS - manual review required"
             )
 
-        # S19: Auto Parts HTS - flag for manual review
+        # A1: Auto Parts HTS - always FLAG
         if in_auto_parts:
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S19",
-                scenario_summary=SCENARIO_SUMMARIES["S19"],
-                status="FLAG",
-                expected_hts=[],
-                missing_hts=[],
-                unexpected_hts=[],
-                issue="Auto parts HTS - manual review required for tariff verification"
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="A1",
+                expected_codes=[], forbidden_codes=set(),
+                additional_set=additional_set,
+                **indicators,
+                always_flag=True,
+                flag_reason="Auto parts HTS - manual review required"
             )
 
-        # Priority 3: Dual list scenarios
-
-        # Dual Aluminum + Copper
-        if in_aluminum and in_copper:
-            # S11: Copper keyword
-            if has_copper_kw:
-                expected = [GENERAL_301_CODE] + list(COPPER_CODES)
-                issues = []
-
-                if not has_301:
-                    issues.append("Missing 99030133")
-                if not has_copper_tariff:
-                    issues.append("Missing copper tariff (99037801/02)")
-                if has_aluminum_232:
-                    issues.append("Should NOT have aluminum 232 when description says copper")
-                if has_mismatch:
-                    issues.append("Should NOT have 99030125 with correct copper classification")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S11",
-                    scenario_summary=SCENARIO_SUMMARIES["S11"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=self._get_missing_codes([GENERAL_301_CODE], has_301, COPPER_CODES, has_copper_tariff),
-                    unexpected_hts=list(ALUMINUM_232_CODES & additional_set) + ([MISMATCH_CODE] if has_mismatch else []),
-                    issue="; ".join(issues) if issues else "Correct - dual AL/CU with copper keyword"
-                )
-
-            # S12: Aluminum keyword
-            if has_aluminum_kw:
-                expected = [GENERAL_301_CODE] + list(ALUMINUM_232_CODES)
-                issues = []
-
-                if not has_301:
-                    issues.append("Missing 99030133")
-                if not has_aluminum_232:
-                    issues.append("Missing aluminum 232 tariff (99038507/08)")
-                if has_copper_tariff:
-                    issues.append("Should NOT have copper tariff when description says aluminum")
-                if has_mismatch:
-                    issues.append("Should NOT have 99030125 with correct aluminum classification")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S12",
-                    scenario_summary=SCENARIO_SUMMARIES["S12"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=self._get_missing_codes([GENERAL_301_CODE], has_301, ALUMINUM_232_CODES, has_aluminum_232),
-                    unexpected_hts=list(COPPER_CODES & additional_set) + ([MISMATCH_CODE] if has_mismatch else []),
-                    issue="; ".join(issues) if issues else "Correct - dual AL/CU with aluminum keyword"
-                )
-
-        # Dual Steel + Aluminum
-        if in_steel and in_aluminum:
-            # S7a: Both keywords - flag for review
-            if has_metal_kw and has_aluminum_kw:
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S7a",
-                    scenario_summary=SCENARIO_SUMMARIES["S7a"],
-                    status="FLAG",
-                    expected_hts=[],
-                    missing_hts=[],
-                    unexpected_hts=[],
-                    issue="AMBIGUOUS: Description contains both steel and aluminum keywords - manual review required"
-                )
-
-            # S7: Steel keyword
-            if has_metal_kw:
-                expected = [GENERAL_301_CODE] + list(STEEL_232_CODES)
-                issues = []
-
-                if not has_301:
-                    issues.append("Missing 99030133")
-                if not has_steel_232:
-                    issues.append("Missing steel 232 tariff (99038190/91)")
-                if has_aluminum_232:
-                    issues.append("Should NOT have aluminum 232 when description says steel")
-                if has_mismatch:
-                    issues.append("Should NOT have 99030125 with correct steel classification")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S7",
-                    scenario_summary=SCENARIO_SUMMARIES["S7"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=self._get_missing_codes([GENERAL_301_CODE], has_301, STEEL_232_CODES, has_steel_232),
-                    unexpected_hts=list(ALUMINUM_232_CODES & additional_set) + ([MISMATCH_CODE] if has_mismatch else []),
-                    issue="; ".join(issues) if issues else "Correct - dual ST/AL with steel keyword"
-                )
-
-            # S7: Aluminum keyword
-            if has_aluminum_kw:
-                expected = [GENERAL_301_CODE] + list(ALUMINUM_232_CODES)
-                issues = []
-
-                if not has_301:
-                    issues.append("Missing 99030133")
-                if not has_aluminum_232:
-                    issues.append("Missing aluminum 232 tariff (99038507/08)")
-                if has_steel_232:
-                    issues.append("Should NOT have steel 232 when description says aluminum")
-                if has_mismatch:
-                    issues.append("Should NOT have 99030125 with correct aluminum classification")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S7",
-                    scenario_summary=SCENARIO_SUMMARIES["S7"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=self._get_missing_codes([GENERAL_301_CODE], has_301, ALUMINUM_232_CODES, has_aluminum_232),
-                    unexpected_hts=list(STEEL_232_CODES & additional_set) + ([MISMATCH_CODE] if has_mismatch else []),
-                    issue="; ".join(issues) if issues else "Correct - dual ST/AL with aluminum keyword"
+        # =====================================================================
+        # LEVEL 2: Dual HTS Categories
+        # =====================================================================
+
+        # H4: Steel + Aluminum
+        if in_steel and in_aluminum and not in_copper:
+            if keyword_cat == "K0":  # D1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D1",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Aluminum HTS with no keyword - cannot determine tariff"
+                )
+            elif keyword_cat == "K1":  # D2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D2",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # D3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D3",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # D4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D4",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # D5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D5",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Aluminum HTS with both metal and aluminum keywords - ambiguous"
+                )
+            elif keyword_cat == "K5":  # D6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D6",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K6":  # D7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D7",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K7":  # D8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="D8",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Aluminum HTS with all keywords - ambiguous"
                 )
 
-            # S8: Neither keyword - FLAG for manual review
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S8",
-                scenario_summary=SCENARIO_SUMMARIES["S8"],
-                status="FLAG",
-                expected_hts=[],
-                missing_hts=[],
-                unexpected_hts=[],
-                issue="HTS in both Steel+Aluminum list but no metal/aluminum keywords - manual review required"
-            )
-
-        # Priority 3: Single list scenarios
+        # H5: Aluminum + Copper
+        if in_aluminum and in_copper and not in_steel:
+            if keyword_cat == "K0":  # E1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E1",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Aluminum+Copper HTS with no keyword - cannot determine tariff"
+                )
+            elif keyword_cat == "K1":  # E2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E2",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # E3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E3",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # E4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E4",
+                    expected_codes=list(COPPER_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # E5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E5",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K5":  # E6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E6",
+                    expected_codes=list(COPPER_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K6":  # E7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E7",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Aluminum+Copper HTS with both aluminum and copper keywords - ambiguous"
+                )
+            elif keyword_cat == "K7":  # E8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="E8",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Aluminum+Copper HTS with all keywords - ambiguous"
+                )
 
-        # Steel scenarios (S1, S15)
-        if in_steel and not in_aluminum and not in_copper:
-            # S15: Steel HTS + aluminum keyword - mismatch, should apply 99030125
-            if has_aluminum_kw and not has_metal_kw:
-                expected = [MISMATCH_CODE]
-                issues = []
-
-                if not has_mismatch:
-                    issues.append("Missing 99030125")
-                if has_steel_232 or has_aluminum_232:
-                    issues.append("Should NOT have 232 tariffs - description says aluminum but HTS is steel")
-                if has_301:
-                    issues.append("Should NOT have 99030133 - description says aluminum but HTS is steel")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S15",
-                    scenario_summary=SCENARIO_SUMMARIES["S15"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                    unexpected_hts=self._get_unexpected_232(additional_set) + ([GENERAL_301_CODE] if has_301 else []),
-                    issue="; ".join(issues) if issues else "Correct - steel HTS with aluminum keyword, has 99030125"
-                )
-
-            if has_metal_kw:
-                # S1: Steel HTS + metal keyword + 232 tariff
-                if has_steel_232:
-                    expected = [GENERAL_301_CODE]
-                    issues = []
-
-                    if not has_301:
-                        issues.append("Missing 99030133")
-                    if has_mismatch:
-                        issues.append("Should NOT have 99030125 with correct steel classification")
-
-                    status = "PASS" if not issues else "FAIL"
-                    return ValidationResult(
-                        entry_number=entry_number,
-                        description=description,
-                        primary_hts=primary_hts,
-                        additional_hts=additional_hts,
-                        scenario_id="S1",
-                        scenario_summary=SCENARIO_SUMMARIES["S1"],
-                        status=status,
-                        expected_hts=[GENERAL_301_CODE] + list(STEEL_232_CODES),
-                        missing_hts=[GENERAL_301_CODE] if not has_301 else [],
-                        unexpected_hts=[MISMATCH_CODE] if has_mismatch else [],
-                        issue="; ".join(issues) if issues else "Correct - steel HTS + keyword + 232"
-                    )
-                else:
-                    # Steel HTS + metal keyword but no 232 - should have 232
-                    issues = ["Missing steel 232 tariff (99038190/91)"]
-                    if not has_301:
-                        issues.append("Missing 99030133")
-
-                    return ValidationResult(
-                        entry_number=entry_number,
-                        description=description,
-                        primary_hts=primary_hts,
-                        additional_hts=additional_hts,
-                        scenario_id="S1",
-                        scenario_summary=SCENARIO_SUMMARIES["S1"],
-                        status="FAIL",
-                        expected_hts=[GENERAL_301_CODE] + list(STEEL_232_CODES),
-                        missing_hts=[GENERAL_301_CODE] + list(STEEL_232_CODES) if not has_301 else list(STEEL_232_CODES),
-                        unexpected_hts=[],
-                        issue="; ".join(issues)
-                    )
-
-        # S2: Metal keyword but NOT in steel list
-        if has_metal_kw and not in_steel:
-            expected = [MISMATCH_CODE]
-            issues = []
+        # H6: Steel + Copper
+        if in_steel and in_copper and not in_aluminum:
+            if keyword_cat == "K0":  # F1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F1",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Copper HTS with no keyword - cannot determine tariff"
+                )
+            elif keyword_cat == "K1":  # F2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F2",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # F3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F3",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES,
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # F4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F4",
+                    expected_codes=list(COPPER_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # F5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F5",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K5":  # F6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F6",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Copper HTS with both metal and copper keywords - ambiguous"
+                )
+            elif keyword_cat == "K6":  # F7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F7",
+                    expected_codes=list(COPPER_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K7":  # F8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="F8",
+                    expected_codes=[], forbidden_codes=set(),
+                    additional_set=additional_set,
+                    **indicators,
+                    always_flag=True,
+                    flag_reason="Steel+Copper HTS with all keywords - ambiguous"
+                )
 
-            if not has_mismatch:
-                issues.append("Missing 99030125")
-            if has_steel_232:
-                issues.append("Should NOT have steel 232 tariff - HTS not in steel list")
+        # =====================================================================
+        # LEVEL 3: Single HTS Category
+        # =====================================================================
 
-            status = "PASS" if not issues else "FAIL"
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S2",
-                scenario_summary=SCENARIO_SUMMARIES["S2"],
-                status=status,
-                expected_hts=expected,
-                missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                unexpected_hts=list(STEEL_232_CODES & additional_set),
-                issue="; ".join(issues) if issues else "Correct - metal keyword with non-steel HTS"
-            )
+        # H1: Steel Only
+        if in_steel and not in_aluminum and not in_copper:
+            if keyword_cat == "K0":  # S1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S1",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K1":  # S2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S2",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # S3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S3",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # S4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S4",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | COPPER_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # S5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S5",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K5":  # S6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S6",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K6":  # S7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S7",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K7":  # S8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="S8",
+                    expected_codes=list(STEEL_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
 
-        # Aluminum scenarios (S4, S16)
+        # H2: Aluminum Only
         if in_aluminum and not in_steel and not in_copper:
-            # S16: Aluminum HTS + steel keyword - mismatch, should apply 99030125
-            if has_metal_kw and not has_aluminum_kw:
-                expected = [MISMATCH_CODE]
-                issues = []
-
-                if not has_mismatch:
-                    issues.append("Missing 99030125")
-                if has_steel_232 or has_aluminum_232:
-                    issues.append("Should NOT have 232 tariffs - description says steel but HTS is aluminum")
-                if has_301:
-                    issues.append("Should NOT have 99030133 - description says steel but HTS is aluminum")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S16",
-                    scenario_summary=SCENARIO_SUMMARIES["S16"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                    unexpected_hts=self._get_unexpected_232(additional_set) + ([GENERAL_301_CODE] if has_301 else []),
-                    issue="; ".join(issues) if issues else "Correct - aluminum HTS with steel keyword, has 99030125"
-                )
-
-            if has_aluminum_kw:
-                # S4: Aluminum HTS + aluminum keyword + 232 tariff
-                if has_aluminum_232:
-                    expected = [GENERAL_301_CODE]
-                    issues = []
-
-                    if not has_301:
-                        issues.append("Missing 99030133")
-                    if has_mismatch:
-                        issues.append("Should NOT have 99030125 with correct aluminum classification")
-
-                    status = "PASS" if not issues else "FAIL"
-                    return ValidationResult(
-                        entry_number=entry_number,
-                        description=description,
-                        primary_hts=primary_hts,
-                        additional_hts=additional_hts,
-                        scenario_id="S4",
-                        scenario_summary=SCENARIO_SUMMARIES["S4"],
-                        status=status,
-                        expected_hts=[GENERAL_301_CODE] + list(ALUMINUM_232_CODES),
-                        missing_hts=[GENERAL_301_CODE] if not has_301 else [],
-                        unexpected_hts=[MISMATCH_CODE] if has_mismatch else [],
-                        issue="; ".join(issues) if issues else "Correct - aluminum HTS + keyword + 232"
-                    )
-                else:
-                    # Aluminum HTS + keyword but no 232
-                    issues = ["Missing aluminum 232 tariff (99038507/08)"]
-                    if not has_301:
-                        issues.append("Missing 99030133")
-
-                    return ValidationResult(
-                        entry_number=entry_number,
-                        description=description,
-                        primary_hts=primary_hts,
-                        additional_hts=additional_hts,
-                        scenario_id="S4",
-                        scenario_summary=SCENARIO_SUMMARIES["S4"],
-                        status="FAIL",
-                        expected_hts=[GENERAL_301_CODE] + list(ALUMINUM_232_CODES),
-                        missing_hts=[GENERAL_301_CODE] + list(ALUMINUM_232_CODES) if not has_301 else list(ALUMINUM_232_CODES),
-                        unexpected_hts=[],
-                        issue="; ".join(issues)
-                    )
-
-        # S5: Aluminum keyword but NOT in aluminum list
-        if has_aluminum_kw and not in_aluminum:
-            expected = [MISMATCH_CODE]
-            issues = []
-
-            if not has_mismatch:
-                issues.append("Missing 99030125")
-            if has_aluminum_232:
-                issues.append("Should NOT have aluminum 232 tariff - HTS not in aluminum list")
-
-            status = "PASS" if not issues else "FAIL"
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S5",
-                scenario_summary=SCENARIO_SUMMARIES["S5"],
-                status=status,
-                expected_hts=expected,
-                missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                unexpected_hts=list(ALUMINUM_232_CODES & additional_set),
-                issue="; ".join(issues) if issues else "Correct - aluminum keyword with non-aluminum HTS"
-            )
+            if keyword_cat == "K0":  # L1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L1",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K1":  # L2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L2",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # L3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L3",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # L4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L4",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALUMINUM_232_CODES | COPPER_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # L5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L5",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K5":  # L6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L6",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K6":  # L7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L7",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K7":  # L8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="L8",
+                    expected_codes=list(ALUMINUM_232_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
 
-        # Copper scenarios (COPPER_OK, S17)
+        # H3: Copper Only
         if in_copper and not in_steel and not in_aluminum:
-            if has_copper_kw:
-                # COPPER_OK: Copper HTS + copper keyword
-                expected = list(COPPER_CODES)
-                issues = []
-
-                if not has_copper_tariff:
-                    issues.append("Missing copper tariff (99037801/02)")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="COPPER_OK",
-                    scenario_summary=SCENARIO_SUMMARIES["COPPER_OK"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=list(COPPER_CODES) if not has_copper_tariff else [],
-                    unexpected_hts=[],
-                    issue="; ".join(issues) if issues else "Correct - copper HTS + keyword"
+            if keyword_cat == "K0":  # U1: No keyword
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U1",
+                    expected_codes=list(COPPER_CODES) + [GENERAL_301_CODE],
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K1":  # U2: Metal only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U2",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=STEEL_232_CODES | COPPER_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K2":  # U3: Aluminum only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U3",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALUMINUM_232_CODES | COPPER_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K3":  # U4: Copper only
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U4",
+                    expected_codes=list(COPPER_CODES),
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K4":  # U5: Metal + Aluminum
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U5",
+                    expected_codes=[MISMATCH_CODE],
+                    forbidden_codes=ALL_232_CODES | {GENERAL_301_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K5":  # U6: Metal + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U6",
+                    expected_codes=list(COPPER_CODES),
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K6":  # U7: Aluminum + Copper
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U7",
+                    expected_codes=list(COPPER_CODES),
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
+                )
+            elif keyword_cat == "K7":  # U8: All three
+                return self._create_result(
+                    entry_number, description, primary_hts, additional_hts,
+                    scenario_id="U8",
+                    expected_codes=list(COPPER_CODES),
+                    forbidden_codes={MISMATCH_CODE},
+                    additional_set=additional_set,
+                **indicators
                 )
-            else:
-                # S17: Copper HTS but NO copper keyword - apply copper tariffs + 99030133, no 99030125
-                expected = list(COPPER_CODES) + [GENERAL_301_CODE]
-                issues = []
-
-                if not has_copper_tariff:
-                    issues.append("Missing copper tariff (99037801/02)")
-                if not has_301:
-                    issues.append("Missing 99030133 - copper HTS without copper keyword")
-                if has_mismatch:
-                    issues.append("Should NOT have 99030125 - no mismatch expected for copper HTS")
-
-                status = "PASS" if not issues else "FAIL"
-                return ValidationResult(
-                    entry_number=entry_number,
-                    description=description,
-                    primary_hts=primary_hts,
-                    additional_hts=additional_hts,
-                    scenario_id="S17",
-                    scenario_summary=SCENARIO_SUMMARIES["S17"],
-                    status=status,
-                    expected_hts=expected,
-                    missing_hts=(list(COPPER_CODES) if not has_copper_tariff else []) + ([GENERAL_301_CODE] if not has_301 else []),
-                    unexpected_hts=[MISMATCH_CODE] if has_mismatch else [],
-                    issue="; ".join(issues) if issues else "Correct - copper HTS without keyword, has copper tariffs + 99030133"
-                )
-
-        # S9: Copper keyword but NOT in copper list
-        if has_copper_kw and not in_copper:
-            expected = [MISMATCH_CODE]
-            issues = []
-
-            if not has_mismatch:
-                issues.append("Missing 99030125")
-            if has_steel_232 or has_aluminum_232 or has_copper_tariff:
-                issues.append("Should NOT have 232/copper tariffs - HTS not in copper list")
-            if has_301:
-                issues.append("Should NOT have 99030133 - HTS not in copper list")
 
-            status = "PASS" if not issues else "FAIL"
-            return ValidationResult(
-                entry_number=entry_number,
-                description=description,
-                primary_hts=primary_hts,
-                additional_hts=additional_hts,
-                scenario_id="S9",
-                scenario_summary=SCENARIO_SUMMARIES["S9"],
-                status=status,
-                expected_hts=expected,
-                missing_hts=[MISMATCH_CODE] if not has_mismatch else [],
-                unexpected_hts=self._get_unexpected_232(additional_set) + ([GENERAL_301_CODE] if has_301 else []),
-                issue="; ".join(issues) if issues else "Correct - copper keyword with non-copper HTS"
+        # =====================================================================
+        # LEVEL 4: No HTS Match
+        # =====================================================================
+
+        # H0: Not in any metal list
+        if keyword_cat == "K0":  # N1: No keyword
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N1",
+                expected_codes=[],
+                forbidden_codes=set(),
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K1":  # N2: Metal only
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N2",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=STEEL_232_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K2":  # N3: Aluminum only
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N3",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=ALUMINUM_232_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K3":  # N4: Copper only
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N4",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=COPPER_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K4":  # N5: Metal + Aluminum
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N5",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=STEEL_232_CODES | ALUMINUM_232_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K5":  # N6: Metal + Copper
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N6",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=STEEL_232_CODES | COPPER_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K6":  # N7: Aluminum + Copper
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N7",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=ALUMINUM_232_CODES | COPPER_CODES,
+                additional_set=additional_set,
+                **indicators
+            )
+        elif keyword_cat == "K7":  # N8: All three
+            return self._create_result(
+                entry_number, description, primary_hts, additional_hts,
+                scenario_id="N8",
+                expected_codes=[MISMATCH_CODE],
+                forbidden_codes=ALL_232_CODES,
+                additional_set=additional_set,
+                **indicators
             )
 
-        # No applicable scenario
+        # Fallback - should not reach here
         return ValidationResult(
             entry_number=entry_number,
             description=description,
@@ -746,24 +1113,19 @@ class HTSValidator:
             expected_hts=[],
             missing_hts=[],
             unexpected_hts=[],
-            issue="No metal-related validation required"
+            issue="No validation rule matched",
+            in_steel_hts=in_steel,
+            in_aluminum_hts=in_aluminum,
+            in_copper_hts=in_copper,
+            in_computer_hts=in_computer_parts,
+            in_auto_hts=in_auto_parts,
+            has_metal_keyword=has_metal_kw,
+            has_aluminum_keyword=has_aluminum_kw,
+            has_copper_keyword=has_copper_kw,
+            has_zinc_keyword=has_zinc_kw,
+            has_plastics_keyword=has_plastics_kw
         )
 
-    def _get_unexpected_232(self, additional_set: Set[str]) -> List[str]:
-        """Get list of 232 tariffs that shouldn't be present"""
-        all_232 = STEEL_232_CODES | ALUMINUM_232_CODES | COPPER_CODES
-        return list(all_232 & additional_set)
-
-    def _get_missing_codes(self, fixed_codes: List[str], has_fixed: bool,
-                           variable_codes: Set[str], has_variable: bool) -> List[str]:
-        """Get list of missing codes"""
-        missing = []
-        if not has_fixed:
-            missing.extend(fixed_codes)
-        if not has_variable:
-            missing.extend(list(variable_codes))
-        return missing
-
 
 def validate_dataframe(df, validator: HTSValidator,
                        description_col: str = "Description",