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/user_overrides_write.test.ts

@@ -46,6 +46,7 @@ import {
   applyPersistedNonFrameOverrides,
   createInitialUserSelection,
   deriveUserOverridesKey,
+  mergeSubmittedPipelineOverridesForRestore,
   remapPersistedFramesToZoneFrames,
 } from "../src/utils/slidePlanUtils";
 import type { SlidePlan, Zone } from "../src/types/designAgent";
@@ -559,6 +560,65 @@ describe("restore-on-reopen end-to-end (IMP-52 u10)", () => {
     });
   });
 
+  it("post-run restore prefers the submitted Generate payload over stale persisted axes", () => {
+    const restoreDoc = mergeSubmittedPipelineOverridesForRestore(
+      {
+        layout: "vertical-2",
+        frames: { "03-1": "stale_frame" },
+        zone_geometries: { left: { x: 0, y: 0, w: 0.4, h: 1 } },
+        zone_sections: { left: ["03-2"], right: ["03-1"] },
+        manual_section_assignment: true,
+        text_overrides: { top: { "title.0": "keep text edit" } },
+      },
+      {
+        frames: { "03-1": "current_frame" },
+      },
+      false,
+    );
+
+    expect(restoreDoc.layout).toBeUndefined();
+    expect(restoreDoc.frames).toEqual({ "03-1": "current_frame" });
+    expect(restoreDoc.zone_geometries).toBeUndefined();
+    expect(restoreDoc.zone_sections).toBeUndefined();
+    expect(restoreDoc.manual_section_assignment).toBe(false);
+    expect(restoreDoc.text_overrides).toEqual({
+      top: { "title.0": "keep text edit" },
+    });
+  });
+
+  it("converts the submitted Generate payload back to persisted-axis names for restore", () => {
+    const restoreDoc = mergeSubmittedPipelineOverridesForRestore(
+      {},
+      {
+        layout: "top-1-bottom-2",
+        frames: { "01-intro": "three_parallel_requirements" },
+        zoneGeometries: {
+          top: { x: 0, y: 0, w: 1, h: 0.35 },
+          bottom: { x: 0, y: 0.35, w: 1, h: 0.65 },
+        },
+        zoneSections: {
+          top: ["01-intro"],
+          bottom: ["01-1", "01-2"],
+        },
+      },
+      true,
+    );
+
+    expect(restoreDoc.layout).toBe("top-1-bottom-2");
+    expect(restoreDoc.frames).toEqual({
+      "01-intro": "three_parallel_requirements",
+    });
+    expect(restoreDoc.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.35 },
+      bottom: { x: 0, y: 0.35, w: 1, h: 0.65 },
+    });
+    expect(restoreDoc.zone_sections).toEqual({
+      top: ["01-intro"],
+      bottom: ["01-1", "01-2"],
+    });
+    expect(restoreDoc.manual_section_assignment).toBe(true);
+  });
+
   it("missing persisted file (GET returns {}) leaves the selection at backend defaults", async () => {
     fetchMock.mockResolvedValueOnce(mockResponse({}));
     const persisted = await getUserOverrides(deriveUserOverridesKey("new_file.mdx"));