# HANDOFF REPORT — EP01 NARRATIVE & SCREENPLAY SPEC SURVEY (R1 & R2)

- **Agent**: `teamwork_preview_spec_miner` (Narrative & Screenplay Spec Miner)
- **Recipient**: Parent Agent (`f9992164-c0e4-4f7d-ba4a-25a83a4436bf`)
- **Working Directory**: `c:\Projects\KieuStory\.agents\teamwork\spec_miner_survey_1`
- **Deliverables**: `survey_report.md`, `handoff.md`, `progress.md`
- **Timestamp**: 2026-10-08T04:16:30Z

---

## 1. OBSERVATION

1. **Current EP01 Video Duration & Shot Count Compression**:
   - In `05_Production_Pipeline/assemble_ep01_feature.py` line 75: `"🎬 Bắt đầu ghép nối 15 phân cảnh thành Grand Feature Master 7m30s..."`.
   - Inspection of `02_AI_Prompts/muse_ai_video_prompts.json` via python script revealed:
     `Total shots: 120, EP01 shots: 48`.
     At 10 seconds per Muse.ai shot, 48 shots yield exactly $480\text{ seconds} = 8\text{ minutes}$.
   - Inspection of `06_Exports/`:
     - `thap_ngu_nien_ep01_grand_feature_master_10min.mp4` (322.94 MB)
     - `thap_ngu_nien_ep01_grand_feature_master_450s_7m30s.mp4` (62.25 MB)
     Actual master cut runtime is only ~7m30s to 8m30s, far below the target cinematic 25-30 minute duration.

2. **Omission and Truncation of Core Scenes in Prompt Registry**:
   - In `02_AI_Prompts/muse_ai_video_prompts.json`:
     - `ep01_scene03` (Khuê phòng Thúy Kiều & Thúy Vân) has **0 shots defined** (missing from JSON).
     - `ep01_scene04` (Lễ hội Thanh minh) has only **2 shots = 20 seconds**.
     - `ep01_scene06` (Hội ngộ Kim Trọng) has only **3 shots = 30 seconds**.
     - `ep01_scene11` (Giông bão phá cổng) has only **2 shots = 20 seconds**.
     - `ep01_scene12` (Gia biến phòng khách) has only **2 shots = 20 seconds**.

3. **Gaps in Đạm Tiên Sequence (R2) Against Nguyễn Du's Original**:
   - In `01_Scripts_And_Episodes/NGUYEN_TAC_TRUYEN_KIEU_LUC_BAT_3254_CAU.md`:
     - Verses 51-56 (Beat 1 - Stroll by the stream): *"Tà tà bóng ngả về tây / Chị em thơ thẩn dan tay ra về / Bước dần theo ngọn tiểu khê / Lần xem phong cảnh có bề thanh thanh / Nao nao dòng nước uốn quanh / Dịp cầu nho nhỏ cuối ghềnh bắc ngang."*
     - Verses 57-60 (Beat 2 - Inquiry & wonder): *"Sè sè nấm đất bên đàng / Dàu dàu ngọn cỏ nửa vàng nửa xanh / Rằng: Sao trong tiết thanh minh / Mà đây hương khói vắng tanh thế mà?"*
     - Verses 61-84 (Beat 3 - Story of Đạm Tiên & Psychological transformation): *"Vương Quan mới dẫn gần xa... Lòng đâu sẵn mối thương tâm / Thoắt nghe Kiều đã đầm đầm châu sa / Đau đớn thay phận đàn bà! / Lời rằng bạc mệnh cũng là lời chung..."*
     - Verses 119-126 (Supernatural sign): *"Thoắt đâu trận gió cuốn cờ đến ngay... Dấu giày từng bước in rêu rành rành."*
   - In existing screenplay `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` (Scene 05 lines 85-113) and `muse_ai_video_prompts.json` (`ep01_scene05_shot01` to `shot06`):
     - Beat 1 is completely omitted; the scene jumps abruptly from the noisy festival street directly to the mound under the barren banyan tree.
     - Beat 2 is distorted: Kiều drops to her knees and weeps in Shot 02 before hearing the full story, skipping the innocent wonder of a 16-year-old girl noticing the contrast of the festival vs. the deserted mound.
     - The physical proof of spiritual connection (*"Dấu giày từng bước in rêu rành rành"*) was omitted; only swirling leaves were depicted.

4. **Script Violation of Anti-Male-Tears Directive (R4)**:
   - In `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` line 195:
     `KIM TRỌNG: *(Nắm chặt tay Kiều, nghẹn ngào rơi nước mắt)*`
     This directly contradicts `ORIGINAL_REQUEST.md` R4: *"Thời phong kiến, nam nhân (Kim Trọng, Vương Quan, Vương Ông, Từ Hải...) tuyệt đối không được khóc hay rơi lệ."*

---

## 2. LOGIC CHAIN

1. **Step 1 (Pacing Expansion Analysis - R1)**:
   - Observation 1 shows current EP01 is only 48 shots (8 minutes), with scenes lasting 20-50s.
   - Observation 2 proves vital narrative elements (Khuê phòng C03, Hội Đạp Thanh C04, Gia phong C02) were compressed into montages.
   - To achieve a serene, classical East Asian cinema pacing with atmospheric breathing room (wide scenic pans, tea ceremonies, lute tuning, leisurely strolls, festive crowds), the scene breakdown must expand from 48 shots to **188 shots (29 minutes 40 seconds)**, structured across a balanced 3-Act arc (Act 1: 10m30s, Act 2: 10m30s, Act 3: 7m00s, plus 1m30s framed prologue).

2. **Step 2 (Đạm Tiên Emotional Arc Analysis - R2)**:
   - Observation 3 proves that jumping straight into tears at the grave mound removes the emotional setup that Nguyễn Du meticulously crafted.
   - Without Beat 1 (stroll along "ngọn tiểu khê" with winding water and quaint bridge), the transition from vibrant festival to deathly silence is jarring.
   - Without Beat 2 (naive curiosity and wonder), Kiều's character appears melodramatic rather than naturally empathetic.
   - Decoupling Scene 05 into three distinct sub-scenes (C05-A: 8 shots/1m20s; C05-B: 7 shots/1m10s; C05-C: 12 shots/2m00s) restores the exact 3-beat progression and brings back the iconic supernatural reveal of footprints in the moss (*"Dấu giày từng bước in rêu rành rành"*).

3. **Step 3 (Acting & Audio Directives Compliance)**:
   - Observation 4 requires correcting Kim Trọng's dialogue direction in Scene 10 from crying to stoic jaw-clenching and controlled breathing.
   - In Scene 08 (garden wall), Kim Trọng's prompt must enforce closed lips when Kiều speaks off-screen (R5).
   - In transitioning between C04 and C05-A, an audio L-Cut crossfade must be scheduled to prevent jarring sound dropouts (R6).

---

## 3. CAVEATS

1. **Production Pipeline Throughput**: Expanding from 48 shots to 188 shots requires generating 140 new Start Frames via Gemini Banana and running 140 headless renders on Muse.ai (`agent-browser --session muse`).
2. **Actor Consistency Across Sub-Beats**: In C05-A to C05-C, maintaining pixel-perfect clothing continuity across 27 consecutive shots requires strict adherence to Head-Tail keyframe chaining (`clean_frame_239.jpg` -> Start Frame $N+1$).
3. **No Project Code Alteration During Survey**: As a read-only Specification Miner, no implementation code in `FilmMaker/` or `02_AI_Prompts/` has been altered in this phase; all detailed findings and blueprints are delivered in `survey_report.md`.

---

## 4. CONCLUSION

1. **R1 Resolution**: A complete, scene-by-scene 188-shot roadmap totaling **29 minutes 40 seconds** has been established in `survey_report.md` Section 6, providing the exact pacing, shot allocations, and narrative expansions required for a classical 3-Act feature episode.
2. **R2 Resolution**: The Đạm Tiên sequence has been systematically re-architected into 3 canonical beats (C05-A Tiểu Khê 8 shots, C05-B Nấm Mồ Sè Sè 7 shots, C05-C Huyết Lệ & Dấu Hài Hiển Linh 12 shots), fully restoring Nguyễn Du's poetic genius.
3. **Universal Standards Integrated**: Detailed rules for R3 (Gemini Banana 720p), R4 (Anti-Male-Tears), R5 (Lip-sync guard), and R6 (4-stem -14 LUFS) have been formulated for prompt engineering.

---

## 5. VERIFICATION METHOD

To independently verify the evidence and findings cited in this report:

1. **Verify Current Shot Count & Duration**:
   ```bash
   python -c "import json; data=json.load(open('02_AI_Prompts/muse_ai_video_prompts.json', encoding='utf-8')); ep01=[k for k in data['motion_prompts'] if 'ep01' in k]; print(f'EP01 shots: {len(ep01)}, duration: {len(ep01)*10}s ({len(ep01)*10/60:.2f} mins)')"
   ```
   *Expected output*: `EP01 shots: 48, duration: 480s (8.00 mins)`.

2. **Verify Grand Master File Reality**:
   ```bash
   python -c "from pathlib import Path; p=Path('06_Exports/thap_ngu_nien_ep01_grand_feature_master_10min.mp4'); print(p.exists(), p.stat().st_size)"
   ```

3. **Verify Textual Gaps in Nguyễn Du's Verses vs. Script**:
   - Inspect `01_Scripts_And_Episodes/NGUYEN_TAC_TRUYEN_KIEU_LUC_BAT_3254_CAU.md` lines 114 to 126.
   - Inspect `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` lines 85 to 113.
   - Notice the complete absence of "ngọn tiểu khê" and "dấu giày từng bước in rêu" in the current screenplay.

4. **Verify Male Crying Violation**:
   - Check line 195 of `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` to confirm the verbatim quote `nghẹn ngào rơi nước mắt`.