wip: phase_z2 evidence 파이프라인 + matching 실험(phase2~26) + 프론트 trace 패널 진행분 스냅샷

- src: phase_z2 composition/mapper/pipeline/placement_planner/retry, ai_fallback(prompts/schema/validate), mdx_text_atoms 신규
- Front: PipelineTracePanel 신규, FramePanel/SlideCanvas/Home/designAgentApi 등 갱신 + 테스트 4종 추가
- templates/phase_z2: catalog(component_expansion_registry, node_slot_mapping 신규), frames, families, slide_base 갱신
- tests/matching: phase2~26 매칭 실험 스크립트·리포트·온톨로지 전체 (미커밋 진행분)
- tests: b4_v4 evidence, task5~28.5 시리즈, regression(imp95 baseline) 등 신규 테스트 대량 추가
- docs/reference: MDX 구조 인벤토리, MDX→Frame 구조 계약 문서
- scripts: mdx 계약/parity/coverage/viewport 체크, gitea comment, run sync 유틸
- .gitignore: tmp*.json, chromedriver, .orchestrator, *.pkl, Front_test* 등 임시/스냅샷 제외

미완성 작업의 보존용 스냅샷 커밋 (2026-07-02)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

tests/matching/ATTACH_05_SAMPLES.html

@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html lang="ko"><head><meta charset="utf-8"><title>첨부 5 — fit-v2 샘플</title>
+<style>
+@page { size: A4 portrait; margin: 14mm 14mm 16mm 14mm; }
+* { box-sizing: border-box; }
+body {
+    font-family: -apple-system, "Segoe UI", Pretendard, "Malgun Gothic", "Apple SD Gothic Neo", sans-serif;
+    background: white; color: #1e293b; margin: 0;
+    font-size: 10pt; line-height: 1.45;
+}
+@media print {
+    body { margin: 0; }
+    .avoid-break { page-break-inside: avoid; }
+    .page-break { page-break-before: always; }
+}
+@media screen {
+    body { max-width: 210mm; margin: 10mm auto; box-shadow: 0 4px 24px rgba(0,0,0,0.12); padding: 14mm; background: #fff; }
+}
+h1 { font-size: 15pt; border-bottom: 2pt solid #2563eb; padding-bottom: 4pt; margin: 0 0 6pt 0; color: #0f172a; }
+h2 { font-size: 11pt; color: #1e293b; margin: 10pt 0 5pt; padding: 3pt 6pt; background: #e0e7ff; border-left: 3pt solid #0a6; border-radius: 2pt; }
+h3 { font-size: 10pt; margin: 6pt 0 3pt; color: #1a365d; font-weight: 700; }
+p { margin: 4pt 0; }
+.meta-bar { color: #64748b; font-size: 8.5pt; margin: -3pt 0 8pt; font-style: italic; }
+.note { background: #fef3c7; border-left: 3pt solid #f59e0b; padding: 4pt 8pt; margin: 6pt 0; font-size: 9pt; color: #78350f; border-radius: 2pt; }
+.fail-note { background: #fee2e2; border-left: 3pt solid #dc2626; padding: 4pt 8pt; margin: 4pt 0; font-size: 9pt; color: #991b1b; border-radius: 2pt; }
+.ok-note { background: #d1fae5; border-left: 3pt solid #059669; padding: 4pt 8pt; margin: 4pt 0; font-size: 9pt; color: #065f46; border-radius: 2pt; }
+.mdx-card { background: #f8fafc; border: 0.5pt solid #cbd5e1; border-radius: 4pt; padding: 6pt 8pt; margin: 4pt 0; }
+.mdx-title { font-weight: 700; color: #0f172a; font-size: 10.5pt; margin-bottom: 2pt; }
+.mdx-excerpt { color: #475569; font-size: 9pt; margin: 2pt 0 4pt; line-height: 1.4; }
+.kw-chip { display: inline-block; padding: 1pt 6pt; background: #dbeafe; color: #1e40af; border-radius: 8pt; font-size: 8pt; margin: 1pt 2pt 1pt 0; font-family: ui-monospace, monospace; }
+.kw-set-chip { background: #fce7f3; color: #9f1239; }
+.kw-rel-chip { background: #e0e7ff; color: #3730a3; }
+table { border-collapse: collapse; width: 100%; font-size: 9pt; margin: 4pt 0; }
+th, td { border: 0.5pt solid #cbd5e1; padding: 3pt 5pt; text-align: left; vertical-align: top; }
+th { background: #1e293b; color: white; font-weight: 700; font-size: 8.5pt; }
+code { background: #f1f5f9; padding: 0 3pt; border-radius: 2pt; font-family: ui-monospace, Menlo, monospace; font-size: 8.5pt; color: #0f172a; }
+.frame-thumb { max-width: 100%; height: auto; border: 0.5pt solid #94a3b8; border-radius: 3pt; display: block; }
+.frame-cell { text-align: center; vertical-align: top; padding: 3pt; }
+.frame-label { font-size: 8.5pt; color: #0f172a; font-weight: 600; margin-top: 2pt; }
+.frame-score { font-family: ui-monospace, monospace; font-size: 8pt; color: #059669; }
+.frame-desc { font-size: 7.5pt; color: #64748b; line-height: 1.25; margin-top: 1pt; }
+.label-badge { display: inline-block; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 700; }
+.label-use_as_is { background: #d1fae5; color: #065f46; }
+.label-light_edit { background: #dbeafe; color: #1e40af; }
+.label-restructure { background: #fef3c7; color: #92400e; }
+.label-reject { background: #fee2e2; color: #991b1b; }
+.answer-box { background: #fff3cd; border: 1.5pt solid #dc2626; border-radius: 3pt; padding: 2pt; }
+.flex-grid { display: table; width: 100%; border-spacing: 0; }
+.flex-row { display: table-row; }
+.flex-cell { display: table-cell; vertical-align: top; padding: 2pt; }
+ol.steps { margin: 4pt 0; padding-left: 16pt; }
+ol.steps li { margin: 3pt 0; line-height: 1.5; }
+.step-title { font-weight: 700; color: #1e293b; }
+.step-fail { color: #991b1b; font-size: 8.5pt; font-style: italic; }
+.step-ok { color: #065f46; font-size: 8.5pt; }
+
+/* V1 매칭 상세 (ATTACH_01) 전용 */
+.page-header-small { font-size: 8pt; color: #64748b; text-align: right; margin: 0 0 2pt 0; }
+.frame-match { border: 0.5pt solid #cbd5e1; border-radius: 4pt; padding: 6pt 8pt; margin: 4pt 0; background: #fafafa; }
+.frame-match.answer { border: 1pt solid #dc2626; background: #fffbeb; }
+.frame-match h3 { margin: 0 0 3pt 0; font-size: 10pt; }
+.fm-body { display: table; width: 100%; }
+.fm-thumb { display: table-cell; width: 32mm; vertical-align: top; padding-right: 6pt; }
+.fm-thumb img { max-width: 30mm; height: auto; border: 0.5pt solid #94a3b8; border-radius: 2pt; display: block; }
+.fm-thumb .frame-desc { font-size: 7pt; color: #64748b; margin-top: 2pt; line-height: 1.25; }
+.fm-detail { display: table-cell; vertical-align: top; }
+.kw-line { margin: 3pt 0; font-size: 8.5pt; line-height: 1.4; }
+.kw-line strong { color: #0f172a; font-weight: 700; }
+.hit-chip { color: #065f46; background: #d1fae5; padding: 1pt 5pt; border-radius: 2pt; font-size: 8pt; display: inline-block; margin: 0 2pt; }
+.miss-chip { color: #991b1b; background: #fee2e2; padding: 1pt 5pt; border-radius: 2pt; font-size: 8pt; display: inline-block; margin: 0 2pt; }
+.hit-inline { color: #065f46; font-weight: 600; }
+.miss-inline { color: #991b1b; }
+.ratio { color: #64748b; font-family: ui-monospace, monospace; font-size: 7.5pt; }
+.frame-match ul { margin: 2pt 0; padding-left: 14pt; font-size: 8.5pt; }
+.frame-match li { line-height: 1.4; margin: 1pt 0; }
+.section-tag { display: inline-block; padding: 2pt 6pt; border-radius: 2pt; font-size: 8pt; font-weight: 700; margin-left: 4pt; vertical-align: middle; }
+.tag-matched { background: #d1fae5; color: #065f46; }
+.tag-unmatched { background: #fee2e2; color: #991b1b; }
+</style></head><body><h1>첨부 5 — fit-v2 적합 샘플</h1><div class="meta-bar">단순 구조 매칭이 아닌 template-fit-v2 판정이 필요한 이유를 3 가지 상황(V1 강함 / V1 약함 / V1 강함 but 재구성 필요) 으로 보여줌.</div><div class="avoid-break"><h2>사례 1 — V1 강함 + V4 use_as_is (사용 가능 확인) — 01-2 · 2. 용어간 상호관계</h2><div class="mdx-card"><div class="mdx-excerpt">DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념 / 건설산업의 DX는 GIS(공간정보), BIM, 디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능 / GIS의 …</div></div><table><thead><tr><th style="width:25%">축</th><th>값</th></tr></thead><tbody><tr><td>V1 점수 (키워드)</td><td><code>0.937</code> → Frame 18</td></tr><tr><td>V4 1위</td><td>Frame 18 conf <code>0.946</code> <span class="label-badge label-use_as_is">use_as_is</span></td></tr><tr><td>V4 axes 분해</td><td>anchor <code>1.0</code> · cardinality <code>1.0</code> · relation <code>1.0</code> · slot <code>1.0</code> · content <code>0.7295</code> · penalty <code>0.0</code></td></tr></tbody></table><div style="text-align:center;margin:4pt 0"><div class="answer-box" style="display:inline-block"><img src="data:image/png;base64,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 truncated