d.jz$dUdZddlmZddlZddlmZmZddlmZddlm Z Gdde ej Z eGd d Z eGd d ZeGd dZe ddddde ddddde ddddde ddd d!de d"d#d$d%de d&d'd(d)de d*d+d,d-de d.d/d0d1de d2d3d4d5de d6d7d8d9de d:d;de d?d@dAdBdCe dDdEdFdGdCe dHdIdJdKde dLdMdNdOde dPdQdRdSde dTdUdVdWdCe dXdYdZd[de d\d]d^d_d`e dadbdcdddCdefgZdgedh<eZdgedi<dS)juGAutoPOE2 - Master Invariants Specifications & SSoT Matrix (2026). ================================================================== Domain: Sư đoàn 4: lead_qa_governance (Quản trị chất lượng & Bất biến). Đặc tả định lượng Single Source of Truth cho 19 Bất biến Kiến trúc (AGENTS.md Mục 8). ) annotationsN) dataclassfield)datetime)ListceZdZdZdZdZdZdS)InvariantStatusuDTrạng thái kiểm định của từng bất biến kiến trúc.PASSEDWARNINGBLOCKEDN)__name__ __module__ __qualname____doc__r r r BC:\Projects\AutoPOE2\src\agentic_engine\master_invariants_specs.pyr r s#NN FGGGGrr cTeZdZUdZded<ded<ded<ded<ded<d Zd ed <d S) InvariantSpecu?Đặc tả định lượng của 1 Bất biến Kiến trúc.strcodenamemonitored_module rule_summaryfloatweightTbool is_criticalN)r rrr__annotations__rrrrrrs\II III IIIMMMKrrc~eZdZUdZded<ded<ded<ded<ded<ded <d ed <ed Zded<dS)InvariantAuditResultuAKết quả kiểm định định lượng của 1 Bất biến.rrrr statusrevidence metric_valuer duration_mscLtjSNrnow isoformatrrrzInvariantAuditResult.+8<>>3K3K3M3Mrdefault_factory timestampN)r rrrrrr/rrrr!r!!sKK III IIIMMMU+M+MNNNINNNNNNrr!ceZdZUdZded<ded<ded<ded<ded<d ed <d ed <ee Zd ed<ed Zded<dZ ded<dS)MasterInvariantsAuditReportuCBáo cáo kiểm định toàn diện 19 Bất biến Kiến trúc.ris_cleared_for_autonomousinttotal_invariants passed_count warning_count blocked_countrautonomy_readiness_scoretotal_duration_msr-zList[InvariantAuditResult]resultscLtjSr'r(rrrr+z$MasterInvariantsAuditReport.9r,rrr/summaryN) r rrrrrlistr:r/r=rrrr1r1.sMM########*/%*E*E*EGEEEEU+M+MNNNINNNNGrr1zINV-INPUT-ABS-MOUSEz#Absolute Mouse UI & Target Movementz7MapDeviceHandler, NpcInteractionHandler, LootControlleruvMọi click UI/target dùng tọa độ tuyệt đối (MoveMouseSmooth). MoveMouse(rx,ry) chỉ nhận delta Bézier.g@)rrrrrzINV-WASD-NO-BLIND-LMBz"WASD Proximity Before Entity Clickz'OpenDevice, EnterPortal, LootControlleruChế độ WASD: LMB là skill khi click đất. Cấm click mù xuống đất/chân nhân vật. Áp sát <= 18u rồi Click LMB có chủ đích.g@zINV-KEY-NO-F-FOR-INTERACTzF Key Reserved For Skill 8zDQuestNavigator, NpcInteractionHandler, MapDeviceHandler, coordinatoruTUYỆT ĐỐI CẤM gửi phím F để tương tác. Phím F là Skill 8 của người chơi; tương tác 100% bằng Click LMB có chủ đích.zINV-KEY-NO-U-FOR-MAP-DEVICEzNo U Key At Hideout Map Devicez2autonomous_mapping_coordinator.py, TownQuestEngineuCấm phím U tại Hideout Map Device. Phím U chỉ mở World Map xem-only của campaign; mở Map Device phải tương tác vật lý trực tiếp.zINV-WASD-MIN-DWELLzWASD Key Minimum Dwell Timez8QuestNavigator::SendDirection, MapDeviceHandler approachuUDwell di chuyển WASD >= 300ms (ngắn) / >= 1000ms (dài). Cấm micro-tap < 150ms.zINV-F8-MUTES-BRAINz#F8 Movement Safety Lock Mutes Brainzmain.cpp, BotBrainujallowPhysicalMove == false (F8 PAUSE) -> tắt botBrain.Process, tự động nhả toàn bộ phím WASD.zINV-MAPDEVICE-VERIFY-UIz%Map Device UI OCR & Tray Verificationz3MapDeviceHandler, autonomous_mapping_coordinator.pyuuCấm advance FSM nếu chưa có tín hiệu UI mở (OCR TRAVERSE / khay Waystone). Timeout -> Failed + backoff 3s.zINV-MAPDEVICE-RETRY-POLLz Map Device Portal Polling 8000msMapDeviceHandleruUWaitForPortals retry polling trong 8000ms, cấm fail-closed vội sau 1 tick 2500ms.zINV-BRAIN-CONFLICT-GATEKEEPERz%Brain Conflict Gatekeeper (Opcode 96)zmain.cpp, town_quest_engine.cppuzC++ Core và TownQuestEngine từ chối Opcode 96 (TRIGGER_WORLD_MAP_TRAVEL) khi ở Hideout hoặc khi MapDevice active.zINV-TERRAIN-ORIGINz)Authentic Terrain Origin & JPS Calibratorz,TerrainReader, TerrainGrid, MapDeviceHandleru]worldOrigin calibrate từ struct địa hình thật. Cấm slide JPS với grid == nullptr.zINV-FSM-SINGLE-OWNERzSingle FSM Lifecycle Ownerz CharacterFSM, core_shm_bridge.pyulMột chủ vòng đời duy nhất: C++ CharacterFSM ghi SHM. Python không click song song khi C++ active.g@z INV-CI-01z"Chaos Inoculation ES Reflex Gating ReflexManageru[Nhân vật CI (HP 1/1): Không dùng Life Flask; trigger dodge/chicken theo Energy Shield.g@zINV-MEM-DYNAMIC-XYZzDynamic XYZ 16MB Scanner PlayerFinderueTọa độ XYZ đọc từ con trỏ động PlayerFinder 16MB, từ chối neo tĩnh 0x290 / 0x540.zINV-KEY-PORTALzTown Portal Uses Period Key '.'zQuestNavigator, UnstuckHandleruWMở Town Portal dùng phím '.' (VK_OEM_PERIOD 0xBE), không dùng phím T hay Warcry.zINV-KEY-E-PULSEz(Pulse E With Forward Disabled By DefaultQuestNavConfiguYCờ pulseEWithForward mặc định false, cấm nhấp phím E tự do khi di chuyển.zINV-OCR-MOCK-NO-CALLz(Headless Mock Harness Zero Real OCR Leakzvision_ocr.py, ScreenCaptureruHeadless Mock Harness cấm gọi OCR thật / ScreenCapture desktop gây blocking hoặc rò rỉ cửa sổ. Sử dụng synthetic perception an toàn 100%.z#INV-FOCUS-INTERLOCK-HARDWARE-SAFETYz#Two-Factor Hardware Focus Interlockz+KMBoxNet, NonBlockingActuator, win32_windowuChỉ chặn KeyDown/MouseDown khi mất focus. CẤM chặn KeyUp/MouseUp. Tự động ReleaseAllKeys() khi unfocused. Two-factor class & image check.zINV-ATLAS-FARM-NODEzSpecial Arena Blacklist GatingzHvision_ocr.py, autonomous_mapping_coordinator.py, atlas_node_selector.pyuTuyệt đối CẤM chọn The Well of Souls, Precursor Tower, The Burning Monolith, hoặc Pinnacle Arenas cho chu trình cày Waystone tự động.zINV-WAYSTONE-ROW1-ONLYz#Waystone Bag Row 1 Slot ReservationzGoptical_inventory_scanner.py, MapDeviceHandler, autonomous_lifecycle.pyuChỉ lấy Waystone từ Hàng 1 (Row 1) của túi đồ/Stash để chạy map nhằm chống nhặt nhầm Currency quý hoặc Gear trang bị.g@zINV-MOTION-INTEGRITYz 0 (RAM) HOẶC Delta Optical > 15px (Vision) sau mỗi nhịp di chuyển WASD >= 300ms. Nếu Delta = 0, phát hiện nhân vật tê liệt: lập tức raise Anomaly và kích hoạt Hardware Fallback.T)rrrrrrzList[InvariantSpec]MASTER_20_INVARIANTS_SPECSMASTER_19_INVARIANTS_SPECS)r __future__renum dataclassesrrrtypingrrEnumr rr!r1rCrrDrrrrJs #""""" ((((((((c49    O O O O O O O  O          $M " 2RN M $ 1Bm M ( )_m M * -Mr M ! *Sl M ! 2-B M & 4NM M ' /+l M , 4:R M ! 8Gt M # );D M  1(r M " ''| M  .9n M  7)p M # 78v M 2 2Fp M " -co M % 2bl M # KiI MN3NNNNb3MLLLLLLr