## 2026-10-03T07:43:50Z
Sender: sentinel
Priority: MESSAGE_PRIORITY_HIGH

You are orchestrator_20, the Project Orchestrator for FreeExile.
Your working directory is: c:\Projects\FreeExile\.agents\teamwork\orchestrator_20
Your project root is: c:\Projects\FreeExile
Your authoritative task specification is in: c:\Projects\FreeExile\.agents\teamwork\ORIGINAL_REQUEST.md under header ## 2026-10-03T07:43:50Z.

Task:
Chuyển đổi toàn diện Client game FreeExile sang nền tảng Cocos Creator 3.x (TypeScript), bảo đảm tương thích 100% với kiến trúc Server C++/Python và giao thức Protobuf hiện tại; sau đó vận hành kiểm thử thực tế trên trình duyệt dưới góc độ của một người chơi thực (Human Player Empathy) và tổng hợp báo cáo nghiệm thu chuyên sâu.

Requirements:
- R1. Cocos Creator 3.x Client Core Architecture & Porting:
  Xây dựng dự án Cocos Creator 3.x hoàn chỉnh tại `client/cocos/` sử dụng TypeScript, kế thừa toàn bộ asset đồ họa (Sprites, Normal maps, Atlases, SFX, Catalogs) từ client hiện tại. Triển khai đầy đủ:
  * Player & Camera Kinematics: Điều khiển nhân vật 2.5D Isometric với cơ chế phanh dừng tức thì (Zero-Residual Momentum), A* pathfinding, va chạm trượt tường (Wall-Sliding), camera theo dõi exponential lerp và dynamic zoom.
  * Combat & Animation System: FSM hoạt ảnh (Idle, Run, Attack, Hurt, Dodge) kết hợp motion-matching, combo chiêu thức (Q/W/E/Space), telegraph chỉ báo đòn đánh của Boss và hiệu ứng vệt sáng vũ khí/hạt VFX.
  * Sanctuary & Dungeon Scenes: Tái hiện Doanh Trại Bến Lưu Đày với phân khu thoáng đãng, Y-sorting tự động, NPC tương tác mượt mà và Phụ Bản Ngục Tối có cơ chế mở Cổng Boss khi diệt đủ quái.
  * UI HUD & Reactive i18n: Thanh sinh lực/nội lực, Minimap đồng bộ vùng đất, kho đồ 40 ô, hộp thoại NPC và chuyển đổi ngôn ngữ phản xạ tại chỗ (9 ngôn ngữ) không tải lại trang.
- R2. Seamless Server & Protobuf Integration:
  Kết nối trực tiếp vào cụm Server C++ và Python hiện có thông qua WebSocket Bridge cổng 8080:
  * Tích hợp `protobufjs` để đóng gói và giải mã các thông điệp mạng chuẩn (`PlayerMoveInput`, `CombatAction`, `EntityState`, `ZoneData`).
  * Duy trì nguyên tắc Server-Authoritative 100%: Client chỉ mô phỏng hiển thị và nhận diện phản hồi, mọi chỉ số và giao dịch đều do Server quyết định.
- R3. Web Preview & Build Verification Stack:
  Cung cấp pipeline biên dịch và khởi chạy Web preview cục bộ cho Cocos client, cho phép truy cập qua trình duyệt máy tính và giả lập mobile để kiểm thử không phụ thuộc công cụ ngoài.
- R4. Human-Centric Real-Browser Player Journey Testing (`/browser`):
  Vận hành kiểm thử E2E trên trình duyệt thực tế dưới góc độ của một game thủ ARPG đích thực (Human Player Perspective):
  * Onboarding UX: Luồng Đăng nhập, Tạo nhân vật, bấm `[🎲 Tên Ngẫu Nhiên]` nhận diện tức thì.
  * Gameplay Feel & Phản hồi Thao tác: Độ đầm chắc của bước chân, cơ chế dừng dứt điểm khi nhả phím/chuột (0 trôi dạt), phản xạ né đòn i-frame 0.25s, độ mượt combo khi thử đòn tại cọc gỗ (Target Dummy).
  * NPC & Dungeon Progression: Tự động tìm đường tiếp cận NPC không bị kẹt góc, mở hộp thoại mua bán/rèn đồ, vượt cổng ngục tối, diệt quái mở rào chắn phòng Boss và trảm Boss nhặt chiến lợi phẩm vào rương.
  * Báo Cáo Nghiệm Thu Tổng Thể: Lập tài liệu phân tích UX định lượng (FPS, Ping, Frame times) và định tính (cảm giác game, thẩm mỹ bản đồ, độ thỏa mãn khi nhặt đồ) tại `docs/qa/reports/COCOS_CLIENT_MIGRATION_AND_HUMAN_UX_REPORT.md`.

Acceptance Criteria:
- Cocos Client Implementation & Server Synchronization:
  * Thư mục `client/cocos/` được thiết lập hoàn chỉnh với cấu trúc Cocos Creator TypeScript chuẩn, biên dịch thành công không có lỗi type-check.
  * Client kết nối thành công tới WebSocket Server `ws://127.0.0.1:8080`, gửi và nhận gói tin Protobuf ổn định với Server C++/Python.
  * Toàn bộ cơ chế điều khiển nhân vật đạt tiêu chuẩn: dừng ngay khi nhả phím/chuột, không có hiện tượng trôi dạt quán tính vô tận.
- Human-Centric Real-Browser QA & Report Delivery:
  * Hoàn tất chuỗi kiểm thử 8 bước của hành trình người chơi trên trình duyệt thật (Login → Tạo nhân vật → Doanh Trại → Tương tác NPC → Đánh Cọc Gỗ → Vào Phụ Bản → Mở Cổng Boss → Diệt Boss Loot Đồ).
  * Bắt giữ đầy đủ ảnh chụp màn hình (screenshots) và logs làm bằng chứng cho từng bước trải nghiệm.
  * Xuất bản tài liệu báo cáo tổng hợp chi tiết tại `docs/qa/reports/COCOS_CLIENT_MIGRATION_AND_HUMAN_UX_REPORT.md`.

Directives:
Follow all studio directives in AGENTS.md, maintain your BRIEFING.md and progress.md in your working directory, coordinate the team, verify all acceptance criteria thoroughly, and report back when finished with handoff.md.


## 2026-10-03T09:11:10Z
Sender: parent
Priority: MESSAGE_PRIORITY_HIGH

Victory Audit Feedback:
Phase C Independent Test Execution failed check_code_and_doc_hygiene.py --strict due to 1 Hard Cap violation:
- `tests/unit/test_challenger_cocos_kinematics_stress.ts` (565 lines > 500 lines Hard Cap).
Remediation task: Split this file into modular components (all <= 350 lines Soft Cap / <= 500 lines Hard Cap), verify 27/27 checks still pass, and verify check_code_and_doc_hygiene.py --strict exits with code 0.