# HANDOFF REPORT: TIER 5 ADVERSARIAL COVERAGE HARDENING (CHALLENGER 1)

**Agent Role**: EMPIRICAL CHALLENGER (teamwork_preview_challenger / Challenger 1)  
**Scope**: Features F1 through F7 (Creative, Directives, Screenplay & Prompts)  
**Date**: 2026-10-08T08:38:00Z  
**Target Files**:
- `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`
- `FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md`
- `00_Project_Bible/CHARACTER_BIBLE.md`
- `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md`
- `02_AI_Prompts/gemini_banana_prompts.json`
- `02_AI_Prompts/muse_ai_video_prompts.json`
- `05_Production_Pipeline/production_orchestrator.py`

---

## 1. Observation

### 1.1 Invariants Successfully Verified (Passing Assertions)
- **F1 (Screenplay & Pacing Expansion)**:
  - `TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` defines exactly 188 shots across 15 scenes (`C01` to `C15`) in strictly contiguous sequence (`ep01_scene01_shot01` to `ep01_scene15_shot06`).
  - Duration is invariant at exactly `(10s)` per shot heading, total runtime = 1880s (31m20s, satisfying >= 1500s / 25-30m requirement).
  - 3 Acts are delineable: Act 1 (Scenes 01-05, 90 shots / 900s), Act 2 (Scenes 06-11, 60 shots / 600s), Act 3 (Scenes 12-15, 38 shots / 380s).
- **F2 (Đạm Tiên Grave 3-Beat Sequence)**:
  - Scene 05 contains exactly 27 shots partitioned into C05-A (8 shots: 01-08, Stroll along "tiểu khê"), C05-B (7 shots: 09-15, Inquiry at deserted mound "sè sè"), C05-C (12 shots: 16-27, Grief & Supernatural footprints "dấu hài in rêu").
  - In Beat C05-B, line 80 explicitly declares: `"Nàng chưa khóc, nhưng lòng dấy lên nỗi thắc mắc xót xa..."` confirming zero premature weeping prior to Beat C05-C.
  - Vương Quan maintains 0% tears across all 27 shots.
- **F3 (Anti-Male-Tears Script Purge)**:
  - Full text scan of all 188 shots in `TAP_01` reveals 0 occurrences of active male crying across all male characters (Kim Trọng, Vương Quan, Vương Ông, Từ Hải, Thúc Sinh, Mã Giám Sinh, Sở Khanh, Hồ Tôn Hiến, Sai Nha).
  - Lines containing weeping words (e.g. lines 792, 821, 909, 1498, 1521, 1683, 1753, 1852, 1872) are explicit feudal stoic negations (`tuyệt đối không rơi lệ`, `0% male tears`, `không rơi một giọt lệ`) or female weeping (Kiều's tears falling on the fan in line 1925).
- **F4 (Character & Acting Directives in Bibles)**:
  - `UNIVERSAL_ACTING_DIRECTIVES.md` codifies the Anti-Male-Tears Directive (§I), 4 male stoic micro-expressions (Jaw Clench, Heavy Downward Gaze, Distant Stare, Deep Compressed Breath), female micro-expressions, crowd decorum, closed-lips syntax, and `_v<N>.mp4` versioning.
  - `CHARACTER_BIBLE.md` codifies the 4-axis twin comparison matrix for Kiều & Vân (§1 & §3) and pure East Asian medieval Sai Nha attire (nón dấu sơn son chóp nhọn, áo chẽn nẹp vạt lính tráng, gậy son bịt đồng, xích sắt rỉ sét, đao bản rộng cổ, quần túm xà cạp vải, 0% Western/modern gear).
- **F5 (2-Step Sweet-Spot Start Frame Protocol)**:
  - 100% of the 188 start frames in `gemini_banana_prompts.json` specify `1280x720` resolution and combine character anchors with environmental anchors. Negative prompts include `--no reverse motion, backwards walking`.
- **F6 (Lip-Sync & Off-Screen Dialogue Guard)**:
  - 100% of off-screen/VO dialogue shots in `muse_ai_video_prompts.json` enforce closed-lips clauses (`[KHÓA KHẨU HÌNH BẮT BUỘC / LIPS CLOSED]`). Scene 08 Shot 02 Kim Trọng enforces closed lips when Kiều speaks off-screen.
- **F7 (AI Prompt Registry Consistency)**:
  - Exact 1-to-1 bijection of 188 shot IDs between `TAP_01`, `gemini_banana_prompts.json`, and `muse_ai_video_prompts.json`.
  - 100% of the 188 motion prompts in `muse_ai_video_prompts.json` terminate with the mandatory audio guard clause.
  - 100% of target video filenames end with `_10s_v1.mp4`.

---

### 1.2 Empirical Implementation Gaps Discovered

#### GAP-CREATIVE-01: Thúy Vân Age & Twin Inconsistency
- **Direct Observation**:
  - `ORIGINAL_REQUEST.md` (Directive Update 2026-10-08T05:21:27Z) and `CHARACTER_BIBLE.md` (§1 & §3) mandate:
    > "Thúy Kiều và Thúy Vân là 2 chị em SONG SINH (cùng 16 tuổi đầu phim), đường nét khuôn mặt ngũ quan khá giống nhau (twin resemblance)."
  - However, in `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`:
    - Line 18: `2. **THÚY VÂN (15 tuổi)**: Em gái Kiều...`
    - Line 389: `- **Nhân vật**: Thúy Kiều (16t), Thúy Vân (15t), Vương Quan (O.S.).`
    - Line 402: `- **Thị giác**: Thúy Vân (15 tuổi) ngồi trước chiếc gương đồng cổ...`
    - Line 664: `- **Nhân vật**: Thúy Kiều (16t), Thúy Vân (15t), Vương Quan (14t)...`
    - Occurrences of "song sinh" or "sinh đôi" in TAP_01: **0 occurrences**.
  - In `FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md`:
    - Scene 03 lists: `Thúy Kiều (16t), Thúy Vân (15t)`.
  - In `02_AI_Prompts/muse_ai_video_prompts.json`:
    - Shot `ep01_scene03_shot02` motion_prompt specifies: `Thúy Vân (15 tuổi) ngồi trước chiếc gương đồng cổ...` while its `character_asset_ref` points to `04_Assets/characters/01_Main_Protagonists/thuy_van_maiden_16yo_720p.png`.

#### GAP-CREATIVE-02: 27 Broken Character Asset Reference Paths in `muse_ai_video_prompts.json`
- **Direct Observation**:
  - In `02_AI_Prompts/muse_ai_video_prompts.json`, 83 shots define `character_asset_ref`.
  - Exactly 27 of these 83 shots (32.5%) point to non-existent file paths in `04_Assets/`:
    1. `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_ong_patriarch_55yo_720p.png` (11 shots: `ep01_scene02_shot04, 05, 07, 10, 13`; `ep01_scene13_shot02, 09, 11`; `ep01_scene14_shot02, 03, 08`).  
       *Actual file on disk*: `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_ong_55yo_720p.png`.
    2. `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_ba_matriarch_50yo_720p.png` (2 shots: `ep01_scene02_shot06`, `ep01_scene13_shot08`).  
       *Actual file on disk*: `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_ba_50yo_720p.png`.
    3. `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_quan_young_14yo_720p.png` (8 shots: `ep01_scene02_shot08, 09, 11, 12, 15`; `ep01_scene03_shot15`; `ep01_scene13_shot04`; `ep01_scene14_shot10`).  
       *Actual file on disk*: `04_Assets/characters/02_Vuong_Family_And_Fate/vuong_quan_16yo_720p.png`.
    4. `04_Assets/characters/05_Imperial_Court_And_Officials/imperial_guards_brutal_officials_720p.png` (6 shots: `ep01_scene12_shot04, 06, 07`; `ep01_scene13_shot03, 10, 12`).  
       *Actual file on disk*: `04_Assets/characters/05_Imperial_Court_And_Officials/sai_nha_720p.png`.

#### GAP-CREATIVE-03: Production Orchestrator Start Frame Fallback Vulnerability
- **Direct Observation**:
  - In `05_Production_Pipeline/production_orchestrator.py`, lines 162-167:
    ```python
    asset_ref = shot_data.get("character_asset_ref")
    if asset_ref:
        asset_path = BASE_DIR / asset_ref
        if asset_path.exists():
            return str(asset_path.resolve())
    return None
    ```
  - When `resolve_start_frame()` evaluates an unrendered shot without a rendered tail frame, it falls back to `character_asset_ref`. Because the 27 paths above do not exist on disk, `resolve_start_frame()` returns `None`, causing headless automated render execution to fail.

---

## 2. Logic Chain

1. **Premise 1 (Director Directive Authority)**: `ORIGINAL_REQUEST.md` (Update 2026-10-08T05:21:27Z) established that Thúy Kiều and Thúy Vân are 16-year-old twins with twin facial resemblance. `CHARACTER_BIBLE.md` was updated accordingly with the 4-axis comparison matrix.
2. **Inference 1 (Screenplay Drift)**: The screenplay (`TAP_01`) and index (`INDEX_VA_DANH_MUC_CANH_QUAY.md`) were created prior to or without backporting this directive, retaining 4 instances of "15 tuổi" / "15t" for Thúy Vân and omitting the "song sinh" status.
3. **Inference 2 (Prompt Registry Divergence)**: In `muse_ai_video_prompts.json`, `ep01_scene03_shot02` copied the old text "Thúy Vân (15 tuổi)" while referencing a file named `thuy_van_maiden_16yo_720p.png`, creating an internal contradiction within the prompt entry.
4. **Premise 2 (Filesystem Ground Truth)**: The actual assets in `04_Assets/characters/` were generated with concise filenames (`vuong_ong_55yo_720p.png`, `vuong_ba_50yo_720p.png`, `vuong_quan_16yo_720p.png`, `sai_nha_720p.png`).
5. **Inference 3 (Path Drift & Orchestrator Breakdown)**: `muse_ai_video_prompts.json` was generated with verbose descriptive keys (`vuong_ong_patriarch_55yo`, `vuong_ba_matriarch_50yo`, `vuong_quan_young_14yo`, `imperial_guards_brutal_officials`). Because `production_orchestrator.py` checks `asset_path.exists()`, these 27 references fail to resolve, breaking the automated start-frame resolution fallback.

---

## 3. Caveats

- **Scope boundary**: This review evaluated Features F1 through F7 (Creative, Directives, Screenplay, Prompt Registries). Audio crossfade waveform spectral continuity and API concurrency stress testing fall under Challenger 2 and were not audited here.
- **Review-only constraint**: As an adversarial challenger, no implementation code or screenplay text was modified. The test suite `tests/test_tier5_creative_hardening.py` was authored to empirically verify specifications and document gaps.

---

## 4. Conclusion

- **Overall Verification Verdict**: **PARTIAL PASS WITH 3 ACTIONABLE GAPS**.
- **Verified Compliant**:
  - Screenplay 188-shot structure, 15 scenes, 10s duration invariant, 3 acts, and pacing distribution.
  - Scene 05 3-beat structure (27 shots: 8+7+12) with zero premature weeping in Beats A & B.
  - Anti-Male-Tears directive: 0% male weeping across all 188 screenplay shots and prompt registries.
  - Gemini Banana start frame resolution (100% 1280x720) and contextual environment blending.
  - Lip-sync guard (100% closed-lips clause on off-screen/VO dialogue).
  - Muse motion prompts audio guard (100% termination clause).
  - Video file versioning (`_10s_v1.mp4`).
- **Actionable Implementation Gaps Requiring Fixes by Milestone Workers**:
  1. **Fix GAP-CREATIVE-01**: In `TAP_01` (lines 18, 389, 402, 664), `INDEX` (C03), and Muse prompt (`ep01_scene03_shot02`), update Thúy Vân's age from 15 to 16 and explicitly note "song sinh cùng Thúy Kiều".
  2. **Fix GAP-CREATIVE-02**: In `muse_ai_video_prompts.json`, update the 27 broken `character_asset_ref` paths to match the existing files on disk (`vuong_ong_55yo_720p.png`, `vuong_ba_50yo_720p.png`, `vuong_quan_16yo_720p.png`, `sai_nha_720p.png`).
  3. **Fix GAP-CREATIVE-03**: In `production_orchestrator.py`, add aliasing/fallback normalization in `resolve_start_frame()` so verbose character names automatically resolve to existing canonical asset filenames.

---

## 5. Verification Method

To independently reproduce and verify this assessment:

1. **Run Tier 5 Adversarial Test Suite**:
   ```powershell
   python tests/test_tier5_creative_hardening.py
   ```
   *Expected Result*: Ran 38 tests, OK (100% passing assertion coverage).

2. **Inspect Structured Gap Audit Report**:
   ```powershell
   python -c "import json; data=json.load(open('tests/tier5_creative_hardening_report.json', encoding='utf-8')); print(f'Total Gaps: {len(data[\"gaps\"])}'); [print(g[\"gap_id\"], ':', g[\"title\"]) for g in data[\"gaps\"]]"
   ```
   *Expected Output*:
   ```
   Total Gaps: 3
   GAP-CREATIVE-01 : Thúy Vân Age & Twin Status Inconsistency across Screenplay and Prompts
   GAP-CREATIVE-02 : 27 Broken Character Asset Reference Paths in muse_ai_video_prompts.json
   GAP-CREATIVE-03 : Start Frame Resolution Fallback Failure Due to Broken Asset References
   ```

3. **Verify Zero Regressions on Existing Suites**:
   ```powershell
   python tests/run_all_tests.py
   ```
   *Expected Result*: Ran 155 tests, OK (100% pass across Tiers 1-4).