# Background Master Plan — D6 raw intent schema

You are a film art-direction master planner for a single building group.

Given (a) the group spec, (b) related scene segments (verbatim), (c) related shots, output **raw intent** for each background variant. **The code assigns deterministic `bg_id` after this step — do NOT output `bg_id`.**

## Output

Strict JSON per the schema. No prose outside JSON.

```
{
  "group_id": "<provided>",
  "rationale_summary": "<≤200 char Korean or English>",
  "floor_plans": [
    {
      "fp_id": "fp_<snake_case>",
      "loc_id": "L##",
      "space_key_hint": "main" | "kitchen" | "rooftop" | "stairs" | "yard" | "exterior" | "office",
      "sub_location": "<snake_case>",
      "scope": "<≤100 char English>",
      "depends_on_fp": ["fp_<other>", ...]
    }
  ],
  "backgrounds": [
    {
      "loc_id": "L##",
      "space_key_hint": "main" | "kitchen" | "rooftop" | "stairs" | "yard" | "exterior" | "office",
      "time_phase": "dawn" | "morning" | "day" | "dusk" | "night",
      "state_class": <STATE_CLASS_ENUM 의 정확히 한 값>,
      "applies_to_shots": ["S<scene_index>_Shot<shot_index>", ...],
      "sub_location_label": "<자유 텍스트, 한국어 OK>",
      "state_label_raw": "<자유 텍스트, 예: 'dusk busy with employee pointing toward exit'>",
      "depends_on_fp": ["fp_<...>"],
      "depends_on_bg": []
    }
  ]
}
```

## state_class enum (정확히 한 값. 그 외는 reject):

`normal` / `quiet` / `busy` / `busy_exit` / `ransacked` / `clean_after` / `blood_scene` / `intrusion` / `arrival` / `evidence_display` / `dream_or_vision_state`

state_class 가 enum 밖이면 코드가 retry 후 fail. 모르면 `normal` 로 처리하지 말고 진짜 적합한 enum 선택.

## Rules

- **`bg_id` 출력 금지** — 코드가 후처리에서 부여 (`f"L{loc_num:02d}B{var_num:02d}"`).
- `state_class` 는 enum 밖 시 reject. nearest-match 시도하지 말 것.
- `space_key_hint` 는 controlled vocab 안에서 선택. single_space location 의 경우 코드가 `main` 으로 normalize — 그래도 출력 의무.
- `time_phase` 는 5 enum (dawn/morning/day/dusk/night) 중 하나.
- `sub_location_label` / `state_label_raw` 는 사람이 읽는 자유 텍스트 (metadata-only — semantic_key 에 안 들어감).
- `applies_to_shots` 는 input shot_ids list 안에서 선택. 같은 (loc_id, space_key, time_phase, state_class) 4-tuple 인 shot 들은 같은 background variant 로 묶음.
- `loc_id` 는 input `members` 의 L## 중 하나.
- `depends_on_fp` 비어있으면 안 됨. 자체 plan 의 fp_id 참조 (1+).
- `depends_on_bg` 는 옵션 — 같은 sub_location 의 chain 일 때만 사용.

## Decisions

1. **floor_plans[]**: how many floor plans to draw (typically 1; multiple if the group has clearly separated sub-rooms — e.g., living room + bedroom + corridor).
2. **backgrounds[] (raw intent)**: 각 background variant 는 (loc_id, space_key_hint, time_phase, state_class) 4-tuple 의 unique combo 별로 1개. `applies_to_shots` 는 그 combo 에 해당하는 shot 들. 코드가 후처리에서 dedup 후 deterministic bg_id 부여.

## Sub-room consistency

If multiple shots happen in clearly different rooms within one building group, name distinct `space_key_hint`s using the controlled vocab. If shots are all in the same room with different states (day/night/blood/etc), keep one `space_key_hint` and vary `state_class`.

## fp ↔ bg link (T4-fix3 — strict)

Each floor_plan MUST declare exactly which `(loc_id, space_key_hint)` it covers — single tuple, no list. If two locations or two space_keys need separate plans, output **two distinct fp entries**.

`backgrounds[].depends_on_fp[*]` MUST reference fp(s) whose declared `(loc_id, space_key_hint)` equals the background's own `(loc_id, space_key_hint)`. Different sub-room or different location → split into separate fp.

Example (group `bg_large_mart` covers L09 외부 + L10 매장 + L14 사무실):
- `fp_sales_floor` → loc_id=L10, space_key_hint=main
- `fp_exterior_entrance` → loc_id=L09, space_key_hint=main
- `fp_office` → loc_id=L14, space_key_hint=main
- Background `loc_id=L10/main/morning/quiet` → `depends_on_fp=["fp_sales_floor"]` (NOT `fp_exterior_entrance`).

Code raises `FpLinkMismatchError` (LLM retry path) if violation.

## Field semantics

- `floor_plans[].fp_id`: ASCII snake_case (e.g., `fp_living`).
- `floor_plans[].loc_id`: which location (`L##`) this plan covers — MUST be in this group's `members`.
- `floor_plans[].space_key_hint`: which space_key this plan covers — controlled vocab. Single tuple per fp; multi-space → split fp.
- `floor_plans[].sub_location`: which sub-room this plan covers (e.g., `living_room`).
- `floor_plans[].scope`: short English phrase (≤100 chars) describing what the plan covers.
- `backgrounds[].loc_id`: MUST be one of the `L##` ids listed in `members` for this group.
- `backgrounds[].space_key_hint`: controlled vocab — `main` / `kitchen` / `rooftop` / `stairs` / `yard` / `exterior` / `office`. 모르는 공간은 `main` 으로 fallback.
- `backgrounds[].time_phase`: 5 enum 중 하나.
- `backgrounds[].state_class`: STATE_CLASS_ENUM 강제.
- `backgrounds[].applies_to_shots`: shot ids (`S##_Shot##`) from the input `shots` list.
- `backgrounds[].sub_location_label`: free text. 코드는 metadata 로만 사용 — semantic_key 에 안 들어감.
- `backgrounds[].state_label_raw`: free text describing visual state (e.g., "dusk busy with employee pointing toward exit"). Reference for downstream prompt builder.
- `backgrounds[].depends_on_fp`: 1+ fp_id from this plan.
- `backgrounds[].depends_on_bg`: optional — chain root 면 빈 list.
- `rationale_summary`: ≤200 chars Korean or English. Why these floor plans + state distinctions + plot-critical decisions.