import copy import sys import threading import unittest from pathlib import Path sys.path[:0] = [str(Path(__file__).resolve().parents[1] / 'scripts'), str(Path(__file__).resolve().parent)] from nao_agent_task import TaskUnavailable, normalize_task, plan_task from nao_query_contract import bind_query from test_nao_agent_task import task_value def defect_catalog(): fields = [ {'stage': 'black', 'key': '责废尺寸重量', 'label': '责废尺寸重量', 'sourceField': '责废尺寸重量', 'category': '责废', 'grain': 'source_defect_weight', 'available': True}, {'stage': 'black', 'key': '料废端面重量', 'label': '料废端面重量', 'sourceField': '料废端面重量', 'category': '料废', 'grain': 'source_defect_weight', 'available': True}, {'stage': 'bright', 'key': '加工缺口重量', 'label': '加工缺口重量', 'sourceField': '加工缺口重量', 'category': '加工废', 'grain': 'source_defect_weight', 'available': True}, {'stage': 'bright', 'key': '加工数量', 'label': '加工数量', 'sourceField': '加工数量', 'category': '加工废', 'grain': 'source_defect_count', 'available': True, 'countOnly': True}, ] categories = [ {'stage': 'black', 'category': '责废', 'available': True}, {'stage': 'black', 'category': '料废', 'available': True}, {'stage': 'bright', 'category': '加工废', 'available': True}, ] return {'fineDefects': {'fields': fields, 'categories': categories}} def defect_node(*, dimension='defect', stages=None, selector=None, defect=None, category=None, node_id='black_defects', comparison=False): node = {'nodeId': node_id, 'purpose': 'defects', 'dimension': dimension, 'fields': ['scrapWeight'], 'stages': stages or ['black'], 'selector': selector or {'kind': 'base'}, 'visualType': 'bar', 'visualPreference': 'auto', 'comparisonRequired': comparison} if defect is not None: node['defect'] = defect if category is not None: node['category'] = category return node class QueryPlanDefectNormalizationTests(unittest.TestCase): def normalize(self, value, question='查看来源具体缺陷重量', context=None): supplied = context or {} business = {**defect_catalog(), **supplied.get('_businessCatalog', {})} return normalize_task(value, question, {'_protocol': {'version': 1}, **supplied, '_businessCatalog': business}) def test_defect_node_derives_root_output_dimensions_stages_and_fields(self): value = task_value(kind='analysis', queryPlan=[defect_node()], dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) task = self.normalize(value) self.assertEqual(task['dimensions'], ['defect']) self.assertEqual(task['dimensionStages'], {'defect': ['black']}) self.assertEqual(task['stages'], ['black']) self.assertEqual(task['fields'], ['scrapWeight']) self.assertEqual(task['queryPlan'][0]['visualType'], 'bar') self.assertEqual(task['periodCoverage'], 'available') def test_product_output_adds_product_and_defect_but_selector_group_is_not_output_dimension(self): selector = {'kind': 'catalog_members', 'dimension': 'group', 'names': ['部门甲-国内', '部门甲-海外']} node = defect_node(dimension='product', defect='责废尺寸重量', category='责废', selector=selector) value = task_value(kind='analysis', queryPlan=[node], dimensions=['product', 'group', 'defect'], dimensionStages={'product': ['black'], 'group': [], 'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) context = {'_businessCatalog': {'groups': ['部门甲-国内', '部门甲-海外']}} task = self.normalize(value, context=context) self.assertEqual(task['dimensions'], ['product', 'group', 'defect']) self.assertEqual(task['dimensionStages'], {'product': ['black'], 'group': [], 'defect': ['black']}) self.assertEqual(task['queryPlan'][0]['selector'], selector) def test_defect_output_can_follow_a_trusted_product_ranking_selector(self): nodes = [ {'nodeId': 'rank', 'purpose': 'ranking', 'dimension': 'product', 'limit': 10, 'fields': ['totalWeight'], 'stages': ['black'], 'selector': {'kind': 'base'}, 'visualType': 'pareto', 'visualPreference': 'auto', 'comparisonRequired': False}, defect_node(dimension='product', defect='责废尺寸重量', selector={'kind': 'ranking_top', 'sourceNodeId': 'rank', 'stage': 'black', 'metric': 'totalWeight', 'count': 2}, node_id='top_defects'), ] value = task_value(kind='analysis', queryPlan=nodes, dimensions=['product', 'defect'], dimensionStages={'product': ['black'], 'defect': ['black']}, stages=['black'], fields=['totalWeight', 'scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) task = self.normalize(value) self.assertEqual(task['dimensions'], ['product', 'defect']) self.assertEqual(task['queryPlan'][1]['selector']['kind'], 'ranking_top') self.assertEqual(task['queryPlan'][1]['defect'], '责废尺寸重量') def test_category_or_defect_must_be_authorized_for_every_stage_and_not_count_only(self): cases = [ defect_node(stages=['black', 'bright'], category='责废'), defect_node(stages=['bright'], defect='加工数量'), defect_node(stages=['black'], defect='责废尺寸重量', category='料废'), ] for node in cases: with self.subTest(node=node): dims = ['defect'] dimension_stages = {'defect': list(node['stages'])} value = task_value(kind='analysis', queryPlan=[node], dimensions=dims, dimensionStages=dimension_stages, stages=list(node['stages']), fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) with self.assertRaises(TaskUnavailable): self.normalize(value) def test_auto_plan_is_limited_to_unqualified_all_detail_defect_analysis(self): value = task_value(kind='analysis', dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) task = self.normalize(value, question='查看2026年9月黑片具体缺陷重量排名') self.assertEqual(len(task['queryPlan']), 1) self.assertEqual(task['queryPlan'][0]['purpose'], 'defects') self.assertEqual(task['queryPlan'][0]['dimension'], 'defect') self.assertEqual(task['queryPlan'][0]['limit'], 100) self.assertEqual(task['queryPlan'][0]['visualType'], 'bar') def test_named_category_or_mixed_goal_cannot_be_silently_expanded(self): value = task_value(kind='analysis', dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) with self.assertRaises(TaskUnavailable) as raised: self.normalize(value, question='只查看黑片责废的具体缺陷重量') self.assertEqual(raised.exception.field, 'queryPlan') self.assertEqual(raised.exception.expected, 'bounded defects node plan') def test_comparison_requires_root_period_and_true_node_union(self): node = defect_node(category='责废', comparison=True) value = task_value(kind='analysis', queryPlan=[node], dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=True, period={'year': 2026, 'month': 9}, comparisonPeriod={'year': 2025, 'month': 9}) task = self.normalize(value) self.assertTrue(task['queryPlan'][0]['comparisonRequired']) self.assertEqual(task['comparisonPeriod'], {'year': 2025, 'month': 9}) value['comparisonRequired'] = False with self.assertRaises(TaskUnavailable): self.normalize(value) def test_defect_query_contract_binds_comparison_frame_and_column_filters(self): task = normalize_task(task_value(kind='analysis', queryPlan=[defect_node(comparison=True)], dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=True, period={'year': 2026, 'monthStart': 3, 'monthEnd': 9}, comparisonPeriod={'year': 2025, 'monthStart': 3, 'monthEnd': 9}), '比较两期黑片来源具体缺陷重量', {'_protocol': {'version': 1}, '_businessCatalog': defect_catalog()}) rule = {'field': 'customerCode', 'stages': ['black'], 'operator': 'in', 'values': ['C-17']} task['filters']['columnFilters'] = [rule] bound = bind_query({'mode': 'defects', 'releaseId': 'release-defects', 'period': task['period'], 'comparisonPeriod': task['comparisonPeriod'], 'filters': {}, 'columnFilters': [rule], 'stage': 'black', 'dimension': 'defect', 'limit': 100}, {'task': task, 'releaseId': 'release-defects', 'exactScope': True, 'nodeId': 'black_defects', 'scopeId': 'server-issued-scope'}) self.assertEqual(bound['period'], task['period']) self.assertEqual(bound['comparisonPeriod'], task['comparisonPeriod']) self.assertEqual(bound['columnFilters'], [rule]) with self.assertRaisesRegex(ValueError, '期间偏离'): bind_query({**bound, 'comparisonPeriod': {'year': 2024, 'month': 9}}, {'task': task, 'releaseId': 'release-defects', 'exactScope': True, 'nodeId': 'black_defects', 'scopeId': 'server-issued-scope'}) def test_planning_payload_keeps_authorized_fine_defect_catalog(self): from unittest.mock import patch plan = task_value(kind='analysis', queryPlan=[defect_node()], dimensions=['defect'], dimensionStages={'defect': ['black']}, stages=['black'], fields=['scrapWeight'], trendRequired=False, comparisonRequired=False, period={'year': 2026, 'month': 9}) review = {'aligned': True, 'requiresEvidence': True, 'requiresSourceVerification': False, 'requiresAllSourceRows': False, 'requiresTrend': False, 'requiresComparison': False} context = {'_protocol': {'version': 1}, '_businessCatalog': defect_catalog()} with patch('nao_agent_task._model_json', side_effect=[plan, review]) as model_call: planned = plan_task(base_url='https://offline.invalid/v1', api_key='synthetic', model='m', question='比较黑片具体缺陷重量', context=context, cancel_event=threading.Event()) payload = model_call.call_args_list[0].kwargs['payload'] self.assertEqual(payload['businessCatalog']['fineDefects'], defect_catalog()['fineDefects']) self.assertEqual(planned['queryPlan'][0]['purpose'], 'defects') if __name__ == '__main__': unittest.main()