import copy import sys import unittest from pathlib import Path sys.path.insert(0, str(Path(__file__).resolve().parents[1] / 'scripts')) from analysis_visuals import _scope, build_visuals from test_month_range_evidence import QUESTION, context, metric_doc class ExclusionVisualScopeTests(unittest.TestCase): def setup_frame(self): period = {'year': 2026, 'monthStart': 1, 'monthEnd': 9} frame = context(period) frame['filters'] = {**frame['filters'], 'exclusions': {'product': ['SPEC-A']}} frame['_agentTask']['filters'] = copy.deepcopy(frame['filters']) doc = metric_doc(period, range(1, 10), filters=frame['filters']) return frame, doc def test_excluded_product_is_preserved_in_the_complete_monthly_chart(self): frame, doc = self.setup_frame() result = build_visuals([doc], QUESTION, 'turn-test', context=frame) self.assertEqual(result['visualState'], 'ready') chart = result['visuals'][0] self.assertEqual(chart['scope']['exclusions'], {'product': ['SPEC-A']}) self.assertEqual(len(chart['series'][0]['values']), 9) self.assertEqual(chart['scope']['monthEnd'], 9) def test_scope_mismatch_never_uses_a_chart_from_other_exclusions(self): for wrong in ({}, {'product': ['SPEC-B']}, {'product': ['SPEC-A'], 'group': ['OTHER']}): frame, doc = self.setup_frame() doc['result']['filters']['exclusions'] = wrong # Separate the source receipt from the immutable expected frame. frame['filters']['exclusions'] = {'product': ['SPEC-A']} frame['_agentTask']['filters'] = copy.deepcopy(frame['filters']) doc['result']['filters'] = {**doc['result']['filters'], 'exclusions': wrong} result = build_visuals([doc], QUESTION, 'turn-test', context=frame) self.assertEqual(result['visuals'], []) def test_malformed_or_unsupported_exclusions_are_rejected(self): for wrong in ({'product': []}, {'product': [None]}, {'customerCode': ['001']}, {'product': 'SPEC-A'}, {'product': [' ']}): self.assertEqual(_scope({'exclusions': wrong}), (None, None)) if __name__ == '__main__': unittest.main()