diff --git a/PROJECT_STATE_2026-07-03.md b/PROJECT_STATE_2026-07-03.md new file mode 100644 index 0000000..1620ffa --- /dev/null +++ b/PROJECT_STATE_2026-07-03.md @@ -0,0 +1,85 @@ +# 프로젝트 전체 그림 — 2026-07-03 종합 + +> 근거: Gitea C.E.L_Slide_test2 이슈 #43~#98 (56건) + #98 코멘트 95개 전문 (5/27~6/4) +> + repo 문서/코드 실측 + GitHub keimin86/design_agent 이슈 #1~#12 처리 결과. + +## 1. 연대기 (무엇이 언제 일어났나) + +| 시기 | 축 | 내용 | +|---|---|---| +| ~4월 | 기반 구축 | Phase 1~5/T/V: 블록 46개, renderer, 적합성 검증 (31/31). figma_to_html_agent 완성 (32 frame 변환, 8개 promoted) | +| 4월 말 | 매칭 시스템 | tests/matching V1~V4 구축. **TARGET 4/4** (v4_full32, 4/29) — 문서의 "3/4"는 낡은 기록 | +| 5월 | IMP wave | Gitea #43~#95: overflow chain(IMP-34/35/36), AI fallback 실선화(IMP-33/46/47B), 사용자 편집·영속(IMP-51/52/54/90), Layer A(#89→94/95/96 분할) 등 50건 closed | +| 5/26 | Emergency | mdx 01~05 empty shell 발생 → root cause 3개(C1/C2/C3) 진단, P2~P5 정책 확정 (emergency.md) | +| 5/27~6/4 | **#98 E2E 스퍼트** | Task 0~13으로 사용자 체감 품질 복구 (아래 §2). 로컬 수정만, 커밋 없이 중단 | +| 6/4~7/2 | 공백 | 미커밋 상태로 방치 (다른 프로젝트 작업) | +| 7/2~3 | 보존+정리 | 스냅샷 커밋 b836e79 push. GitHub 이슈 12건 등록, 5건 처리 (#1,#4,#9,#10,#12) | + +## 2. #98 스퍼트가 이룬 것 (Task 0~13, 5/27~6/4) + +달성 (모든 mdx): 텍스트 손실 0 (missing_atoms=0) / section 순서·분리 보존 / +`__empty__` zone 제거 / markdown 문법 노출 제거 / clean generate (--ignore-user-overrides) / +false PASS 차단 / stale overlay 제거 / AI trace 관측성. + +**6/4 최종 5-MDX presentation readiness** (마지막 코멘트 30028): + +| MDX | 기계 판정 | 사람 판정 | 남은 문제 | +|---|---|---|---| +| 01 | PASS | needs_review | generic fallback (intro), bottom dense | +| 02 | PASS | **needs_review** | **false-positive 최악** — 카드 cramped, density gate 없음 | +| 03 | PASS | ready | 유일한 design-matched ✓ | +| 04 | VISUAL_REGRESSION | not_ready | overflow 실재 (honest fail) — height-fit 필요 | +| 05 | PASS | needs_review | 양쪽 zone generic fallback — design matching 필요 | + +## 3. 7/2~3 세션이 추가로 해결한 것 + +- **#12**: SlideCanvas.tsx 한글 손상 복구 (ad10657) +- **#9-P4**: AI proposal envelope 버그 — #98 Task 12가 남긴 "AI 호출되나 no_proposal" 문제의 근본 원인이 envelope 미명시였음을 확인·수정 (9717898). 이제 design_adaptation_plan이 **검증 통과** (apply 계층만 미구현) +- **#10**: V4 evidence trace가 P4b 복구 경로에서 유실되던 것 수정 (d75c063) — Gitea #95(89-c)의 실질 마무리 +- 전제가 낡은 이슈 정정: #1 (변환기 이미 push됨), #4 (TARGET 이미 4/4) +- 발견: tests/phase_z2 기존 실패 11건 (layout cols / fixtures / imp88 salvage / step17 — #98 스퍼트의 WIP 잔재로 추정) + +## 4. 남은 갭 — 목표 축별 정리 + +### 목표 A: Figma→HTML 정확 변환 +- frame 커버리지 8/32 promoted — 매칭 성공해도 partial 없어 못 그리는 frame 존재 (GitHub #2) +- **MDX01/05 generic fallback 탈출이 이 축의 실전 과제** — catalog matching 개선 또는 AI adaptation (#98 추천 4번) +- provenance 손실 (GitHub #3, P3) + +### 목표 B: 콘텐츠 의미 → HTML 반영 +- **design_adaptation_plan apply 계층 미구현** — proposal 검증까지 도달, 적용만 남음 (GitHub #7과 통합, #98 Task 12의 완결) +- T25 node_slot_mapping runtime 배선 (GitHub #7) +- 분류 LLM화 (GitHub #5), V4 가중치 재조정 (GitHub #6) — 방법론 개선, 후순위 + +### 목표 C: 품질 게이트 신뢰성 (#98이 남긴 최우선) +- **density/readability gate** — MDX02 false-positive 차단 (#98 추천 1·2번) +- **MDX04 height-fit escalation** — overflow 해소 (#98 추천 3번) +- readiness 신호 통합 (text coverage + design_readiness + density) +- popup/details live fixture (#98 추천 5번) +- 기존 테스트 실패 11건 수복 + +### 인프라 큐 (Gitea #97 Queue Tracker, paused 5/26) +- P0: #91 multi-sample regression CI → #71 진단 도구 → #73 mismatch warning → … +- 열린 축: #55 (contract validator, deferred), #66 (IMP-37 stage0 normalizer ★), #83 (AI 결과 자산화, Future), #96 (89-d marker) + +## 5. 권장 다음 스퍼트 (우선순위) + +1. **기존 실패 11건 수복** — 이후 작업의 회귀 판별 기반 +2. **design_adaptation_plan apply 계층** (GitHub #7 + #98 Task 12 완결) — AI 재배치가 실제로 동작해야 MDX01/05 generic fallback 탈출과 MDX04 height-fit에 모두 쓰임 +3. **density/readability gate** (MDX02) + **MDX04 height-fit** — 사람 판정과 기계 판정의 간극 해소 +4. **MDX05/01 design matching** — frame 커버리지 확장(#2)과 연동 +5. Gitea #91 (regression CI) — 위 작업들의 안전망 자동화 + +## 6. 이슈 트래커 대응표 + +| GitHub (7/2 등록) | Gitea 대응 | 상태 | +|---|---|---| +| #1 변환기 통합 | — | closed (전제 낡음) | +| #4 02-2.2 교정 | — | closed (이미 4/4) | +| #9 Emergency P2~P5 | emergency.md, #98 Task 10 | closed (P4 수정 완료) | +| #10 V4 evidence 배선 | #95 (89-c) | closed (trace 유실 수정) | +| #12 인코딩 복구 | — | closed | +| #7 슬롯 매핑+apply | #98 Task 12, #83 선행 | **open — 다음 핵심** | +| #2 frame 32개 완성 | #98 추천 4 (design matching) | open | +| #11 trace 계약 검증 | #98 Task 6/7 (구현됨 — 검증만) | open (경량화 가능) | +| #5, #6, #8, #3 | 방법론/보강 | open (후순위) |