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>
2026-07-02 17:03:42 +09:00
parent 97b7833a1b
commit b836e79ee1
527 changed files with 673036 additions and 717 deletions
@@ -0,0 +1,101 @@
+from types import SimpleNamespace
+
+from src.phase_z2_pipeline import _build_t28_5c_reselection_trace
+
+
+def _candidate(template_id, status="auto_renderable", label="use_as_is"):
+    return SimpleNamespace(
+        template_id=template_id,
+        frame_id=f"frame-{template_id}",
+        label=label,
+        candidate_status=status,
+    )
+
+
+def test_t28_5c_abort_trace_finds_eligible_frame_alternative():
+    units = [
+        SimpleNamespace(
+            source_section_ids=["02-2"],
+            frame_template_id="three_parallel_requirements",
+            v4_candidates=[
+                _candidate("three_parallel_requirements"),
+                _candidate("three_persona_benefits"),
+                _candidate("pre_construction_model_info_stacked", "ai_adaptation_required", "reject"),
+            ],
+        ),
+        SimpleNamespace(source_section_ids=["02-1"], frame_template_id="construction_goals_three_circle_intersection", v4_candidates=[]),
+    ]
+    trace = _build_t28_5c_reselection_trace(
+        units=units,
+        debug_zones=[
+            {
+                "position": "right",
+                "source_section_ids": ["02-2"],
+                "template_id": "three_parallel_requirements",
+            }
+        ],
+        layout_preset="vertical-2",
+        router_decision={"proposed_actions_summary": ["abort"]},
+        presentation_fit={
+            "passed": False,
+            "zones": [{"position": "right", "overflow_px": 165, "overflow_x_px": 0}],
+        },
+    )
+
+    assert trace["triggered"] is True
+    assert trace["policy"] == "trace_only_no_silent_swap"
+    zone = trace["zones"][0]
+    assert zone["current_template_id"] == "three_parallel_requirements"
+    assert zone["eligible_candidate_count"] == 1
+    assert zone["selected_candidate"]["template_id"] == "three_persona_benefits"
+    assert zone["candidates"][0]["ineligible_reason"] == "current_template"
+    assert zone["candidates"][2]["coverage_state"] == "requires_adaptation"
+    assert zone["candidates"][2]["eligible"] is False
+    assert trace["next_step"] == "frame_or_layout_candidate_available"
+
+
+def test_t28_5c_manual_geometry_blocks_layout_reselection_only():
+    trace = _build_t28_5c_reselection_trace(
+        units=[
+            SimpleNamespace(source_section_ids=["a"], frame_template_id="three_parallel_requirements", v4_candidates=[]),
+            SimpleNamespace(source_section_ids=["b"], frame_template_id="three_parallel_requirements", v4_candidates=[]),
+        ],
+        debug_zones=[
+            {
+                "position": "right",
+                "source_section_ids": ["b"],
+                "template_id": "three_parallel_requirements",
+            }
+        ],
+        layout_preset="vertical-2",
+        router_decision={"proposed_actions_summary": ["abort"]},
+        presentation_fit={
+            "passed": False,
+            "zones": [{"position": "right", "overflow_px": 100, "overflow_x_px": 0}],
+        },
+        override_zone_geometries={"right": {"x": 0.45, "y": 0, "w": 0.55, "h": 1}},
+    )
+
+    assert trace["triggered"] is True
+    assert trace["manual_zone_positions"] == ["right"]
+    assert trace["zones"][0]["manual_geometry_applied"] is True
+    assert trace["layout_reselection"]["allowed"] is False
+    assert trace["layout_reselection"]["blocked_reason"] == "manual_geometry_present"
+    assert trace["next_step"] == "escalate_to_t28_5d_or_presentation_not_ready"
+
+
+def test_t28_5c_no_abort_no_reselection_trigger():
+    trace = _build_t28_5c_reselection_trace(
+        units=[],
+        debug_zones=[],
+        layout_preset="single",
+        router_decision={"proposed_actions_summary": ["zone_ratio_retry"]},
+        presentation_fit={
+            "passed": False,
+            "zones": [{"position": "primary", "overflow_px": 10, "overflow_x_px": 0}],
+        },
+    )
+
+    assert trace["triggered"] is False
+    assert trace["zones"]
+    assert trace["layout_reselection"]["evaluated"] is False