# Dispatch Log

## 2026-10-01T00:41:45Z
You are the Project Orchestrator (orchestrator_4) for FreeExile.

Your working directory is: `c:\Projects\FreeExile\.agents\teamwork\orchestrator_4`
Your persistent files are:
- `c:\Projects\FreeExile\.agents\teamwork\orchestrator_4\BRIEFING.md`
- `c:\Projects\FreeExile\.agents\teamwork\orchestrator_4\plan.md`
- `c:\Projects\FreeExile\.agents\teamwork\orchestrator_4\progress.md`

Read the authoritative user request in `c:\Projects\FreeExile\.agents\teamwork\ORIGINAL_REQUEST.md` under section `## 2026-10-01T00:40:44Z`.

## Mission
Thiết kế và triển khai hoàn chỉnh hệ thống Cấp độ (Level 1-100), Đường cong Kinh nghiệm Đa tầng (Piecewise Exponential EXP Curve), Cơ chế Phạt Chết Hardcore-Softcore lai (15% ở 90-99, 25% ở 99->100), và Nhiệm vụ Thăng Hoa Tối Thượng Cấp 100 mở Node Niết Bàn Đổi Hình Dạng (Godhood Avatar Metamorphosis Keystone) cho FreeExile.

## Requirements

### R1. Mô Hình Toán Học & Đường Cong Kinh Nghiệm Đa Tầng (Piecewise EXP Curve 1-100)
- Thiết lập công thức toán học phân tầng và bảng dữ liệu chuẩn 100 cấp:
  - Cấp 1 - 20: Tăng tốc dễ dàng, nhịp độ mượt mà cho trải nghiệm tân thủ.
  - Cấp 20 - 40: Chậm dần đều theo tiến trình Cốt truyện Hồi I - II.
  - Cấp 40 - 60: Chậm hơn rõ rệt theo tiến trình Cốt truyện Hồi III - IV và giai đoạn chuẩn bị tiến vào Endgame.
  - Cấp 60 - 80: Nhịp độ bình thường, ổn định tương ứng giai đoạn farm Bí Cảnh Tinh Đồ (Atlas Maps T1-T10).
  - Cấp 80 - 90: Chậm rõ rệt, quái vật T11-T13 bắt đầu đòi hỏi đầu tư trang bị nghiêm túc.
  - Cấp 90 - 99: Cực kỳ chậm, leo dốc gắt gao ở các Map Đỏ T14-T16.
  - Cấp 99 - 100: Bức tường cực hạn (Hardcore Soft-Wall) — delta EXP riêng cho cấp 99->100 tương đương 25-35% tổng EXP cả đời nhân vật, khiến việc hoàn thành trong mùa giải 3 tháng là kỳ tích chỉ dành cho số ít người chơi cày cuốc liên tục và không để tử trận.

### R2. Cơ Chế Hiệu Dụng Kinh Nghiệm & Phạt Chết Lai Hardcore (Level Gap & Hybrid Death Penalty)
- Công thức Giảm trừ EXP theo Chênh lệch Cấp độ (Level Gap Penalty): Khi nhân vật chênh lệch quá ±5 cấp so với cấp quái vật/vùng đất (Zone Level), tỷ lệ EXP hiệu dụng giảm dần theo hàm lũy thừa, triệt tiêu hoàn toàn hành vi cày quái cấp thấp để farm an toàn.
- Cơ chế Phạt Chết Phân Bậc (Tiered Death Penalty):
  - Cấp 1 - 60: Không phạt mất EXP khi tử trận.
  - Cấp 61 - 80: Phạt 5% thanh EXP của cấp hiện tại khi chết.
  - Cấp 81 - 89: Phạt 10% thanh EXP của cấp hiện tại khi chết.
  - Cấp 90 - 99: Phạt 15% thanh EXP của cấp hiện tại khi chết.
  - Cấp 99 - 100: Phạt 25% thanh EXP của cấp hiện tại khi chết (1 lần chết có thể xóa sạch công sức cày nhiều ngày).
  - Quy tắc sàn an toàn: Phạt chết chỉ trừ đến tối thiểu 0% của cấp hiện tại, không bao giờ bị tụt cấp độ nhân vật.

### R3. Thí Luyện Thăng Hoa Cấp 100 & Node Thần Ma Niết Bàn Đổi Hình Dạng (Avatar Metamorphosis Keystone)
- Thí Luyện thứ 10 (`TRIAL_10_GODHOOD_TRANSCENDENCE`) bắt buộc yêu cầu nhân vật đạt đúng `level == 100` mới được phép tiếp nhận và tiến vào Đỉnh Núi Tận Diệt.
- Vượt qua 3 giai đoạn của Boss "Thượng Cổ Thần Ma Tàn Thể" sẽ thưởng 3 Điểm Thăng Hoa cuối cùng và mở khóa Node Keystone Độc Bản "Cổ Thần Niết Bàn" (`GODHOOD_AVATAR_METAMORPHOSIS`):
  - Đổi hình dạng nhân vật (Form Metamorphosis): Kích hoạt cờ `avatar_metamorphosis_active = True`, chuyển đổi hình thái nhân vật sang Thần Ma Tôn Giả với hào quang áp chế đặc biệt.
  - Đột biến sức mạnh (Paradigm Shift Power Spike): Cung cấp hệ số khuếch đại sát thương vượt bậc (+40% More Damage), phá vỡ giới hạn kháng tối đa (+5% Max Elemental/Chaos Resists), hoặc cơ chế võ học đột phá.

### R4. Tích Hợp Hệ Thống Core, Database Seeder & Kiểm Chứng Tự Động (Integration & Verification)
- Cập nhật cấu trúc bảng `progression_benchmarks` trong `data/game_design_matrix.db` và tái cấu trúc thuật toán sinh dữ liệu trong `server/world/game_design_matrix_seeder.py`.
- Hiện thực hóa `LevelProgressionService` (`server/world/level_progression_service.py`) quản lý: tính EXP quái chết, kiểm tra thăng cấp, cộng điểm căn cốt/kỹ năng, áp dụng phạt chết, và đồng bộ trạng thái thăng hoa.
- Xây dựng công cụ kiểm chứng mô phỏng (`tools/balance/simulate_level_progression.py`) chạy Monte-Carlo 1.000 kịch bản người chơi (với tỷ lệ chết ngẫu nhiên 0.5% - 2% mỗi map) để chứng minh mốc 99->100 là bất khả thi trong 90 ngày với người chơi thông thường.
- Bộ Unit Test khép kín kiểm chứng 100% các điều kiện biên của hệ thống.

## Acceptance Criteria

### Mathematical Balance & EXP Curve
- [ ] Công thức đường cong EXP cho ra bảng giá trị 100 cấp độ đơn điệu tăng ngặt, trong đó tổng EXP cấp 1-20 chiếm < 0.1% tổng tích lũy, cấp 60-80 tăng tuyến tính ổn định, cấp 90-99 tăng dựng đứng, và cấp 99-100 cần lượng EXP bằng ít nhất 30% toàn bộ EXP từ 1 đến 99.
- [ ] Script mô phỏng `simulate_level_progression.py` chạy qua 90 ngày (mỗi ngày 5 tiếng cày Map T16 chuẩn) chứng minh xác suất đạt cấp 100 của người chơi có tỷ lệ tử trận $\ge 1\%$ mỗi ngày là $\approx 0\%$, chỉ người chơi tiệm cận 0% tử trận mới có thể hoàn thành trong 80-90 ngày.

### Level Progression Service & Death Penalty
- [ ] `LevelProgressionService.award_monster_exp()` tính toán đúng Level Gap Penalty: quái thấp hơn 10 cấp chỉ cho $\le 5\%$ EXP.
- [ ] `LevelProgressionService.apply_death_penalty()` trừ đúng 15% ở cấp 90-99 và đúng 25% ở cấp 99->100; khi thanh EXP còn 10% mà bị trừ 25% thì đưa về đúng 0%, không giảm cấp.
- [ ] Sự kiện thăng cấp kích hoạt đầy đủ cập nhật chỉ số HP/Qi và điểm thiên phú.

### Ultimate Ascension & Avatar Metamorphosis
- [ ] Nhân vật cấp 99 cố gắng truy cập Thí Luyện 10 bị từ chối với thông báo cấp độ không đủ; chỉ cấp 100 mới kích hoạt được phụ bản.
- [ ] Node Keystone Niết Bàn Cấp 100 áp dụng thành công các thuộc tính đột biến sức mạnh vào `AscendancyAppliedEffects` và cờ biến hình `avatar_metamorphosis_active = True`.

### Code Quality & Hygiene Guardrails
- [ ] Toàn bộ mã nguồn Python mới tuân thủ `mypy --strict`, `@dataclass(slots=True, frozen=True)` cho models, độ dài file logic $\le 350-500$ dòng.
- [ ] Công cụ kiểm toán độc lập `python tools/security/run_independent_security_audit.py` trả về PASS (0 Critical, 0 High).
- [ ] Kiểm toán vệ sinh mã nguồn `python tools/lint/check_code_and_doc_hygiene.py --strict` đạt 100% hợp lệ.

## 2026-10-01T02:15:47Z
Liveness check: Your progress.md has not been updated in over 20 minutes (current stale time: ~75 mins). Worker worker_m1_progression_1 has completed M1 and delivered handoff.md at c:\Projects\FreeExile\.agents\teamwork\worker_m1_progression_1\handoff.md. Please acknowledge, review M1 handoff, and update progress.md and BRIEFING.md.