W21B-w5 — Space-Type-Aware Floor Plan Prompt

설계 + 상세 수정 계획서 · 2026-06-01 · DOC-ONLY Codex 2R 합의 commit·push 0 / ahead 10 hold

비-실내 공간(옥상·외부·선박)이 floor_plan_prompt에서 아파트처럼 과분할되는 구조 결함을 근본 수정한다. 핵심은 surface_role 공간유형 신호를 FP 생성 입력으로 전파하고, FP 프롬프트를 공간유형별로 분기하는 것(신규 pack v8, opt-in). STEP5-B sparse FP sidecar의 upstream 수정이며 sidecar는 건드리지 않는다.

1. 개요 & 현재 상태

2. 근본원인 (코드로 직접 검증)

메모리 주장을 코드로 전수 확인함(Codex 아닌 실측).

2.1 surface_role는 background에만, FP로 미전파

• SURFACE_ROLE_ENUM = {interior_room, exterior_plate, transition_zone, site_surface} — background_master_plan.py:24. 4개(이전 메모리엔 3개로 잘못 기재 → 정정).
• surface_role는 background(bg) 단위에만 존재. floor_plans[] 스키마 = fp_id / loc_id / space_key_hint / sub_location / scope / depends_on_fp — surface_role 필드 없음 (bgmp.py:107).
• floor_plan_prompt.py / floor_plan_render.py 에 surface_role 참조 0건 → FP 생성·렌더는 공간유형을 전혀 모른다.
• invariant E (bgmp.py:245): interior_room bg만 depends_on_fp 필수. exterior/transition/site는 fp 불필요(금지는 아님).

2.2 FP 시스템 프롬프트(v7)가 실내 주거 모델을 무조건 강제

prompts/_base/floor_plan_prompt/7.202605291624/system.md

→ LLM은 주어진 유일한 어휘(방·벽·여닫이문·zone)로 옥상·어선도 충실히 모델링. 프롬프트 설계 결함이지 LLM 오작동이 아님. 두 image model(NB2/gpt-image-2) 모두 동일 재현(갤러리 8820/8821).

3. 데이터 흐름 & 전파 지점

# background_master_plan (LLM) — surface_role 원천 (bg 단위)
plan.backgrounds[].surface_role  ∈ SURFACE_ROLE_ENUM
plan.backgrounds[].depends_on_fp  ──┐  (interior_room은 필수)
plan.floor_plans[]  (surface_role 없음) │
        │                              │
        ▼                              ▼
floor_plan_prompt_step._process  (floor_plan_prompt_step.py:158)
   job["applied_bgs"] = [bg for bg in plan.backgrounds
                         if fp_id in bg.depends_on_fp]   # ← surface_role 여기 도달!
        │
        │  ★ NEW: space_type, mix = derive_fp_space_type(applied_bgs)
        ▼
build_fp_user_prompt(fp_spec, applied_bgs, …, prompt_version, space_type=…)
        │   .replace("{space_type_block}", …)   # selector "8"만; 5/6/7은 토큰無=no-op
        ▼
run_floor_plan_prompt → LLM → numbered_elements + camera_recommendations + t2i_prompt
        ▼
floor_plan_render.render_one_floor_plan(prompt=t2i_prompt, …)  # 얇은 렌더러, prompt만 받음
        ▼  → FP PNG  (프롬프트 고치면 spec+render 동시교정, render 코드 변경 불필요)

4. 설계 결정 (Codex 2라운드 합의)

4.1 space_type 도출 규칙

space_type / surface_role_mix / open_safe는 prompt-input diagnostic 값 — FP output schema(numbered_elements/camera_recommendations) 필드가 아니다. 도출은 enum 집합연산(글자/substring 파싱 0 = 절대규칙 준수).

4.2 v8 공간유형 분기 (system.md)

5. ★ 수정 계획서 (파일별 상세)

Codex 5단계 순서 + A/B/C 확정 반영. 구현 순서 = 의존 역순(pure helper → builder → pack → wiring → canary)로, 각 단계가 독립 green.

_SPACE_TYPE_PRIORITY = ["interior_room", "transition_zone", "exterior_plate", "site_surface"]
_OPEN_SAFE = "open_safe"

def derive_fp_space_type(applied_backgrounds) -> tuple[str, list[str]]:
    """applied_bgs의 surface_role 집합으로 fp 공간유형 도출.
    반환: (space_type, surface_role_mix). 순수 enum 집합연산 — 글자 파싱 0."""
    roles = [b.get("surface_role", "") for b in applied_backgrounds
             if b.get("surface_role")]
    uniq = sorted(set(roles))
    if not uniq:                      # empty → open_safe (interior 금지)
        return _OPEN_SAFE, []
    if len(uniq) == 1:                  # consensus = SOT
        return uniq[0], uniq
    for r in _SPACE_TYPE_PRIORITY:        # 이상치만 conservative priority
        if r in uniq:
            return r, uniq
    return _OPEN_SAFE, uniq            # 미지 enum 방어

def build_fp_user_prompt(fp_spec, applied_backgrounds, applied_shots,
        scene_segments, visual_world_rules, prompt_version="5",
        space_type="", surface_role_mix=None):     # ★ 신규 kwargs
    ...
    # space_type 비어있으면(=selector 5/6/7 경로) block은 "" → 토큰 없어 무영향
    space_type_block = _build_space_type_block(space_type, surface_role_mix) if space_type else ""
    return (template
        .replace("{fp_id}", …)
        … # 기존 7개 그대로
        .replace("{space_type_block}", space_type_block))  # ★ 추가

6. 테스트 계획 (deterministic = TDD)

※ 절대규칙: PASS 카운트는 deterministic 안전망일 뿐 — 프롬프트/렌더 품질 검증 아님. "테스트 통과 = 동작 검증"으로 보고 금지.

7. canary 검증 계획 (완성도 gate)

1. 1단계 — surface_role 확인: 각 canary fp의 실제 surface_role을 background_master_plan cp에서 직접 조회(cp 불변 유지, Codex B). 옥상이 정말 exterior_plate로 부여됐는지 등 확인.
2. 2단계 — selector "8" 재생성 + 갤러리 비교:

비용: canary image 소액(자율 범위). 결과는 사용자 visual gate. image model은 기존 gpt-image-2(sidecar와 무관, FP 본 렌더).

8. 경계 lock & 절대규칙 준수

9. Codex 협업 기록 (2026-06-01, gpt-5.5 xhigh)

• 설계 1R (Q1–Q4): consensus+priority(이상치만) / exterior 경량 open diagram 유지(skip 아님) / site=open-surface family / v8 opt-in / empty→open_safe.
• brief 리뷰 2R: Required #1(system-only 금지) · Required #2(어선 overclaim — wheelhouse interior_room이면 과분할 잔존, vehicle 후속) · 답변(1)(2)(validator 재사용 / Rule43 전type 유지) · non-blocking(open_safe diagnostic / site canary 분리) — 전부 반영.
• 수정계획 A/B/C: A=derive_fp_space_type는 모듈 pure helper / B=prompt-input only(cp 불변, SCHEMA bump 없음) / C=selector "8" pack명으로 config_hash 충분, 별도 hash 불필요.

Codex 의견은 모두 검증 후 채택. 특히 Q1은 Codex의 "interior 무조건 우선"을 "이상치에만 발동"으로 좁혔고, 어선 overclaim은 내가 검증해 수정함(verify-codex-not-blindly).

10. open items / 후속

• vehicle/cabin subtype: 선박/차량 특화 layout(갑판/선실)은 후속 wave. surface_role enum에 vehicle 없음 → 추가 여부는 master_plan 작업과 함께 별도 결정.
• master_plan surface_role 정확도: 옥상이 exterior_plate로 정확히 부여되는지 canary 1단계에서 확인. 오부여 시 본 fix만으로 불충분 → master_plan 분류 작업 선행(별도 brief).
• open_safe 빈도: applied_bgs empty fp가 실제로 얼마나 나오는지 canary에서 집계.
• 운영 관측용 stamp: space_type을 cp에 남길 필요가 생기면 별도 SCHEMA bump로 추가(v0 범위 외, Codex B).

관련: brief.md(동일 폴더, 텍스트 원본) · 선행 진입점 메모리 session-20260601-w21b-w5-fp-spacetype-brief.