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>

Front/client/tests/render_stale_guard.test.ts

@@ -0,0 +1,58 @@
+import { describe, expect, it } from "vitest";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+const HOME_TSX = readFileSync(
+  resolve(__dirname, "..", "src", "pages", "Home.tsx"),
+  "utf-8",
+);
+const SLIDE_CANVAS_TSX = readFileSync(
+  resolve(__dirname, "..", "src", "components", "SlideCanvas.tsx"),
+  "utf-8",
+);
+
+function sliceHandleGenerateBody(source: string): string {
+  const startMarker = "const handleGenerate = useCallback(async () =>";
+  const startIdx = source.indexOf(startMarker);
+  if (startIdx === -1) throw new Error("handleGenerate declaration not found");
+  const afterStart = source.slice(startIdx + startMarker.length);
+  const nextDeclIdx = afterStart.search(/\n {2}const [A-Za-z]/);
+  return nextDeclIdx === -1 ? afterStart : afterStart.slice(0, nextDeclIdx);
+}
+
+const HANDLE_GENERATE_BODY = sliceHandleGenerateBody(HOME_TSX);
+
+describe("#98 Task 4 render stale guard", () => {
+  it("clears prior runMeta before invoking runPipeline", () => {
+    const clearIdx = HANDLE_GENERATE_BODY.indexOf("setRunMeta(null)");
+    const loadingIdx = HANDLE_GENERATE_BODY.indexOf("isLoading: true");
+    const runPipelineIdx = HANDLE_GENERATE_BODY.indexOf("runPipeline(");
+
+    expect(clearIdx).toBeGreaterThan(-1);
+    expect(loadingIdx).toBeGreaterThan(-1);
+    expect(runPipelineIdx).toBeGreaterThan(-1);
+    expect(clearIdx).toBeLessThan(runPipelineIdx);
+    expect(loadingIdx).toBeLessThan(runPipelineIdx);
+  });
+
+  it("does not pass a finalHtmlUrl to SlideCanvas while a pipeline run is loading", () => {
+    expect(HOME_TSX).toContain(
+      "finalHtmlUrl={state.isLoading ? undefined : runMeta?.final_html_url}",
+    );
+  });
+
+  it("forces iframe remounts by keying the iframe on embeddedSrc", () => {
+    expect(SLIDE_CANVAS_TSX).toContain("key={embeddedSrc}");
+  });
+
+  it("resets iframe-derived overlay state on render url, loading, or pending-layout changes", () => {
+    expect(SLIDE_CANVAS_TSX).toContain(
+      "}, [finalHtmlUrl, isPipelineRunning, isPendingLayout]);",
+    );
+    expect(SLIDE_CANVAS_TSX).toContain("setMeasuredZones({});");
+    expect(SLIDE_CANVAS_TSX).toContain("setMeasuredImages({});");
+    expect(SLIDE_CANVAS_TSX).toContain("setSelectedImageId(null);");
+    expect(SLIDE_CANVAS_TSX).toContain("setDragOverZoneId(null);");
+    expect(SLIDE_CANVAS_TSX).toContain("setEditMode(\"off\");");
+  });
+});