# BÁO CÁO BÀN GIAO (HANDOFF REPORT) — EXPLORER M1 ITERATION 2 (1)
## KHẮC PHỤC TRIỆT ĐỂ LỖI ANTI-MALE-TEARS TẠI BẢNG NHÂN VẬT (CHARACTER ROSTER CLEANSE)

> **Agent**: `teamwork_preview_explorer` (`explorer_m1_iter2_1`)  
> **Thư mục làm việc**: `c:\Projects\KieuStory\.agents\teamwork\explorer_m1_iter2_1`  
> **Nhiệm vụ**: Điều tra Character Roster (dòng 15-25 của TAP_01), định danh chính xác các từ khóa khóc/rơi lệ gây fail 5 test Anti-Male-Tears, và xây dựng khối thay thế chuẩn phong thái khắc kỷ phong kiến.  
> **Thời điểm**: 2026-10-08T05:22:00Z  
> **Parent Orchestrator ID**: `f9992164-c0e4-4f7d-ba4a-25a83a4436bf`  
> **Handoff Type**: **Hard Handoff** (Nhiệm vụ hoàn thành trọn vẹn, sẵn sàng cho Worker triển khai)

---

## 1. OBSERVATION (Quan Sát Trực Tiếp)

### 1.1 Quan sát dòng 15-25 của `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`
- **Tệp nguồn**: `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`
- **Đoạn mã nguyên bản (dòng 15 đến 25)**:
  ```markdown
  15: ### DANH SÁCH NHÂN VẬT TẬP 1 (CHARACTER ROSTER)
  16: 1. **THÚY KIỀU (16 tuổi)**: Đại tiểu thư họ Vương, tuyệt thế giai nhân "làn thu thủy nét xuân sơn", tài hoa xuất chúng, đàn tỳ bà trác tuyệt, đa sầu đa cảm. Y phục: Áo Giao Lĩnh xanh ngọc bích, trâm hoa lê. Chuẩn diễn xuất: Biểu cảm vi mô điện ảnh (Micro-expressions: lắng nghe -> bàng hoàng -> ngấn lệ -> quỳ sụp thương xót).
  17: 2. **KIM TRỌNG (18 tuổi)**: Thư sinh trâm anh thế phiệt đất Bắc, tuấn tú nho nhã, khí chất cao quý, bạch y cưỡi ngựa trắng. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Quai hàm bạnh chặt, ánh mắt trĩu nặng thâm trầm, lồng ngực nén sâu hơi thở, tuyệt đối 0% nước mắt trước mọi nghịch cảnh hay chia ly.
  18: 3. **THÚY VÂN (15 tuổi)**: Em gái Kiều, nhan sắc đoan trang phúc hậu "khuôn trăng đầy đặn nét ngài nở nang", tâm tính bình hòa vô tư. Y phục: Áo lụa trắng ngà thuần khiết, nụ cười rạng rỡ.
  19: 4. **VƯƠNG QUAN (14 tuổi)**: Em trai út, thư sinh hiếu nghĩa, áo chàm nho sinh. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Phong thái nam nhân phong kiến mực thước, điềm đạm, khi gia biến thì cơ mặt đanh lại, ánh mắt uất hận cương trực, tuyệt đối không rơi lệ hay gào khóc yếu mềm.
  20: 5. **VƯƠNG ÔNG (55 tuổi)**: Phụ thân mẫu mực, đạo mạo, gia tư trung lưu bậc trung. **Tuân thủ Anti-Male-Tears Directive (R4)**: Khi chịu oan khiên giáng họa, biểu đạt sự uất nghẹn qua cơ hàm bạnh chặt, hai hàm răng nghiến chặt, giọng trầm đục đau đớn, không rên rỉ ủy mị hay gào khóc mất lý trí.
  21: 6. **VƯƠNG BÀ (50 tuổi)**: Mẫu thân hiền từ, thương con hết mực, áo tứ thân khăn vấn. Biểu cảm vi mô: Nấc nghẹn đau đớn, tránh cường điệu sân khấu.
  22: 7. **ĐẠM TIÊN (Linh hồn hư ảo)**: Ca nhi tiền kiếp tài hoa bạc mệnh, hiện diện qua bóng hình mờ ảo trong khói sương, hương trầm và chuỗi dấu hài in trên rêu xanh (không jump-scare kinh dị, 100% YouTube Green Dollar).
  23: 8. **VIÊN QUAN SAI NHA**: Cai ngục hung hãn, mặt sắt đen ngòm, tay cầm roi trượng và bản án vu khống.
  24: 9. **KẺ LẠ MẶT (BÓNG MÃ GIÁM SINH)**: Kẻ bí ẩn xuất hiện cuối tập mang theo bọc tiền chuộc mạng ba trăm lượng vàng, nụ cười nham hiểm.
  25: 10. **QUẦN CHÚNG DU XUÂN, GIA NHÂN, TOÁN SAI NHA ĐẦU TRÂU MẶT NGỰA**.
  ```

### 1.2 Kết quả thực thi `python tests/run_all_tests.py` và 5 lỗi Anti-Male-Tears
Lệnh chạy: `python tests/run_all_tests.py`  
Kết quả: `Ran 155 tests in 6.617s. FAILED (failures=23).`  
Có đúng **5 ca kiểm thử thất bại** do các từ khóa vi phạm Anti-Male-Tears:

1. **`test_f3_01_no_male_crying_in_ep01_screenplay`** (`tests/test_tier1_features.py:158`):
   ```
   AssertionError: Detected 3 Anti-Male-Tears violations in EP01:
   Line 17: KIM TRỌNG -> '2. **KIM TRỌNG (18 tuổi)**: ... tuyệt đối 0% nước mắt trước mọi nghịch cảnh hay chia ly.'
   Line 19: VƯƠNG QUAN -> '4. **VƯƠNG QUAN (14 tuổi)**: ... tuyệt đối không rơi lệ hay gào khóc yếu mềm.'
   Line 20: VƯƠNG ÔNG -> '5. **VƯƠNG ÔNG (55 tuổi)**: ... không rên rỉ ủy mị hay gào khóc mất lý trí.'
   ```
2. **`test_f3_03_vuong_quan_stoic_delivery`** (`tests/test_tier1_features.py:176`):
   ```
   AssertionError: Line 19 violates Anti-Male-Tears: Vương Quan weeps: 4. **VƯƠNG QUAN (14 tuổi)**: Em trai út, thư sinh hiếu nghĩa, áo chàm nho sinh. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Phong thái nam nhân phong kiến mực thước, điềm đạm, khi gia biến thì cơ mặt đanh lại, ánh mắt uất hận cương trực, tuyệt đối không rơi lệ hay gào khóc yếu mềm.
   ```
3. **`test_f3_04_vuong_ong_dignity_during_arrest`** (`tests/test_tier1_features.py:184`):
   ```
   AssertionError: Line 20 violates Anti-Male-Tears: Vương Ông breaks stoic dignity: 5. **VƯƠNG ÔNG (55 tuổi)**: Phụ thân mẫu mực, đạo mạo, gia tư trung lưu bậc trung. **Tuân thủ Anti-Male-Tears Directive (R4)**: Khi chịu oan khiên giáng họa, biểu đạt sự uất nghẹn qua cơ hàm bạnh chặt, hai hàm răng nghiến chặt, giọng trầm đục đau đớn, không rên rỉ ủy mị hay gào khóc mất lý trí.
   ```
4. **`test_f1_f3_screenplay_expansion_with_zero_male_tears`** (`tests/test_tier3_interactions.py:45`):
   ```
   AssertionError: 3 != 0 : Found male tears violations in expanded screenplay: [{'line_num': 17, 'character': 'KIM TRỌNG', 'keyword': 'nước mắt', ...}, {'line_num': 19, 'character': 'VƯƠNG QUAN', 'keyword': 'khóc', ...}, {'line_num': 20, 'character': 'VƯƠNG ÔNG', 'keyword': 'khóc', ...}]
   ```
5. **`test_workload_06_complete_anti_male_tears_audit_across_all_acts`** (`tests/test_tier4_workloads.py:161`):
   ```
   AssertionError: Anti-Male-Tears audit failed (3 violations): Line 17, Line 19, Line 20.
   ```

### 1.3 Cơ chế phân tích của bộ kiểm thử `find_male_crying_violations` (`tests/__init__.py`)
- `MALE_CHARACTERS`: `KIM TRỌNG`, `VƯƠNG QUAN`, `VƯƠNG ÔNG`, `TỪ HẢI`, `THÚC SINH`, `THÚC ÔNG`, `MÃ GIÁM SINH`, `SỞ KHANH`, `HỒ TÔN HIẾN`, `BẠC BÀ`, `BẠC HẠNH`.
- `CRYING_KEYWORDS`: `["khóc", "rơi lệ", "rơi nước mắt", "châu sa", "ngấn lệ", "nước mắt", "nước mắt tuôn", "khóc ngất", "khóc rống", "gào khóc", "nức nở", "thút thít", "rưng rưng giọt lệ"]`.
- Thuật toán tại dòng 119-135 của `tests/__init__.py`:
  Quét từng dòng. Nếu tên một nhân vật nam thuộc `MALE_CHARACTERS` xuất hiện trong dòng, và dòng đó chứa bất kỳ chuỗi con nào thuộc `CRYING_KEYWORDS` (không phân biệt hoa thường), hàm sẽ ghi nhận vi phạm trừ phi nước mắt được chỉ định rõ ràng cho nhân vật nữ ("thiếu nữ", "nàng", "cô gái", "kiều").

---

## 2. LOGIC CHAIN (Chuỗi Suy Luận Logic)

1. **Từ Quan sát 1.1 và 1.3**:
   - Dòng 17 chứa tên `KIM TRỌNG` và cụm từ `tuyệt đối 0% nước mắt`. Chuỗi `"nước mắt"` thuộc `CRYING_KEYWORDS` -> Khớp lỗi.
   - Dòng 19 chứa tên `VƯƠNG QUAN` và cụm từ `tuyệt đối không rơi lệ hay gào khóc yếu mềm`. Các chuỗi `"rơi lệ"`, `"khóc"`, `"gào khóc"` đều thuộc `CRYING_KEYWORDS` -> Khớp lỗi.
   - Dòng 20 chứa tên `VƯƠNG ÔNG` và cụm từ `không rên rỉ ủy mị hay gào khóc mất lý trí`. Chuỗi `"gào khóc"` và `"khóc"` thuộc `CRYING_KEYWORDS` -> Khớp lỗi.
2. **Từ Quan sát 1.2**:
   - `test_f3_01`, `test_f1_f3`, và `test_workload_06` cùng sử dụng chung hàm `find_male_crying_violations`. Khi hàm trả về 3 vi phạm tại các dòng 17, 19, 20, cả 3 test này đều ném ra ngoại lệ `AssertionError`.
   - `test_f3_03` duyệt trực tiếp từng dòng chứa `VƯƠNG QUAN` và kiểm tra `any(w in line.lower() for w in ["khóc", "rơi lệ", "rơi nước mắt"])`. Dòng 19 khớp `"rơi lệ"` và `"khóc"` nên fail.
   - `test_f3_04` duyệt trực tiếp từng dòng chứa `VƯƠNG ÔNG` và kiểm tra `any(w in line.lower() for w in ["khóc ngất", "khóc rống", "gào khóc"])`. Dòng 20 khớp `"gào khóc"` nên fail.
3. **Từ bản chất ngữ nghĩa**:
   - Ý định kịch bản hoàn toàn không cho nhân vật nam khóc mà nhằm nhấn mạnh quy tắc cấm khóc ("tuyệt đối không...", "0%...").
   - Tuy nhiên, do parser dùng kỹ thuật kiểm tra chuỗi con (naive substring matching), việc dùng từ phủ định chứa từ khóa cấm đã phản tác dụng (false positive về mặt ý định, nhưng là true positive về mặt regex).
4. **Từ nguyên lý thiết kế Khắc Kỷ Phong Kiến (Positive Feudal Stoicism)**:
   - Thay vì diễn đạt cấm đoán bằng phủ định ("không khóc", "không rơi lệ", "0% nước mắt"), kịch bản phong kiến chuẩn mực cần mô tả hành vi biểu cảm vi mô tích cực:
     * Quai hàm bạnh chặt (clenched jaw).
     * Ánh mắt trĩu nặng thâm trầm, giữ vững phong thái khắc kỷ và thần thái kiên định (unwavering composure).
     * Lồng ngực nén sâu hơi thở kiên nghị (deep stoic breath).
     * Cơ mặt đanh lại, giữ trọn sự sắt đá kiên cường và khí chất trượng phu bất khuất.
     * Cơ hàm bạnh chặt, hai hàm răng nghiến chặt, giọng trầm đục đanh thép, giữ trọn khí tiết gia trưởng và phong thái kiên cường trầm mặc.
5. **Từ kết quả mô phỏng kiểm thử**:
   - Khi áp dụng khối thay thế mới, số vi phạm của `find_male_crying_violations` giảm về **0**.
   - Cả 5 bài test (`test_f3_01`, `test_f3_03`, `test_f3_04`, `test_f1_f3`, `test_workload_06`) chuyển sang **PASS** 100%. Đồng thời `test_f3_02`, `test_f3_05`, và `tests/verify_m1_screenplay.py` vẫn giữ nguyên trạng thái **PASS**.

---

## 3. CAVEATS (Lưu Ý & Giới Hạn)

1. **Phạm vi thẩm định**: Báo cáo này tập trung vào 5 test Anti-Male-Tears tại Character Roster (dòng 15-25 của TAP_01). Hai lỗi kiểm thử khác của Milestone M1 (`test_f1_f2_screenplay_scene05_sub_beats_integration` và `test_workload_07_full_scene05_sub_beat_dramatic_arc_verification`) do xung đột tiêu đề tiểu phân cảnh Cảnh 05 (`##### CẢNH 05-A:` vs `re.split(r"(#{3,4}\s*CẢNH\s*\d+[^:\n]*:[^\n]*)")`) thuộc nhiệm vụ của Explorer 2 (`explorer_m1_iter2_2`).
2. **Không chỉnh sửa trực tiếp file nguồn**: Tuân thủ nghiêm ngặt vai trò Explorer (Read-only Investigation), báo cáo này không trực tiếp sửa đổi `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` mà cung cấp chính xác khối mã thay thế (drop-in replacement chunk) để Worker triển khai an toàn.

---

## 4. CONCLUSION (Đề Xuất & Khối Thay Thế Drop-In)

Khuyến nghị Worker áp dụng khối thay thế duy nhất, liên tục từ dòng 17 đến dòng 20 trong `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`:

### Tệp mục tiêu:
`c:\Projects\KieuStory\FilmMaker\TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` (Dòng 17 - 20)

### Target Content:
```markdown
2. **KIM TRỌNG (18 tuổi)**: Thư sinh trâm anh thế phiệt đất Bắc, tuấn tú nho nhã, khí chất cao quý, bạch y cưỡi ngựa trắng. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Quai hàm bạnh chặt, ánh mắt trĩu nặng thâm trầm, lồng ngực nén sâu hơi thở, tuyệt đối 0% nước mắt trước mọi nghịch cảnh hay chia ly.
3. **THÚY VÂN (15 tuổi)**: Em gái Kiều, nhan sắc đoan trang phúc hậu "khuôn trăng đầy đặn nét ngài nở nang", tâm tính bình hòa vô tư. Y phục: Áo lụa trắng ngà thuần khiết, nụ cười rạng rỡ.
4. **VƯƠNG QUAN (14 tuổi)**: Em trai út, thư sinh hiếu nghĩa, áo chàm nho sinh. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Phong thái nam nhân phong kiến mực thước, điềm đạm, khi gia biến thì cơ mặt đanh lại, ánh mắt uất hận cương trực, tuyệt đối không rơi lệ hay gào khóc yếu mềm.
5. **VƯƠNG ÔNG (55 tuổi)**: Phụ thân mẫu mực, đạo mạo, gia tư trung lưu bậc trung. **Tuân thủ Anti-Male-Tears Directive (R4)**: Khi chịu oan khiên giáng họa, biểu đạt sự uất nghẹn qua cơ hàm bạnh chặt, hai hàm răng nghiến chặt, giọng trầm đục đau đớn, không rên rỉ ủy mị hay gào khóc mất lý trí.
```

### Replacement Content:
```markdown
2. **KIM TRỌNG (18 tuổi)**: Thư sinh trâm anh thế phiệt đất Bắc, tuấn tú nho nhã, khí chất cao quý, bạch y cưỡi ngựa trắng. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Quai hàm bạnh chặt, ánh mắt trĩu nặng thâm trầm, lồng ngực nén sâu hơi thở kiên nghị, giữ vững phong thái khắc kỷ và thần thái kiên định trước mọi nghịch cảnh hay chia ly.
3. **THÚY VÂN (15 tuổi)**: Em gái Kiều, nhan sắc đoan trang phúc hậu "khuôn trăng đầy đặn nét ngài nở nang", tâm tính bình hòa vô tư. Y phục: Áo lụa trắng ngà thuần khiết, nụ cười rạng rỡ.
4. **VƯƠNG QUAN (14 tuổi)**: Em trai út, thư sinh hiếu nghĩa, áo chàm nho sinh. **Tuân thủ tuyệt đối Anti-Male-Tears Directive (R4)**: Phong thái nam nhân phong kiến mực thước, điềm đạm, khi gia biến thì cơ mặt đanh lại, ánh mắt uất hận cương trực, giữ trọn sự sắt đá kiên cường và khí chất trượng phu bất khuất.
5. **VƯƠNG ÔNG (55 tuổi)**: Phụ thân mẫu mực, đạo mạo, gia tư trung lưu bậc trung. **Tuân thủ Anti-Male-Tears Directive (R4)**: Khi chịu oan khiên giáng họa, biểu đạt sự uất nghẹn qua cơ hàm bạnh chặt, hai hàm răng nghiến chặt, giọng trầm đục đanh thép, giữ trọn khí tiết gia trưởng và phong thái kiên cường trầm mặc.
```

---

## 5. VERIFICATION METHOD (Phương Pháp Kiểm Tra Lại)

Sau khi Worker áp dụng khối thay thế trên, thực hiện kiểm chứng độc lập bằng lệnh:

```powershell
# 1. Kiểm tra 0 vi phạm Anti-Male-Tears trên toàn bộ kịch bản 188 shots:
python -X utf8 -c "from tests import read_ep01_screenplay, find_male_crying_violations; viols = find_male_crying_violations(read_ep01_screenplay()); print('VIOLATIONS:', len(viols)); assert len(viols) == 0"

# 2. Chạy bộ kiểm thử kịch bản M1:
python tests/verify_m1_screenplay.py

# 3. Chạy kiểm tra trực tiếp các test case F3 của M1:
python -m unittest tests.test_tier1_features.TestTier1Features.test_f3_01_no_male_crying_in_ep01_screenplay
python -m unittest tests.test_tier1_features.TestTier1Features.test_f3_03_vuong_quan_stoic_delivery
python -m unittest tests.test_tier1_features.TestTier1Features.test_f3_04_vuong_ong_dignity_during_arrest
python -m unittest tests.test_tier3_interactions.TestTier3Interactions.test_f1_f3_screenplay_expansion_with_zero_male_tears
python -m unittest tests.test_tier4_workloads.TestTier4Workloads.test_workload_06_complete_anti_male_tears_audit_across_all_acts
```

**Điều kiện nghiệm thu (Acceptance Criteria)**:
- Cả 5 lệnh kiểm thử trên đều thoát với mã 0 (PASS).
- `verify_m1_screenplay.py` hoàn tất thành công (`PASS: test_m1_screenplay completed successfully`).
- Số lượng test failures trong `python tests/run_all_tests.py` giảm đúng 5 ca.