test: 통합 스냅샷 재생성 스크립트 추가 + 회귀 테스트 갱신 (#29 후속 작업분)

- tests/integration/scripts/regenerate_snapshots.py: 스냅샷 일괄 재생성 도구
- 통합 스냅샷 9종 갱신, 회귀/유닛 테스트 7건 보강
- ISSUE_DRAFTS_2026-07-02.md: 7/2 전수 검토 이슈 초안 보존

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.claude/settings.json

@@ -400,7 +400,88 @@
       "Read(//tmp/**)",
       "Read(//d/tmp/**)",
       "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test5)",
-      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test7)"
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test7)",
+      "Bash(git commit -m ' *)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\"; \"Content-Type\" = \"application/json\" }; $body = @{ state = \"open\" } | ConvertTo-Json; Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/90\" -Method Patch -Headers $headers -Body $body | Select-Object number, state, title)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $resp = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/90\" -Method Get -Headers $headers; \"#$\\($resp.number\\) state=$\\($resp.state\\) title=$\\($resp.title\\)\")",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\"; \"Content-Type\" = \"application/json\" }; $body = @{ state = \"closed\" } | ConvertTo-Json; $bytes = [System.Text.Encoding]::UTF8.GetBytes\\($body\\); Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/90\" -Method Patch -Headers $headers -Body $bytes | Select-Object number, state, closed_at, title | Format-List)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $all = @\\(\\); $page = 1; do { $url = \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues?state=closed&type=issues&page=$page&limit=50\"; $batch = Invoke-RestMethod -Uri $url -Method Get -Headers $headers; $all += $batch; $page++ } while \\($batch.Count -eq 50\\); \"Total closed issues: $\\($all.Count\\)\"; $all | Select-Object number, title | Sort-Object number | Format-Table -AutoSize -Wrap)",
+      "Bash(git log *)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; foreach \\($n in 14, 64, 74, 91\\) { $r = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/$n\" -Method Get -Headers $headers; \"#$\\($r.number\\) state=$\\($r.state\\) closed_at=$\\($r.closed_at\\)\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $issue = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84\" -Method Get -Headers $headers; \"=== #84 META ===\"; \"state=$\\($issue.state\\) created=$\\($issue.created_at\\) closed=$\\($issue.closed_at\\)\"; \"title=$\\($issue.title\\)\"; \"\"; \"=== #84 BODY ===\"; $issue.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $comments = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84/comments\" -Method Get -Headers $headers; \"=== #84 COMMENT COUNT: $\\($comments.Count\\) ===\"; \"\"; $i = 0; foreach \\($c in $comments\\) { $i++; $bodyPreview = $c.body.Substring\\(0, [Math]::Min\\(200, $c.body.Length\\)\\); \"--- [$i] id=$\\($c.id\\) created=$\\($c.created_at\\) ---\"; \"$bodyPreview\"; \"\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $r = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/83\" -Method Get -Headers $headers; \"#83 state=$\\($r.state\\) closed_at=$\\($r.closed_at\\) title=$\\($r.title\\)\")",
+      "Bash(git status *)",
+      "Bash(python -m py_compile orchestrator.py)",
+      "Bash(echo \"origin = $\\(git ls-remote origin refs/heads/main)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\"; \"Content-Type\" = \"application/json\" }; $body = @{ state = \"open\" } | ConvertTo-Json; Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/83\" -Method Patch -Headers $headers -Body $body | Select-Object number, state, closed_at, title | Format-List)",
+      "Bash(git restore *)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $r83 = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/83\" -Method Get -Headers $headers; \"#83 state=$\\($r83.state\\) closed_at=[$\\($r83.closed_at\\)] labels=[$\\($r83.labels.Count\\)]\")",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84/comments?limit=100\" -Method Get -Headers $headers; \"#84 current comment count = $\\($cs.Count\\)\")",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84/comments?limit=100\" -Method Get -Headers $headers; \"Total comments now: $\\($cs.Count\\)\"; \"Recent 3:\"; $cs | Select-Object -Last 3 | ForEach-Object { $preview = $_.body.Substring\\(0, [Math]::Min\\(80, $_.body.Length\\)\\); \"  id=$\\($_.id\\) [$preview...]\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $r = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84\" -Method Get -Headers $headers; \"#84 Gitea: state=$\\($r.state\\) closed_at=[$\\($r.closed_at\\)]\")",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\"; \"Content-Type\" = \"application/json\" }; $body = @{ state = \"closed\" } | ConvertTo-Json; $bytes = [System.Text.Encoding]::UTF8.GetBytes\\($body\\); Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84\" -Method Patch -Headers $headers -Body $bytes | Select-Object number, state, closed_at, title | Format-List)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $r84 = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/84\" -Method Get -Headers $headers; \"#84 state=$\\($r84.state\\) closed_at=$\\($r84.closed_at\\)\"; \"\"; \"orchestrator HEAD = $\\(git rev-parse HEAD\\)\"; \"orchestrator fix commits in chain:\"; git log --oneline -3 -- orchestrator.py)",
+      "Bash(python -m py_compile src/phase_z2_pipeline.py)",
+      "Bash(grep -n \"^import re\\\\|^import re$\" src/phase_z2_pipeline.py)",
+      "Bash(grep -n \"^import os\\\\|^import os$\" src/phase_z2_pipeline.py)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/05.mdx mdx05_emergency_p3)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/04.mdx mdx04_emergency_p3)",
+      "Bash(python -c \"from src.config import settings; print\\(f'ai_fallback_enabled={settings.ai_fallback_enabled} model={settings.ai_fallback_model} has_api_key={bool\\(settings.anthropic_api_key\\)}'\\)\")",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/05.mdx mdx05_emergency_p4)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/04.mdx mdx04_emergency_p4)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/04.mdx mdx04_emergency_p4b)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/04.mdx mdx04_p4b_full)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/03.mdx mdx03_layout_test --override-layout vertical-2)",
+      "Bash(python -m src.phase_z2_pipeline samples/mdx_batch/05.mdx mdx05_layout_test --override-layout horizontal-2)",
+      "Bash(cp data/user_overrides/*.json data/user_overrides_backup_20260526/)",
+      "Bash(rm -f data/user_overrides/*.json)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $issue = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/94\" -Method Get -Headers $headers; \"#94 state=$\\($issue.state\\)\"; \"title=$\\($issue.title\\)\"; \"\"; \"=== body ===\"; $issue.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/94/comments\" -Method Get -Headers $headers; \"Total comments: $\\($cs.Count\\)\"; foreach \\($c in $cs | Select-Object -Last 5\\) { \"--- comment_id=$\\($c.id\\) ---\"; $c.body.Substring\\(0, [Math]::Min\\(600, $c.body.Length\\)\\); \"\" })",
+      "Bash(git ls-tree *)",
+      "Bash(grep -i \".html$\")",
+      "Bash(grep \".html$\")",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $issue = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98\" -Method Get -Headers $headers; \"=== #$\\($issue.number\\) state=$\\($issue.state\\) ===\"; $issue.title; \"\"; \"=== BODY \\(truncated\\) ===\"; $issue.body.Substring\\(0, [Math]::Min\\(3000, $issue.body.Length\\)\\))",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $issue = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98\" -Method Get -Headers $headers; if \\($issue.body.Length -gt 3000\\) { $issue.body.Substring\\(3000, [Math]::Min\\(4000, $issue.body.Length - 3000\\)\\) })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; \"=== LATEST 2 comments ===\"; foreach \\($c in $cs | Select-Object -Last 2\\) { \"--- comment_id=$\\($c.id\\) created=$\\($c.created_at\\) ---\"; $c.body.Substring\\(0, [Math]::Min\\(3000, $c.body.Length\\)\\); \"\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; $last = $cs[-1]; if \\($last.body.Length -gt 3000\\) { $last.body.Substring\\(3000, [Math]::Min\\(4500, $last.body.Length - 3000\\)\\) })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; $last = $cs[-1]; if \\($last.body.Length -gt 7500\\) { $last.body.Substring\\(7500, $last.body.Length - 7500\\) })",
+      "Bash(echo '=== task8_e2e___TRACKED_VAR__ ===')",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28849\" -Method Get -Headers $headers; \"comment_id=$\\($c.id\\) created=$\\($c.created_at\\)\"; \"\"; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; \"=== Recent comments \\(last 8\\) — id / time / first line ===\"; foreach \\($c in $cs | Select-Object -Last 8\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; foreach \\($id in 28850, 28856, 28857, 28858, 28859\\) { $c = $cs | Where-Object { $_.id -eq $id }; if \\($c\\) { \"═══════════════════════════════════════════════════════\"; \"ID $id @ $\\($c.created_at\\)\"; \"═══════════════════════════════════════════════════════\"; $c.body.Substring\\(0, [Math]::Min\\(1800, $c.body.Length\\)\\); \"\" } })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; \"=== All comments after 28850 ===\"; foreach \\($c in $cs | Where-Object { $_.id -gt 28850 }\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; foreach \\($c in $cs | Where-Object { $_.id -gt 28850 }\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28868\" -Method Get -Headers $headers; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; foreach \\($c in $cs | Where-Object { $_.id -gt 28868 }\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28869\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\)\"; \"\"; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; foreach \\($c in $cs | Where-Object { $_.id -gt 28869 }\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; foreach \\($id in 28871, 28872, 28873, 28907\\) { $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/$id\" -Method Get -Headers $headers; \"═══ [$id] @ $\\($c.created_at\\) ═══\"; $c.body.Substring\\(0, [Math]::Min\\(2000, $c.body.Length\\)\\); \"\" })",
+      "Bash(python -m pytest -q tests/test_phase_z2_task15_summary_footer.py tests/test_phase_z2_task14_parent_units.py tests/test_mdx_text_atoms.py)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $cs = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/98/comments\" -Method Get -Headers $headers; \"Total: $\\($cs.Count\\)\"; \"\"; foreach \\($c in $cs | Where-Object { $_.id -gt 28907 }\\) { $first = \\($c.body -split \"`n\"\\)[0]; \"[$\\($c.id\\)] $\\($c.created_at\\) | $first\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28908\" -Method Get -Headers $headers; $c.body)",
+      "Bash(python -m pytest -q tests/test_phase_z2_task18_5_semantic_sanitizer.py)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28916\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\)\"; \"\"; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; foreach \\($id in 28928, 28929\\) { $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/$id\" -Method Get -Headers $headers; \"═══ [$id] @ $\\($c.created_at\\) \\($\\($c.body.Length\\) chars\\) ═══\"; $c.body.Substring\\(0, [Math]::Min\\(3000, $c.body.Length\\)\\); \"\" })",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28955\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\) @ $\\($c.created_at\\)\"; \"\"; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/28965\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\) @ $\\($c.created_at\\)\"; \"\"; $c.body)",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/29012\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\) @ $\\($c.created_at\\)\"; \"\"; $c.body.Substring\\(0, [Math]::Min\\(2500, $c.body.Length\\)\\))",
+      "PowerShell($token = [Environment]::GetEnvironmentVariable\\(\"GITEA_TOKEN\", \"User\"\\); $headers = @{ \"Authorization\" = \"token $token\" }; $c = Invoke-RestMethod -Uri \"https://gitea.hmac.kr/api/v1/repos/Kyeongmin/C.E.L_Slide_test2/issues/comments/29018\" -Method Get -Headers $headers; \"Length: $\\($c.body.Length\\) @ $\\($c.created_at\\)\"; \"\"; $c.body.Substring\\(0, [Math]::Min\\(2500, $c.body.Length\\)\\))",
+      "Bash(python scripts/check_mdx_source_parity.py --max-items 1)",
+      "Bash(sed -n '8025,8040p' src/phase_z2_pipeline.py)",
+      "Bash(python -m pytest tests/test_phase_z2_task22_section_tree.py -q)",
+      "Bash(python scripts/check_mdx_source_parity.py)",
+      "Bash(python -c \"import json; d=json.load\\(open\\('Front/package.json'\\)\\); print\\('scripts:', d.get\\('scripts'\\)\\)\")",
+      "Bash(python -c \"import json; d=json.load\\(open\\('Front_test_v515/package.json'\\)\\); print\\('name:', d.get\\('name'\\)\\); print\\('scripts:', d.get\\('scripts'\\)\\)\")",
+      "Bash(python -m pytest tests/test_phase_z2_task23_component_expansion.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task24_layout_policy.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task22_section_tree.py tests/test_phase_z2_task23_component_expansion.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task26_coverage_state.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task22_section_tree.py tests/test_phase_z2_task23_component_expansion.py tests/test_phase_z2_task24_layout_policy.py tests/test_phase_z2_task25_slot_mapping.py tests/test_phase_z2_task26_coverage_state.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task26_coverage_state.py tests/test_phase_z2_task25_slot_mapping.py tests/test_phase_z2_task23_component_expansion.py -q)",
+      "Bash(npx vitest *)",
+      "Bash(python -m pytest tests/test_phase_z2_task27_expand_state.py -q)",
+      "Bash(python -m pytest tests/test_phase_z2_task22_section_tree.py tests/test_phase_z2_task23_component_expansion.py tests/test_phase_z2_task24_layout_policy.py tests/test_phase_z2_task25_slot_mapping.py tests/test_phase_z2_task26_coverage_state.py tests/test_phase_z2_task27_expand_state.py -q)"
     ],
     "additionalDirectories": [
       "d:\\ad-hoc\\kei\\design_agent\\templates\\blocks\\new",

.github/workflows/multi-mdx-regression.yml

@@ -0,0 +1,71 @@
+name: Multi-MDX Regression (IMP-91)
+
+# IMP-#91 u13 — auto-gate the mdx 01-05 acceptance set on every push to main
+# and on PRs targeting main. Failure of any integration test blocks the
+# commit. JSON report is emitted via pytest-json-report (u12 dep) and
+# uploaded as an artifact for u14/u15 status-board updater consumption.
+#
+# [[feedback_validation_first_for_closed_issues]] — fresh subprocess per CI run.
+# [[feedback_auto_pipeline_first]] — no manual review queue; deterministic gate.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  multi-mdx-regression:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+
+      - name: Install Chrome and ChromeDriver
+        uses: browser-actions/setup-chrome@v1
+        with:
+          install-chromedriver: true
+
+      - name: Install project (dev extras + selenium)
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m pip install "selenium>=4.20"
+
+      - name: Run multi-mdx regression tests
+        run: |
+          python -m pytest -q -m integration \
+            tests/integration/test_multi_mdx_regression.py \
+            --json-report \
+            --json-report-file=imp91-report.json \
+            --json-report-omit keywords streams
+
+      - name: Upload pytest JSON report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: imp91-multi-mdx-report
+          path: imp91-report.json
+          if-no-files-found: warn
+
+      - name: Update status-board markers (IMP-91 u15)
+        if: always()
+        run: |
+          python scripts/update_status_board.py \
+            --report imp91-report.json \
+            --board docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md
+
+      - name: Upload updated status board
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: imp91-status-board
+          path: docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md
+          if-no-files-found: warn

.gitignore

@@ -8,7 +8,24 @@ dist/
 build/
 .venv/
 node_modules/
-data/
+data/*
+# IMP-46 u6 — track only the frame_cache directory marker; cached payloads stay ignored.
+!data/frame_cache/
+data/frame_cache/*
+!data/frame_cache/.gitkeep
 
 # session workspace (push X — 작업 흐름 trace, 사용자 결정 2026-05-08)
 forex/
+
+# 임시/생성물 정리 커밋 제외 (사용자 결정 2026-07-02)
+/tmp*.json
+/ad-hoc*.json
+/D*tmp*.json
+.orchestrator/
+chromedriver/
+*.pkl
+.claude/settings.local.json
+
+# 프로젝트 전체 스냅샷 사본 (395MB/130MB — push 제외, 사용자 결정 2026-07-02)
+Front_test/
+Front_test_v515/

Front/client/public/data/runs/mdx03_f29_fix_check/debug.json

@@ -0,0 +1,569 @@
+{
+  "v4_source": "tests\\matching\\v4_full32_result.yaml",
+  "v4_label_to_phase_z_status": {
+    "use_as_is": "matched_zone",
+    "light_edit": "adapt_matched_zone",
+    "restructure": "extract_matched_zone",
+    "reject": "fallback_candidate"
+  },
+  "mvp1_allowed_statuses": [
+    "adapt_matched_zone",
+    "matched_zone"
+  ],
+  "mode": "composition_v0_layout_8preset",
+  "mode_note": "MVP-1.5b w/ composition planner v0 — sections → candidates (separate / parent_merged) → score → greedy select → 8-preset layout vocabulary (single / horizontal-2 / vertical-2 / top-1-bottom-2 / top-2-bottom-1 / left-1-right-2 / left-2-right-1 / grid-2x2). v0 layout = count-based; v1 axes (cardinality_fit / hierarchy_coherence / density_score) 추후.",
+  "layout_preset": "horizontal-2",
+  "layout_css": {
+    "areas": "\"top\" \"bottom\"",
+    "cols": "1fr",
+    "rows": "228px 343px",
+    "heights_px": [
+      228,
+      343
+    ],
+    "ratios": [
+      0.39,
+      0.586
+    ],
+    "computation": "min_height_first + content_weight_distribution",
+    "dynamic_rows": true,
+    "raw_zone_layout": {
+      "computation": "min_height_first + content_weight_distribution",
+      "slide_body_height": 585,
+      "gap": 14,
+      "available_after_gap": 571,
+      "min_heights_px": [
+        228,
+        342
+      ],
+      "min_scaled": true,
+      "total_min_height": 570,
+      "remaining_after_min": 1,
+      "content_weights": [
+        {
+          "position": "top",
+          "template_id": "three_parallel_requirements",
+          "score": 4.425
+        },
+        {
+          "position": "bottom",
+          "template_id": "process_product_two_way",
+          "score": 7.305
+        }
+      ],
+      "weight_shares": [
+        0.377,
+        0.623
+      ],
+      "extras_px": [
+        0,
+        1
+      ],
+      "heights_px": [
+        228,
+        343
+      ],
+      "ratios": [
+        0.39,
+        0.586
+      ]
+    }
+  },
+  "slide_status": {
+    "rendered": true,
+    "visual_check_passed": true,
+    "full_mdx_coverage": true,
+    "aligned_section_ids": [
+      "03-1",
+      "03-2"
+    ],
+    "covered_section_ids": [
+      "03-1",
+      "03-2"
+    ],
+    "filtered_section_ids": [],
+    "filtered_section_reasons": [],
+    "visual_fail_reasons": [],
+    "adapter_needed_count": 0,
+    "adapter_needed_units": [],
+    "content_truncated_count": 0,
+    "content_truncated_units": [],
+    "overall": "PASS",
+    "note": "자동 파이프라인 결과 보고. review/UI 개념 X. final.html 파일명 != PASS 의미. overall == PASS 는 visual OK + full coverage + adapter_needed=0 일 때만. adapter_needed_count > 0 = mapper 가 contract 와 안 맞아 자동 렌더 못 한 zone 존재. content_truncated_count > 0 = builder 가 truncate 한 zone 존재 (rendered 됐지만 일부 콘텐츠 손실)."
+  },
+  "fit_classification": {
+    "visual_check_passed": true,
+    "classifications": [],
+    "summary": "visual check passed — no overflow to classify",
+    "categories_seen": [],
+    "unclassified_signals": [],
+    "placement_diagnostics": [
+      {
+        "zone_position": "top",
+        "mapper_frame_template_id": "three_parallel_requirements",
+        "b4_selected_template_id": "three_parallel_requirements",
+        "frame_selection_matches_mapper": true,
+        "frame_selection_match_note": null,
+        "region_count": 1,
+        "slot_assignment_count": 1,
+        "rejection_count": 0
+      },
+      {
+        "zone_position": "bottom",
+        "mapper_frame_template_id": "process_product_two_way",
+        "b4_selected_template_id": "process_product_two_way",
+        "frame_selection_matches_mapper": true,
+        "frame_selection_match_note": null,
+        "region_count": 2,
+        "slot_assignment_count": 2,
+        "rejection_count": 0
+      }
+    ]
+  },
+  "router_decision": {
+    "router_active": false,
+    "proposed_actions_summary": [],
+    "implementation_status_summary": {},
+    "routed_count": 0,
+    "routed_details": [],
+    "missing_actions_pending_impl": [],
+    "note": "visual check passed — no overflow to route"
+  },
+  "retry_trace": {
+    "retry_attempted": false,
+    "retry_action": null,
+    "plan": null,
+    "rerender_attempted": false,
+    "retry_passed": false,
+    "retry_failure_reason": null,
+    "retried_candidate_path": null,
+    "safety_margin_px": 4,
+    "policy": "A3 locked rules : retry budget=1, slide-base/spacing/gap fixed, donor strict (sibling/visual ok/capacity ok/slack>0/min_height 보존), (b) revert on redistribution fail or rerender visual fail.",
+    "retry_skipped_reason": "router_active=False (visual check passed — no overflow)",
+    "failure_classification": {
+      "failure_type": "not_attempted",
+      "failure_type_description": "retry was not attempted (router_active=False or zone_ratio_retry not in proposed actions). 정상 path 의 일부 — 실패 X",
+      "classification_rule": "retry_attempted=False — router_active=False or zone_ratio_retry not in proposed_actions"
+    },
+    "next_action_proposal": {
+      "next_proposed_action": "none",
+      "next_action_rationale": "retry 시도 자체가 없었음 (visual ok 등) — escalation 불필요",
+      "next_action_implementation_status": "n/a",
+      "mapping_source": "A4 NEXT_ACTION_BY_FAILURE (사용자 잠금 2026-04-29)"
+    }
+  },
+  "composition_planner_debug": {
+    "planner_version": "v0.2",
+    "selection_rule": "score desc, then source_section_ids count desc (coverage tiebreak). filter = phase_z_status ∉ allowed_statuses OR auto_selectable=False. auto_selectable=False 사유 : C1 (capacity mismatch — silent truncate / FitError 차단), W1 (rep not auto-renderable), W2 (all children reject), W3 (majority children non-auto-renderable).",
+    "candidates_total": 2,
+    "candidates_viable_auto": 2,
+    "candidates_summary": [
+      {
+        "source_section_ids": [
+          "03-1"
+        ],
+        "merge_type": "single",
+        "template_id": "three_parallel_requirements",
+        "label": "use_as_is",
+        "phase_z_status": "matched_zone",
+        "score": 0.9268,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 3,
+          "source_shape": "top_bullets",
+          "capacity": {
+            "strict": 3,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      },
+      {
+        "source_section_ids": [
+          "03-2"
+        ],
+        "merge_type": "single",
+        "template_id": "process_product_two_way",
+        "label": "use_as_is",
+        "phase_z_status": "matched_zone",
+        "score": 0.9198,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 2,
+          "source_shape": "h3_subsections",
+          "capacity": {
+            "strict": 2,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      }
+    ],
+    "merge_candidates": [],
+    "capacity_mismatches": [],
+    "selected_units_count": 2,
+    "layout_preset": "horizontal-2",
+    "layout_preset_rationale": "v0 count-based: 2 units → horizontal-2"
+  },
+  "zones": [
+    {
+      "position": "top",
+      "source_section_ids": [
+        "03-1"
+      ],
+      "merge_type": "single",
+      "title": "1. DX 시행을 위한 필수 요건",
+      "v4_rank1_frame_id": "1171281190",
+      "v4_rank1_frame_number": 13,
+      "v4_template_id": "three_parallel_requirements",
+      "v4_label": "use_as_is",
+      "v4_confidence": 0.9268,
+      "phase_z_status": "matched_zone",
+      "composition_score": 0.9268,
+      "composition_rationale": {
+        "capacity_fit": {
+          "item_count": 3,
+          "source_shape": "top_bullets",
+          "capacity": {
+            "strict": 3,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        },
+        "frame_compat": 0.9268,
+        "confidence": 0.9268,
+        "label": "use_as_is",
+        "label_weight": 1.0,
+        "merge_type": "single",
+        "hierarchy_coherence": null,
+        "density_score": null
+      },
+      "composition_notes": [],
+      "mapper_type": "contract",
+      "contract_id": "three_parallel_requirements",
+      "contract_frame_id": 1171281190,
+      "builder": "items_with_role",
+      "min_height_px": 230,
+      "slot_payload_keys": [
+        "pillars",
+        "title"
+      ],
+      "content_truncated_count": null,
+      "assets_dir": null,
+      "content_weight": {
+        "score": 4.425,
+        "text_length": 660,
+        "top_bullets": 3,
+        "nested_bullets": 16,
+        "has_table": false,
+        "subsection_count": 0
+      },
+      "placement_trace": {
+        "section_id": "03-1",
+        "selected_frame_id": "1171281190",
+        "selected_template_id": "three_parallel_requirements",
+        "internal_regions": [
+          {
+            "region_id": "03-1.region-1",
+            "role": "primary",
+            "content_type": "text_block",
+            "ratio_estimate": 1.0,
+            "content_unit_ids": [
+              "03-1.text-1"
+            ],
+            "frame_match_strategy": {
+              "kind": "frame_match",
+              "frame_id": null,
+              "display_strategy": "inline_full"
+            },
+            "source_shape_index": null
+          }
+        ],
+        "slot_assignments": [
+          {
+            "region_id": "03-1.region-1",
+            "content_unit_id": "03-1.text-1",
+            "frame_slot_id": "pillar_1",
+            "partial_target_path": ".f13b__cols > .f13b__col:nth-child(1)",
+            "display_strategy": "inline_full"
+          }
+        ],
+        "overflow_buffer": [],
+        "rejection": [],
+        "mapper_frame_template_id": "three_parallel_requirements",
+        "frame_selection_matches_mapper": true,
+        "frame_selection_match_note": null
+      },
+      "height_px": 228,
+      "ratio": 0.39
+    },
+    {
+      "position": "bottom",
+      "source_section_ids": [
+        "03-2"
+      ],
+      "merge_type": "single",
+      "title": "2. Process의 혁신과 Product의 변화",
+      "v4_rank1_frame_id": "1171281210",
+      "v4_rank1_frame_number": 29,
+      "v4_template_id": "process_product_two_way",
+      "v4_label": "use_as_is",
+      "v4_confidence": 0.9198,
+      "phase_z_status": "matched_zone",
+      "composition_score": 0.9198,
+      "composition_rationale": {
+        "capacity_fit": {
+          "item_count": 2,
+          "source_shape": "h3_subsections",
+          "capacity": {
+            "strict": 2,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        },
+        "frame_compat": 0.9198,
+        "confidence": 0.9198,
+        "label": "use_as_is",
+        "label_weight": 1.0,
+        "merge_type": "single",
+        "hierarchy_coherence": null,
+        "density_score": null
+      },
+      "composition_notes": [],
+      "mapper_type": "contract",
+      "contract_id": "process_product_two_way",
+      "contract_frame_id": 1171281210,
+      "builder": "process_product_pair",
+      "min_height_px": 345,
+      "slot_payload_keys": [
+        "banner_left",
+        "banner_right",
+        "process",
+        "product",
+        "title"
+      ],
+      "content_truncated_count": null,
+      "assets_dir": "assets\\process_product_two_way",
+      "content_weight": {
+        "score": 7.305,
+        "text_length": 924,
+        "top_bullets": 6,
+        "nested_bullets": 7,
+        "has_table": true,
+        "subsection_count": 2
+      },
+      "placement_trace": {
+        "section_id": "03-2",
+        "selected_frame_id": "1171281210",
+        "selected_template_id": "process_product_two_way",
+        "internal_regions": [
+          {
+            "region_id": "03-2.region-1",
+            "role": "primary",
+            "content_type": "text_block",
+            "ratio_estimate": 0.8421,
+            "content_unit_ids": [
+              "03-2.text-1"
+            ],
+            "frame_match_strategy": {
+              "kind": "frame_match",
+              "frame_id": null,
+              "display_strategy": "inline_full"
+            },
+            "source_shape_index": null
+          },
+          {
+            "region_id": "03-2.region-2",
+            "role": "supporting",
+            "content_type": "transform_table",
+            "ratio_estimate": 0.1579,
+            "content_unit_ids": [
+              "03-2.transform-1"
+            ],
+            "frame_match_strategy": {
+              "kind": "frame_match",
+              "frame_id": null,
+              "display_strategy": "inline_full"
+            },
+            "source_shape_index": null
+          }
+        ],
+        "slot_assignments": [
+          {
+            "region_id": "03-2.region-1",
+            "content_unit_id": "03-2.text-1",
+            "frame_slot_id": "product_column",
+            "partial_target_path": ".f29b__grid .f29b__cell--right",
+            "display_strategy": "inline_full"
+          },
+          {
+            "region_id": "03-2.region-2",
+            "content_unit_id": "03-2.transform-1",
+            "frame_slot_id": "process_column",
+            "partial_target_path": ".f29b__grid .f29b__cell--left",
+            "display_strategy": "inline_full"
+          }
+        ],
+        "overflow_buffer": [],
+        "rejection": [],
+        "mapper_frame_template_id": "process_product_two_way",
+        "frame_selection_matches_mapper": true,
+        "frame_selection_match_note": null
+      },
+      "height_px": 343,
+      "ratio": 0.586
+    }
+  ],
+  "visual_runtime_check": {
+    "frame_slot_metrics": [
+      {
+        "class_name": "f29b__cell f29b__cell--left",
+        "clientHeight": 125,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "process_column",
+        "overflowed": false,
+        "scrollHeight": 125,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      },
+      {
+        "class_name": "f29b__cell f29b__cell--right",
+        "clientHeight": 125,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "product_column",
+        "overflowed": false,
+        "scrollHeight": 125,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      },
+      {
+        "class_name": "f29b__cell f29b__cell--left",
+        "clientHeight": 43,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "process_column",
+        "overflowed": false,
+        "scrollHeight": 43,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      },
+      {
+        "class_name": "f29b__cell f29b__cell--right",
+        "clientHeight": 43,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "product_column",
+        "overflowed": false,
+        "scrollHeight": 43,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      },
+      {
+        "class_name": "f29b__cell f29b__cell--left",
+        "clientHeight": 63,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "process_column",
+        "overflowed": false,
+        "scrollHeight": 63,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      },
+      {
+        "class_name": "f29b__cell f29b__cell--right",
+        "clientHeight": 63,
+        "clientWidth": 577,
+        "excess_x": 0,
+        "excess_y": 0,
+        "frame_slot_id": "product_column",
+        "overflowed": false,
+        "scrollHeight": 63,
+        "scrollWidth": 577,
+        "zone_position": "bottom",
+        "zone_template_id": "process_product_two_way"
+      }
+    ],
+    "slide": {
+      "clientHeight": 720,
+      "clientWidth": 1280,
+      "excess_x": 0,
+      "excess_y": 0,
+      "overflowed": false,
+      "scrollHeight": 720,
+      "scrollWidth": 1280,
+      "size_correct": true
+    },
+    "slide_body": {
+      "clientHeight": 585,
+      "clientWidth": 1180,
+      "excess_x": 0,
+      "excess_y": 0,
+      "overflowed": false,
+      "scrollHeight": 585,
+      "scrollWidth": 1180
+    },
+    "zones": [
+      {
+        "clientHeight": 228,
+        "clientWidth": 1180,
+        "clipped_inner": [],
+        "excess_x": 0,
+        "excess_y": 0,
+        "overflowed": false,
+        "position": "top",
+        "scrollHeight": 228,
+        "scrollWidth": 1180,
+        "template_id": "three_parallel_requirements"
+      },
+      {
+        "clientHeight": 343,
+        "clientWidth": 1180,
+        "clipped_inner": [],
+        "excess_x": 0,
+        "excess_y": 0,
+        "overflowed": false,
+        "position": "bottom",
+        "scrollHeight": 343,
+        "scrollWidth": 1180,
+        "template_id": "process_product_two_way"
+      }
+    ],
+    "screenshot": "data\\runs\\mdx03_f29_fix_check\\phase_z2\\preview.png",
+    "passed": true,
+    "fail_reasons": []
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/final.html

@@ -0,0 +1,927 @@
+<!-- Phase Z-2 MVP-1.5b — single slide + Type B layout (top/bottom zones).
+     원래 Phase Z 설계 복귀: MDX 1 = slide 1, layout preset = zone 분할, frame-derived block ⊂ zone. -->
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=1280">
+  <title>DX 실행 체계 구축 방안</title>
+  <style>
+    /* ── existing tokens (inlined) ── */
+    /* === typography.css === */
+/* ══════════════════════════════════════
+   Typography Tokens v1
+   ══════════════════════════════════════
+   슬라이드 전체의 공통 글자 위계.
+   모든 블록은 이 토큰을 참조한다.
+   직접값(font-size: 11px) 금지 → var(--font-body) 사용.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ── 1층: Global Hierarchy ── */
+
+  /* 대목차: 슬라이드 상단 제목 */
+  --font-slide-title: 22px;
+  --weight-slide-title: 700;
+  --lh-slide-title: 1.4;
+
+  /* 중목차: zone 제목 */
+  --font-zone-title: 16px;
+  --weight-zone-title: 700;
+  --lh-zone-title: 1.4;
+
+  /* 소목차: 블록 내 소제목, 카드 제목 */
+  --font-sub-title: 12px;
+  --weight-sub-title: 700;
+  --lh-sub-title: 1.45;
+
+  /* 본문: 블릿, 설명 텍스트 */
+  --font-body: 10px;
+  --weight-body: 500;
+  --lh-body: 1.55;
+
+  /* 캡션: 각주, 출처, 보조 텍스트 */
+  --font-caption: 10px;
+  --weight-caption: 400;
+  --lh-caption: 1.4;
+
+  /* footer: 핵심 인사이트 pill */
+  --font-footer: 20px;
+  --weight-footer: 700;
+  --lh-footer: 1.2;
+
+  /* ── 2층: Component Semantic Tokens ── */
+  /* 가까운 위계에서 기본값, 필요시 override */
+
+  /* 본문 강조 (인라인 heading) */
+  --font-body-strong: var(--font-body);
+  --weight-body-strong: 600;
+
+  /* 자세히보기 링크 */
+  --font-detail-link: var(--font-caption);
+  --weight-detail-link: 500;
+
+  /* pill/badge 라벨 */
+  --font-pill-label: var(--font-sub-title);
+  --weight-pill-label: 700;
+
+  /* 표 헤더 */
+  --font-table-header: var(--font-sub-title);
+  --weight-table-header: 700;
+
+  /* 표 셀 */
+  --font-table-cell: var(--font-body);
+  --weight-table-cell: 400;
+
+  /* 비교 뱃지 */
+  --font-compare-badge: var(--font-sub-title);
+  --weight-compare-badge: 700;
+
+  /* 강조 인용 */
+  --font-callout: var(--font-sub-title);
+  --weight-callout: 700;
+
+  /* 상단 라벨 (overline) */
+  --font-overline: var(--font-caption);
+  --weight-overline: 600;
+  --ls-overline: 0.05em;
+}
+
+
+/* === spacing.css === */
+/* ══════════════════════════════════════
+   Spacing Tokens v1
+   ══════════════════════════════════════
+   여백/간격/들여쓰기 공통 기준.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ── 기본 스케일 ── */
+  --space-xs: 4px;
+  --space-sm: 8px;
+  --space-md: 12px;
+  --space-lg: 16px;
+  --space-xl: 24px;
+
+  /* ── slide-base 레이아웃 ── */
+  --slide-padding-x: 40px;       /* 본문 좌우 여백 */
+  --slide-title-left: 52px;      /* 대목차 시작 */
+  --slide-title-top: 22px;       /* 대목차 위치 */
+  --slide-divider-top: 58px;     /* 구분선 위치 (slide_base.html 와 일치 2026-05-07) */
+  --slide-body-top: 76px;        /* 본문 시작 (사용자 직설: divider-body 16px) */
+  --slide-body-height: 585px;    /* 본문 높이 (사용자 직설: body-footer 10px) */
+  --slide-footer-bottom: 8px;    /* footer 하단 여백 (slide_base.html 와 일치) */
+  --slide-footer-height: 41px;   /* footer 높이 */
+
+  /* ── zone ── */
+  --zone-gap: 8px;               /* zone 간 간격 */
+  --zone-padding-left: 12px;     /* zone 안쪽 좌측 여백 */
+  --zone-padding-right: 8px;     /* zone 안쪽 우측 여백 */
+  --zone-title-mb: 8px;          /* zone 제목 아래 여백 */
+
+  /* ── 블록 공통 ── */
+  --card-padding: 16px;          /* 카드 내부 여백 */
+  --card-padding-sm: 8px;        /* 작은 카드 내부 여백 */
+  --card-gap: 12px;              /* 카드 간 간격 */
+  --card-radius: 6px;            /* 카드 모서리 */
+
+  /* ── 블릿/텍스트 ── */
+  --bullet-indent: 14px;         /* 불릿 hanging indent */
+  --bullet-gap: 2px;             /* 불릿 항목 간 간격 */
+  --heading-gap: 4px;            /* 소제목 아래 간격 */
+  --section-gap: 10px;           /* 섹션 간 간격 */
+
+  /* ── flex/grid 기본 ── */
+  --flex-gap: 12px;              /* 기본 flex gap */
+  --flex-gap-sm: 6px;            /* 좁은 flex gap */
+  --grid-gap: 16px;              /* 기본 grid gap */
+}
+
+
+/* === colors.css === */
+/* ══════════════════════════════════════
+   Color Tokens v1
+   ══════════════════════════════════════
+   2층 구조: 공통 테마색 + 블록 의미색.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ══ 1층: 공통 테마색 ══ */
+  /* 모든 블록이 공유하는 기본 팔레트 */
+
+  /* 텍스트 */
+  --color-title: #1e293b;             /* 제목 (진한 남색) */
+  --color-zone-title: #1a365d;        /* zone 중목차 제목 */
+  --color-body: #475569;              /* 본문 */
+  --color-body-strong: #1e293b;       /* 본문 강조 */
+  --color-caption: #94a3b8;           /* 캡션, 보조 */
+  --color-muted: #64748b;             /* 약한 텍스트 */
+
+  /* 배경 */
+  --color-bg: #ffffff;                /* 슬라이드 배경 */
+  --color-bg-subtle: #f8fafc;         /* 카드/영역 배경 */
+  --color-bg-page: #e8ecf0;           /* 페이지 배경 (슬라이드 바깥) */
+
+  /* 보더 */
+  --color-border: #e2e8f0;            /* 기본 보더 */
+  --color-border-strong: #cbd5e1;     /* 강한 보더 */
+
+  /* 강조 */
+  --color-accent: #2563eb;            /* 링크, 강조 (파랑) */
+  --color-accent-hover: #eff6ff;      /* 링크 hover 배경 */
+  --color-danger: #dc2626;            /* 경고, 에러 */
+
+  /* slide-base 전용 */
+  --color-slide-title-from: #296b55;  /* 대목차 gradient 시작 */
+  --color-slide-title-to: #123328;    /* 대목차 gradient 끝 */
+  --color-footer-bg-from: #3b3523;    /* footer gradient 시작 */
+  --color-footer-bg-mid: #263a2a;     /* footer gradient 중간 */
+  --color-footer-bg-to: #113f31;      /* footer gradient 끝 */
+  --color-footer-text: #ffffff;       /* footer 텍스트 */
+  --color-footer-accent: #ffee33;     /* footer 강조 (em) */
+
+  /* ══ 2층: 블록 의미색 ══ */
+  /* 특정 블록 유형에서 의미를 가지는 색 */
+
+  /* 3열 비교 (prerequisites-3col) */
+  --color-col-1-from: #0D78D0;        /* 1열 gradient 시작 */
+  --color-col-1-to: #023056;          /* 1열 gradient 끝 */
+  --color-col-2-from: #FF9A23;        /* 2열 gradient 시작 */
+  --color-col-2-to: #CC5200;          /* 2열 gradient 끝 */
+  --color-col-3-from: #39BE49;        /* 3열 gradient 시작 */
+  --color-col-3-to: #23742C;          /* 3열 gradient 끝 */
+
+  /* 비교 블록 (compare) */
+  --color-compare-left: #5c3714;      /* 좌측 (AS-IS 계열) */
+  --color-compare-right: #285b4a;     /* 우측 (TO-BE 계열) */
+  --color-compare-badge: #ae3607;     /* VS 뱃지 */
+
+  /* 다크 카드 (direct render) */
+  --color-dark-card-1: #1a365d;       /* 카드 1 배경 */
+  --color-dark-card-2: #1e3a2f;       /* 카드 2 배경 */
+  --color-dark-card-3: #3b1f2b;       /* 카드 3 배경 */
+  --color-dark-card-title: #fbbf24;   /* 다크카드 제목 (금색) */
+  --color-dark-card-body: #e2e8f0;    /* 다크카드 본문 */
+
+  /* 표 */
+  --color-table-header-bg: #64748b;   /* 표 헤더 배경 */
+  --color-table-header-text: #ffffff; /* 표 헤더 텍스트 */
+
+  /* 블록 제목 gradient (Figma 원본) */
+  --color-block-title-from: #CC5200;  /* 주황 gradient 시작 */
+  --color-block-title-to: #883700;    /* 주황 gradient 끝 */
+
+  /* pill */
+  --color-pill-bg: #1e293b;           /* pill 배경 */
+  --color-pill-text: #ffffff;         /* pill 텍스트 */
+}
+
+
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+      background: #e8ecf0;
+      display: flex; justify-content: center; align-items: center;
+      min-height: 100vh;
+      word-break: keep-all;
+      padding: 20px 0;
+    }
+
+    /* ── 16:9 슬라이드 (single, 1280×720) ── */
+    .slide {
+      width: 1280px; height: 720px;
+      position: relative;
+      overflow: hidden;
+      background: #fff;
+      box-shadow: 0 4px 20px rgba(0,0,0,.15);
+      flex-shrink: 0;
+    }
+    .slide-bg {
+      position: absolute; inset: 0;
+      background: linear-gradient(180deg, #f0f0f0 0%, #ffffff 100%);
+      z-index: 0;
+    }
+    .slide-title {
+      position: absolute;
+      left: 52px; top: 22px;
+      width: calc(100% - 104px);
+      font-weight: 700;
+      font-size: var(--font-slide-title);
+      line-height: var(--lh-slide-title);
+      background-image: linear-gradient(180deg, #296b55 0%, #123328 100%);
+      -webkit-background-clip: text; background-clip: text;
+      color: transparent;
+      text-shadow: 0 0 2px #322c1e;
+      z-index: 2;
+    }
+    .slide-divider {
+      position: absolute;
+      left: 50px; top: 58px;
+      width: calc(100% - 100px);
+      height: 2px;
+      background: #cbd5e1;
+      z-index: 2;
+    }
+    .slide-body {
+      position: absolute;
+      left: 50px; top: 76px;
+      width: calc(100% - 100px);  /* 1180 */
+      height: 585px;
+      z-index: 1;
+      overflow: hidden;
+    }
+
+    /* ── Layout preset (composition planner v0 — 8 vocabulary) ──
+         단일 .layout-{preset} 클래스에 grid CSS 주입.
+         layout_css = pipeline build_layout_css() 결과 :
+           - horizontal-2 : rows = dynamic px (content_weight + frame_min_height)
+           - 그 외       : rows / cols = fr default (LAYOUT_PRESETS)
+         positions (single / top / bottom / left / right / top-left / ... / grid-2x2 9개)
+         은 .zone 의 inline grid-area 로 지정 — preset CSS 는 areas 만 정의. */
+    .layout-horizontal-2 {
+      display: grid;
+      grid-template-columns: 1fr;
+      grid-template-rows: 228px 343px;
+      grid-template-areas: "top" "bottom";
+      gap: 14px;
+      height: 100%;
+    }
+
+    /* ── Zone — block 가용 공간 최대화. 프레임 자체 styling 이 boundary 역할 ── */
+    .zone {
+      position: relative;
+      overflow: hidden;
+      padding: 0;
+      min-width: 0;
+      min-height: 0;
+    }
+
+    /* ── Frame-family text layout contract (shared, reusable) ──
+         feedback-1 (mvp1.5b_test7): visible improvement 강화.
+         Stronger hanging indent + breathing line spacing + visible hierarchy. */
+    .text-line {
+      font-size: var(--font-body);          /* 11px */
+      font-weight: var(--weight-body);
+      line-height: 1.6;                     /* breathing room */
+      margin: 0;
+    }
+    .text-line + .text-line {
+      margin-top: 4px;                      /* visible gap between lines (was 2px) */
+    }
+
+    /* bullet line — hanging indent via padding + absolute marker (안정적) */
+    .text-line--bullet {
+      padding-left: 14px;
+      position: relative;
+    }
+    .text-line--bullet::before {
+      content: "•";                         /* visible bullet 마커 */
+      position: absolute;
+      left: 2px;
+      top: 0;
+      font-weight: 700;
+      line-height: inherit;
+      color: inherit;
+    }
+    /* indent levels — visible nested hierarchy */
+    .text-line--indent-1 {
+      padding-left: 30px;
+    }
+    .text-line--indent-1::before {
+      content: "◦";                         /* sub-bullet 다른 마커 */
+      left: 18px;
+    }
+    .text-line--indent-2 {
+      padding-left: 46px;
+    }
+    .text-line--indent-2::before {
+      content: "▪";
+      left: 34px;
+    }
+    /* body line — 마커 없음 */
+    .text-line--body {
+      padding-left: 0;
+    }
+    .text-line strong { color: #000; font-weight: 700; }
+
+    /* ── Transform-block family (frame 29 AS-IS/TO-BE dedicated comparison component) ──
+         feedback-3: bullet rows 가 아닌 *전용 비교 component*. Header (AS-IS / TO-BE) + paired rows.
+         color-coded cells, left-border accent → 단번에 *비교 구조* 인지. */
+    .transform-block {
+      margin-top: 4px;
+      padding: 6px 8px 6px;
+      background: rgba(255, 255, 255, 0.4);
+      border-radius: 3px;
+      border: 1px solid rgba(0,0,0,0.05);
+    }
+    .transform-block__header {
+      display: grid;
+      grid-template-columns: 1fr 22px 1fr;
+      gap: 6px;
+      margin-bottom: 4px;
+      padding-bottom: 3px;
+      border-bottom: 1px dashed rgba(0,0,0,0.12);
+      font-size: 9px;
+      font-weight: 900;
+      letter-spacing: 0.5px;
+    }
+    .transform-block__label--from { color: #6b5444; }
+    .transform-block__label--to { color: #2563eb; text-align: left; }
+    .transform-rows {
+      display: flex; flex-direction: column;
+      gap: 4px;
+    }
+    .transform-row {
+      display: grid;
+      grid-template-columns: 1fr 22px 1fr;
+      gap: 6px;
+      align-items: stretch;
+      font-size: var(--font-body);
+      line-height: 1.45;
+    }
+    .transform-row__from {
+      padding: 3px 8px;
+      background: linear-gradient(90deg, rgba(140,120,90,0.16), rgba(140,120,90,0.08));
+      border-left: 2px solid #b8a98a;
+      border-radius: 2px;
+      color: #4b3f30;
+      font-weight: 500;
+    }
+    .transform-row__arrow {
+      text-align: center;
+      color: #2563eb;
+      font-weight: 900;
+      font-size: 14px;
+      align-self: center;
+    }
+    .transform-row__to {
+      padding: 3px 8px;
+      background: linear-gradient(90deg, rgba(37,99,235,0.10), rgba(37,99,235,0.18));
+      border-left: 2px solid #2563eb;
+      border-radius: 2px;
+      color: #1e40af;
+      font-weight: 700;
+    }
+
+    /* ── Footer pill — feedback-3: body 와 weight balance, 살짝 가벼워짐 ── */
+    .slide-footer {
+      position: absolute;
+      left: 50px; bottom: 8px;
+      width: calc(100% - 100px);             /* front 기준 (body 와 정렬) */
+      height: 41px;                          /* front 기준 */
+      border-radius: 999px;
+      overflow: hidden;
+      z-index: 2;
+      display: flex; align-items: center; justify-content: center;
+      background: linear-gradient(90deg, #3b3523 5%, #263a2a 50%, #113f31 95%);
+      opacity: 0.92;                         /* slightly lighter */
+    }
+    .slide-footer-text {
+      position: relative; z-index: 1;
+      font-size: 15px;                       /* was 20px (--font-footer) */
+      font-weight: 700;
+      line-height: 1.2;
+      color: #fff;
+      text-align: center;
+      text-shadow: 0 0 3px rgba(0,0,0,.4);
+      letter-spacing: -0.01em;
+    }
+    .slide-footer-text em { color: #fe3; font-style: normal; }
+
+    .phase-z2-marker {
+      position: absolute;
+      top: 4px; right: 8px;
+      font-size: 9px; color: #94a3b8;
+      font-family: monospace;
+      z-index: 3;
+    }
+  </style>
+</head>
+<body>
+  <div class="slide" data-page="1">
+    <div class="slide-bg"></div>
+    <div class="phase-z2-marker">phase_z2 / mvp-1.5b / horizontal-2 / single slide</div>
+    <div class="slide-title">DX 실행 체계 구축 방안</div>
+    <div class="slide-divider"></div>
+    <div class="slide-body">
+      <div class="layout-horizontal-2">
+        
+        <div class="zone" data-zone-position="top" data-template-id="three_parallel_requirements" style="grid-area: top;">
+          <!-- Phase Z-2 MVP-1.5b frame-derived adapted block.
+     §17 룰 — Figma 시각 언어 promote, geometry 만 zone-compatible adapt.
+     Legacy templates/blocks/structures/prerequisites-3col.html 의 token-fixed font 접근 학습. -->
+
+
+<style>
+  .f13b {
+    width: 100%; height: 100%;
+    display: flex; flex-direction: column;
+    gap: 4px;
+    font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+    word-break: keep-all;
+  }
+  .f13b__title {
+    font-size: var(--font-zone-title);
+    font-weight: 700;
+    line-height: var(--lh-zone-title);
+    background-image: linear-gradient(180deg, #000 0%, #883700 100%);
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    flex-shrink: 0;
+  }
+  .f13b__cols {
+    display: grid;
+    grid-template-columns: 1fr 1fr 1fr;
+    gap: 8px;
+    flex: 1;
+    min-height: 0;
+  }
+  .f13b__col {
+    display: flex;
+    border-top: 2px solid #000;          /* PROMOTED line 57 */
+    border-bottom: 2px solid #000;
+    overflow: hidden;
+    min-width: 0;
+    background: rgba(255,255,255,0.5);
+  }
+  .f13b__bar {
+    flex: 0 0 50px;
+    display: flex; flex-direction: column;
+    align-items: center; justify-content: center;
+    color: #fff;
+    font-weight: 700;
+    text-align: center;
+    padding: 6px 2px;
+    gap: 3px;
+  }
+  .f13b__col--tech   .f13b__bar { background: linear-gradient(180deg, #0D78D0 0%, #023056 100%); }
+  .f13b__col--people .f13b__bar { background: linear-gradient(180deg, #FF9A23 0%, #CC5200 100%); }
+  .f13b__col--nature .f13b__bar { background: linear-gradient(180deg, #39BE49 21%, #23742C 100%); }
+  /* PROMOTED Figma frame 13 line 92-93 — main + parenthetical stacked vertically */
+  .f13b__bar-main {
+    font-size: var(--font-sub-title);    /* 12px — main word "기술/사람/자연" */
+    font-weight: 700;
+    line-height: 1.2;
+    display: block;
+  }
+  .f13b__bar-paren {
+    font-size: var(--font-caption);      /* 10px — "(디지털/역량/여건)" */
+    font-weight: 500;
+    line-height: 1.2;
+    display: block;
+    opacity: 0.95;
+  }
+
+  .f13b__body {
+    flex: 1;
+    display: flex; flex-direction: column;
+    padding: 8px 12px;                   /* breathing (was 6px 10px) */
+    min-width: 0;
+    overflow: hidden;
+  }
+  .f13b__section {
+    flex: 1;
+    padding: 6px 0;                       /* breathing (was 4px) */
+    overflow: hidden;
+    min-height: 0;
+  }
+  .f13b__section + .f13b__section {
+    border-top: 2px dashed #000;        /* PROMOTED line 103 */
+    margin-top: 6px;                      /* visible section gap (was 4px) */
+    padding-top: 8px;                     /* breathing (was 6px) */
+  }
+  /* heading — 부소목차 (사용자 5-layer 직설 2026-05-07): Digital 기술과... 같은 깊이 1 굵은 bullet */
+  .f13b__heading {
+    font-size: var(--font-sub-title);    /* 12px — 부소목차 위계 */
+    font-weight: 700;
+    line-height: var(--lh-sub-title);
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    margin-bottom: 6px;                   /* visible heading-body gap (was 4px) */
+  }
+  .f13b__col--tech   .f13b__heading { background-image: linear-gradient(180deg, #0D78D0 0%, #134D7F 100%); }
+  .f13b__col--people .f13b__heading { background-image: linear-gradient(180deg, #FE900C 0%, #D18B37 100%); }
+  .f13b__col--nature .f13b__heading { background-image: linear-gradient(180deg, #3CA649 21%, #23742C 100%); }
+
+  /* desc — frame-family text layout contract (.text-line 공통 클래스 사용)
+     feedback (mvp1.5b_test5): browser-native ul/li 폐기. */
+  .f13b__desc {
+    color: #3E3523;                      /* PROMOTED line 118 */
+    overflow: hidden;
+  }
+  /* desc 안 .text-line 색 override */
+  .f13b__desc .text-line { color: #3E3523; }
+</style>
+
+<div class="f13b" data-frame-id="1171281190" data-template-id="three_parallel_requirements">
+  <div class="f13b__title">1. DX 시행을 위한 필수 요건</div>
+  <div class="f13b__cols">
+    
+    <div class="f13b__col f13b__col--tech">
+      <div class="f13b__bar">
+        <span class="f13b__bar-main">기술</span>
+        
+        <span class="f13b__bar-paren">(디지털)</span>
+        
+      </div>
+      <div class="f13b__body">
+        
+        <div class="f13b__section">
+          <div class="f13b__heading">Digital 기술(S/W, H/W)과 업무 Process의 통합</div>
+          
+          <div class="f13b__desc">
+            <div class="text-line text-line--bullet">기존 업무 프로세스에 다양한 디지털 기술을 접목하여 업무 수행</div><div class="text-line text-line--bullet">프로젝트 전반에 걸친 업무 프로세스의 연결 및 조율</div>
+          </div>
+          
+        </div>
+        
+        <div class="f13b__section">
+          <div class="f13b__heading">분야별 전문 지식(설계, 시공, 유지관리 등) 보유</div>
+          
+          <div class="f13b__desc">
+            <div class="text-line text-line--bullet">건설 전 단계에 대한 근본적인 이해와 지식 및 경험</div><div class="text-line text-line--bullet">최신 토목 기술 트랜드 및 표준 기준 등에 대한 높은 지식</div>
+          </div>
+          
+        </div>
+        
+      </div>
+    </div>
+    
+    <div class="f13b__col f13b__col--people">
+      <div class="f13b__bar">
+        <span class="f13b__bar-main">사람</span>
+        
+        <span class="f13b__bar-paren">(역량)</span>
+        
+      </div>
+      <div class="f13b__body">
+        
+        <div class="f13b__section">
+          <div class="f13b__heading">혁신적 사고방식과 창의적 문제 해결 능력</div>
+          
+          <div class="f13b__desc">
+            <div class="text-line text-line--bullet">기존 수행 방식과 관습적 사고 등에 의한 접근 방식 탈피</div><div class="text-line text-line--bullet">디지털 기술을 활용한 창의적, 혁신적인 솔루션 제시</div>
+          </div>
+          
+        </div>
+        
+        <div class="f13b__section">
+          <div class="f13b__heading">사용자 중심 사고와 DX 수행 경험</div>
+          
+          <div class="f13b__desc">
+            <div class="text-line text-line--bullet">사용자의 요구와 기대를 충족시키는 설계 및 구현</div><div class="text-line text-line--bullet">시행착오를 포함한 수행 경험과 사용자 경험(UX)을 반영한 해결 방안 제시</div>
+          </div>
+          
+        </div>
+        
+      </div>
+    </div>
+    
+    <div class="f13b__col f13b__col--nature">
+      <div class="f13b__bar">
+        <span class="f13b__bar-main">자연</span>
+        
+        <span class="f13b__bar-paren">(여건)</span>
+        
+      </div>
+      <div class="f13b__body">
+        
+        <div class="f13b__section">
+          <div class="f13b__heading">지속적인 투자 및 실행 의지</div>
+          
+          <div class="f13b__desc">
+            <div class="text-line text-line--bullet">기술 도입 초기 단계에 필요한 인력·기간·비용 등의 대규모 투자</div><div class="text-line text-line--bullet">기술 고도화를 위한 지속적인 개선 및 투자 체계 구축</div><div class="text-line text-line--bullet">변화와 혁신을 통해 부가가치를 창출하려는 실행 의지와 추진력</div>
+          </div>
+          
+        </div>
+        
+      </div>
+    </div>
+    
+  </div>
+</div>
+        </div>
+        
+        <div class="zone" data-zone-position="bottom" data-template-id="process_product_two_way" style="grid-area: bottom;">
+          <!-- Phase Z-2 MVP-1.5b frame-derived adapted block.
+     §17 룰 — Figma 시각 언어 promote, geometry 만 zone-compatible adapt. -->
+
+
+<style>
+  .f29b {
+    width: 100%; height: 100%;
+    display: flex; flex-direction: column;
+    gap: 4px;
+    position: relative;
+    font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+    word-break: keep-all;
+    overflow: hidden;
+  }
+  .f29b__title {
+    font-size: var(--font-zone-title);   /* 13px — frame 13 의 f13b__title 과 동일 위계 */
+    font-weight: 700;
+    line-height: var(--lh-zone-title);
+    background-image: linear-gradient(180deg, #000 0%, #883700 100%);
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    flex-shrink: 0;
+    padding-left: 4px;
+  }
+
+  /* banners — top */
+  .f29b__banners {
+    flex: 0 0 auto;
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 4px;
+    position: relative;
+    height: 36px;
+  }
+  .f29b__banner {
+    position: relative;
+    overflow: hidden;
+    display: flex; align-items: center; justify-content: center;
+  }
+  /* PROMOTED background gradients — figma origin lines 84-98 (header-bg--left/right).
+     원본 SVG 3 개 → CSS gradient 로 재현 (R8/R9 준수). border-radius 9999px = 자동 pill. */
+  .f29b__banner--left {
+    background: linear-gradient(to right,
+      rgba(136, 131, 118, 0.343) 0%,
+      #39321E 73.1%,
+      #39321E 100%);
+    border-radius: 0 9999px 9999px 0;
+  }
+  .f29b__banner--right {
+    background: linear-gradient(to right,
+      #032118 0%,
+      rgba(41, 107, 85, 0.1) 100%);
+    border-radius: 9999px 0 0 9999px;
+  }
+  .f29b__banner-text {
+    position: relative;
+    z-index: 1;
+    font-size: var(--font-sub-title);
+    font-weight: 900;
+    line-height: 1;
+    text-shadow: 0 0 2px #322C1E;
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    padding: 0 8px;
+  }
+  /* PROMOTED gradient — lines 101-104 / 110-113 */
+  .f29b__banner--left .f29b__banner-text {
+    background-image:
+      linear-gradient(90deg, rgb(62,53,35) 0%, rgb(62,53,35) 100%),
+      linear-gradient(180deg, rgb(41,107,85) 0%, rgb(18,51,40) 100%);
+  }
+  .f29b__banner--right .f29b__banner-text {
+    background-image:
+      linear-gradient(90deg, rgb(34,95,74) 0%, rgb(34,95,74) 100%),
+      linear-gradient(180deg, rgb(41,107,85) 0%, rgb(18,51,40) 100%);
+  }
+
+  /* body — 6 cell grid (3 rows × 2 cols) — 좌우 row divider Y 정렬 */
+  /* PROMOTED background — figma origin lines 53-68 (body-bg-left/right).
+     좌(0~50%): #39321E α0.3 (top) → white α0.3 (bottom)
+     우(50~100%): #296B55 α0.3 (top) → white α0.3 (bottom)
+     원본 SVG → CSS multi-bg 로 재현. */
+  .f29b__body {
+    flex: 1;
+    position: relative;
+    min-height: 0;
+    padding-top: 4px;
+    background:
+      linear-gradient(to bottom, rgba(57,50,30,0.3) 0%, rgba(255,255,255,0.3) 100%) 0% 0% / 50% 100% no-repeat,
+      linear-gradient(to bottom, rgba(41,107,85,0.3) 0%, rgba(255,255,255,0.3) 100%) 100% 0% / 50% 100% no-repeat;
+  }
+
+  /* 6 cell grid: 3 rows (section 1/2/3), 2 cols (process/product). 각 row 의 height = max(좌, 우) */
+  .f29b__grid {
+    position: relative;
+    z-index: 1;
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    grid-auto-rows: auto;
+    gap: 6px 10px;
+    padding: 4px 8px;
+    height: 100%;
+    align-content: start;
+  }
+  .f29b__cell {
+    overflow: hidden;
+    min-width: 0;
+    min-height: 0;
+  }
+  /* row 2/3 (3 번째 cell 이후) 위에 dashed divider — 좌우 같은 Y */
+  .f29b__cell:nth-child(n+3) {
+    border-top: 1px dashed rgba(0,0,0,0.15);
+    padding-top: 6px;
+    margin-top: 4px;
+  }
+  /* section-title — 부소목차 (사용자 5-layer 직설 2026-05-07): Analogue 기반... 같은 깊이 0 굵은 bullet */
+  .f29b__section-title {
+    font-size: var(--font-sub-title);    /* 12px — 부소목차 위계 */
+    font-weight: 900;
+    line-height: 1.3;
+    margin-bottom: 5px;
+    padding-left: 6px;
+    border-left: 3px solid currentColor;
+  }
+  .f29b__cell--left  .f29b__section-title { color: #5C3714; }   /* PROMOTED line 125 */
+  .f29b__cell--right .f29b__section-title { color: #084C56; }   /* PROMOTED line 126 */
+  .f29b__section-title__sub {
+    font-size: var(--font-caption);      /* 10px */
+    margin-left: 3px;
+  }
+  /* f29b 의 본문 = .text-line 공통 contract 사용. bullet color override. */
+  .f29b__cell .text-line--bullet { color: #000; font-weight: 700; }
+
+  /* AS-IS/TO-BE 좌우 + arrow (PROMOTED 구조) */
+  .f29b__transform {
+    display: grid;
+    grid-template-columns: 1fr auto 1fr;
+    gap: 4px;
+    align-items: start;
+  }
+  .f29b__transform__list {
+    /* .text-line 공통 contract 그대로. wrapper 만 grid 안의 cell 역할 */
+  }
+  .f29b__transform__arrow {
+    align-self: center;
+    width: 28px;
+    flex-shrink: 0;
+  }
+  .f29b__transform__arrow img {
+    width: 100%;
+    height: auto;
+    display: block;
+  }
+
+  .f29b__footnote {
+    font-size: var(--font-caption);      /* 10px */
+    line-height: var(--lh-caption);
+    color: #333;
+    padding-left: 14px;
+    margin-top: 1px;
+    white-space: pre-wrap;
+  }
+  .f29b__aster-small { font-size: 9px; }
+</style>
+
+<div class="f29b" data-frame-id="1171281210" data-template-id="process_product_two_way">
+
+  
+  <div class="f29b__title">2. Process의 혁신과 Product의 변화</div>
+
+  
+  <div class="f29b__banners">
+    <div class="f29b__banner f29b__banner--left">
+      <div class="f29b__banner-text">과정(Process)의 혁신</div>
+    </div>
+    <div class="f29b__banner f29b__banner--right">
+      <div class="f29b__banner-text">결과(Product)의 변화</div>
+    </div>
+  </div>
+
+  
+  <div class="f29b__body">
+
+    <div class="f29b__grid">
+
+      
+      
+      <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+        
+        <div class="f29b__section-title">Analogue 기반 업무의 Digital화</div>
+        
+        <div class="transform-block">
+          <div class="transform-block__header">
+            <span class="transform-block__label--from">AS-IS</span>
+            <span></span>
+            <span class="transform-block__label--to">TO-BE</span>
+          </div>
+          <div class="transform-rows">
+            
+            <div class="transform-row">
+              <div class="transform-row__from">개념·문서·행정 절차 중심</div>
+              <div class="transform-row__arrow">➜</div>
+              <div class="transform-row__to">시각화된 목적물, 소통, 투명성 중심</div>
+            </div>
+            
+            <div class="transform-row">
+              <div class="transform-row__from">2D 도면, 전문가, 규정</div>
+              <div class="transform-row__arrow">➜</div>
+              <div class="transform-row__to">3D 모델, 참여자, 실체</div>
+            </div>
+            
+            <div class="transform-row">
+              <div class="transform-row__from">업무 구분(단절), 책임</div>
+              <div class="transform-row__arrow">➜</div>
+              <div class="transform-row__to">협업(융·복합), 창의성</div>
+            </div>
+            
+          </div>
+        </div>
+        
+        
+      </div>
+
+      
+      <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+        
+        <div class="f29b__section-title">Copy & Paste로 인해 하향 평준화된 기존 성과물의 품질 향상</div>
+        <div class="text-line text-line--bullet">과거 수작업으로 시행하면서 발생하던 오류 등의 최소화</div><div class="text-line text-line--bullet">정확한 Data에 기반한 계획으로 고품질 성과물 도출</div>
+        
+      </div>
+
+      
+      
+      <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+        
+        <div class="f29b__section-title">GIS + BIM의 연계</div>
+        <div class="text-line text-line--bullet">지리·지형·지반 등 위치정보(GIS)와 3D모델(형상, 속성정보) 기반의 건설 정보를 포함하는 BIM의 연계를 통한 업무 프로세스의 혁신</div>
+        
+      </div>
+
+      
+      <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+        
+        <div class="f29b__section-title">Analogue 기반 도서 외 Digital 기반 정보물 추가</div>
+        <div class="text-line text-line--bullet">기존 성과물(도면, 수량, 계산서, 시방서 등)에 3D 모델, Simulation 등의 Digital 기반 정보물 추가</div>
+        
+        
+      </div>
+
+      
+      
+      <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+        
+        <div class="f29b__section-title">사용자 중심의 Solution 제공</div>
+        <div class="text-line text-line--bullet">서로 다른 S/W로 작성되어 분절화된 Analogue 방식의 성과물과 정보물을 연계할 수 있는 설계·시공 Solution 제공</div>
+        
+      </div>
+
+      
+      <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+        
+        <div class="f29b__section-title">Solution을 활용한 업무 효율화</div>
+        <div class="text-line text-line--bullet">Engn. Solution을 통해 성과물에 관한 이슈를 함께 검토·논의하는 협업 환경 조성</div><div class="text-line text-line--bullet">건설 단계별 정보를 디지털 데이터로 축적하여, 건설 전 과정을 통합관리</div>
+        
+      </div>
+
+    </div>
+
+  </div>
+</div>
+        </div>
+        
+      </div>
+    </div>
+    
+    <div class="slide-footer">
+      <div class="slide-footer-text">DX는 필요한 요건과 체계를 갖춘 후 시행해야만 그 효과를 기대할 수 있다.</div>
+    </div>
+    
+  </div>
+</body>
+</html>

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step01_mdx_source.md

@@ -0,0 +1,89 @@
+---
+title: DX 실행 체계 구축 방안
+sidebar:
+  order: 02
+---
+
+## 1. DX 시행을 위한 필수 요건
+
+<br/>
+
+* **기술(디지털)**
+  * **Digital 기술(S/W, H/W)과 업무 Process의 통합**
+    * 기존 업무 프로세스에 다양한 디지털 기술을 접목하여 업무 수행
+    * 프로젝트 전반에 걸친 업무 프로세스의 연결 및 조율
+  * **분야별 전문 지식(설계, 시공, 유지관리 등) 보유**
+    * 건설 전 단계에 대한 근본적인 이해와 지식 및 경험
+    * 최신 토목 기술 트랜드 및 표준 기준 등에 대한 높은 지식
+
+<br/>
+
+* **사람(역량)**
+  * **혁신적 사고방식과 창의적 문제 해결 능력**
+    * 기존 수행 방식과 관습적 사고 등에 의한 접근 방식 탈피
+    * 디지털 기술을 활용한 창의적, 혁신적인 솔루션 제시
+  * **사용자 중심 사고와 DX 수행 경험**
+    * 사용자의 요구와 기대를 충족시키는 설계 및 구현
+    * 시행착오를 포함한 수행 경험과 사용자 경험(UX)을 반영한 해결 방안 제시
+
+<br/>
+
+* **자연(여건)**
+  * **지속적인 투자 및 실행 의지**
+    * 기술 도입 초기 단계에 필요한 인력·기간·비용 등의 대규모 투자
+    * 기술 고도화를 위한 지속적인 개선 및 투자 체계 구축
+    * 변화와 혁신을 통해 부가가치를 창출하려는 실행 의지와 추진력
+
+<br/>
+---
+
+## 2. Process의 혁신과 Product의 변화
+
+<br/>
+
+### 2.1 과정(Process)의 혁신
+
+* **Analogue 기반 업무의 Digital화**
+
+  | As-is [Analogue] | 구분 | To-be [Digital] |
+  | :--- | :---: | :--- |
+  | **개념·문서·행정 절차 중심** | ➠ | **시각화된 목적물, 소통, 투명성 중심** |
+  | **2D 도면, 전문가, 규정** | ➠ | **3D 모델, 참여자, 실체** |
+  | **업무 구분(단절), 책임** | ➠ | **협업(융·복합), 창의성** |
+
+<br/>
+
+* **GIS + BIM의 연계**
+  * 지리·지형·지반 등 위치정보(GIS)와 3D모델(형상, 속성정보) 기반의 건설 정보를 포함하는 BIM의 연계를 통한 업무 프로세스의 혁신
+
+<br/>
+
+* **사용자 중심의 Solution 제공**
+  * 서로 다른 S/W로 작성되어 분절화된 Analogue 방식의 성과물과 정보물을 연계할 수 있는 설계·시공 Solution 제공
+
+<br/>
+<br/>
+
+### 2.2 결과(Product)의 변화
+
+* **Copy & Paste로 인해 하향 평준화된 기존 성과물의 품질 향상**
+  * 과거 수작업으로 시행하면서 발생하던 오류 등의 최소화
+  * 정확한 Data에 기반한 계획으로 고품질 성과물 도출
+
+<br/>
+
+* **Analogue 기반 도서 외 Digital 기반 정보물 추가**
+  * 기존 성과물(도면, 수량, 계산서, 시방서 등)에 3D 모델, Simulation 등의 Digital 기반 정보물 추가
+
+<br/>
+
+* **Solution을 활용한 업무 효율화**
+  * Engn. Solution을 통해 성과물에 관한 이슈를 함께 검토·논의하는 협업 환경 조성
+  * 건설 단계별 정보를 디지털 데이터로 축적하여, 건설 전 과정을 통합관리
+
+<br/>
+---
+
+:::note[핵심 요약]
+* **DX는 필요한 요건과 체계를 갖춘 후 시행해야만 그 효과를 기대할 수 있다.**
+:::

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step01_mdx_upload.json

@@ -0,0 +1,21 @@
+{
+  "step_num": 1,
+  "step_name": "mdx_upload",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "samples\\mdx_batch\\03.mdx"
+  ],
+  "output": [
+    "step01_mdx_upload.json",
+    "step01_mdx_source.md"
+  ],
+  "note": "MDX 원본 그대로 step01_mdx_source.md 에 복사.",
+  "data": {
+    "mdx_path": "samples\\mdx_batch\\03.mdx",
+    "run_id": "mdx03_f29_fix_check",
+    "run_dir": "d:\\ad-hoc\\kei\\design_agent\\data\\runs\\mdx03_f29_fix_check\\phase_z2",
+    "mdx_source_size_bytes": 3213,
+    "mdx_source_lines": 89
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step02_normalized.json

@@ -0,0 +1,36 @@
+{
+  "step_num": 2,
+  "step_name": "normalized",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step01_mdx_source.md"
+  ],
+  "output": [
+    "step02_normalized.json"
+  ],
+  "note": "parse_mdx 결과: title / sections / footer 분리 + raw_content 보존. heading tree 미생성, orphan / details 감지 미완 (Step 2 ⚠ partial — 별 axis). orphans / details 필드는 schema lock — 빈 배열이라도 'detection 미수행' marker.",
+  "data": {
+    "slide_title": "DX 실행 체계 구축 방안",
+    "slide_footer": "DX는 필요한 요건과 체계를 갖춘 후 시행해야만 그 효과를 기대할 수 있다.",
+    "sections_count": 2,
+    "sections": [
+      {
+        "section_id": "03-1",
+        "section_num": 1,
+        "title": "1. DX 시행을 위한 필수 요건",
+        "raw_content_length": 660,
+        "raw_content": "<br/>\n\n* **기술(디지털)**\n  * **Digital 기술(S/W, H/W)과 업무 Process의 통합**\n    * 기존 업무 프로세스에 다양한 디지털 기술을 접목하여 업무 수행\n    * 프로젝트 전반에 걸친 업무 프로세스의 연결 및 조율\n  * **분야별 전문 지식(설계, 시공, 유지관리 등) 보유**\n    * 건설 전 단계에 대한 근본적인 이해와 지식 및 경험\n    * 최신 토목 기술 트랜드 및 표준 기준 등에 대한 높은 지식\n\n<br/>\n\n* **사람(역량)**\n  * **혁신적 사고방식과 창의적 문제 해결 능력**\n    * 기존 수행 방식과 관습적 사고 등에 의한 접근 방식 탈피\n    * 디지털 기술을 활용한 창의적, 혁신적인 솔루션 제시\n  * **사용자 중심 사고와 DX 수행 경험**\n    * 사용자의 요구와 기대를 충족시키는 설계 및 구현\n    * 시행착오를 포함한 수행 경험과 사용자 경험(UX)을 반영한 해결 방안 제시\n\n<br/>\n\n* **자연(여건)**\n  * **지속적인 투자 및 실행 의지**\n    * 기술 도입 초기 단계에 필요한 인력·기간·비용 등의 대규모 투자\n    * 기술 고도화를 위한 지속적인 개선 및 투자 체계 구축\n    * 변화와 혁신을 통해 부가가치를 창출하려는 실행 의지와 추진력\n\n<br/>\n---"
+      },
+      {
+        "section_id": "03-2",
+        "section_num": 2,
+        "title": "2. Process의 혁신과 Product의 변화",
+        "raw_content_length": 924,
+        "raw_content": "<br/>\n\n### 2.1 과정(Process)의 혁신\n\n* **Analogue 기반 업무의 Digital화**\n\n  | As-is [Analogue] | 구분 | To-be [Digital] |\n  | :--- | :---: | :--- |\n  | **개념·문서·행정 절차 중심** | ➠ | **시각화된 목적물, 소통, 투명성 중심** |\n  | **2D 도면, 전문가, 규정** | ➠ | **3D 모델, 참여자, 실체** |\n  | **업무 구분(단절), 책임** | ➠ | **협업(융·복합), 창의성** |\n\n<br/>\n\n* **GIS + BIM의 연계**\n  * 지리·지형·지반 등 위치정보(GIS)와 3D모델(형상, 속성정보) 기반의 건설 정보를 포함하는 BIM의 연계를 통한 업무 프로세스의 혁신\n\n<br/>\n\n* **사용자 중심의 Solution 제공**\n  * 서로 다른 S/W로 작성되어 분절화된 Analogue 방식의 성과물과 정보물을 연계할 수 있는 설계·시공 Solution 제공\n\n<br/>\n<br/>\n\n### 2.2 결과(Product)의 변화\n\n* **Copy & Paste로 인해 하향 평준화된 기존 성과물의 품질 향상**\n  * 과거 수작업으로 시행하면서 발생하던 오류 등의 최소화\n  * 정확한 Data에 기반한 계획으로 고품질 성과물 도출\n\n<br/>\n\n* **Analogue 기반 도서 외 Digital 기반 정보물 추가**\n  * 기존 성과물(도면, 수량, 계산서, 시방서 등)에 3D 모델, Simulation 등의 Digital 기반 정보물 추가\n\n<br/>\n\n* **Solution을 활용한 업무 효율화**\n  * Engn. Solution을 통해 성과물에 관한 이슈를 함께 검토·논의하는 협업 환경 조성\n  * 건설 단계별 정보를 디지털 데이터로 축적하여, 건설 전 과정을 통합관리\n\n<br/>\n---"
+      }
+    ],
+    "orphans": [],
+    "details": []
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step05_v4_evidence.json

@@ -0,0 +1,63 @@
+{
+  "step_num": 5,
+  "step_name": "v4_evidence",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step02_normalized.json",
+    "tests/matching/v4_full32_result.yaml"
+  ],
+  "output": [
+    "step05_v4_evidence.json"
+  ],
+  "note": "V4 non-reject max-6 후보 list (Step 9 application_plan input). raw 32 entry 는 tests/matching/v4_full32_result.yaml 에 영속. candidate_status='ok' = 후보 1개 이상 / 'no_non_reject_v4_candidate' = 0개 (Step 9 fallback path 입력). Step 6 plan_composition() 은 lookup_v4_match() (rank-1) 그대로 사용 — backward compat (Step 6-A axis 까지).",
+  "data": {
+    "v4_source": "tests\\matching\\v4_full32_result.yaml",
+    "aligned_section_ids": [
+      "03-1",
+      "03-2"
+    ],
+    "evidence_per_section": [
+      {
+        "section_id": "03-1",
+        "v4_candidates": [
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "frame_number": 13,
+            "confidence": 0.9268,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "frame_number": 20,
+            "confidence": 0.8413,
+            "label": "light_edit"
+          }
+        ],
+        "candidate_status": "ok"
+      },
+      {
+        "section_id": "03-2",
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.9198,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "frame_number": 27,
+            "confidence": 0.6278,
+            "label": "restructure"
+          }
+        ],
+        "candidate_status": "ok"
+      }
+    ]
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step06_composition_plan.json

@@ -0,0 +1,180 @@
+{
+  "step_num": 6,
+  "step_name": "composition_plan",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step02_normalized.json",
+    "step05_v4_evidence.json"
+  ],
+  "output": [
+    "step06_composition_plan.json"
+  ],
+  "note": "composition v0 count-based — sections → candidates → score → greedy select. Step 6-A (사용자 lock 2026-05-08): selected_units[i].v4_candidates 추가 (non-reject max-6 후보 list, candidates[0] = 단일 frame_* 와 일관). logic 무변 — runtime 결과 동일. Step 9 application_plan input.",
+  "data": {
+    "selected_units_count": 2,
+    "layout_preset_decided": "horizontal-2",
+    "candidates_summary": [
+      {
+        "source_section_ids": [
+          "03-1"
+        ],
+        "merge_type": "single",
+        "template_id": "three_parallel_requirements",
+        "label": "use_as_is",
+        "phase_z_status": "matched_zone",
+        "score": 0.9268,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 3,
+          "source_shape": "top_bullets",
+          "capacity": {
+            "strict": 3,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      },
+      {
+        "source_section_ids": [
+          "03-2"
+        ],
+        "merge_type": "single",
+        "template_id": "process_product_two_way",
+        "label": "use_as_is",
+        "phase_z_status": "matched_zone",
+        "score": 0.9198,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 2,
+          "source_shape": "h3_subsections",
+          "capacity": {
+            "strict": 2,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      }
+    ],
+    "candidates_total": 2,
+    "candidates_viable_auto": 2,
+    "selected_units": [
+      {
+        "source_section_ids": [
+          "03-1"
+        ],
+        "merge_type": "single",
+        "frame_id": "1171281190",
+        "frame_number": 13,
+        "frame_template_id": "three_parallel_requirements",
+        "label": "use_as_is",
+        "score": 0.9268,
+        "phase_z_status": "matched_zone",
+        "rationale": {
+          "capacity_fit": {
+            "item_count": 3,
+            "source_shape": "top_bullets",
+            "capacity": {
+              "strict": 3,
+              "min": null,
+              "max": null,
+              "truncate_at": null,
+              "pad_to": null
+            },
+            "fit_status": "ok",
+            "mismatch_reason": null
+          },
+          "frame_compat": 0.9268,
+          "confidence": 0.9268,
+          "label": "use_as_is",
+          "label_weight": 1.0,
+          "merge_type": "single",
+          "hierarchy_coherence": null,
+          "density_score": null
+        },
+        "notes": [],
+        "v4_candidates": [
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "frame_number": 13,
+            "confidence": 0.9268,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "frame_number": 20,
+            "confidence": 0.8413,
+            "label": "light_edit"
+          }
+        ]
+      },
+      {
+        "source_section_ids": [
+          "03-2"
+        ],
+        "merge_type": "single",
+        "frame_id": "1171281210",
+        "frame_number": 29,
+        "frame_template_id": "process_product_two_way",
+        "label": "use_as_is",
+        "score": 0.9198,
+        "phase_z_status": "matched_zone",
+        "rationale": {
+          "capacity_fit": {
+            "item_count": 2,
+            "source_shape": "h3_subsections",
+            "capacity": {
+              "strict": 2,
+              "min": null,
+              "max": null,
+              "truncate_at": null,
+              "pad_to": null
+            },
+            "fit_status": "ok",
+            "mismatch_reason": null
+          },
+          "frame_compat": 0.9198,
+          "confidence": 0.9198,
+          "label": "use_as_is",
+          "label_weight": 1.0,
+          "merge_type": "single",
+          "hierarchy_coherence": null,
+          "density_score": null
+        },
+        "notes": [],
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.9198,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "frame_number": 27,
+            "confidence": 0.6278,
+            "label": "restructure"
+          }
+        ]
+      }
+    ]
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step07_layout.json

@@ -0,0 +1,79 @@
+{
+  "step_num": 7,
+  "step_name": "layout",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step06_composition_plan.json"
+  ],
+  "output": [
+    "step07_layout.json",
+    "step07_selected_layout.html"
+  ],
+  "note": "count-based v0 — 들여쓰기 / 정렬 미세 layout 미구현 (Step 7 ⚠ partial). Step 7-conn (사용자 lock 2026-05-08): unit_count → layout_candidates list (select_layout_candidates) artifact 기록. default 결정 자체는 무변 — candidates[0] 가 default (default_selection: true), 나머지는 alternative. Step 9 application_plan input.",
+  "data": {
+    "layout_preset": "horizontal-2",
+    "layout_css": {
+      "areas": "\"top\" \"bottom\"",
+      "cols": "1fr",
+      "rows": "228px 343px",
+      "heights_px": [
+        228,
+        343
+      ],
+      "ratios": [
+        0.39,
+        0.586
+      ],
+      "computation": "min_height_first + content_weight_distribution",
+      "dynamic_rows": true,
+      "raw_zone_layout": {
+        "computation": "min_height_first + content_weight_distribution",
+        "slide_body_height": 585,
+        "gap": 14,
+        "available_after_gap": 571,
+        "min_heights_px": [
+          228,
+          342
+        ],
+        "min_scaled": true,
+        "total_min_height": 570,
+        "remaining_after_min": 1,
+        "content_weights": [
+          {
+            "position": "top",
+            "template_id": "three_parallel_requirements",
+            "score": 4.425
+          },
+          {
+            "position": "bottom",
+            "template_id": "process_product_two_way",
+            "score": 7.305
+          }
+        ],
+        "weight_shares": [
+          0.377,
+          0.623
+        ],
+        "extras_px": [
+          0,
+          1
+        ],
+        "heights_px": [
+          228,
+          343
+        ],
+        "ratios": [
+          0.39,
+          0.586
+        ]
+      }
+    },
+    "zones_count": 2,
+    "unit_count": 2,
+    "layout_candidates": [
+      "horizontal-2",
+      "vertical-2"
+    ]
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step08_zone_region_ratios.json

@@ -0,0 +1,122 @@
+{
+  "step_num": 8,
+  "step_name": "zone_region_ratios",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step07_layout.json",
+    "step10_frame_contract.json"
+  ],
+  "output": [
+    "step08_zone_region_ratios.json",
+    "step08_zone_content_placement.html"
+  ],
+  "note": "계획값 only. 실측값은 Step 14 (visual_check). zone-level 만 dynamic, region-level (sub_zone 안 sections) 은 균등 분배 (1/1/1). F29 처럼 비균등 콘텐츠 (transform_table + plain) 는 첫 cell 부족 가능 — Step 8 ⚠ partial. Step 8-conn (사용자 lock 2026-05-08): per_zone_plan[i] 에 region_layout_candidates + display_strategy_candidates 추가 (passive 기록). placeholder signals = text-only / region_count=1 (Step 3/4 부재 종속). 실제 content_object 신호 활성화는 별 axis. Step 9 application_plan input.",
+  "data": {
+    "zone_heights_px_planned": [
+      228,
+      343
+    ],
+    "zone_ratios_planned": [
+      0.39,
+      0.586
+    ],
+    "per_zone_plan": [
+      {
+        "position": "top",
+        "zone_height_px_planned": 228,
+        "zone_ratio_planned": 0.39,
+        "min_height_px": 230,
+        "frame_cardinality_strict": 3,
+        "sub_zones_planned": [
+          {
+            "id": "pillar_1",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": 1,
+            "partial_target_path": ".f13b__cols > .f13b__col:nth-child(1)"
+          },
+          {
+            "id": "pillar_2",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": 1,
+            "partial_target_path": ".f13b__cols > .f13b__col:nth-child(2)"
+          },
+          {
+            "id": "pillar_3",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": 1,
+            "partial_target_path": ".f13b__cols > .f13b__col:nth-child(3)"
+          }
+        ],
+        "child_distribution_note": "현재 child zone (sub_zones 안 sections) 균등 분배 — Step 8 region-level ratio ⚠ partial.",
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ]
+      },
+      {
+        "position": "bottom",
+        "zone_height_px_planned": 343,
+        "zone_ratio_planned": 0.586,
+        "min_height_px": 345,
+        "frame_cardinality_strict": 2,
+        "sub_zones_planned": [
+          {
+            "id": "process_column",
+            "role": "main_text",
+            "accepts": [
+              "text_block",
+              "transform_table"
+            ],
+            "cardinality_strict": 3,
+            "partial_target_path": ".f29b__grid .f29b__cell--left"
+          },
+          {
+            "id": "product_column",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": 3,
+            "partial_target_path": ".f29b__grid .f29b__cell--right"
+          }
+        ],
+        "child_distribution_note": "현재 child zone (sub_zones 안 sections) 균등 분배 — Step 8 region-level ratio ⚠ partial.",
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ]
+      }
+    ],
+    "step8_conn_placeholder_signals": {
+      "region_count": 1,
+      "content_type": "text_block",
+      "flow_type": null,
+      "role_pattern": null,
+      "ratio_asymmetric": false,
+      "has_visual_element": false,
+      "details_presence": false,
+      "large_table": false,
+      "long_text": false,
+      "fits_in_region": null,
+      "_note": "Step 3/4 부재 종속 placeholder — 모든 zone 을 text-only / region_count=1 로 가정. 실제 content_object 신호 활성화는 별 axis."
+    }
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step09_application_plan.json

@@ -0,0 +1,135 @@
+{
+  "step_num": 9,
+  "step_name": "application_plan",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step05_v4_evidence.json",
+    "step06_composition_plan.json",
+    "step07_layout.json",
+    "step08_zone_region_ratios.json"
+  ],
+  "output": [
+    "step09_application_plan.json",
+    "step09_application_plan.html"
+  ],
+  "note": "Step 9 v0 passive application_plan trace (사용자 lock 2026-05-08). V4 후보 + layout / region / display 후보 + V4 label → application_mode 변환을 side-by-side 로 기록. v0 invariant 5 가지 (status.md §4) 만족. Step 6 의 default 결정 그대로 (current_default_candidate). auto decision 은 Step 9 v1 (별 axis). region/display 후보는 Step 8-conn 의 placeholder signal 종속 (Step 3/4 부재).",
+  "data": {
+    "units": [
+      {
+        "unit_id": "03-1",
+        "layout_preset": "horizontal-2",
+        "layout_candidates": [
+          "horizontal-2",
+          "vertical-2"
+        ],
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ],
+        "candidate_status": "ok",
+        "application_status": "ok",
+        "current_default_candidate": "three_parallel_requirements",
+        "v4_candidates": [
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "frame_number": 13,
+            "confidence": 0.9268,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "frame_number": 20,
+            "confidence": 0.8413,
+            "label": "light_edit"
+          }
+        ],
+        "application_candidates": [
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "v4_label": "use_as_is",
+            "application_mode": "direct_insert",
+            "auto_applicable": true,
+            "required_changes": [],
+            "delegated_to": "step10_contract_check"
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "v4_label": "light_edit",
+            "application_mode": "same_frame_with_adjustment",
+            "auto_applicable": true,
+            "required_changes": [],
+            "delegated_to": "step10_contract_check"
+          }
+        ]
+      },
+      {
+        "unit_id": "03-2",
+        "layout_preset": "horizontal-2",
+        "layout_candidates": [
+          "horizontal-2",
+          "vertical-2"
+        ],
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ],
+        "candidate_status": "ok",
+        "application_status": "ok",
+        "current_default_candidate": "process_product_two_way",
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.9198,
+            "label": "use_as_is"
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "frame_number": 27,
+            "confidence": 0.6278,
+            "label": "restructure"
+          }
+        ],
+        "application_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "v4_label": "use_as_is",
+            "application_mode": "direct_insert",
+            "auto_applicable": true,
+            "required_changes": [],
+            "delegated_to": "step10_contract_check"
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "v4_label": "restructure",
+            "application_mode": "layout_or_region_change",
+            "auto_applicable": false,
+            "required_changes": [],
+            "delegated_to": "human_review"
+          }
+        ]
+      }
+    ],
+    "candidate_status_summary": {
+      "units_with_no_v4_candidate": []
+    },
+    "v0_lock_note": "Step 9 v0 passive (사용자 lock 2026-05-08). Step 6 default 그대로 사용 — runtime 결과 byte-동일. auto decision / scoring 은 Step 9 v1 (별 axis)."
+  }
+}

Front/client/public/data/runs/mdx03_f29_fix_check/steps/step20_slide_status.json

@@ -0,0 +1,38 @@
+{
+  "step_num": 20,
+  "step_name": "slide_status",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step14_visual_check.json",
+    "step17_retry_trace.json",
+    "step19_next_action.json"
+  ],
+  "output": [
+    "step20_slide_status.json",
+    "step20_final_status.html"
+  ],
+  "note": "자동 파이프라인 최종 결과 보고. overall = PASS/RENDERED_WITH_VISUAL_REGRESSION/PARTIAL_COVERAGE 등.",
+  "data": {
+    "rendered": true,
+    "visual_check_passed": true,
+    "full_mdx_coverage": true,
+    "aligned_section_ids": [
+      "03-1",
+      "03-2"
+    ],
+    "covered_section_ids": [
+      "03-1",
+      "03-2"
+    ],
+    "filtered_section_ids": [],
+    "filtered_section_reasons": [],
+    "visual_fail_reasons": [],
+    "adapter_needed_count": 0,
+    "adapter_needed_units": [],
+    "content_truncated_count": 0,
+    "content_truncated_units": [],
+    "overall": "PASS",
+    "note": "자동 파이프라인 결과 보고. review/UI 개념 X. final.html 파일명 != PASS 의미. overall == PASS 는 visual OK + full coverage + adapter_needed=0 일 때만. adapter_needed_count > 0 = mapper 가 contract 와 안 맞아 자동 렌더 못 한 zone 존재. content_truncated_count > 0 = builder 가 truncate 한 zone 존재 (rendered 됐지만 일부 콘텐츠 손실)."
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/final.html

@@ -0,0 +1,992 @@
+<!-- Phase Z-2 MVP-1.5b — single slide + Type B layout (top/bottom zones).
+     원래 Phase Z 설계 복귀: MDX 1 = slide 1, layout preset = zone 분할, frame-derived block ⊂ zone. -->
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=1280">
+  <title>DX 지연 요인</title>
+  <style>
+    /* ── existing tokens (inlined) ── */
+    /* === typography.css === */
+/* ══════════════════════════════════════
+   Typography Tokens v1
+   ══════════════════════════════════════
+   슬라이드 전체의 공통 글자 위계.
+   모든 블록은 이 토큰을 참조한다.
+   직접값(font-size: 11px) 금지 → var(--font-body) 사용.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ── 1층: Global Hierarchy ── */
+
+  /* 대목차: 슬라이드 상단 제목 */
+  --font-slide-title: 22px;
+  --weight-slide-title: 700;
+  --lh-slide-title: 1.4;
+
+  /* 중목차: zone 제목 */
+  --font-zone-title: 16px;
+  --weight-zone-title: 700;
+  --lh-zone-title: 1.4;
+
+  /* 소목차: 블록 내 소제목, 카드 제목 */
+  --font-sub-title: 12px;
+  --weight-sub-title: 700;
+  --lh-sub-title: 1.45;
+
+  /* 본문: 블릿, 설명 텍스트 */
+  --font-body: 10px;
+  --weight-body: 500;
+  --lh-body: 1.55;
+
+  /* 캡션: 각주, 출처, 보조 텍스트 */
+  --font-caption: 10px;
+  --weight-caption: 400;
+  --lh-caption: 1.4;
+
+  /* footer: 핵심 인사이트 pill */
+  --font-footer: 20px;
+  --weight-footer: 700;
+  --lh-footer: 1.2;
+
+  /* ── 2층: Component Semantic Tokens ── */
+  /* 가까운 위계에서 기본값, 필요시 override */
+
+  /* 본문 강조 (인라인 heading) */
+  --font-body-strong: var(--font-body);
+  --weight-body-strong: 600;
+
+  /* 자세히보기 링크 */
+  --font-detail-link: var(--font-caption);
+  --weight-detail-link: 500;
+
+  /* pill/badge 라벨 */
+  --font-pill-label: var(--font-sub-title);
+  --weight-pill-label: 700;
+
+  /* 표 헤더 */
+  --font-table-header: var(--font-sub-title);
+  --weight-table-header: 700;
+
+  /* 표 셀 */
+  --font-table-cell: var(--font-body);
+  --weight-table-cell: 400;
+
+  /* 비교 뱃지 */
+  --font-compare-badge: var(--font-sub-title);
+  --weight-compare-badge: 700;
+
+  /* 강조 인용 */
+  --font-callout: var(--font-sub-title);
+  --weight-callout: 700;
+
+  /* 상단 라벨 (overline) */
+  --font-overline: var(--font-caption);
+  --weight-overline: 600;
+  --ls-overline: 0.05em;
+}
+
+
+/* === spacing.css === */
+/* ══════════════════════════════════════
+   Spacing Tokens v1
+   ══════════════════════════════════════
+   여백/간격/들여쓰기 공통 기준.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ── 기본 스케일 ── */
+  --space-xs: 4px;
+  --space-sm: 8px;
+  --space-md: 12px;
+  --space-lg: 16px;
+  --space-xl: 24px;
+
+  /* ── slide-base 레이아웃 ── */
+  --slide-padding-x: 40px;       /* 본문 좌우 여백 */
+  --slide-title-left: 52px;      /* 대목차 시작 */
+  --slide-title-top: 22px;       /* 대목차 위치 */
+  --slide-divider-top: 58px;     /* 구분선 위치 (slide_base.html 와 일치 2026-05-07) */
+  --slide-body-top: 76px;        /* 본문 시작 (사용자 직설: divider-body 16px) */
+  --slide-body-height: 585px;    /* 본문 높이 (사용자 직설: body-footer 10px) */
+  --slide-footer-bottom: 8px;    /* footer 하단 여백 (slide_base.html 와 일치) */
+  --slide-footer-height: 41px;   /* footer 높이 */
+
+  /* ── zone ── */
+  --zone-gap: 8px;               /* zone 간 간격 */
+  --zone-padding-left: 12px;     /* zone 안쪽 좌측 여백 */
+  --zone-padding-right: 8px;     /* zone 안쪽 우측 여백 */
+  --zone-title-mb: 8px;          /* zone 제목 아래 여백 */
+
+  /* ── 블록 공통 ── */
+  --card-padding: 16px;          /* 카드 내부 여백 */
+  --card-padding-sm: 8px;        /* 작은 카드 내부 여백 */
+  --card-gap: 12px;              /* 카드 간 간격 */
+  --card-radius: 6px;            /* 카드 모서리 */
+
+  /* ── 블릿/텍스트 ── */
+  --bullet-indent: 14px;         /* 불릿 hanging indent */
+  --bullet-gap: 2px;             /* 불릿 항목 간 간격 */
+  --heading-gap: 4px;            /* 소제목 아래 간격 */
+  --section-gap: 10px;           /* 섹션 간 간격 */
+
+  /* ── flex/grid 기본 ── */
+  --flex-gap: 12px;              /* 기본 flex gap */
+  --flex-gap-sm: 6px;            /* 좁은 flex gap */
+  --grid-gap: 16px;              /* 기본 grid gap */
+}
+
+
+/* === colors.css === */
+/* ══════════════════════════════════════
+   Color Tokens v1
+   ══════════════════════════════════════
+   2층 구조: 공통 테마색 + 블록 의미색.
+   ══════════════════════════════════════ */
+
+:root {
+  /* ══ 1층: 공통 테마색 ══ */
+  /* 모든 블록이 공유하는 기본 팔레트 */
+
+  /* 텍스트 */
+  --color-title: #1e293b;             /* 제목 (진한 남색) */
+  --color-zone-title: #1a365d;        /* zone 중목차 제목 */
+  --color-body: #475569;              /* 본문 */
+  --color-body-strong: #1e293b;       /* 본문 강조 */
+  --color-caption: #94a3b8;           /* 캡션, 보조 */
+  --color-muted: #64748b;             /* 약한 텍스트 */
+
+  /* 배경 */
+  --color-bg: #ffffff;                /* 슬라이드 배경 */
+  --color-bg-subtle: #f8fafc;         /* 카드/영역 배경 */
+  --color-bg-page: #e8ecf0;           /* 페이지 배경 (슬라이드 바깥) */
+
+  /* 보더 */
+  --color-border: #e2e8f0;            /* 기본 보더 */
+  --color-border-strong: #cbd5e1;     /* 강한 보더 */
+
+  /* 강조 */
+  --color-accent: #2563eb;            /* 링크, 강조 (파랑) */
+  --color-accent-hover: #eff6ff;      /* 링크 hover 배경 */
+  --color-danger: #dc2626;            /* 경고, 에러 */
+
+  /* slide-base 전용 */
+  --color-slide-title-from: #296b55;  /* 대목차 gradient 시작 */
+  --color-slide-title-to: #123328;    /* 대목차 gradient 끝 */
+  --color-footer-bg-from: #3b3523;    /* footer gradient 시작 */
+  --color-footer-bg-mid: #263a2a;     /* footer gradient 중간 */
+  --color-footer-bg-to: #113f31;      /* footer gradient 끝 */
+  --color-footer-text: #ffffff;       /* footer 텍스트 */
+  --color-footer-accent: #ffee33;     /* footer 강조 (em) */
+
+  /* ══ 2층: 블록 의미색 ══ */
+  /* 특정 블록 유형에서 의미를 가지는 색 */
+
+  /* 3열 비교 (prerequisites-3col) */
+  --color-col-1-from: #0D78D0;        /* 1열 gradient 시작 */
+  --color-col-1-to: #023056;          /* 1열 gradient 끝 */
+  --color-col-2-from: #FF9A23;        /* 2열 gradient 시작 */
+  --color-col-2-to: #CC5200;          /* 2열 gradient 끝 */
+  --color-col-3-from: #39BE49;        /* 3열 gradient 시작 */
+  --color-col-3-to: #23742C;          /* 3열 gradient 끝 */
+
+  /* 비교 블록 (compare) */
+  --color-compare-left: #5c3714;      /* 좌측 (AS-IS 계열) */
+  --color-compare-right: #285b4a;     /* 우측 (TO-BE 계열) */
+  --color-compare-badge: #ae3607;     /* VS 뱃지 */
+
+  /* 다크 카드 (direct render) */
+  --color-dark-card-1: #1a365d;       /* 카드 1 배경 */
+  --color-dark-card-2: #1e3a2f;       /* 카드 2 배경 */
+  --color-dark-card-3: #3b1f2b;       /* 카드 3 배경 */
+  --color-dark-card-title: #fbbf24;   /* 다크카드 제목 (금색) */
+  --color-dark-card-body: #e2e8f0;    /* 다크카드 본문 */
+
+  /* 표 */
+  --color-table-header-bg: #64748b;   /* 표 헤더 배경 */
+  --color-table-header-text: #ffffff; /* 표 헤더 텍스트 */
+
+  /* 블록 제목 gradient (Figma 원본) */
+  --color-block-title-from: #CC5200;  /* 주황 gradient 시작 */
+  --color-block-title-to: #883700;    /* 주황 gradient 끝 */
+
+  /* pill */
+  --color-pill-bg: #1e293b;           /* pill 배경 */
+  --color-pill-text: #ffffff;         /* pill 텍스트 */
+}
+
+
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+      background: #e8ecf0;
+      display: flex; justify-content: center; align-items: center;
+      min-height: 100vh;
+      word-break: keep-all;
+      padding: 20px 0;
+    }
+
+    /* ── 16:9 슬라이드 (single, 1280×720) ── */
+    .slide {
+      width: 1280px; height: 720px;
+      position: relative;
+      overflow: hidden;
+      background: #fff;
+      box-shadow: 0 4px 20px rgba(0,0,0,.15);
+      flex-shrink: 0;
+    }
+    .slide-bg {
+      position: absolute; inset: 0;
+      background: linear-gradient(180deg, #f0f0f0 0%, #ffffff 100%);
+      z-index: 0;
+    }
+    .slide-title {
+      position: absolute;
+      left: 52px; top: 22px;
+      width: calc(100% - 104px);
+      font-weight: 700;
+      font-size: var(--font-slide-title);
+      line-height: var(--lh-slide-title);
+      background-image: linear-gradient(180deg, #296b55 0%, #123328 100%);
+      -webkit-background-clip: text; background-clip: text;
+      color: transparent;
+      text-shadow: 0 0 2px #322c1e;
+      z-index: 2;
+    }
+    .slide-divider {
+      position: absolute;
+      left: 50px; top: 58px;
+      width: calc(100% - 100px);
+      height: 2px;
+      background: #cbd5e1;
+      z-index: 2;
+    }
+    .slide-body {
+      position: absolute;
+      left: 50px; top: 76px;
+      width: calc(100% - 100px);  /* 1180 */
+      height: 585px;
+      z-index: 1;
+      overflow: hidden;
+    }
+
+    /* ── Layout preset (composition planner v0 — 8 vocabulary) ──
+         단일 .layout-{preset} 클래스에 grid CSS 주입.
+         layout_css = pipeline build_layout_css() 결과 :
+           - horizontal-2 : rows = dynamic px (content_weight + frame_min_height)
+           - 그 외       : rows / cols = fr default (LAYOUT_PRESETS)
+         positions (single / top / bottom / left / right / top-left / ... / grid-2x2 9개)
+         은 .zone 의 inline grid-area 로 지정 — preset CSS 는 areas 만 정의. */
+    .layout-horizontal-2 {
+      display: grid;
+      grid-template-columns: 1fr;
+      grid-template-rows: 211px 360px;
+      grid-template-areas: "top" "bottom";
+      gap: 14px;
+      height: 100%;
+    }
+
+    /* ── Zone — block 가용 공간 최대화. 프레임 자체 styling 이 boundary 역할 ── */
+    .zone {
+      position: relative;
+      overflow: hidden;
+      padding: 0;
+      min-width: 0;
+      min-height: 0;
+    }
+
+    /* ── Frame-family text layout contract (shared, reusable) ──
+         feedback-1 (mvp1.5b_test7): visible improvement 강화.
+         Stronger hanging indent + breathing line spacing + visible hierarchy. */
+    .text-line {
+      font-size: var(--font-body);          /* 11px */
+      font-weight: var(--weight-body);
+      line-height: 1.6;                     /* breathing room */
+      margin: 0;
+    }
+    .text-line + .text-line {
+      margin-top: 4px;                      /* visible gap between lines (was 2px) */
+    }
+
+    /* bullet line — hanging indent via padding + absolute marker (안정적) */
+    .text-line--bullet {
+      padding-left: 14px;
+      position: relative;
+    }
+    .text-line--bullet::before {
+      content: "•";                         /* visible bullet 마커 */
+      position: absolute;
+      left: 2px;
+      top: 0;
+      font-weight: 700;
+      line-height: inherit;
+      color: inherit;
+    }
+    /* indent levels — visible nested hierarchy */
+    .text-line--indent-1 {
+      padding-left: 30px;
+    }
+    .text-line--indent-1::before {
+      content: "◦";                         /* sub-bullet 다른 마커 */
+      left: 18px;
+    }
+    .text-line--indent-2 {
+      padding-left: 46px;
+    }
+    .text-line--indent-2::before {
+      content: "▪";
+      left: 34px;
+    }
+    /* body line — 마커 없음 */
+    .text-line--body {
+      padding-left: 0;
+    }
+    .text-line strong { color: #000; font-weight: 700; }
+
+    /* ── Transform-block family (frame 29 AS-IS/TO-BE dedicated comparison component) ──
+         feedback-3: bullet rows 가 아닌 *전용 비교 component*. Header (AS-IS / TO-BE) + paired rows.
+         color-coded cells, left-border accent → 단번에 *비교 구조* 인지. */
+    .transform-block {
+      margin-top: 4px;
+      padding: 6px 8px 6px;
+      background: rgba(255, 255, 255, 0.4);
+      border-radius: 3px;
+      border: 1px solid rgba(0,0,0,0.05);
+    }
+    .transform-block__header {
+      display: grid;
+      grid-template-columns: 1fr 22px 1fr;
+      gap: 6px;
+      margin-bottom: 4px;
+      padding-bottom: 3px;
+      border-bottom: 1px dashed rgba(0,0,0,0.12);
+      font-size: 9px;
+      font-weight: 900;
+      letter-spacing: 0.5px;
+    }
+    .transform-block__label--from { color: #6b5444; }
+    .transform-block__label--to { color: #2563eb; text-align: left; }
+    .transform-rows {
+      display: flex; flex-direction: column;
+      gap: 4px;
+    }
+    .transform-row {
+      display: grid;
+      grid-template-columns: 1fr 22px 1fr;
+      gap: 6px;
+      align-items: stretch;
+      font-size: var(--font-body);
+      line-height: 1.45;
+    }
+    .transform-row__from {
+      padding: 3px 8px;
+      background: linear-gradient(90deg, rgba(140,120,90,0.16), rgba(140,120,90,0.08));
+      border-left: 2px solid #b8a98a;
+      border-radius: 2px;
+      color: #4b3f30;
+      font-weight: 500;
+    }
+    .transform-row__arrow {
+      text-align: center;
+      color: #2563eb;
+      font-weight: 900;
+      font-size: 14px;
+      align-self: center;
+    }
+    .transform-row__to {
+      padding: 3px 8px;
+      background: linear-gradient(90deg, rgba(37,99,235,0.10), rgba(37,99,235,0.18));
+      border-left: 2px solid #2563eb;
+      border-radius: 2px;
+      color: #1e40af;
+      font-weight: 700;
+    }
+
+    /* ── Footer pill — feedback-3: body 와 weight balance, 살짝 가벼워짐 ── */
+    .slide-footer {
+      position: absolute;
+      left: 50px; bottom: 8px;
+      width: calc(100% - 100px);             /* front 기준 (body 와 정렬) */
+      height: 41px;                          /* front 기준 */
+      border-radius: 999px;
+      overflow: hidden;
+      z-index: 2;
+      display: flex; align-items: center; justify-content: center;
+      background: linear-gradient(90deg, #3b3523 5%, #263a2a 50%, #113f31 95%);
+      opacity: 0.92;                         /* slightly lighter */
+    }
+    .slide-footer-text {
+      position: relative; z-index: 1;
+      font-size: 15px;                       /* was 20px (--font-footer) */
+      font-weight: 700;
+      line-height: 1.2;
+      color: #fff;
+      text-align: center;
+      text-shadow: 0 0 3px rgba(0,0,0,.4);
+      letter-spacing: -0.01em;
+    }
+    .slide-footer-text em { color: #fe3; font-style: normal; }
+
+    .phase-z2-marker {
+      position: absolute;
+      top: 4px; right: 8px;
+      font-size: 9px; color: #94a3b8;
+      font-family: monospace;
+      z-index: 3;
+    }
+  </style>
+</head>
+<body>
+  <div class="slide" data-page="1">
+    <div class="slide-bg"></div>
+    <div class="phase-z2-marker">phase_z2 / mvp-1.5b / horizontal-2 / single slide</div>
+    <div class="slide-title">DX 지연 요인</div>
+    <div class="slide-divider"></div>
+    <div class="slide-body">
+      <div class="layout-horizontal-2">
+        
+        <div class="zone" data-zone-position="top" data-template-id="pre_construction_model_info_stacked" style="grid-area: top;">
+          <!-- Phase Z-2 신규 frame partial — Frame 9 (1171281180) pre_construction_model_info_stacked.
+     2026-05-14 — V4 04-1 top rank-1 매칭 (의미 conf=0.722) + structure cardinality 5 일치.
+     사용자 룰 부합 : Figma visual (계단 pill / 5 색상 / vertical label) 유지 + 콘텐츠 cardinality
+     에 맞춰 보완 (pill 안 1 라인 → multi-line: pill_N_label + pill_N_body). -->
+
+
+<style>
+  .f9b {
+    width: 100%; height: 100%;
+    display: flex; flex-direction: column;
+    gap: 6px;
+    font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+    word-break: keep-all;
+    position: relative;
+  }
+
+  /* 2026-05-14 — title 스타일 통일 (frame 29 process_product_two_way 와 동일 패턴) :
+     배경 box + box-shadow 제거, gradient 텍스트 만 유지. 사용자 룰 Q1. */
+  .f9b__title {
+    font-size: var(--font-zone-title);
+    font-weight: 700;
+    line-height: var(--lh-zone-title);
+    background-image: linear-gradient(180deg, #000 0%, #883700 100%);
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    flex-shrink: 0;
+    padding-left: 4px;
+  }
+
+  .f9b__body {
+    flex: 1;
+    display: flex;
+    flex-direction: row;
+    gap: 8px;
+    min-height: 0;
+  }
+
+  /* 좌측 vertical label — 콘텐츠 있을 때만 표시 */
+  .f9b__vlabel {
+    flex: 0 0 auto;
+    width: 56px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-weight: 700;
+    font-size: var(--font-sub-title);
+    line-height: 1.2;
+    color: #144838;
+    text-align: center;
+    writing-mode: vertical-rl;
+    text-orientation: upright;
+    text-shadow: 0 2px 2px rgba(0,0,0,0.15);
+  }
+
+  /* 2026-05-14 — pill 배치 vertical → horizontal (grid). 5 pills 를 가로로 나열 →
+     우측 공란 활용 + 세로 공간 절약. auto-fit + minmax 으로 N 동적 (4 / 5 / 6 모두 자동). */
+  .f9b__pill-rows {
+    flex: 1;
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+    gap: 6px;
+    min-height: 0;
+  }
+
+  /* 2026-05-14 — bullet 줄간격 1/3 으로 압축 + 다른 간격 (padding, label↔body) 살짝 늘림. */
+  .f9b__pill {
+    min-height: 0;
+    background: rgba(255,255,255,0.7);
+    border-radius: 10px;
+    border-bottom: 3px solid;
+    box-shadow: 1px 2px 4px rgba(0,0,0,0.15);
+    padding: 8px 12px;
+    display: flex;
+    flex-direction: column;
+    gap: 5px;
+    overflow: hidden;
+    align-self: start;
+  }
+  /* Figma frame 9 의 5 색상 — nth-child cycle. N>5 면 default border-bottom 색 (회색). */
+  .f9b__pill:nth-child(5n+1) { border-bottom-color: #fb5915; }
+  .f9b__pill:nth-child(5n+2) { border-bottom-color: #e79000; }
+  .f9b__pill:nth-child(5n+3) { border-bottom-color: #e9a804; }
+  .f9b__pill:nth-child(5n+4) { border-bottom-color: #919f00; }
+  .f9b__pill:nth-child(5n)   { border-bottom-color: #0d6361; }
+
+  .f9b__pill-label {
+    font-size: var(--font-sub-title);
+    font-weight: 900;
+    line-height: 1.2;
+    color: #144838;
+    margin-bottom: 4px;
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+  /* arrow indicator — Figma frame 9 의 좌측 화살표 (▶) approximation */
+  .f9b__pill-label::before {
+    content: "▶";
+    flex-shrink: 0;
+    color: currentColor;
+    font-size: 0.85em;
+  }
+
+  /* 2026-05-14 — bullet 줄간격 1/3 으로 압축 : line-height 1.3 → 1.05 (약 1/3 감소).
+     bullet 간 gap 2 → 1 로 더 압축. 가독성 임계 (한 bullet 안 line wrap 시 라인 겹침 직전). */
+  .f9b__pill-body {
+    flex: 1 1 auto;
+    overflow: hidden;
+    min-height: 0;
+    color: #0c271e;
+    font-size: var(--font-body);
+    line-height: 1.05;
+    display: flex;
+    flex-direction: column;
+    gap: 1px;
+  }
+
+  /* 첫 line = 인용구 (italic + 무 마커) — 04-1 의 따옴표 인용구 패턴 */
+  .f9b__pill-body .text-line:first-child {
+    font-style: italic;
+    color: #5C3714;
+    padding-left: 0;
+  }
+  /* 이후 lines = 각 이슈 bullet (▪ 마커로 구분 강화) */
+  .f9b__pill-body .text-line:not(:first-child) {
+    position: relative;
+    padding-left: 12px;
+  }
+  .f9b__pill-body .text-line:not(:first-child)::before {
+    content: "▪";
+    position: absolute;
+    left: 0;
+    color: #919f00;
+    font-size: 0.9em;
+  }
+</style>
+
+<div class="f9b" data-frame-id="1171281180" data-template-id="pre_construction_model_info_stacked">
+  <div class="f9b__title">1. DX에 대한 인식</div>
+  <div class="f9b__body">
+    
+    
+
+    <div class="f9b__pill-rows">
+      
+      
+        
+        
+        
+        <div class="f9b__pill" data-frame-slot-id="pill_dynamic" data-pill-n="1">
+          
+          <div class="f9b__pill-label">기술 및 소프트웨어 이해도</div>
+          
+          
+          <div class="f9b__pill-body">
+            <div class="text-line">"무슨 말인지 잘 모르겠다, 어디까지 어떻게 해야 하는지 모르겠다"</div><div class="text-line">기본지침, 시행지침 등 새롭게 알아야 할 게 너무 많다.</div><div class="text-line">3D 모델과 별 차이점을 모르겠다. S/W마다 사용법이 다르다.</div><div class="text-line">필요한 것은 쉽고 간단한 건데, 왜 이렇게 복잡하게 만들까?</div>
+          </div>
+          
+        </div>
+        
+      
+        
+        
+        
+        <div class="f9b__pill" data-frame-slot-id="pill_dynamic" data-pill-n="2">
+          
+          <div class="f9b__pill-label">효과와 효율성</div>
+          
+          
+          <div class="f9b__pill-body">
+            <div class="text-line">"2D 설계 후 전환설계를 수행하는데 효과는 모르겠고, 효율은 낮다"</div><div class="text-line">성과품 작성은 기존과 같게 하고, 추가 업무만 발생해 효율이 낮다.</div><div class="text-line">BIM으로 인해 가중되는 업무 대비 효과가 거의 없어 보인다.</div><div class="text-line">결과적으로 큰 차이를 못 느끼겠고, 이런 노력이 정말 가치 있는 일이야?</div>
+          </div>
+          
+        </div>
+        
+      
+        
+        
+        
+        <div class="f9b__pill" data-frame-slot-id="pill_dynamic" data-pill-n="3">
+          
+          <div class="f9b__pill-label">인력 및 교육</div>
+          
+          
+          <div class="f9b__pill-body">
+            <div class="text-line">"수행 인력이 부족하고, 기존 직원들은 어떻게 교육해야 하나"</div><div class="text-line">교육시간 손실로 일손이 더 필요해지고, 적응하는데도 시간이 걸린다.</div><div class="text-line">신입사원은 없고 BIM 수행을 할 수 있는 기술자가 부족하다.</div><div class="text-line">여러 회사의 S/W별 사용법이 달라 새로운 S/W에 적용에 시간이 필요하다.</div>
+          </div>
+          
+        </div>
+        
+      
+        
+        
+        
+        <div class="f9b__pill" data-frame-slot-id="pill_dynamic" data-pill-n="4">
+          
+          <div class="f9b__pill-label">경제적 부담</div>
+          
+          
+          <div class="f9b__pill-body">
+            <div class="text-line">"S/W 구독료만 크게 발생되고, 비용 보전은 안 된다"</div><div class="text-line">사용해야 할 S/W의 종류가 너무 많고 복잡한데 모두 필요한가?</div><div class="text-line">모든 Project에 적용되는 것도 아닌데, 다수의 S/W 구독료를 내야 한다.</div><div class="text-line">디지털전환 하기 위해 이 비용을 쓰는게 정말 경제적인 이득이 있는 거야?</div>
+          </div>
+          
+        </div>
+        
+      
+        
+        
+        
+        <div class="f9b__pill" data-frame-slot-id="pill_dynamic" data-pill-n="5">
+          
+          <div class="f9b__pill-label">실무 및 적용성</div>
+          
+          
+          <div class="f9b__pill-body">
+            <div class="text-line">"실무적 사용에 의한 효율성 증진보다는 홍보, PQ용으로 사용한다"</div><div class="text-line">구체적 적용에 의한 비용, 시간, 품질 등의 효과 사례가 없다.</div><div class="text-line">지형, 선형, 도로, 교량 Model을 만드는 S/W가 모두 달라 적용이 어렵다.</div><div class="text-line">속성정보를 반영하지 않은 형상 위주의 3D 모델 제작에만 초점이 맞춰져 있다.</div>
+          </div>
+          
+        </div>
+        
+      
+    </div>
+  </div>
+</div>
+        </div>
+        
+        <div class="zone" data-zone-position="bottom" data-template-id="process_product_two_way" style="grid-area: bottom;">
+          <!-- Phase Z-2 MVP-1.5b frame-derived adapted block.
+     §17 룰 — Figma 시각 언어 promote, geometry 만 zone-compatible adapt. -->
+
+
+<style>
+  .f29b {
+    width: 100%; height: 100%;
+    display: flex; flex-direction: column;
+    gap: 4px;
+    position: relative;
+    font-family: 'Noto Sans KR', 'Pretendard', sans-serif;
+    word-break: keep-all;
+    overflow: hidden;
+  }
+  .f29b__title {
+    font-size: var(--font-zone-title);   /* 13px — frame 13 의 f13b__title 과 동일 위계 */
+    font-weight: 700;
+    line-height: var(--lh-zone-title);
+    background-image: linear-gradient(180deg, #000 0%, #883700 100%);
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    flex-shrink: 0;
+    padding-left: 4px;
+  }
+
+  /* banners — top */
+  .f29b__banners {
+    flex: 0 0 auto;
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 4px;
+    position: relative;
+    height: 36px;
+  }
+  .f29b__banner {
+    position: relative;
+    overflow: hidden;
+    display: flex; align-items: center; justify-content: center;
+  }
+  /* PROMOTED background gradients — figma origin lines 84-98 (header-bg--left/right).
+     원본 SVG 3 개 → CSS gradient 로 재현 (R8/R9 준수). border-radius 9999px = 자동 pill. */
+  .f29b__banner--left {
+    background: linear-gradient(to right,
+      rgba(136, 131, 118, 0.343) 0%,
+      #39321E 73.1%,
+      #39321E 100%);
+    border-radius: 0 9999px 9999px 0;
+  }
+  .f29b__banner--right {
+    background: linear-gradient(to right,
+      #032118 0%,
+      rgba(41, 107, 85, 0.1) 100%);
+    border-radius: 9999px 0 0 9999px;
+  }
+  .f29b__banner-text {
+    position: relative;
+    z-index: 1;
+    font-size: var(--font-sub-title);
+    font-weight: 900;
+    line-height: 1;
+    text-shadow: 0 0 2px #322C1E;
+    -webkit-background-clip: text; background-clip: text;
+    color: transparent;
+    padding: 0 8px;
+  }
+  /* PROMOTED gradient — lines 101-104 / 110-113 */
+  .f29b__banner--left .f29b__banner-text {
+    background-image:
+      linear-gradient(90deg, rgb(62,53,35) 0%, rgb(62,53,35) 100%),
+      linear-gradient(180deg, rgb(41,107,85) 0%, rgb(18,51,40) 100%);
+  }
+  .f29b__banner--right .f29b__banner-text {
+    background-image:
+      linear-gradient(90deg, rgb(34,95,74) 0%, rgb(34,95,74) 100%),
+      linear-gradient(180deg, rgb(41,107,85) 0%, rgb(18,51,40) 100%);
+  }
+
+  /* body — 6 cell grid (3 rows × 2 cols) — 좌우 row divider Y 정렬 */
+  /* PROMOTED background — figma origin lines 53-68 (body-bg-left/right).
+     좌(0~50%): #39321E α0.3 (top) → white α0.3 (bottom)
+     우(50~100%): #296B55 α0.3 (top) → white α0.3 (bottom)
+     원본 SVG → CSS multi-bg 로 재현. */
+  .f29b__body {
+    flex: 1;
+    position: relative;
+    min-height: 0;
+    padding-top: 4px;
+    background:
+      linear-gradient(to bottom, rgba(57,50,30,0.3) 0%, rgba(255,255,255,0.3) 100%) 0% 0% / 50% 100% no-repeat,
+      linear-gradient(to bottom, rgba(41,107,85,0.3) 0%, rgba(255,255,255,0.3) 100%) 100% 0% / 50% 100% no-repeat;
+  }
+
+  /* 6 cell grid: 3 rows (section 1/2/3), 2 cols (process/product). 각 row 의 height = max(좌, 우) */
+  .f29b__grid {
+    position: relative;
+    z-index: 1;
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    grid-auto-rows: auto;
+    gap: 6px 10px;
+    padding: 4px 8px;
+    height: 100%;
+  }
+  .f29b__cell {
+    overflow: hidden;
+    min-width: 0;
+    min-height: 0;
+  }
+  /* row 2/3 (3 번째 cell 이후) 위에 dashed divider — 좌우 같은 Y */
+  .f29b__cell:nth-child(n+3) {
+    border-top: 1px dashed rgba(0,0,0,0.15);
+    padding-top: 6px;
+    margin-top: 4px;
+  }
+  /* section-title — 부소목차 (사용자 5-layer 직설 2026-05-07): Analogue 기반... 같은 깊이 0 굵은 bullet */
+  .f29b__section-title {
+    font-size: var(--font-sub-title);    /* 12px — 부소목차 위계 */
+    font-weight: 900;
+    line-height: 1.3;
+    margin-bottom: 5px;
+    padding-left: 6px;
+    border-left: 3px solid currentColor;
+  }
+  .f29b__cell--left  .f29b__section-title { color: #5C3714; }   /* PROMOTED line 125 */
+  .f29b__cell--right .f29b__section-title { color: #084C56; }   /* PROMOTED line 126 */
+  .f29b__section-title__sub {
+    font-size: var(--font-caption);      /* 10px */
+    margin-left: 3px;
+  }
+  /* f29b 의 본문 = .text-line 공통 contract 사용. bullet color override. */
+  .f29b__cell .text-line--bullet { color: #000; font-weight: 700; }
+  /* 2026-05-14 — line-line gap 만 1/2 압축 (사용자 lock 정확 의도) :
+     line-height 1.6 (공통 contract) 유지. .text-line + .text-line margin 4px → 2px. */
+  .f29b__cell .text-line + .text-line { margin-top: 2px; }
+
+  /* popup link — 각 column 끝, 파란색 글씨 (사용자 lock 2026-05-14). */
+  .f29b__popup-link {
+    margin-top: 2px;
+    font-size: var(--font-caption);
+    font-weight: 600;
+    color: #1a73e8;
+    cursor: pointer;
+    text-decoration: underline;
+  }
+  .f29b__popup-link::before { content: "▶ "; font-size: 0.85em; }
+
+  /* AS-IS/TO-BE 좌우 + arrow (PROMOTED 구조) */
+  .f29b__transform {
+    display: grid;
+    grid-template-columns: 1fr auto 1fr;
+    gap: 4px;
+    align-items: start;
+  }
+  .f29b__transform__list {
+    /* .text-line 공통 contract 그대로. wrapper 만 grid 안의 cell 역할 */
+  }
+  .f29b__transform__arrow {
+    align-self: center;
+    width: 28px;
+    flex-shrink: 0;
+  }
+  .f29b__transform__arrow img {
+    width: 100%;
+    height: auto;
+    display: block;
+  }
+
+  .f29b__footnote {
+    font-size: var(--font-caption);      /* 10px */
+    line-height: var(--lh-caption);
+    color: #333;
+    padding-left: 14px;
+    margin-top: 1px;
+    white-space: pre-wrap;
+  }
+  .f29b__aster-small { font-size: 9px; }
+</style>
+
+<div class="f29b" data-frame-id="1171281210" data-template-id="process_product_two_way">
+
+  
+  <div class="f29b__title">2. DX 추진의 실태</div>
+
+  
+  <div class="f29b__banners">
+    <div class="f29b__banner f29b__banner--left">
+      <div class="f29b__banner-text">정책 및 발주 체계</div>
+    </div>
+    <div class="f29b__banner f29b__banner--right">
+      <div class="f29b__banner-text">조직 및 수행 역량</div>
+    </div>
+  </div>
+
+  
+  <div class="f29b__body">
+
+    <div class="f29b__grid">
+
+      
+      
+      
+      
+      
+        
+        
+
+        <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+          
+          <div class="f29b__section-title">실질적 기술 경쟁을 저해하는 정책 집행</div>
+          
+          <div class="text-line text-line--bullet">모든 설계사가 수행 능력을 갖추었다는 전제하에 정책 시행</div><div class="text-line text-line--bullet">수행 능력이 없는 업체 선정 후 성과품의 수준을 낮추어 시행</div>
+          
+          
+        </div>
+
+        <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+          
+          <div class="f29b__section-title">공학적 개념 정립 부재</div>
+          <div class="text-line text-line--bullet">DX와 BIM의 차이점을 명확히 구분하지 못하고 접근 방식과 기술적 도구 사이의 혼란만 가중</div><div class="text-line text-line--bullet">단순히 기술적 도구의 사용에 초점을 맞추느라 3D모델 제작 S/W에 과도하게 의존</div>
+          
+          
+        </div>
+      
+        
+        
+
+        <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+          
+          <div class="f29b__section-title">적용 효과가 있는 사례도 없이 방침부터 도입</div>
+          
+          <div class="text-line text-line--bullet">DX/BIM 적용에 따른 실무적 이득이 있다고 판단된 사례 부족</div><div class="text-line text-line--bullet">BIM 지침/방침 등을 시행 경험과 효과 검증도 없이 남발</div>
+          
+          
+        </div>
+
+        <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+          
+          <div class="f29b__section-title">‘본업 기술력 확보’ 우선의 개념 부재</div>
+          <div class="text-line text-line--bullet">고도의 전문지식과 현장 경험이 축적된 Manual의 중요성과 필요성에 대한 이해 부족</div><div class="text-line text-line--bullet">국가·발주처의 지침·방침에만 의존한 업체의 기술력</div>
+          
+          
+        </div>
+      
+        
+        
+
+        <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+          
+          <div class="f29b__section-title">엔지니어링 S/W에 대한 개념 부재</div>
+          
+          <div class="text-line text-line--bullet">다양한 엔지니어링 S/W의 특성에 대한 깊은 이해 없이 범용 S/W 선택</div><div class="text-line text-line--bullet">대형 Global S/W 회사에 과도한 의존과 이에 예속되는 방침 남발로 전용 S/W 소멸</div>
+          
+          
+        </div>
+
+        <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+          
+          <div class="f29b__section-title">DX/BIM의 근본 취지와 목표의 이해 부족</div>
+          <div class="text-line text-line--bullet">DX에 의한 과정의 혁신과 결과물의 변화에 대한 고민 부재</div><div class="text-line text-line--bullet">기술자가 직접 3D모델을 만들고 수정하며 설계를 수행하지 않고, 별도로 외주 처리하여 본질 회피</div>
+          
+          
+        </div>
+      
+        
+        
+
+        <div class="f29b__cell f29b__cell--left" data-frame-slot-id="process_column">
+          
+          <div class="f29b__section-title">기술투자(R&D) 없는 성과 창출 기대</div>
+          
+          <div class="text-line text-line--bullet">단순 BIM S/W만 구입하면 될 것이라는 안일한 생각</div><div class="text-line text-line--bullet">실질적 기술 개발 투자 노력 없이 남들이 하는 대로 하면 된다는 착각</div>
+          
+          
+        </div>
+
+        <div class="f29b__cell f29b__cell--right" data-frame-slot-id="product_column">
+          
+          <div class="f29b__section-title">과거의 타성에 머무르고 있는 기술자 집단</div>
+          <div class="text-line text-line--bullet">설계/감리/시공 임직원들의 Digital 무지와 전략적 무지</div><div class="text-line text-line--bullet">교육과 학습을 통한 인재 양성보다 당장 실무 활용이 가능한 타사 인력 빼오기에 집중</div>
+          
+          
+        </div>
+      
+
+    </div>
+
+    
+    
+    <div class="f29b__popups" style="display: grid; grid-template-columns: 1fr 1fr; gap: 6px 10px; padding: 0 8px;">
+      <div>
+        
+        <div class="f29b__popup-link">발주처 반응</div>
+        
+      </div>
+      <div>
+        
+        <div class="f29b__popup-link">설계·시공업계 반응</div>
+        
+      </div>
+    </div>
+    
+
+  </div>
+</div>
+        </div>
+        
+      </div>
+    </div>
+    
+    <div class="slide-footer">
+      <div class="slide-footer-text">검증 없는 정책의 일방적 추진과 조직의 회피, 이해 부족은 DX 지연을 반복시키고 있다.</div>
+    </div>
+    
+  </div>
+</body>
+</html>

Front/client/public/data/runs/mdx04_b3_v12/steps/step01_mdx_source.md

@@ -0,0 +1,89 @@
+---
+title: DX 지연 요인
+sidebar:
+  order: 03
+---
+
+## 1. DX에 대한 인식
+
+- **기술 및 소프트웨어 이해도**
+  - "무슨 말인지 잘 모르겠다, 어디까지 어떻게 해야 하는지 모르겠다"
+  - 기본지침, 시행지침 등 새롭게 알아야 할 게 너무 많다.
+  - 3D 모델과 별 차이점을 모르겠다. S/W마다 사용법이 다르다.
+  - 필요한 것은 쉽고 간단한 건데, 왜 이렇게 복잡하게 만들까?
+- **효과와 효율성**
+  - "2D 설계 후 전환설계를 수행하는데 효과는 모르겠고, 효율은 낮다"
+  - 성과품 작성은 기존과 같게 하고, 추가 업무만 발생해 효율이 낮다.
+  - BIM으로 인해 가중되는 업무 대비 효과가 거의 없어 보인다.
+  - 결과적으로 큰 차이를 못 느끼겠고, 이런 노력이 정말 가치 있는 일이야?
+- **인력 및 교육**
+  - "수행 인력이 부족하고, 기존 직원들은 어떻게 교육해야 하나"
+  - 교육시간 손실로 일손이 더 필요해지고, 적응하는데도 시간이 걸린다.
+  - 신입사원은 없고 BIM 수행을 할 수 있는 기술자가 부족하다.
+  - 여러 회사의 S/W별 사용법이 달라 새로운 S/W에 적용에 시간이 필요하다.
+- **경제적 부담**
+  - "S/W 구독료만 크게 발생되고, 비용 보전은 안 된다"
+  - 사용해야 할 S/W의 종류가 너무 많고 복잡한데 모두 필요한가?
+  - 모든 Project에 적용되는 것도 아닌데, 다수의 S/W 구독료를 내야 한다.
+  - 디지털전환 하기 위해 이 비용을 쓰는게 정말 경제적인 이득이 있는 거야?
+- **실무 및 적용성**
+  - "실무적 사용에 의한 효율성 증진보다는 홍보, PQ용으로 사용한다"
+  - 구체적 적용에 의한 비용, 시간, 품질 등의 효과 사례가 없다.
+  - 지형, 선형, 도로, 교량 Model을 만드는 S/W가 모두 달라 적용이 어렵다.
+  - 속성정보를 반영하지 않은 형상 위주의 3D 모델 제작에만 초점이 맞춰져 있다.
+<br/>
+---
+<br/>
+## 2. DX 추진의 실태
+
+<br/>
+
+### 2.1 정책 및 발주 체계
+- **실질적 기술 경쟁을 저해하는 정책 집행** 
+  - 모든 설계사가 수행 능력을 갖추었다는 전제하에 정책 시행
+  - 수행 능력이 없는 업체 선정 후 성과품의 수준을 낮추어 시행 
+<br/>
+- **적용 효과가 있는 사례도 없이 방침부터 도입** 
+  - DX/BIM 적용에 따른 실무적 이득이 있다고 판단된 사례 부족
+  - BIM 지침/방침 등을 시행 경험과 효과 검증도 없이 남발
+<br/>
+- **엔지니어링 S/W에 대한 개념 부재** 
+  - 다양한 엔지니어링 S/W의 특성에 대한 깊은 이해 없이 범용 S/W 선택
+  - 대형 Global S/W 회사에 과도한 의존과 이에 예속되는 방침 남발로 전용 S/W 소멸
+<br/>
+- **기술투자(R&D) 없는 성과 창출 기대** 
+  - 단순 BIM S/W만 구입하면 될 것이라는 안일한 생각
+  - 실질적 기술 개발 투자 노력 없이 남들이 하는 대로 하면 된다는 착각
+<br/>
+<details>
+  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>발주처 반응</summary>
+  <img src="/assets/images/발주처반응.png" />
+</details>
+
+### 2.2 조직 및 수행 역량
+- **공학적 개념 정립 부재** 
+  - DX와 BIM의 차이점을 명확히 구분하지 못하고 접근 방식과 기술적 도구 사이의 혼란만 가중
+  - 단순히 기술적 도구의 사용에 초점을 맞추느라 3D모델 제작 S/W에 과도하게 의존
+<br/>
+- **‘본업 기술력 확보’ 우선의 개념 부재** 
+  - 고도의 전문지식과 현장 경험이 축적된 Manual의 중요성과 필요성에 대한 이해 부족
+  - 국가·발주처의 지침·방침에만 의존한 업체의 기술력 
+<br/>
+- **DX/BIM의 근본 취지와 목표의 이해 부족** 
+  - DX에 의한 과정의 혁신과 결과물의 변화에 대한 고민 부재
+  - 기술자가 직접 3D모델을 만들고 수정하며 설계를 수행하지 않고, 별도로 외주 처리하여 본질 회피
+<br/>
+- **과거의 타성에 머무르고 있는 기술자 집단** 
+  - 설계/감리/시공 임직원들의 Digital 무지와 전략적 무지
+  - 교육과 학습을 통한 인재 양성보다 당장 실무 활용이 가능한 타사 인력 빼오기에 집중
+<br/>
+<details>
+  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>설계·시공업계 반응</summary>
+  <img src="/assets/images/설계시공업계반응.png" />
+</details>
+<br/>
+---
+
+:::note[핵심 요약]
+* 검증 없는 정책의 일방적 추진과 조직의 회피, 이해 부족은 DX 지연을 반복시키고 있다. 
+:::

Front/client/public/data/runs/mdx04_b3_v12/steps/step01_mdx_upload.json

@@ -0,0 +1,21 @@
+{
+  "step_num": 1,
+  "step_name": "mdx_upload",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "samples\\mdx\\04. DX 지연 요인.mdx"
+  ],
+  "output": [
+    "step01_mdx_upload.json",
+    "step01_mdx_source.md"
+  ],
+  "note": "MDX 원본 그대로 step01_mdx_source.md 에 복사.",
+  "data": {
+    "mdx_path": "samples\\mdx\\04. DX 지연 요인.mdx",
+    "run_id": "mdx04_b3_v12",
+    "run_dir": "d:\\ad-hoc\\kei\\design_agent\\data\\runs\\mdx04_b3_v12\\phase_z2",
+    "mdx_source_size_bytes": 4710,
+    "mdx_source_lines": 89
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step02_normalized.json

@@ -0,0 +1,51 @@
+{
+  "step_num": 2,
+  "step_name": "normalized",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step01_mdx_source.md"
+  ],
+  "output": [
+    "step02_normalized.json"
+  ],
+  "note": "parse_mdx 결과: title / sections / footer 분리 + raw_content 보존. heading tree 미생성, orphan / details 감지 미완 (Step 2 ⚠ partial — 별 axis). orphans / details 필드는 schema lock — 빈 배열이라도 'detection 미수행' marker. stage0_adapter_diagnostics = IMP-02 chained adapter trace (default OFF canary). stage0_normalized_assets = IMP-03 Step 3 slide-level handoff (popups/images/tables list).",
+  "data": {
+    "slide_title": "DX 지연 요인",
+    "slide_footer": "검증 없는 정책의 일방적 추진과 조직의 회피, 이해 부족은 DX 지연을 반복시키고 있다.",
+    "sections_count": 2,
+    "sections": [
+      {
+        "section_id": "04-1",
+        "section_num": 1,
+        "title": "1. DX에 대한 인식",
+        "raw_content_length": 934,
+        "raw_content": "- **기술 및 소프트웨어 이해도**\n  - \"무슨 말인지 잘 모르겠다, 어디까지 어떻게 해야 하는지 모르겠다\"\n  - 기본지침, 시행지침 등 새롭게 알아야 할 게 너무 많다.\n  - 3D 모델과 별 차이점을 모르겠다. S/W마다 사용법이 다르다.\n  - 필요한 것은 쉽고 간단한 건데, 왜 이렇게 복잡하게 만들까?\n- **효과와 효율성**\n  - \"2D 설계 후 전환설계를 수행하는데 효과는 모르겠고, 효율은 낮다\"\n  - 성과품 작성은 기존과 같게 하고, 추가 업무만 발생해 효율이 낮다.\n  - BIM으로 인해 가중되는 업무 대비 효과가 거의 없어 보인다.\n  - 결과적으로 큰 차이를 못 느끼겠고, 이런 노력이 정말 가치 있는 일이야?\n- **인력 및 교육**\n  - \"수행 인력이 부족하고, 기존 직원들은 어떻게 교육해야 하나\"\n  - 교육시간 손실로 일손이 더 필요해지고, 적응하는데도 시간이 걸린다.\n  - 신입사원은 없고 BIM 수행을 할 수 있는 기술자가 부족하다.\n  - 여러 회사의 S/W별 사용법이 달라 새로운 S/W에 적용에 시간이 필요하다.\n- **경제적 부담**\n  - \"S/W 구독료만 크게 발생되고, 비용 보전은 안 된다\"\n  - 사용해야 할 S/W의 종류가 너무 많고 복잡한데 모두 필요한가?\n  - 모든 Project에 적용되는 것도 아닌데, 다수의 S/W 구독료를 내야 한다.\n  - 디지털전환 하기 위해 이 비용을 쓰는게 정말 경제적인 이득이 있는 거야?\n- **실무 및 적용성**\n  - \"실무적 사용에 의한 효율성 증진보다는 홍보, PQ용으로 사용한다\"\n  - 구체적 적용에 의한 비용, 시간, 품질 등의 효과 사례가 없다.\n  - 지형, 선형, 도로, 교량 Model을 만드는 S/W가 모두 달라 적용이 어렵다.\n  - 속성정보를 반영하지 않은 형상 위주의 3D 모델 제작에만 초점이 맞춰져 있다.\n<br/>\n---\n<br/>"
+      },
+      {
+        "section_id": "04-2",
+        "section_num": 2,
+        "title": "2. DX 추진의 실태",
+        "raw_content_length": 1349,
+        "raw_content": "<br/>\n\n### 2.1 정책 및 발주 체계\n- **실질적 기술 경쟁을 저해하는 정책 집행** \n  - 모든 설계사가 수행 능력을 갖추었다는 전제하에 정책 시행\n  - 수행 능력이 없는 업체 선정 후 성과품의 수준을 낮추어 시행 \n<br/>\n- **적용 효과가 있는 사례도 없이 방침부터 도입** \n  - DX/BIM 적용에 따른 실무적 이득이 있다고 판단된 사례 부족\n  - BIM 지침/방침 등을 시행 경험과 효과 검증도 없이 남발\n<br/>\n- **엔지니어링 S/W에 대한 개념 부재** \n  - 다양한 엔지니어링 S/W의 특성에 대한 깊은 이해 없이 범용 S/W 선택\n  - 대형 Global S/W 회사에 과도한 의존과 이에 예속되는 방침 남발로 전용 S/W 소멸\n<br/>\n- **기술투자(R&D) 없는 성과 창출 기대** \n  - 단순 BIM S/W만 구입하면 될 것이라는 안일한 생각\n  - 실질적 기술 개발 투자 노력 없이 남들이 하는 대로 하면 된다는 착각\n<br/>\n<details>\n  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>발주처 반응</summary>\n  <img src=\"/assets/images/발주처반응.png\" />\n</details>\n\n### 2.2 조직 및 수행 역량\n- **공학적 개념 정립 부재** \n  - DX와 BIM의 차이점을 명확히 구분하지 못하고 접근 방식과 기술적 도구 사이의 혼란만 가중\n  - 단순히 기술적 도구의 사용에 초점을 맞추느라 3D모델 제작 S/W에 과도하게 의존\n<br/>\n- **‘본업 기술력 확보’ 우선의 개념 부재** \n  - 고도의 전문지식과 현장 경험이 축적된 Manual의 중요성과 필요성에 대한 이해 부족\n  - 국가·발주처의 지침·방침에만 의존한 업체의 기술력 \n<br/>\n- **DX/BIM의 근본 취지와 목표의 이해 부족** \n  - DX에 의한 과정의 혁신과 결과물의 변화에 대한 고민 부재\n  - 기술자가 직접 3D모델을 만들고 수정하며 설계를 수행하지 않고, 별도로 외주 처리하여 본질 회피\n<br/>\n- **과거의 타성에 머무르고 있는 기술자 집단** \n  - 설계/감리/시공 임직원들의 Digital 무지와 전략적 무지\n  - 교육과 학습을 통한 인재 양성보다 당장 실무 활용이 가능한 타사 인력 빼오기에 집중\n<br/>\n<details>\n  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>설계·시공업계 반응</summary>\n  <img src=\"/assets/images/설계시공업계반응.png\" />\n</details>\n<br/>\n---"
+      }
+    ],
+    "orphans": [],
+    "details": [],
+    "stage0_adapter_diagnostics": {
+      "enabled": false,
+      "used": false,
+      "fallback_reason": null,
+      "id_reconstruction_log": [],
+      "adapter_counts": null,
+      "legacy_counts": {
+        "sections": 2
+      }
+    },
+    "stage0_normalized_assets": {
+      "popups": [],
+      "images": [],
+      "tables": []
+    }
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step05_v4_evidence.json

@@ -0,0 +1,41 @@
+{
+  "step_num": 5,
+  "step_name": "v4_evidence",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step02_normalized.json",
+    "tests/matching/v4_full32_result.yaml"
+  ],
+  "output": [
+    "step05_v4_evidence.json"
+  ],
+  "note": "V4 non-reject max-6 후보 list (Step 9 application_plan input). raw 32 entry 는 tests/matching/v4_full32_result.yaml 에 영속. candidate_status='ok' = 후보 1개 이상 / 'no_non_reject_v4_candidate' = 0개 (Step 9 fallback path 입력). Step 6 plan_composition() 은 lookup_v4_match() (rank-1) 그대로 사용 — backward compat (Step 6-A axis 까지).",
+  "data": {
+    "v4_source": "tests\\matching\\v4_full32_result.yaml",
+    "aligned_section_ids": [
+      "04-1",
+      "04-2"
+    ],
+    "evidence_per_section": [
+      {
+        "section_id": "04-1",
+        "v4_candidates": [],
+        "candidate_status": "no_non_reject_v4_candidate"
+      },
+      {
+        "section_id": "04-2",
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.7711,
+            "label": "light_edit"
+          }
+        ],
+        "candidate_status": "ok"
+      }
+    ]
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step06_composition_plan.json

@@ -0,0 +1,170 @@
+{
+  "step_num": 6,
+  "step_name": "composition_plan",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step02_normalized.json",
+    "step05_v4_evidence.json"
+  ],
+  "output": [
+    "step06_composition_plan.json"
+  ],
+  "note": "composition v0 count-based — sections → candidates → score → greedy select. Step 6-A (사용자 lock 2026-05-08): selected_units[i].v4_candidates 추가 (non-reject max-6 후보 list, candidates[0] = 단일 frame_* 와 일관). logic 무변 — runtime 결과 동일. Step 9 application_plan input.",
+  "data": {
+    "selected_units_count": 2,
+    "layout_preset_decided": "horizontal-2",
+    "candidates_summary": [
+      {
+        "source_section_ids": [
+          "04-1"
+        ],
+        "merge_type": "single",
+        "template_id": "pre_construction_model_info_stacked",
+        "label": "reject",
+        "phase_z_status": "fallback_candidate",
+        "v4_rank": 1,
+        "selection_path": "rank_1",
+        "fallback_reason": null,
+        "score": 0.0,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 5,
+          "source_shape": "top_bullets",
+          "capacity": {
+            "strict": null,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      },
+      {
+        "source_section_ids": [
+          "04-2"
+        ],
+        "merge_type": "single",
+        "template_id": "process_product_two_way",
+        "label": "light_edit",
+        "phase_z_status": "adapt_matched_zone",
+        "v4_rank": 2,
+        "selection_path": "rank_2_fallback",
+        "fallback_reason": "capacity_mismatch:strict_mismatch",
+        "score": 0.53977,
+        "selection_state": "selected",
+        "auto_selectable": true,
+        "filter_reasons": [],
+        "notes": [],
+        "capacity_fit": {
+          "item_count": 2,
+          "source_shape": "h3_subsections",
+          "capacity": {
+            "strict": 2,
+            "min": null,
+            "max": null,
+            "truncate_at": null,
+            "pad_to": null
+          },
+          "fit_status": "ok",
+          "mismatch_reason": null
+        }
+      }
+    ],
+    "candidates_total": 2,
+    "candidates_viable_auto": 2,
+    "selected_units": [
+      {
+        "source_section_ids": [
+          "04-1"
+        ],
+        "merge_type": "single",
+        "frame_id": "1171281180",
+        "frame_number": 9,
+        "frame_template_id": "pre_construction_model_info_stacked",
+        "label": "reject",
+        "v4_rank": 1,
+        "selection_path": "rank_1",
+        "fallback_reason": null,
+        "score": 0.0,
+        "phase_z_status": "fallback_candidate",
+        "rationale": {
+          "capacity_fit": {
+            "item_count": 5,
+            "source_shape": "top_bullets",
+            "capacity": {
+              "strict": null,
+              "min": null,
+              "max": null,
+              "truncate_at": null,
+              "pad_to": null
+            },
+            "fit_status": "ok",
+            "mismatch_reason": null
+          },
+          "frame_compat": 0.0,
+          "confidence": 0.7223,
+          "label": "reject",
+          "label_weight": 0.0,
+          "merge_type": "single",
+          "hierarchy_coherence": null,
+          "density_score": null
+        },
+        "notes": [],
+        "v4_candidates": []
+      },
+      {
+        "source_section_ids": [
+          "04-2"
+        ],
+        "merge_type": "single",
+        "frame_id": "1171281210",
+        "frame_number": 29,
+        "frame_template_id": "process_product_two_way",
+        "label": "light_edit",
+        "v4_rank": 2,
+        "selection_path": "rank_2_fallback",
+        "fallback_reason": "capacity_mismatch:strict_mismatch",
+        "score": 0.53977,
+        "phase_z_status": "adapt_matched_zone",
+        "rationale": {
+          "capacity_fit": {
+            "item_count": 2,
+            "source_shape": "h3_subsections",
+            "capacity": {
+              "strict": 2,
+              "min": null,
+              "max": null,
+              "truncate_at": null,
+              "pad_to": null
+            },
+            "fit_status": "ok",
+            "mismatch_reason": null
+          },
+          "frame_compat": 0.5398,
+          "confidence": 0.7711,
+          "label": "light_edit",
+          "label_weight": 0.7,
+          "merge_type": "single",
+          "hierarchy_coherence": null,
+          "density_score": null
+        },
+        "notes": [],
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.7711,
+            "label": "light_edit"
+          }
+        ]
+      }
+    ]
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step07_layout.json

@@ -0,0 +1,81 @@
+{
+  "step_num": 7,
+  "step_name": "layout",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step06_composition_plan.json"
+  ],
+  "output": [
+    "step07_layout.json",
+    "step07_selected_layout.html"
+  ],
+  "note": "count-based v0 — 들여쓰기 / 정렬 미세 layout 미구현 (Step 7 ⚠ partial). Step 7-conn (사용자 lock 2026-05-08): unit_count → layout_candidates list (select_layout_candidates) artifact 기록. default 결정 자체는 무변 — candidates[0] 가 default (default_selection: true), 나머지는 alternative. Step 9 application_plan input.",
+  "data": {
+    "layout_preset": "horizontal-2",
+    "layout_css": {
+      "areas": "\"top\" \"bottom\"",
+      "cols": "1fr",
+      "rows": "211px 360px",
+      "heights_px": [
+        211,
+        360
+      ],
+      "ratios": [
+        0.361,
+        0.615
+      ],
+      "computation": "min_height_first + content_weight_distribution",
+      "dynamic_rows": true,
+      "raw_zone_layout": {
+        "computation": "min_height_first + content_weight_distribution",
+        "slide_body_height": 585,
+        "gap": 14,
+        "available_after_gap": 571,
+        "min_heights_px": [
+          200,
+          345
+        ],
+        "min_scaled": false,
+        "total_min_height": 545,
+        "remaining_after_min": 26,
+        "content_weights": [
+          {
+            "position": "top",
+            "template_id": "pre_construction_model_info_stacked",
+            "score": 6.168
+          },
+          {
+            "position": "bottom",
+            "template_id": "process_product_two_way",
+            "score": 8.486
+          }
+        ],
+        "weight_shares": [
+          0.421,
+          0.579
+        ],
+        "extras_px": [
+          11,
+          15
+        ],
+        "heights_px": [
+          211,
+          360
+        ],
+        "ratios": [
+          0.361,
+          0.615
+        ]
+      }
+    },
+    "zones_count": 2,
+    "unit_count": 2,
+    "layout_candidates": [
+      "horizontal-2",
+      "vertical-2"
+    ],
+    "layout_override_applied": false,
+    "auto_layout_preset": "horizontal-2"
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step08_zone_region_ratios.json

@@ -0,0 +1,104 @@
+{
+  "step_num": 8,
+  "step_name": "zone_region_ratios",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step07_layout.json",
+    "step10_frame_contract.json"
+  ],
+  "output": [
+    "step08_zone_region_ratios.json",
+    "step08_zone_content_placement.html"
+  ],
+  "note": "계획값 only. 실측값은 Step 14 (visual_check). zone-level 만 dynamic, region-level (sub_zone 안 sections) 은 균등 분배 (1/1/1). F29 처럼 비균등 콘텐츠 (transform_table + plain) 는 첫 cell 부족 가능 — Step 8 ⚠ partial. Step 8-conn (사용자 lock 2026-05-08): per_zone_plan[i] 에 region_layout_candidates + display_strategy_candidates 추가 (passive 기록). placeholder signals = text-only / region_count=1 (Step 3/4 부재 종속). 실제 content_object 신호 활성화는 별 axis. Step 9 application_plan input.",
+  "data": {
+    "zone_heights_px_planned": [
+      211,
+      360
+    ],
+    "zone_ratios_planned": [
+      0.361,
+      0.615
+    ],
+    "per_zone_plan": [
+      {
+        "position": "top",
+        "zone_height_px_planned": 211,
+        "zone_ratio_planned": 0.361,
+        "min_height_px": 200,
+        "frame_cardinality_strict": null,
+        "sub_zones_planned": [
+          {
+            "id": "pill_dynamic",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": null,
+            "partial_target_path": ".f9b__pill-rows .f9b__pill:nth-child(N)"
+          }
+        ],
+        "child_distribution_note": "현재 child zone (sub_zones 안 sections) 균등 분배 — Step 8 region-level ratio ⚠ partial.",
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ]
+      },
+      {
+        "position": "bottom",
+        "zone_height_px_planned": 360,
+        "zone_ratio_planned": 0.615,
+        "min_height_px": 345,
+        "frame_cardinality_strict": 2,
+        "sub_zones_planned": [
+          {
+            "id": "process_column",
+            "role": "main_text",
+            "accepts": [
+              "text_block",
+              "transform_table"
+            ],
+            "cardinality_strict": null,
+            "partial_target_path": ".f29b__grid .f29b__cell--left"
+          },
+          {
+            "id": "product_column",
+            "role": "main_text",
+            "accepts": [
+              "text_block"
+            ],
+            "cardinality_strict": null,
+            "partial_target_path": ".f29b__grid .f29b__cell--right"
+          }
+        ],
+        "child_distribution_note": "현재 child zone (sub_zones 안 sections) 균등 분배 — Step 8 region-level ratio ⚠ partial.",
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ]
+      }
+    ],
+    "step8_conn_placeholder_signals": {
+      "region_count": 1,
+      "content_type": "text_block",
+      "flow_type": null,
+      "role_pattern": null,
+      "ratio_asymmetric": false,
+      "has_visual_element": false,
+      "details_presence": false,
+      "large_table": false,
+      "long_text": false,
+      "fits_in_region": null,
+      "_note": "Step 3/4 부재 종속 placeholder — 모든 zone 을 text-only / region_count=1 로 가정. 실제 content_object 신호 활성화는 별 axis."
+    }
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step09_application_plan.json

@@ -0,0 +1,893 @@
+{
+  "step_num": 9,
+  "step_name": "application_plan",
+  "step_status": "partial",
+  "pipeline_path_connected": true,
+  "input": [
+    "step05_v4_evidence.json",
+    "step06_composition_plan.json",
+    "step07_layout.json",
+    "step08_zone_region_ratios.json"
+  ],
+  "output": [
+    "step09_application_plan.json",
+    "step09_application_plan.html"
+  ],
+  "note": "Step 9 v0 passive application_plan trace (사용자 lock 2026-05-08). V4 후보 + layout / region / display 후보 + V4 label → application_mode 변환을 side-by-side 로 기록. v0 invariant 5 가지 (status.md §4) 만족. Step 6 의 default 결정 그대로 (current_default_candidate). auto decision 은 Step 9 v1 (별 axis). region/display 후보는 Step 8-conn 의 placeholder signal 종속 (Step 3/4 부재). Step 7-A axis (2026-05-08): frame_overrides_applied 가 사용자 LayoutPanel/FramePanel 선택값을 강제 적용한 trace.",
+  "data": {
+    "units": [
+      {
+        "unit_id": "04-1",
+        "layout_preset": "horizontal-2",
+        "layout_candidates": [
+          "horizontal-2",
+          "vertical-2"
+        ],
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ],
+        "candidate_status": "no_non_reject_v4_candidate",
+        "application_status": "no_v4_candidate",
+        "current_default_candidate": null,
+        "selected_v4_rank": 1,
+        "selection_path": "rank_1",
+        "fallback_used": false,
+        "fallback_reason": null,
+        "candidate_evidence": [
+          {
+            "rank": 1,
+            "template_id": "pre_construction_model_info_stacked",
+            "frame_id": "1171281180",
+            "frame_number": 9,
+            "confidence": 0.7223,
+            "label": "reject",
+            "v4_label": "reject",
+            "phase_z_status": "fallback_candidate",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "design_reference_only",
+            "decision": "selected",
+            "reason": "primary_selected",
+            "capacity_fit": {
+              "item_count": 5,
+              "source_shape": "top_bullets",
+              "capacity": {
+                "strict": null,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "ok",
+              "mismatch_reason": null
+            }
+          }
+        ],
+        "fallback_chain": [
+          {
+            "rank": 1,
+            "template_id": "pre_construction_model_info_stacked",
+            "frame_id": "1171281180",
+            "frame_number": 9,
+            "confidence": 0.7223,
+            "label": "reject",
+            "v4_label": "reject",
+            "phase_z_status": "fallback_candidate",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "design_reference_only",
+            "decision": "selected",
+            "reason": "primary_selected",
+            "capacity_fit": {
+              "item_count": 5,
+              "source_shape": "top_bullets",
+              "capacity": {
+                "strict": null,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "ok",
+              "mismatch_reason": null
+            }
+          }
+        ],
+        "v4_candidates": [],
+        "v4_all_judgments": [
+          {
+            "template_id": "pre_construction_model_info_stacked",
+            "frame_id": "1171281180",
+            "frame_number": 9,
+            "v4_rank": 1,
+            "confidence": 0.7223,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "field_effectiveness_five_elements",
+            "frame_id": "1171281181",
+            "frame_number": 10,
+            "v4_rank": 2,
+            "confidence": 0.6586,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "policy_achievement_five_goals",
+            "frame_id": "1171281213",
+            "frame_number": 32,
+            "v4_rank": 3,
+            "confidence": 0.6514,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "compensation_complaint_side_card",
+            "frame_id": "1171281176",
+            "frame_number": 5,
+            "v4_rank": 4,
+            "confidence": 0.6058,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "solution_engn_split_diagram",
+            "frame_id": "1171281201",
+            "frame_number": 21,
+            "v4_rank": 5,
+            "confidence": 0.4773,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "model_specialized_engn_sw",
+            "frame_id": "1171281202",
+            "frame_number": 22,
+            "v4_rank": 6,
+            "confidence": 0.4624,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "commercial_sw_four_categories",
+            "frame_id": "1171281205",
+            "frame_number": 25,
+            "v4_rank": 7,
+            "confidence": 0.4293,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "construction_bim_three_usage",
+            "frame_id": "1171281182",
+            "frame_number": 11,
+            "v4_rank": 8,
+            "confidence": 0.4234,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "sw_dependency_four_problems",
+            "frame_id": "1171281206",
+            "frame_number": 26,
+            "v4_rank": 9,
+            "confidence": 0.3986,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "engn_sw_development_domain_knowledge",
+            "frame_id": "1171281173",
+            "frame_number": 2,
+            "v4_rank": 10,
+            "confidence": 0.3942,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "sw_development_cycle_six_nodes",
+            "frame_id": "1171281172",
+            "frame_number": 1,
+            "v4_rank": 11,
+            "confidence": 0.3899,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "policy_goals_plus_execution_requirements",
+            "frame_id": "1171281192",
+            "frame_number": 15,
+            "v4_rank": 12,
+            "confidence": 0.3833,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "bim_current_problems_paired",
+            "frame_id": "1171281194",
+            "frame_number": 17,
+            "v4_rank": 13,
+            "confidence": 0.3773,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "overseas_bim_numbered_list",
+            "frame_id": "1171281174",
+            "frame_number": 3,
+            "v4_rank": 14,
+            "confidence": 0.3748,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "frame_number": 13,
+            "v4_rank": 15,
+            "confidence": 0.3713,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "bim_issues_quadrant_four",
+            "frame_id": "1171281193",
+            "frame_number": 16,
+            "v4_rank": 16,
+            "confidence": 0.3699,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "frame_number": 20,
+            "v4_rank": 17,
+            "confidence": 0.3158,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "domestic_bim_actor_relations",
+            "frame_id": "1171281175",
+            "frame_number": 4,
+            "v4_rank": 18,
+            "confidence": 0.2897,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "bigroom_system_components",
+            "frame_id": "1171281178",
+            "frame_number": 7,
+            "v4_rank": 19,
+            "confidence": 0.2742,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "info_management_what_how_when",
+            "frame_id": "1171281179",
+            "frame_number": 8,
+            "v4_rank": 20,
+            "confidence": 0.2604,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "v4_rank": 21,
+            "confidence": 0.2313,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "compensation_complaint_map",
+            "frame_id": "1171281177",
+            "frame_number": 6,
+            "v4_rank": 22,
+            "confidence": 0.201,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "sw_reality_three_emphasis",
+            "frame_id": "1171281209",
+            "frame_number": 28,
+            "v4_rank": 23,
+            "confidence": 0.201,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "bim_dx_comparison_table",
+            "frame_id": "1171281195",
+            "frame_number": 18,
+            "v4_rank": 24,
+            "confidence": 0.1798,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "three_persona_benefits",
+            "frame_id": "1171281191",
+            "frame_number": 14,
+            "v4_rank": 25,
+            "confidence": 0.1787,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "construction_goals_three_circle_intersection",
+            "frame_id": "1171281189",
+            "frame_number": 12,
+            "v4_rank": 26,
+            "confidence": 0.1706,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "frame_number": 27,
+            "v4_rank": 27,
+            "confidence": 0.1399,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "engn_sw_three_types",
+            "frame_id": "1171281204",
+            "frame_number": 24,
+            "v4_rank": 28,
+            "confidence": 0.0929,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "design_method_distortion_three_col",
+            "frame_id": "1171281197",
+            "frame_number": 19,
+            "v4_rank": 29,
+            "confidence": 0.0584,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "app_sw_package_vs_solution",
+            "frame_id": "1171281203",
+            "frame_number": 23,
+            "v4_rank": 30,
+            "confidence": 0.0052,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "industry_current_status_three_col",
+            "frame_id": "1171281211",
+            "frame_number": 30,
+            "v4_rank": 31,
+            "confidence": 0.0044,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "industry_characteristics_three_col",
+            "frame_id": "1171281212",
+            "frame_number": 31,
+            "v4_rank": 32,
+            "confidence": 0.0029,
+            "label": "reject",
+            "catalog_registered": false
+          }
+        ],
+        "application_candidates": [],
+        "position": null,
+        "assignment_source": null,
+        "section_assignment_override": false,
+        "replaced_auto_unit": null,
+        "skipped_collided_auto_units": [],
+        "skipped_reason": null
+      },
+      {
+        "unit_id": "04-2",
+        "layout_preset": "horizontal-2",
+        "layout_candidates": [
+          "horizontal-2",
+          "vertical-2"
+        ],
+        "region_layout_candidates": [
+          "region-single"
+        ],
+        "display_strategy_candidates": [
+          "inline_full",
+          "inline_preview_with_details",
+          "details_only"
+        ],
+        "candidate_status": "ok",
+        "application_status": "ok",
+        "current_default_candidate": "process_product_two_way",
+        "selected_v4_rank": 2,
+        "selection_path": "rank_2_fallback",
+        "fallback_used": true,
+        "fallback_reason": "capacity_mismatch:strict_mismatch",
+        "candidate_evidence": [
+          {
+            "rank": 1,
+            "template_id": "bim_dx_comparison_table",
+            "frame_id": "1171281195",
+            "frame_number": 18,
+            "confidence": 0.8152,
+            "label": "reject",
+            "v4_label": "reject",
+            "phase_z_status": "fallback_candidate",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "design_reference_only",
+            "decision": "skipped",
+            "reason": "capacity_mismatch:strict_mismatch",
+            "capacity_fit": {
+              "item_count": 8,
+              "source_shape": "top_bullets",
+              "capacity": {
+                "strict": 2,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "strict_mismatch",
+              "mismatch_reason": "strict cardinality 2, content has 8 items. mapper 가 FitError 를 raise 할 것."
+            }
+          },
+          {
+            "rank": 2,
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.7711,
+            "label": "light_edit",
+            "v4_label": "light_edit",
+            "phase_z_status": "adapt_matched_zone",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "deterministic_minor_adjustment",
+            "decision": "selected",
+            "reason": "fallback_selected",
+            "capacity_fit": {
+              "item_count": 2,
+              "source_shape": "h3_subsections",
+              "capacity": {
+                "strict": 2,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "ok",
+              "mismatch_reason": null
+            }
+          }
+        ],
+        "fallback_chain": [
+          {
+            "rank": 1,
+            "template_id": "bim_dx_comparison_table",
+            "frame_id": "1171281195",
+            "frame_number": 18,
+            "confidence": 0.8152,
+            "label": "reject",
+            "v4_label": "reject",
+            "phase_z_status": "fallback_candidate",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "design_reference_only",
+            "decision": "skipped",
+            "reason": "capacity_mismatch:strict_mismatch",
+            "capacity_fit": {
+              "item_count": 8,
+              "source_shape": "top_bullets",
+              "capacity": {
+                "strict": 2,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "strict_mismatch",
+              "mismatch_reason": "strict cardinality 2, content has 8 items. mapper 가 FitError 를 raise 할 것."
+            }
+          },
+          {
+            "rank": 2,
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "confidence": 0.7711,
+            "label": "light_edit",
+            "v4_label": "light_edit",
+            "phase_z_status": "adapt_matched_zone",
+            "catalog_registered": true,
+            "filtered_for_direct_execution": false,
+            "route_hint": "deterministic_minor_adjustment",
+            "decision": "selected",
+            "reason": "fallback_selected",
+            "capacity_fit": {
+              "item_count": 2,
+              "source_shape": "h3_subsections",
+              "capacity": {
+                "strict": 2,
+                "min": null,
+                "max": null,
+                "truncate_at": null,
+                "pad_to": null
+              },
+              "fit_status": "ok",
+              "mismatch_reason": null
+            }
+          }
+        ],
+        "v4_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "v4_rank": 2,
+            "confidence": 0.7711,
+            "label": "light_edit"
+          }
+        ],
+        "v4_all_judgments": [
+          {
+            "template_id": "bim_dx_comparison_table",
+            "frame_id": "1171281195",
+            "frame_number": 18,
+            "v4_rank": 1,
+            "confidence": 0.8152,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "frame_number": 29,
+            "v4_rank": 2,
+            "confidence": 0.7711,
+            "label": "light_edit",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "app_sw_package_vs_solution",
+            "frame_id": "1171281203",
+            "frame_number": 23,
+            "v4_rank": 3,
+            "confidence": 0.6389,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "engn_sw_three_types",
+            "frame_id": "1171281204",
+            "frame_number": 24,
+            "v4_rank": 4,
+            "confidence": 0.6372,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "industry_characteristics_three_col",
+            "frame_id": "1171281212",
+            "frame_number": 31,
+            "v4_rank": 5,
+            "confidence": 0.5996,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "bim_adoption_central_split",
+            "frame_id": "1171281208",
+            "frame_number": 27,
+            "v4_rank": 6,
+            "confidence": 0.55,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "bigroom_system_components",
+            "frame_id": "1171281178",
+            "frame_number": 7,
+            "v4_rank": 7,
+            "confidence": 0.5172,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "industry_current_status_three_col",
+            "frame_id": "1171281211",
+            "frame_number": 30,
+            "v4_rank": 8,
+            "confidence": 0.4774,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "design_method_distortion_three_col",
+            "frame_id": "1171281197",
+            "frame_number": 19,
+            "v4_rank": 9,
+            "confidence": 0.4179,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "sw_dependency_four_problems",
+            "frame_id": "1171281206",
+            "frame_number": 26,
+            "v4_rank": 10,
+            "confidence": 0.4138,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "bim_current_problems_paired",
+            "frame_id": "1171281194",
+            "frame_number": 17,
+            "v4_rank": 11,
+            "confidence": 0.3559,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "domestic_bim_actor_relations",
+            "frame_id": "1171281175",
+            "frame_number": 4,
+            "v4_rank": 12,
+            "confidence": 0.3457,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "pre_construction_model_info_stacked",
+            "frame_id": "1171281180",
+            "frame_number": 9,
+            "v4_rank": 13,
+            "confidence": 0.332,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "model_specialized_engn_sw",
+            "frame_id": "1171281202",
+            "frame_number": 22,
+            "v4_rank": 14,
+            "confidence": 0.3275,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "commercial_sw_four_categories",
+            "frame_id": "1171281205",
+            "frame_number": 25,
+            "v4_rank": 15,
+            "confidence": 0.3074,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "policy_goals_plus_execution_requirements",
+            "frame_id": "1171281192",
+            "frame_number": 15,
+            "v4_rank": 16,
+            "confidence": 0.2847,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "construction_goals_three_circle_intersection",
+            "frame_id": "1171281189",
+            "frame_number": 12,
+            "v4_rank": 17,
+            "confidence": 0.2558,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "bim_issues_quadrant_four",
+            "frame_id": "1171281193",
+            "frame_number": 16,
+            "v4_rank": 18,
+            "confidence": 0.2302,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "compensation_complaint_map",
+            "frame_id": "1171281177",
+            "frame_number": 6,
+            "v4_rank": 19,
+            "confidence": 0.2077,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "dx_sw_necessity_three_perspectives",
+            "frame_id": "1171281198",
+            "frame_number": 20,
+            "v4_rank": 20,
+            "confidence": 0.1842,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "three_parallel_requirements",
+            "frame_id": "1171281190",
+            "frame_number": 13,
+            "v4_rank": 21,
+            "confidence": 0.1399,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "sw_reality_three_emphasis",
+            "frame_id": "1171281209",
+            "frame_number": 28,
+            "v4_rank": 22,
+            "confidence": 0.1271,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "solution_engn_split_diagram",
+            "frame_id": "1171281201",
+            "frame_number": 21,
+            "v4_rank": 23,
+            "confidence": 0.1171,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "overseas_bim_numbered_list",
+            "frame_id": "1171281174",
+            "frame_number": 3,
+            "v4_rank": 24,
+            "confidence": 0.1007,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "policy_achievement_five_goals",
+            "frame_id": "1171281213",
+            "frame_number": 32,
+            "v4_rank": 25,
+            "confidence": 0.0751,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "three_persona_benefits",
+            "frame_id": "1171281191",
+            "frame_number": 14,
+            "v4_rank": 26,
+            "confidence": 0.0722,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "engn_sw_development_domain_knowledge",
+            "frame_id": "1171281173",
+            "frame_number": 2,
+            "v4_rank": 27,
+            "confidence": 0.0635,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "sw_development_cycle_six_nodes",
+            "frame_id": "1171281172",
+            "frame_number": 1,
+            "v4_rank": 28,
+            "confidence": 0.0633,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "field_effectiveness_five_elements",
+            "frame_id": "1171281181",
+            "frame_number": 10,
+            "v4_rank": 29,
+            "confidence": 0.0618,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "info_management_what_how_when",
+            "frame_id": "1171281179",
+            "frame_number": 8,
+            "v4_rank": 30,
+            "confidence": 0.0487,
+            "label": "reject",
+            "catalog_registered": true
+          },
+          {
+            "template_id": "compensation_complaint_side_card",
+            "frame_id": "1171281176",
+            "frame_number": 5,
+            "v4_rank": 31,
+            "confidence": 0.0457,
+            "label": "reject",
+            "catalog_registered": false
+          },
+          {
+            "template_id": "construction_bim_three_usage",
+            "frame_id": "1171281182",
+            "frame_number": 11,
+            "v4_rank": 32,
+            "confidence": 0.0,
+            "label": "reject",
+            "catalog_registered": true
+          }
+        ],
+        "application_candidates": [
+          {
+            "template_id": "process_product_two_way",
+            "frame_id": "1171281210",
+            "v4_label": "light_edit",
+            "application_mode": "same_frame_with_adjustment",
+            "auto_applicable": true,
+            "required_changes": [],
+            "delegated_to": "step10_contract_check"
+          }
+        ],
+        "position": null,
+        "assignment_source": null,
+        "section_assignment_override": false,
+        "replaced_auto_unit": null,
+        "skipped_collided_auto_units": [],
+        "skipped_reason": null
+      }
+    ],
+    "candidate_status_summary": {
+      "units_with_no_v4_candidate": [
+        "04-1"
+      ],
+      "units_with_fallback": [
+        "04-2"
+      ]
+    },
+    "fallback_policy": {
+      "fallback_used_count": 1,
+      "fallback_selection_count": 1,
+      "chain_exhausted_count": 0,
+      "selection_paths": [
+        {
+          "section_id": "04-1",
+          "selection_path": "rank_1",
+          "selected_rank": 1,
+          "selected_template_id": "pre_construction_model_info_stacked",
+          "fallback_trigger": null
+        },
+        {
+          "section_id": "04-2",
+          "selection_path": "rank_2_fallback",
+          "selected_rank": 2,
+          "selected_template_id": "process_product_two_way",
+          "fallback_trigger": "capacity_mismatch:strict_mismatch"
+        }
+      ],
+      "policy": "IMP-05: rank-1 is kept when usable; rank-2/3 may be promoted only when the earlier rank is not auto-renderable, has no catalog contract, or fails capacity precheck. calculate_fit is not used."
+    },
+    "frame_overrides_applied": [],
+    "frame_overrides_skipped": [],
+    "section_assignment_plan": null,
+    "section_assignment_summary": null,
+    "v0_lock_note": "Step 9 v0 passive (사용자 lock 2026-05-08). Step 6 default 그대로 사용 — runtime 결과 byte-동일. auto decision / scoring 은 Step 9 v1 (별 axis)."
+  }
+}

Front/client/public/data/runs/mdx04_b3_v12/steps/step20_slide_status.json

@@ -0,0 +1,72 @@
+{
+  "step_num": 20,
+  "step_name": "slide_status",
+  "step_status": "done",
+  "pipeline_path_connected": true,
+  "input": [
+    "step14_visual_check.json",
+    "step17_retry_trace.json",
+    "step19_next_action.json"
+  ],
+  "output": [
+    "step20_slide_status.json",
+    "step20_final_status.html"
+  ],
+  "note": "자동 파이프라인 최종 결과 보고. overall = PASS/RENDERED_WITH_VISUAL_REGRESSION/PARTIAL_COVERAGE 등.",
+  "data": {
+    "rendered": true,
+    "visual_check_passed": false,
+    "full_mdx_coverage": true,
+    "aligned_section_ids": [
+      "04-1",
+      "04-2"
+    ],
+    "covered_section_ids": [
+      "04-1",
+      "04-2"
+    ],
+    "filtered_section_ids": [],
+    "filtered_section_reasons": [],
+    "selection_path": "fallback_used",
+    "fallback_used": true,
+    "fallback_selections": [
+      {
+        "position": "bottom",
+        "source_section_ids": [
+          "04-2"
+        ],
+        "template_id": "process_product_two_way",
+        "selected_v4_rank": 2,
+        "selection_path": "rank_2_fallback",
+        "fallback_reason": "capacity_mismatch:strict_mismatch"
+      }
+    ],
+    "fallback_selection_count": 1,
+    "selection_paths": [
+      {
+        "section_id": "04-1",
+        "selection_path": "rank_1",
+        "selected_rank": 1,
+        "selected_template_id": "pre_construction_model_info_stacked",
+        "fallback_trigger": null
+      },
+      {
+        "section_id": "04-2",
+        "selection_path": "rank_2_fallback",
+        "selected_rank": 2,
+        "selected_template_id": "process_product_two_way",
+        "fallback_trigger": "capacity_mismatch:strict_mismatch"
+      }
+    ],
+    "visual_fail_reasons": [
+      "zone--bottom: inner clipped .f29b — excess 17px vert / 0px horiz (content 377 vs container 360)",
+      "zone--bottom: inner clipped .f29b__body — excess 17px vert / 0px horiz (content 311 vs container 294)"
+    ],
+    "adapter_needed_count": 0,
+    "adapter_needed_units": [],
+    "content_truncated_count": 0,
+    "content_truncated_units": [],
+    "overall": "RENDERED_WITH_VISUAL_REGRESSION",
+    "note": "자동 파이프라인 결과 보고. review/UI 개념 X. final.html 파일명 != PASS 의미. overall == PASS 는 visual OK + full coverage + adapter_needed=0 일 때만. adapter_needed_count > 0 = mapper 가 contract 와 안 맞아 자동 렌더 못 한 zone 존재. content_truncated_count > 0 = builder 가 truncate 한 zone 존재 (rendered 됐지만 일부 콘텐츠 손실)."
+  }
+}

Front/client/src/components/BottomActions.tsx

@@ -1,99 +1,200 @@
 /**
- * BottomActions - 하단 액션 버튼 영역
+ * BottomActions — Step 22 footer wire-up (IMP-56 #90 u20).
  *
- * 생성하기, 다운로드, 연동하기 버튼 컴포넌트
+ * Two real endpoints replace the prior placeholder toasts:
+ *   • POST /api/connect  (u18 / Front/vite.config.ts) — copies
+ *     data/runs/<run_id>/phase_z2/final.html + assets/ into the cel mirror
+ *     (`<CEL_PROJECT_ROOT>/public/slides/<slug>.html`).
+ *   • POST /api/export   (u19 / Front/vite.config.ts) — returns a standalone
+ *     text/html body with every `url(assets/...)` ref inlined as base64
+ *     data URLs. Response is piped into a Blob → a[download] click chain so
+ *     the user receives `<run_id>.html` portable for file:// or any host.
+ *
+ * The prior `serializeSlidePlan` JSON-download path was a dead reference
+ * (the export never existed in slidePlanUtils) and is removed here — the
+ * "다운로드" button now means standalone HTML download via /api/export.
+ * Both buttons disable when no run is loaded (runMeta == null) so the
+ * UI cannot fire requests with an undefined run_id.
  */
 
+import { useState } from "react";
 import { Sparkles, Download, Link2, Loader2 } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { toast } from "sonner";
-import type { SlidePlan, UserSelection } from "../types/designAgent";
+import type { SlidePlan } from "../types/designAgent";
-import { serializeSlidePlan } from "../utils/slidePlanUtils";
+import type { RunMeta } from "../services/designAgentApi";
+import { deriveUserOverridesKey } from "../utils/slidePlanUtils";
+
+// ─── pure request builders (exported for vitest; jsdom-free) ─────────────
+// The component below uses these verbatim. Each returns a {url, body} pair
+// so the test surface is the *literal* HTTP payload sent to the u18 / u19
+// middlewares — any future shape drift fails here before the network call.
+
+export function buildConnectRequest(
+  run_id: string,
+  slug: string,
+): { url: string; body: string } {
+  return {
+    url: "/api/connect",
+    body: JSON.stringify({ run_id, slug }),
+  };
+}
+
+export function buildExportRequest(
+  run_id: string,
+): { url: string; body: string } {
+  return {
+    url: "/api/export",
+    body: JSON.stringify({ run_id }),
+  };
+}
+
+export function buildDownloadFilename(run_id: string): string {
+  return `${run_id}.html`;
+}
 
 interface BottomActionsProps {
   slidePlan: SlidePlan | null;
-  userSelection: UserSelection;
+  runMeta: RunMeta | null;
+  uploadedFile: File | null;
   isLoading: boolean;
   onGenerate: () => void;
 }
 
 export default function BottomActions({
   slidePlan,
-  userSelection,
+  runMeta,
+  uploadedFile,
   isLoading,
   onGenerate,
 }: BottomActionsProps) {
-  const handleDownload = () => {
+  const [isConnecting, setIsConnecting] = useState(false);
-    if (!slidePlan) {
+  const [isExporting, setIsExporting] = useState(false);
-      toast.error("슬라이드 플랜이 없습니다. 먼저 생성하기를 눌러주세요.");
+
+  const runReady = !!runMeta && !!slidePlan;
+
+  const handleExport = async () => {
+    if (!runMeta) {
+      toast.error("Run 산출물이 없습니다. 먼저 생성하기를 눌러주세요.");
       return;
     }
-
+    setIsExporting(true);
-    const json = serializeSlidePlan(slidePlan, userSelection);
+    try {
-    console.log("[Download] SlidePlan JSON:", json);
+      const exportReq = buildExportRequest(runMeta.run_id);
-
+      const resp = await fetch(exportReq.url, {
-    // JSON 파일 다운로드
+        method: "POST",
-    const blob = new Blob([json], { type: "application/json" });
+        headers: { "Content-Type": "application/json" },
-    const url = URL.createObjectURL(blob);
+        body: exportReq.body,
-    const a = document.createElement("a");
+      });
-    a.href = url;
+      if (!resp.ok) {
-    a.download = `slide-plan-${Date.now()}.json`;
+        const text = await resp.text();
-    a.click();
+        toast.error(`Export 실패 (${resp.status}): ${text.slice(0, 160)}`);
-    URL.revokeObjectURL(url);
+        return;
-
+      }
-    toast.success("SlidePlan JSON이 다운로드되었습니다.");
+      const blob = await resp.blob();
+      const objectUrl = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      a.href = objectUrl;
+      a.download = buildDownloadFilename(runMeta.run_id);
+      document.body.appendChild(a);
+      a.click();
+      a.remove();
+      URL.revokeObjectURL(objectUrl);
+      toast.success(`standalone HTML 다운로드 — ${runMeta.run_id}.html`);
+    } catch (err) {
+      toast.error(`Export 네트워크 오류: ${(err as Error).message}`);
+    } finally {
+      setIsExporting(false);
+    }
   };
 
-  const handleConnect = () => {
+  const handleConnect = async () => {
-    toast.info("연동하기 기능은 파이프라인 연결 후 활성화됩니다.");
+    if (!runMeta) {
+      toast.error("Run 산출물이 없습니다. 먼저 생성하기를 눌러주세요.");
+      return;
+    }
+    if (!uploadedFile) {
+      toast.error("MDX 파일이 없습니다 — slug 도출 불가.");
+      return;
+    }
+    const slug = deriveUserOverridesKey(uploadedFile.name);
+    setIsConnecting(true);
+    try {
+      const connectReq = buildConnectRequest(runMeta.run_id, slug);
+      const resp = await fetch(connectReq.url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: connectReq.body,
+      });
+      const payload = (await resp.json().catch(() => ({}))) as {
+        success?: boolean;
+        assets_copied?: number;
+        error?: string;
+      };
+      if (!resp.ok || !payload.success) {
+        toast.error(
+          `Connect 실패 (${resp.status}): ${payload.error ?? "unknown error"}`,
+        );
+        return;
+      }
+      toast.success(
+        `cel 미러 연동 완료 — ${slug}.html (assets ${payload.assets_copied ?? 0}개 복사)`,
+      );
+    } catch (err) {
+      toast.error(`Connect 네트워크 오류: ${(err as Error).message}`);
+    } finally {
+      setIsConnecting(false);
+    }
   };
 
   return (
-    <div className="flex items-center justify-center gap-3 px-6 py-3 bg-white border-t border-slate-200">
+    <div className="flex items-center gap-3">
-      <div className="flex items-center gap-1.5 mr-2">
-        <span className="w-5 h-5 rounded-full bg-blue-600 text-white text-xs flex items-center justify-center font-bold">4</span>
-        <span className="text-xs text-slate-500 font-medium">액션</span>
-      </div>
-      {/* 생성하기 */}
       <Button
         onClick={onGenerate}
         disabled={isLoading}
-        className="gap-2 min-w-[120px]"
+        className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest bg-slate-900 hover:bg-slate-800"
         size="default"
       >
         {isLoading ? (
           <>
-            <Loader2 className="w-4 h-4 animate-spin" />
+            <Loader2 className="w-3.5 h-3.5 animate-spin" />
             생성 중...
           </>
         ) : (
           <>
-            <Sparkles className="w-4 h-4" />
+            <Sparkles className="w-3.5 h-3.5" />
             생성하기
           </>
         )}
       </Button>
 
-      {/* 다운로드 */}
       <Button
         variant="outline"
-        onClick={handleDownload}
+        onClick={handleExport}
-        disabled={!slidePlan || isLoading}
+        disabled={!runReady || isExporting || isLoading}
-        className="gap-2 min-w-[120px]"
+        className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"
         size="default"
       >
-        <Download className="w-4 h-4" />
+        {isExporting ? (
+          <Loader2 className="w-3.5 h-3.5 animate-spin" />
+        ) : (
+          <Download className="w-3.5 h-3.5" />
+        )}
         다운로드
       </Button>
 
-      {/* 연동하기 */}
       <Button
         variant="outline"
         onClick={handleConnect}
-        className="gap-2 min-w-[120px] text-slate-500"
+        disabled={!runReady || isConnecting || isLoading}
+        className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"
         size="default"
       >
-        <Link2 className="w-4 h-4" />
+        {isConnecting ? (
+          <Loader2 className="w-3.5 h-3.5 animate-spin" />
+        ) : (
+          <Link2 className="w-3.5 h-3.5" />
+        )}
         연동하기
       </Button>
     </div>

Front/client/src/components/FramePanel.tsx

@@ -9,6 +9,7 @@ import { Badge } from '@/components/ui/badge';
 import { motion } from 'framer-motion';
 import type { Zone, InternalRegion, UserSelection, FrameCandidate, SlidePlan } from '../types/designAgent';
 import { getSectionsForZone } from '../utils/slidePlanUtils';
+import { buildBadgeTitle } from '../services/applicationMode';
 
 interface FramePanelProps {
   slidePlan: SlidePlan | null;
@@ -19,6 +20,19 @@ interface FramePanelProps {
   onNoDesignToggle: () => void;
 }
 
+// IMP-#84 u1 — silent-automation contract: frame selection delegates directly
+// to onFrameSelect for every V4 label (use_as_is / light_edit / restructure /
+// reject). Prior IMP-47B u11 surfaced a window.confirm popup on reject; that
+// popup is informational UI noise per `feedback_auto_pipeline_first` and is
+// removed. Frame identity is preserved on reject (AI 재구성 = content-only,
+// per AI 격리 contract); the popup never gated that contract.
+export function applyFrameSelection(
+  candidate: FrameCandidate,
+  onFrameSelect: (frameId: string) => void,
+): void {
+  onFrameSelect(candidate.id);
+}
+
 export default function FramePanel({
   slidePlan,
   selectedZone,
@@ -46,6 +60,13 @@ export default function FramePanel({
     return userSelection.overrides.zone_frames[targetRegion.id] || targetRegion.frame_match_strategy.frame_id;
   }, [selectedZone, selectedRegion, userSelection.overrides.zone_frames]);
 
+  const handleFrameSelect = React.useCallback(
+    (candidate: FrameCandidate) => {
+      applyFrameSelection(candidate, onFrameSelect);
+    },
+    [onFrameSelect],
+  );
+
   if (!selectedZone) {
     return (
       <div className="h-full flex flex-col items-center justify-center bg-slate-50 p-8 text-center text-slate-400">
@@ -78,6 +99,9 @@ export default function FramePanel({
         {candidates.length === 0 ? (
           <div className="py-20 text-center border-2 border-dashed border-slate-50 rounded-2xl">
              <p className="text-[10px] font-bold text-slate-300 uppercase">No Candidates Available</p>
+             <p className="mt-2 px-4 text-[10px] leading-relaxed text-slate-400">
+               backend candidate pool is empty for {assignedSectionIds.join(", ") || selectedZone.zone_id}.
+             </p>
           </div>
         ) : (
           candidates.map((candidate, index) => {
@@ -87,6 +111,67 @@ export default function FramePanel({
             // catalog 미등록 = backend Step 7-A 가 override 시도해도 skip.
             // catalogRegistered === false 만 체크 (undefined = 정보 없음, 일반 처리).
             const isCatalogMissing = candidate.catalogRegistered === false;
+
+            // ─── IMP-29 u3 — IMP-05 L2 candidate_evidence surface ───────────
+            // All evidence fields optional; silent degradation when undefined
+            // (pre-IMP-05 fixtures fall back to label/catalogRegistered only).
+            const isFilteredDirect = candidate.filteredForDirectExecution === true;
+            const hasDecision = candidate.decision === "selected" || candidate.decision === "skipped";
+            const isSkipped = candidate.decision === "skipped";
+            const isSelectedDecision = candidate.decision === "selected";
+            const showRouteChip =
+              candidate.routeHint && candidate.routeHint !== "direct_render";
+            const showStatusChip =
+              candidate.phaseZStatus && candidate.phaseZStatus !== "auto_renderable";
+            const showCoverageChip = Boolean(candidate.coverageState);
+            const hasCapacityFit =
+              candidate.capacityFit && candidate.capacityFit.fit_status;
+            const capacityMismatch =
+              hasCapacityFit && candidate.capacityFit!.fit_status !== "ok";
+
+            // Compose evidence tooltip lines (only when at least one signal present).
+            const evidenceLines: string[] = [];
+            if (candidate.decision) evidenceLines.push(`decision: ${candidate.decision}`);
+            if (candidate.reason) evidenceLines.push(`reason: ${candidate.reason}`);
+            if (candidate.routeHint) evidenceLines.push(`route: ${candidate.routeHint}`);
+            if (candidate.phaseZStatus)
+              evidenceLines.push(`phase_z_status: ${candidate.phaseZStatus}`);
+            if (candidate.candidateStatus)
+              evidenceLines.push(`candidate_status: ${candidate.candidateStatus}`);
+            if (candidate.coverageState)
+              evidenceLines.push(`coverage_state: ${candidate.coverageState}`);
+            if (hasCapacityFit) {
+              const cf = candidate.capacityFit!;
+              const capacityLine =
+                cf.fit_status === "ok"
+                  ? `capacity: ok${
+                      typeof cf.item_count === "number"
+                        ? ` (items=${cf.item_count})`
+                        : ""
+                    }`
+                  : `capacity: ${cf.fit_status}${
+                      cf.mismatch_reason ? ` — ${cf.mismatch_reason}` : ""
+                    }`;
+              evidenceLines.push(capacityLine);
+            }
+            const evidenceTooltip =
+              evidenceLines.length > 0 ? evidenceLines.join("\n") : undefined;
+
+            // Compose final tooltip: existing catalog/reject reasons first, then
+            // evidence detail (preserves Phase Q tooltip semantics).
+            const tooltipParts = [
+              isCatalogMissing
+                ? "⚠ catalog 미등록 — render path 에서 적용 안 됨 (선택해도 backend 가 skip)"
+                : null,
+              isFilteredDirect
+                ? "⚠ filtered_for_direct_execution — MVP1 직접 렌더 경로 제외"
+                : null,
+              isReject ? "V4 reject — render path 비추천" : null,
+              evidenceTooltip,
+            ].filter((s): s is string => Boolean(s));
+            const composedTitle =
+              tooltipParts.length > 0 ? tooltipParts.join("\n\n") : undefined;
+
             return (
               <motion.div
                 key={candidate.id}
@@ -95,7 +180,7 @@ export default function FramePanel({
                 className="w-full"
               >
                 <button
-                  onClick={() => onFrameSelect(candidate.id)}
+                  onClick={() => handleFrameSelect(candidate)}
                   draggable
                   onDragStart={(e) => {
                     e.dataTransfer.setData("frameId", candidate.id);
@@ -105,17 +190,13 @@ export default function FramePanel({
                       ? 'border-blue-500 bg-white shadow-xl shadow-blue-500/10'
                       : isCatalogMissing
                       ? 'border-slate-100 bg-slate-50/40 opacity-60 hover:opacity-90 hover:border-amber-200'
+                      : isFilteredDirect
+                      ? 'border-slate-100 bg-slate-50/30 opacity-50 hover:opacity-90 hover:border-amber-200'
                       : isReject
                       ? 'border-slate-100 bg-slate-50/30 opacity-50 hover:opacity-90 hover:border-slate-200'
                       : 'border-slate-100 bg-slate-50/50 hover:border-slate-200 hover:bg-white'
                   }`}
-                  title={
+                  title={composedTitle}
-                    isCatalogMissing
-                      ? "⚠ catalog 미등록 — render path 에서 적용 안 됨 (선택해도 backend 가 skip)"
-                      : isReject
-                      ? "V4 reject — render path 비추천"
-                      : undefined
-                  }
                 >
                   {/* Rank Badge */}
                   <div className="absolute top-3 left-3 z-10">
@@ -183,6 +264,13 @@ export default function FramePanel({
                            </span>
                          )}
                          {/* V4 label badge */}
+                         {/* IMP-41 u5 — tooltip delegated to pure helper
+                             `buildBadgeTitle` (services/applicationMode.ts).
+                             applicationMode is forwarded by designAgentApi.ts
+                             (u4) from Step 9 unit.application_candidates[];
+                             helper falls back to the raw V4 label when the
+                             mode is undefined or unknown. Badge color mapping
+                             is intentionally untouched per Stage 2 scope. */}
                          {candidate.label && (
                            <span
                              className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
@@ -194,11 +282,91 @@ export default function FramePanel({
                                  ? "bg-amber-100 text-amber-700"
                                  : "bg-red-100 text-red-700"
                              }`}
-                             title={`V4 label: ${candidate.label}`}
+                             title={buildBadgeTitle(candidate.label, candidate.applicationMode)}
                            >
                              {candidate.label}
                            </span>
                          )}
+                         {showCoverageChip && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               candidate.coverageState === "covered_native"
+                                 ? "bg-emerald-50 text-emerald-700"
+                                 : candidate.coverageState === "covered_via_expand"
+                                 ? "bg-cyan-50 text-cyan-700"
+                                 : candidate.coverageState === "requires_adaptation"
+                                 ? "bg-amber-50 text-amber-700"
+                                 : "bg-slate-100 text-slate-600"
+                             }`}
+                             title={`coverage_state: ${candidate.coverageState}`}
+                           >
+                             {candidate.coverageState === "covered_native"
+                               ? "native"
+                               : candidate.coverageState === "covered_via_expand"
+                               ? "expand"
+                               : candidate.coverageState === "requires_adaptation"
+                               ? "adapt"
+                               : "unsup"}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — route hint chip (skip when direct_render = default). */}
+                         {showRouteChip && (
+                           <span
+                             className="text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded bg-slate-100 text-slate-600"
+                             title={`route_hint: ${candidate.routeHint}`}
+                           >
+                             {candidate.routeHint === "deterministic_minor_adjustment"
+                               ? "adapt"
+                               : candidate.routeHint === "ai_adaptation_required"
+                               ? "ai req"
+                               : candidate.routeHint === "design_reference_only"
+                               ? "ref"
+                               : candidate.routeHint}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — phase_z status warning chip (skip when auto_renderable). */}
+                         {showStatusChip && (
+                           <span
+                             className="text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded bg-amber-50 text-amber-700"
+                             title={`phase_z_status: ${candidate.phaseZStatus}`}
+                           >
+                             {candidate.phaseZStatus!.replace(/_/g, " ")}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — capacity_fit indicator (ok = subtle, mismatch = warning). */}
+                         {hasCapacityFit && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               capacityMismatch
+                                 ? "bg-amber-100 text-amber-700"
+                                 : "bg-slate-100 text-slate-500"
+                             }`}
+                             title={`capacity_fit: ${candidate.capacityFit!.fit_status}${
+                               candidate.capacityFit!.mismatch_reason
+                                 ? ` — ${candidate.capacityFit!.mismatch_reason}`
+                                 : ""
+                             }`}
+                           >
+                             {capacityMismatch
+                               ? `fit: ${candidate.capacityFit!.fit_status}`
+                               : "fit ok"}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — decision badge (Stage 2 contract: surface both selected & skipped). */}
+                         {hasDecision && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               isSelectedDecision
+                                 ? "bg-emerald-50 text-emerald-700"
+                                 : "bg-red-50 text-red-600"
+                             }`}
+                             title={`decision: ${candidate.decision}${
+                               candidate.reason ? ` — ${candidate.reason}` : ""
+                             }`}
+                           >
+                             {isSkipped ? "skip" : "sel"}
+                           </span>
+                         )}
                          {isSelected && (
                            <div className="flex items-center gap-1 text-[8px] font-black text-emerald-500 uppercase">
                              <Check className="w-2.5 h-2.5 stroke-[4]" />

Front/client/src/components/LeftMdxPanel.tsx

@@ -34,12 +34,14 @@ interface LeftMdxPanelProps {
   onFileUpload: (file: File) => void;
   onGenerate: () => void;
   onSectionClick: (sectionId: string) => void;
-  /** 사용자 lock 2026-05-14 — 좌측 패널에 03/04/05 fix 고정 list. 클릭 시 callback. */
+  /** 사용자 lock 2026-05-14 — 좌측 패널에 01~05 fix 고정 list. 클릭 시 callback. */
-  onSelectSample?: (which: "03" | "04" | "05") => void;
+  onSelectSample?: (which: "01" | "02" | "03" | "04" | "05") => void;
-  selectedSample?: "03" | "04" | "05" | null;
+  selectedSample?: "01" | "02" | "03" | "04" | "05" | null;
 }
 
-const SAMPLE_MDX_LIST: { key: "03" | "04" | "05"; label: string; subtitle: string }[] = [
+const SAMPLE_MDX_LIST: { key: "01" | "02" | "03" | "04" | "05"; label: string; subtitle: string }[] = [
+  { key: "01", label: "01. 건설산업 DX의 올바른 이해", subtitle: "DX 개념 + 산업 전환 관점" },
+  { key: "02", label: "02. DX의 시행 목표 및 기대효과", subtitle: "시행 목표 + 기대효과" },
   { key: "03", label: "03. DX 시행을 위한 필수 요건", subtitle: "필수 요건 + Process/Product 혁신" },
   { key: "04", label: "04. DX 지연 요인", subtitle: "DX 인식 + 정책/조직 실태" },
   { key: "05", label: "05. 설계 방식의 왜곡", subtitle: "설계 자동화 오용 + S/W 한계" },
@@ -74,7 +76,7 @@ export default function LeftMdxPanel({
           MDX Source
         </h2>
 
-        {/* 2026-05-14 — 03/04/05 fix 고정 list. 클릭 시 해당 mdx 자동 fetch + 분석.
+        {/* 2026-05-14 — 01~05 fix 고정 list. 클릭 시 해당 mdx 자동 fetch + 분석.
             frame/layout override 는 분석 후 우측 패널에서 가능. */}
         {onSelectSample && (
           <div className="space-y-1 mb-3">

Front/client/src/components/PipelineTracePanel.tsx

@@ -0,0 +1,216 @@
+import { AlertTriangle, CheckCircle2, GitBranch, Layers3 } from "lucide-react";
+import type React from "react";
+import type { AiTraceSummary, PipelineTraceSummary } from "../services/designAgentApi";
+
+interface PipelineTracePanelProps {
+  trace: PipelineTraceSummary | null | undefined;
+  aiTrace?: AiTraceSummary | null;
+}
+
+const stateClass: Record<string, string> = {
+  rendered: "bg-emerald-50 text-emerald-700 border-emerald-200",
+  render_blocked: "bg-red-50 text-red-700 border-red-200",
+  filtered: "bg-amber-50 text-amber-700 border-amber-200",
+  covered_not_rendered: "bg-orange-50 text-orange-700 border-orange-200",
+  uncovered: "bg-slate-50 text-slate-500 border-slate-200",
+};
+
+function Chip({ children, tone = "slate" }: { children: React.ReactNode; tone?: "slate" | "red" | "green" | "amber" }) {
+  const tones = {
+    slate: "bg-slate-100 text-slate-600",
+    red: "bg-red-100 text-red-700",
+    green: "bg-emerald-100 text-emerald-700",
+    amber: "bg-amber-100 text-amber-700",
+  };
+  return (
+    <span className={`inline-flex items-center rounded px-1.5 py-0.5 text-[9px] font-black uppercase ${tones[tone]}`}>
+      {children}
+    </span>
+  );
+}
+
+export default function PipelineTracePanel({ trace, aiTrace }: PipelineTracePanelProps) {
+  if (!trace) {
+    return (
+      <div className="h-full flex items-center justify-center bg-slate-50 p-8 text-center text-slate-400">
+        <div>
+          <GitBranch className="mx-auto mb-3 h-10 w-10 opacity-20" />
+          <p className="text-[10px] font-black uppercase tracking-[0.18em]">No Trace Loaded</p>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div className="h-full overflow-y-auto bg-white p-4 text-slate-700">
+      <div className="mb-4 flex items-center justify-between">
+        <div className="flex items-center gap-2">
+          <GitBranch className="h-4 w-4 text-blue-500" />
+          <h3 className="text-[10px] font-black uppercase tracking-widest text-slate-500">Pipeline Trace</h3>
+        </div>
+        <Chip tone={trace.warnings.length > 0 ? "amber" : "green"}>{trace.status}</Chip>
+      </div>
+
+      {trace.warnings.length > 0 && (
+        <div className="mb-4 rounded border border-amber-200 bg-amber-50 p-3">
+          <div className="mb-1 flex items-center gap-1.5 text-[10px] font-black uppercase text-amber-700">
+            <AlertTriangle className="h-3.5 w-3.5" />
+            Warnings
+          </div>
+          <div className="flex flex-wrap gap-1">
+            {trace.warnings.map((warning) => (
+              <Chip key={warning} tone="amber">{warning}</Chip>
+            ))}
+          </div>
+        </div>
+      )}
+
+      <section className="mb-5">
+        <div className="mb-2 flex items-center gap-1.5 text-[10px] font-black uppercase tracking-widest text-slate-400">
+          <Layers3 className="h-3.5 w-3.5" />
+          Sections
+        </div>
+        <div className="space-y-2">
+          {trace.sections.map((section) => (
+            <div key={section.id} className={`rounded border p-2 ${stateClass[section.state] ?? stateClass.uncovered}`}>
+              <div className="flex items-center justify-between gap-2">
+                <span className="font-mono text-[11px] font-bold">{section.id}</span>
+                <span className="text-[9px] font-black uppercase">{section.state}</span>
+              </div>
+              {section.title && <div className="mt-1 text-[11px] leading-snug">{section.title}</div>}
+              {section.child_ids.length > 0 && (
+                <div className="mt-1 text-[10px] text-slate-500">children: {section.child_ids.join(", ")}</div>
+              )}
+              {section.reasons.length > 0 && (
+                <div className="mt-2 flex flex-wrap gap-1">
+                  {section.reasons.map((reason) => (
+                    <Chip key={reason} tone={section.state === "render_blocked" ? "red" : "amber"}>
+                      {reason}
+                    </Chip>
+                  ))}
+                </div>
+              )}
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section className="mb-5">
+        <div className="mb-2 text-[10px] font-black uppercase tracking-widest text-slate-400">Units</div>
+        <div className="space-y-2">
+          {trace.units.map((unit) => (
+            <div key={unit.unit_id} className="rounded border border-slate-200 bg-slate-50 p-2">
+              <div className="font-mono text-[11px] font-bold text-slate-700">{unit.unit_id || "(empty unit)"}</div>
+              <div className="mt-1 grid grid-cols-2 gap-x-2 gap-y-1 text-[10px]">
+                <span>frame</span><span className="font-mono">{unit.selected_frame ?? "-"}</span>
+                <span>candidates</span><span className="font-mono">{unit.candidate_count}</span>
+                <span>path</span><span className="font-mono">{unit.selection_path ?? "-"}</span>
+                <span>label</span><span className="font-mono">{unit.label ?? "-"}</span>
+              </div>
+              {unit.warnings.length > 0 && (
+                <div className="mt-2 flex flex-wrap gap-1">
+                  {unit.warnings.map((warning) => <Chip key={warning} tone="amber">{warning}</Chip>)}
+                </div>
+              )}
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section>
+        <div className="mb-2 text-[10px] font-black uppercase tracking-widest text-slate-400">Zones / Render</div>
+        <div className="space-y-2">
+          {trace.zones.map((zone) => {
+            const filled = zone.slot_status === "filled";
+            return (
+              <div key={zone.position} className="rounded border border-slate-200 bg-white p-2">
+                <div className="flex items-center justify-between">
+                  <span className="font-mono text-[11px] font-bold">{zone.position}</span>
+                  <Chip tone={filled ? "green" : "red"}>{zone.slot_status}</Chip>
+                </div>
+                <div className="mt-1 text-[10px] text-slate-500">sections: {zone.source_section_ids.join(", ") || "-"}</div>
+                <div className="mt-1 text-[10px] text-slate-500">template: <span className="font-mono">{zone.template_id ?? "-"}</span></div>
+                <div className="mt-1 text-[10px] text-slate-500">slot keys: {zone.slot_key_count}</div>
+                {zone.warnings.length > 0 ? (
+                  <div className="mt-2 flex flex-wrap gap-1">
+                    {zone.warnings.map((warning) => <Chip key={warning} tone="red">{warning}</Chip>)}
+                  </div>
+                ) : (
+                  <div className="mt-2 flex items-center gap-1 text-[10px] text-emerald-600">
+                    <CheckCircle2 className="h-3 w-3" />
+                    render payload ready
+                  </div>
+                )}
+              </div>
+            );
+          })}
+        </div>
+      </section>
+
+      <section className="mt-5">
+        <div className="mb-2 text-[10px] font-black uppercase tracking-widest text-slate-400">AI Status</div>
+        {!aiTrace ? (
+          <div className="rounded border border-slate-200 bg-slate-50 p-3 text-[11px] text-slate-500">
+            AI trace not loaded.
+          </div>
+        ) : (
+          <div className="rounded border border-slate-200 bg-white p-3">
+            <div className="mb-2 flex flex-wrap gap-1">
+              <Chip tone={aiTrace.artifact_present ? "green" : "red"}>
+                {aiTrace.artifact_present ? "artifact" : "missing"}
+              </Chip>
+              <Chip tone={aiTrace.ai_enabled === false ? "amber" : aiTrace.ai_enabled ? "green" : "slate"}>
+                enabled {aiTrace.ai_enabled === null ? "unknown" : String(aiTrace.ai_enabled)}
+              </Chip>
+              <Chip tone={aiTrace.ai_called_count > 0 ? "green" : "slate"}>
+                called {aiTrace.ai_called_count}
+              </Chip>
+              <Chip tone={aiTrace.eligible_count > 0 ? "amber" : "slate"}>
+                eligible {aiTrace.eligible_count}
+              </Chip>
+              <Chip tone={aiTrace.error_count > 0 ? "red" : "slate"}>
+                errors {aiTrace.error_count}
+              </Chip>
+            </div>
+            <div className="grid grid-cols-2 gap-x-2 gap-y-1 text-[10px] text-slate-500">
+              <span>status</span><span className="font-mono">{aiTrace.status}</span>
+              <span>coverage</span><span className="font-mono">{aiTrace.coverage_status ?? "-"}</span>
+              <span>provider</span><span className="font-mono">{aiTrace.provider ?? "-"}</span>
+              <span>human review</span><span className="font-mono">{String(aiTrace.human_review_required)}</span>
+            </div>
+            {Object.keys(aiTrace.skip_reasons).length > 0 && (
+              <div className="mt-3">
+                <div className="mb-1 text-[10px] font-black uppercase text-slate-400">Skip Reasons</div>
+                <div className="flex flex-wrap gap-1">
+                  {Object.entries(aiTrace.skip_reasons).map(([reason, count]) => (
+                    <Chip key={reason} tone={reason === "called" ? "green" : "slate"}>
+                      {reason}: {count}
+                    </Chip>
+                  ))}
+                </div>
+              </div>
+            )}
+            {aiTrace.units.length > 0 && (
+              <div className="mt-3 space-y-2">
+                {aiTrace.units.map((unit) => (
+                  <div key={`${unit.unit_index}-${unit.source_section_ids.join("+")}`} className="rounded bg-slate-50 p-2 text-[10px]">
+                    <div className="flex items-center justify-between">
+                      <span className="font-mono font-bold">{unit.source_section_ids.join("+") || `unit-${unit.unit_index}`}</span>
+                      <Chip tone={unit.ai_called ? "green" : "slate"}>{unit.ai_called ? "called" : "not called"}</Chip>
+                    </div>
+                    <div className="mt-1 grid grid-cols-2 gap-x-2 gap-y-1 text-slate-500">
+                      <span>route</span><span className="font-mono">{unit.route_hint ?? "-"}</span>
+                      <span>skip</span><span className="font-mono">{unit.skip_reason ?? "-"}</span>
+                      <span>apply</span><span className="font-mono">{unit.apply_status ?? "-"}</span>
+                      <span>error</span><span className="font-mono">{unit.error ?? "-"}</span>
+                    </div>
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+        )}
+      </section>
+    </div>
+  );
+}

Front/client/src/components/StructureEditOverlay.tsx

@@ -0,0 +1,165 @@
+/**
+ * IMP-90 (#90) u14 — Structure edit overlay.
+ *
+ * React component + pure helpers that present a per-zone slot list with
+ * reorder (↑ / ↓) and hide (👁 / 🚫) affordances. Mounted by SlideCanvas
+ * when `editMode === "structure"`. Emits a `StructureOverridePerZone`
+ * tuple `{slot_order, hidden_slots}` through `onChange`; u15 will debounce
+ * + PUT this to `/api/user-overrides` (NOT u14 scope), and u16 reads the
+ * persisted axis at the next CLI generate run.
+ *
+ * SCOPE LOCK (binding contract):
+ *   - inner shape = `{slot_order, hidden_slots}` ONLY.
+ *   - frame swap stays on the existing `frames` axis (u6 backend resolver
+ *     rejects frame-swap-shaped inner keys).
+ *   - per-slot text content NEVER mutated here — `text_overrides` axis
+ *     (u4/u5/u13) handles that exclusively.
+ *
+ * The exported pure helpers (`resolveEffectiveSlotOrder`, `moveItem`) are
+ * the unit's vitest surface; React rendering is NOT tested because the
+ * Front package devDependencies do not include jsdom / @testing-library
+ * (verified by u11/u12/u13 test pattern).
+ */
+import type {
+  StructureOverridePerZone,
+} from "../services/userOverridesApi";
+
+export interface StructureEditOverlayProps {
+  zoneId: string;
+  /** Discovered slot keys for this zone (e.g. from iframe DOM
+   *  `data-text-path` prefixes). Order = backend default. */
+  slotKeys: ReadonlyArray<string>;
+  /** Current persisted override (or undefined). `slot_order` reorders the
+   *  discovered keys; missing keys keep backend order at the tail. */
+  current?: StructureOverridePerZone;
+  /** Emitted on every user mutation. u15 wires this to autosave. */
+  onChange?: (zoneId: string, next: StructureOverridePerZone) => void;
+}
+
+/** Apply `slot_order` override to the discovered slot list. Unknown
+ *  override entries are dropped; missing discovered keys are appended in
+ *  backend order so the user never loses a slot by partial-override. */
+export function resolveEffectiveSlotOrder(
+  slotKeys: ReadonlyArray<string>,
+  slotOrder?: ReadonlyArray<string> | null,
+): string[] {
+  if (!slotOrder || slotOrder.length === 0) return [...slotKeys];
+  const allowed = new Set(slotKeys);
+  const seen = new Set<string>();
+  const ordered: string[] = [];
+  for (const k of slotOrder) {
+    if (typeof k === "string" && allowed.has(k) && !seen.has(k)) {
+      ordered.push(k);
+      seen.add(k);
+    }
+  }
+  for (const k of slotKeys) {
+    if (!seen.has(k)) ordered.push(k);
+  }
+  return ordered;
+}
+
+/** Move `arr[index]` by `delta` positions. Out-of-range returns a fresh
+ *  copy of the input (defensive: caller can always treat the result as a
+ *  new reference). */
+export function moveItem<T>(
+  arr: ReadonlyArray<T>,
+  index: number,
+  delta: number,
+): T[] {
+  const next = arr.slice();
+  const target = index + delta;
+  if (
+    index < 0 ||
+    index >= next.length ||
+    target < 0 ||
+    target >= next.length
+  ) {
+    return next;
+  }
+  const tmp = next[index];
+  next[index] = next[target];
+  next[target] = tmp;
+  return next;
+}
+
+export default function StructureEditOverlay({
+  zoneId,
+  slotKeys,
+  current,
+  onChange,
+}: StructureEditOverlayProps) {
+  const effective = resolveEffectiveSlotOrder(slotKeys, current?.slot_order);
+  const hidden = new Set(current?.hidden_slots ?? []);
+  const emit = (nextOrder: string[], nextHidden: Set<string>) => {
+    onChange?.(zoneId, {
+      slot_order: nextOrder,
+      hidden_slots: Array.from(nextHidden),
+    });
+  };
+  return (
+    <div
+      data-testid={`structure-overlay-${zoneId}`}
+      className="bg-white/95 border border-emerald-300 rounded shadow p-2 flex flex-col gap-1 text-[10px]"
+      style={{ pointerEvents: "auto" }}
+    >
+      <div className="font-bold uppercase tracking-wider text-emerald-700 mb-1">
+        ▦ {zoneId}
+      </div>
+      {effective.length === 0 ? (
+        <div className="text-slate-400 italic">slot 없음</div>
+      ) : (
+        effective.map((key, i) => (
+          <div
+            key={key}
+            data-testid={`slot-${zoneId}-${key}`}
+            className="flex items-center gap-1"
+          >
+            <span
+              className={`flex-1 truncate ${
+                hidden.has(key) ? "text-slate-400 line-through" : "text-slate-700"
+              }`}
+            >
+              {key}
+            </span>
+            <button
+              type="button"
+              data-testid={`slot-up-${zoneId}-${key}`}
+              disabled={i === 0}
+              onClick={() => emit(moveItem(effective, i, -1), hidden)}
+              className="px-1 rounded border border-slate-200 disabled:opacity-30 hover:bg-slate-100"
+              title="위로"
+            >
+              ↑
+            </button>
+            <button
+              type="button"
+              data-testid={`slot-down-${zoneId}-${key}`}
+              disabled={i === effective.length - 1}
+              onClick={() => emit(moveItem(effective, i, 1), hidden)}
+              className="px-1 rounded border border-slate-200 disabled:opacity-30 hover:bg-slate-100"
+              title="아래로"
+            >
+              ↓
+            </button>
+            <button
+              type="button"
+              data-testid={`slot-hide-${zoneId}-${key}`}
+              aria-pressed={hidden.has(key)}
+              onClick={() => {
+                const nh = new Set(hidden);
+                if (nh.has(key)) nh.delete(key);
+                else nh.add(key);
+                emit(effective, nh);
+              }}
+              className="px-1 rounded border border-slate-200 hover:bg-slate-100"
+              title={hidden.has(key) ? "표시" : "숨김"}
+            >
+              {hidden.has(key) ? "🚫" : "👁"}
+            </button>
+          </div>
+        ))
+      )}
+    </div>
+  );
+}

Front/client/src/components/slideCanvasDragMath.test.ts

@@ -0,0 +1,225 @@
+// IMP-54 u4 — vitest coverage for the pure drag-math helpers extracted in u3
+// (`Front/client/src/components/slideCanvasDragMath.ts`).
+//
+// Stage 2 contract (`Stage 2 Exit Report → implementation_units → u4`):
+//   • Threshold pass/fail at 5 px (strict `Math.hypot > 5`).
+//   • Clamp negative delta to 0 on both axes.
+//   • Clamp max-edge delta to `1 - startGeom.w` (x) and `1 - startGeom.h` (y).
+//
+// The helpers are pure (no React, no DOM) so we drive them directly with
+// numeric inputs — no fake timers, no fetch stubs, no component mount.
+
+import { describe, expect, it } from "vitest";
+
+import {
+  DRAG_THRESHOLD_PX,
+  IMAGE_RESIZE_MIN_SIZE_PERCENT,
+  clampImagePercentGeometry,
+  clampZoneMove,
+  crossedDragThreshold,
+  type ImagePercentGeom,
+  type ZoneFracGeom,
+} from "./slideCanvasDragMath";
+
+describe("DRAG_THRESHOLD_PX", () => {
+  it("is 5", () => {
+    expect(DRAG_THRESHOLD_PX).toBe(5);
+  });
+});
+
+describe("crossedDragThreshold", () => {
+  it("returns false for zero movement (still a click)", () => {
+    expect(crossedDragThreshold(0, 0)).toBe(false);
+  });
+
+  it("returns false just below threshold — 3,4 → hypot 5 with strict >", () => {
+    expect(crossedDragThreshold(3, 4)).toBe(false);
+  });
+
+  it("returns false at exactly the threshold along each axis", () => {
+    // strict inequality: Math.hypot(5, 0) === 5, not > 5
+    expect(crossedDragThreshold(5, 0)).toBe(false);
+    expect(crossedDragThreshold(0, 5)).toBe(false);
+  });
+
+  it("returns true once distance exceeds threshold", () => {
+    expect(crossedDragThreshold(4, 4)).toBe(true); // hypot ≈ 5.6568
+    expect(crossedDragThreshold(6, 0)).toBe(true);
+    expect(crossedDragThreshold(0, 6)).toBe(true);
+  });
+
+  it("treats negative deltas symmetrically (Euclidean distance)", () => {
+    expect(crossedDragThreshold(-3, -4)).toBe(false);
+    expect(crossedDragThreshold(-4, -4)).toBe(true);
+    expect(crossedDragThreshold(-6, 0)).toBe(true);
+  });
+});
+
+describe("clampZoneMove", () => {
+  // 1000 × 1000 slide body so 1 px == 0.001 frac — keeps the arithmetic
+  // exact and the boundary deltas (1000 px) round-trip back to `1 - w/h`.
+  const W = 1000;
+  const H = 1000;
+  const baseGeom: ZoneFracGeom = { x: 0.1, y: 0.2, w: 0.3, h: 0.4 };
+
+  it("applies in-bounds delta as startGeom + (dPx / slideBodySize)", () => {
+    expect(clampZoneMove(baseGeom, 100, 50, W, H)).toEqual({
+      x: 0.2,
+      y: 0.25,
+    });
+  });
+
+  it("clamps negative delta to 0 on both axes", () => {
+    expect(clampZoneMove(baseGeom, -1000, -1000, W, H)).toEqual({
+      x: 0,
+      y: 0,
+    });
+  });
+
+  it("clamps max-edge delta to (1 - w) on x and (1 - h) on y", () => {
+    expect(clampZoneMove(baseGeom, 1000, 1000, W, H)).toEqual({
+      x: 1 - baseGeom.w, // 0.7
+      y: 1 - baseGeom.h, // 0.6
+    });
+  });
+
+  it("clamps the two axes independently (negative x, in-bounds y)", () => {
+    expect(clampZoneMove(baseGeom, -1000, 50, W, H)).toEqual({
+      x: 0,
+      y: 0.25,
+    });
+  });
+
+  it("honours non-square slide bodies via per-axis division", () => {
+    // dxPx 100 / 500 = 0.2 fr; dyPx 100 / 250 = 0.4 fr (hits the y boundary).
+    // x is checked with toBeCloseTo because 0.1 + 0.2 is the canonical IEEE-754
+    // floating-point trap (0.30000000000000004) — the clamp logic is correct,
+    // it just inherits JS number precision. y stays exact since it clamps to
+    // the boundary `1 - h`.
+    const result = clampZoneMove(baseGeom, 100, 100, 500, 250);
+    expect(result.x).toBeCloseTo(0.3, 10);
+    expect(result.y).toBe(1 - baseGeom.h); // 0.6
+  });
+
+  it("returns only { x, y } — width / height are preserved by the caller", () => {
+    const out = clampZoneMove(baseGeom, 0, 0, W, H);
+    expect(out).toEqual({ x: 0.1, y: 0.2 });
+    expect("w" in out).toBe(false);
+    expect("h" in out).toBe(false);
+  });
+});
+
+// IMP-51 (#79) u9 — image overlay resize / move math.
+// Boundary contract (must match the inline u8 math Codex #16 verified):
+// • slide-bound invariant — x+w ≤ 100 ∧ y+h ≤ 100 for ALL valid inputs,
+//   including small-near-edge geoms where the existing minSize floor
+//   would otherwise have pushed past the slide bound.
+// • aspect-locked corner — baseAspect = startGeom.w / startGeom.h is
+//   preserved exactly; the wFloor uses `min(minSize, maxW, maxH*baseAspect)`
+//   so a floor application never violates either axis.
+// The two concrete Codex #15 reproductions are encoded explicitly below
+// so a future regression on the boundary math fails this suite directly.
+describe("IMAGE_RESIZE_MIN_SIZE_PERCENT", () => {
+  it("is 2 (percent of slide bbox)", () => {
+    expect(IMAGE_RESIZE_MIN_SIZE_PERCENT).toBe(2);
+  });
+});
+
+describe("clampImagePercentGeometry", () => {
+  const baseGeom: ImagePercentGeom = { x: 10, y: 10, w: 20, h: 10 };
+
+  describe("direction = 'move'", () => {
+    it("translates and clamps both axes; preserves w/h", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, 5, 7, "move", false),
+      ).toEqual({ x: 15, y: 17, w: 20, h: 10 });
+    });
+
+    it("clamps negative deltas to (0, 0)", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, -1000, -1000, "move", false),
+      ).toEqual({ x: 0, y: 0, w: 20, h: 10 });
+    });
+
+    it("clamps max-edge deltas to (100 - w, 100 - h)", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, 1000, 1000, "move", false),
+      ).toEqual({ x: 80, y: 90, w: 20, h: 10 });
+    });
+  });
+
+  describe("edge resize — independent per-axis clamp", () => {
+    it("right edge clamps width to 100 - startGeom.x", () => {
+      const out = clampImagePercentGeometry(baseGeom, 1000, 0, "right", false);
+      expect(out).toEqual({ x: 10, y: 10, w: 90, h: 10 });
+      expect(out.x + out.w).toBeLessThanOrEqual(100);
+    });
+
+    it("left drag dx=-100 emits {x:0,y:10,w:30,h:10} (Codex regression)", () => {
+      // From Codex #15 / #16 verification — ordinary left drag past the
+      // slide edge should pin x at 0 and grow w by the original x amount.
+      expect(
+        clampImagePercentGeometry(baseGeom, -100, 0, "left", false),
+      ).toEqual({ x: 0, y: 10, w: 30, h: 10 });
+    });
+
+    it("near-edge right resize keeps x + w ≤ 100 (Codex #15 reproduction)", () => {
+      // Pre-fix: minSize=2 floor applied AFTER span clamp would emit
+      // {x:99, w:2} so x+w=101. Post-fix: floor caps at maxW=1.
+      const start: ImagePercentGeom = { x: 99, y: 10, w: 0.5, h: 10 };
+      const out = clampImagePercentGeometry(start, 1, 0, "right", false);
+      expect(out).toEqual({ x: 99, y: 10, w: 1, h: 10 });
+      expect(out.x + out.w).toBe(100);
+    });
+
+    it("top/bottom edges are symmetric to left/right", () => {
+      const bottom = clampImagePercentGeometry(baseGeom, 0, 1000, "bottom", false);
+      expect(bottom).toEqual({ x: 10, y: 10, w: 20, h: 90 });
+      const top = clampImagePercentGeometry(baseGeom, 0, -100, "top", false);
+      expect(top).toEqual({ x: 10, y: 0, w: 20, h: 20 });
+    });
+  });
+
+  describe("corner resize — aspect locked (default Shift-off)", () => {
+    it("NW drag dx=-100,dy=-100 emits {x:0,y:5,w:30,h:15} (Codex regression)", () => {
+      // From Codex #16 verification — aspect-locked NW past the slide
+      // edge: rightEdge=30, bottomEdge=20, baseAspect=2. Independent
+      // clamps give x=0,w=30,y=0,h=20. Aspect block then picks the
+      // limiting axis: newH = 30/2 = 15 (≤20). Re-anchor: y = 20 - 15 = 5.
+      expect(
+        clampImagePercentGeometry(baseGeom, -100, -100, "nw", true),
+      ).toEqual({ x: 0, y: 5, w: 30, h: 15 });
+    });
+
+    it("tiny near-corner NE resize stays within bounds (Codex #15 reproduction)", () => {
+      // Pre-fix: dual-axis minSize floor would emit w=2, h=2 with
+      // re-anchor pushing x+w past 100. Post-fix: wFloor caps at
+      // min(2, maxW=1, maxH*baseAspect=1) = 1, so newW=1, newH=1.
+      const start: ImagePercentGeom = { x: 99, y: 99, w: 0.5, h: 0.5 };
+      const out = clampImagePercentGeometry(start, 1, -1, "ne", true);
+      expect(out).toEqual({ x: 99, y: 98.5, w: 1, h: 1 });
+      expect(out.x + out.w).toBeLessThanOrEqual(100);
+      expect(out.y + out.h).toBeLessThanOrEqual(100);
+    });
+
+    it("preserves baseAspect exactly when the floor is hit", () => {
+      // 2:1 aspect ratio (w=20, h=10); large negative drag past edges
+      // hits wFloor. newW/newH ratio must equal baseAspect.
+      const out = clampImagePercentGeometry(
+        baseGeom, -1000, -1000, "nw", true,
+      );
+      expect(out.w / out.h).toBeCloseTo(baseGeom.w / baseGeom.h, 10);
+    });
+  });
+
+  describe("corner resize — Shift unlock (independent edges)", () => {
+    it("SE without aspect lock degenerates to right + bottom edges", () => {
+      const corner = clampImagePercentGeometry(baseGeom, 1000, 1000, "se", false);
+      const sides = clampImagePercentGeometry(
+        clampImagePercentGeometry(baseGeom, 1000, 0, "right", false),
+        0, 1000, "bottom", false,
+      );
+      expect(corner).toEqual(sides);
+    });
+  });
+});

Front/client/src/components/slideCanvasDragMath.ts

@@ -0,0 +1,201 @@
+// IMP-54 u3 — pure drag math extracted from SlideCanvas.tsx
+// `handleZoneMouseDown` (`Front/client/src/components/SlideCanvas.tsx:537-598`).
+//
+// Resize math (`makeResizeHandler` at SlideCanvas.tsx:465-523) is intentionally
+// NOT touched — it has its own independent geometry model (per-side
+// `affectsLeft/Right/Top/Bottom`, `minSize`, `1 - startGeom.x/y` cap) that
+// must not regress.
+//
+// Two responsibilities live here:
+//
+//   1. Drag-vs-click classification — a pointer must travel more than
+//      `DRAG_THRESHOLD_PX` (Euclidean distance from the mousedown origin)
+//      before mousedown→mousemove is treated as a drag. Below the
+//      threshold the gesture stays a click, which the caller surfaces as
+//      `onZoneClick(zone.id)` in `onUp`.
+//
+//   2. Pixel-delta → slide-body fraction conversion plus clamp to keep the
+//      moved zone fully inside the slide body. Width/height are preserved
+//      verbatim by this helper — only `x` and `y` move.
+//
+// Both helpers are pure (no React, no DOM, no side effects) so vitest can
+// drive them directly. The numeric contract is the inline behavior that
+// existed before the extraction; this file is a relocation, not a behavior
+// change.
+
+export const DRAG_THRESHOLD_PX = 5;
+
+// IMP-51 (#79) u9 — image overlay resize / move math extracted from
+// SlideCanvas.tsx `beginDrag` onMove (lines 1092–1219 of the u8 patch).
+// Slide-absolute percent coordinate space (0–100 on both axes), matching
+// the persisted `image_overrides` axis (`src/user_overrides_io.py` u1
+// KNOWN_AXES) and the typed client `ImageOverride` shape (`userOverridesApi.ts`
+// u3). The math is the contract Codex #16 verified post-u8 — this file
+// is a relocation, not a behavior change. SlideCanvas calls it from a
+// single hook so future tweaks need to update one place + the vitest
+// suite alongside.
+export const IMAGE_RESIZE_MIN_SIZE_PERCENT = 2;
+
+/** Image overlay geometry in slide-absolute percent (each component ∈ [0, 100]).
+ *  Mirrors `ImageOverride` from `services/userOverridesApi.ts` (u3) so this
+ *  shape moves end-to-end through stamper → overlay → persisted axis. */
+export interface ImagePercentGeom {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+
+export type ImageDragDirection =
+  | "move"
+  | "left"
+  | "right"
+  | "top"
+  | "bottom"
+  | "nw"
+  | "ne"
+  | "sw"
+  | "se";
+
+/** Apply a percent-space drag delta to `startGeom` per `direction` and clamp.
+ *
+ *  Contract (must match the inline u8 math Codex #16 verified):
+ *    • `direction === "move"` → translate only; w/h preserved verbatim;
+ *      x/y clamped to `[0, 100 - w]` and `[0, 100 - h]`.
+ *    • Edge handle (`left|right|top|bottom`) → one axis only; opposite
+ *      edge pinned so x+w ≤ 100 and y+h ≤ 100 hold.
+ *    • Corner handle (`nw|ne|sw|se`) with `aspectLocked=false` → two
+ *      independent edges (same per-edge clamp as above).
+ *    • Corner handle with `aspectLocked=true` → preserves
+ *      `baseAspect = startGeom.w / startGeom.h`; the pinned-opposite-corner
+ *      stays fixed; the floored axis is `w` and `h` is re-derived so the
+ *      aspect ratio is exact even at the minSize floor.
+ *
+ *  `minSize` is best-effort: when the available span (e.g. `100 - startGeom.x`
+ *  for `affectsRight`) is below `minSize`, the floor caps at the span itself
+ *  so the slide-bound invariant (x+w ≤ 100 ∧ y+h ≤ 100) is never violated.
+ *  Pure / deterministic / no DOM access — vitest drives it directly. */
+export function clampImagePercentGeometry(
+  startGeom: ImagePercentGeom,
+  dxPercent: number,
+  dyPercent: number,
+  direction: ImageDragDirection,
+  aspectLocked: boolean,
+  minSize: number = IMAGE_RESIZE_MIN_SIZE_PERCENT,
+): ImagePercentGeom {
+  if (direction === "move") {
+    const x = Math.max(0, Math.min(100 - startGeom.w, startGeom.x + dxPercent));
+    const y = Math.max(0, Math.min(100 - startGeom.h, startGeom.y + dyPercent));
+    return { x, y, w: startGeom.w, h: startGeom.h };
+  }
+
+  const affectsLeft =
+    direction === "left" || direction === "nw" || direction === "sw";
+  const affectsRight =
+    direction === "right" || direction === "ne" || direction === "se";
+  const affectsTop =
+    direction === "top" || direction === "nw" || direction === "ne";
+  const affectsBottom =
+    direction === "bottom" || direction === "sw" || direction === "se";
+  const isCorner =
+    direction === "nw" ||
+    direction === "ne" ||
+    direction === "sw" ||
+    direction === "se";
+
+  const rightEdge = startGeom.x + startGeom.w;
+  const bottomEdge = startGeom.y + startGeom.h;
+  let x = startGeom.x;
+  let y = startGeom.y;
+  let w = startGeom.w;
+  let h = startGeom.h;
+
+  if (affectsRight) {
+    const maxW = 100 - startGeom.x;
+    const floor = Math.min(minSize, maxW);
+    w = Math.max(floor, Math.min(maxW, startGeom.w + dxPercent));
+  }
+  if (affectsBottom) {
+    const maxH = 100 - startGeom.y;
+    const floor = Math.min(minSize, maxH);
+    h = Math.max(floor, Math.min(maxH, startGeom.h + dyPercent));
+  }
+  if (affectsLeft) {
+    const floor = Math.min(minSize, rightEdge);
+    x = Math.max(0, Math.min(rightEdge - floor, startGeom.x + dxPercent));
+    w = rightEdge - x;
+  }
+  if (affectsTop) {
+    const floor = Math.min(minSize, bottomEdge);
+    y = Math.max(0, Math.min(bottomEdge - floor, startGeom.y + dyPercent));
+    h = bottomEdge - y;
+  }
+
+  if (isCorner && aspectLocked) {
+    const baseAspect =
+      startGeom.w > 0 && startGeom.h > 0 ? startGeom.w / startGeom.h : 1;
+    if (baseAspect > 0) {
+      const maxW = affectsLeft ? rightEdge : 100 - startGeom.x;
+      const maxH = affectsTop ? bottomEdge : 100 - startGeom.y;
+      let newW = w;
+      let newH = newW / baseAspect;
+      if (newH > maxH) {
+        newH = maxH;
+        newW = newH * baseAspect;
+      }
+      if (newW > maxW) {
+        newW = maxW;
+        newH = newW / baseAspect;
+      }
+      const wFloor = Math.min(minSize, maxW, maxH * baseAspect);
+      if (newW < wFloor) {
+        newW = wFloor;
+        newH = newW / baseAspect;
+      }
+      w = newW;
+      h = newH;
+      x = affectsLeft ? rightEdge - w : startGeom.x;
+      y = affectsTop ? bottomEdge - h : startGeom.y;
+    }
+  }
+
+  return { x, y, w, h };
+}
+
+/** Returns true once the pointer has travelled far enough from the mousedown
+ *  origin to be treated as a drag rather than a click. */
+export function crossedDragThreshold(dxPx: number, dyPx: number): boolean {
+  return Math.hypot(dxPx, dyPx) > DRAG_THRESHOLD_PX;
+}
+
+/** Zone geometry in slide-body fraction space (each component ∈ [0, 1]).
+ *  Mirrors the shape the SlideCanvas pipeline already uses for
+ *  `localGeom` / `overrideGeom` / `onZoneResize` payloads. */
+export interface ZoneFracGeom {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+
+/** Convert a pixel-space drag delta into a slide-body fraction delta, apply
+ *  it to `startGeom.{x, y}`, and clamp so the zone never escapes the slide
+ *  body (`x ∈ [0, 1 - w]`, `y ∈ [0, 1 - h]`). `w` and `h` are not modified.
+ *
+ *  The caller (`SlideCanvas.tsx` `handleZoneMouseDown` onMove) guarantees
+ *  `slideBodyWidthPx > 0` and `slideBodyHeightPx > 0` via the
+ *  `measuredSlideBody` precondition, so this helper does not re-guard
+ *  divide-by-zero. */
+export function clampZoneMove(
+  startGeom: ZoneFracGeom,
+  dxPx: number,
+  dyPx: number,
+  slideBodyWidthPx: number,
+  slideBodyHeightPx: number,
+): { x: number; y: number } {
+  const dx = dxPx / slideBodyWidthPx;
+  const dy = dyPx / slideBodyHeightPx;
+  const x = Math.max(0, Math.min(1 - startGeom.w, startGeom.x + dx));
+  const y = Math.max(0, Math.min(1 - startGeom.h, startGeom.y + dy));
+  return { x, y };
+}

Front/client/src/data/mockDesignAgentData.ts

@@ -0,0 +1,181 @@
+/**
+ * Design Agent - Mock Data
+ *
+ * 이 파일은 백엔드 파이프라인이 연결되기 전까지 사용하는 mock 데이터입니다.
+ * Phase Z 설계 규격을 따릅니다.
+ */
+
+import type {
+  NormalizedContent,
+  SlidePlan,
+  LayoutCandidate,
+  FrameCandidate,
+} from "../types/designAgent";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Layout Candidates
+// ─────────────────────────────────────────────────────────────────────────────
+
+// 8 preset = backend templates/phase_z2/layouts/layouts.yaml 1:1 매칭.
+// id / 순서 / 의미 모두 backend 와 동일해야 함.
+export const MOCK_LAYOUT_CANDIDATES: LayoutCandidate[] = [
+  { id: "single", name: "단일 본문", type: "full", description: "전체 영역 1 zone (primary)" },
+  { id: "horizontal-2", name: "상/하 2단", type: "top-bottom", description: "위/아래 2 zone (top, bottom) — rows topology" },
+  { id: "vertical-2", name: "좌/우 2단", type: "left-right", description: "좌/우 2 zone (left, right) — cols topology" },
+  { id: "top-1-bottom-2", name: "상 1 : 하 2", type: "asymmetric", description: "위 1 zone + 아래 좌/우 2 zone — T topology" },
+  { id: "top-2-bottom-1", name: "상 2 : 하 1", type: "asymmetric", description: "위 좌/우 2 zone + 아래 1 zone — inverted-T topology" },
+  { id: "left-1-right-2", name: "좌 1 : 우 2", type: "asymmetric", description: "좌 1 zone + 우 상/하 2 zone — side-T-left topology" },
+  { id: "left-2-right-1", name: "좌 2 : 우 1", type: "asymmetric", description: "좌 상/하 2 zone + 우 1 zone — side-T-right topology" },
+  { id: "grid-2x2", name: "2x2 그리드", type: "grid", description: "4 zone 균등 배치 — 2x2 topology" },
+];
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Frame Candidates (샘플 이미지 포함 - 8종 세트)
+// ─────────────────────────────────────────────────────────────────────────────
+
+const SAMPLE_FRAMES: FrameCandidate[] = [
+  {
+    id: "frame-001",
+    name: "3-Card 프로세스",
+    score: 0.98,
+    confidence: "high",
+    label: "use_as_is",
+    thumbnailUrl: "https://images.unsplash.com/photo-1614850523296-d8c1af93d400?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-002",
+    name: "비교 테이블 (Light)",
+    score: 0.85,
+    confidence: "medium",
+    label: "light_edit",
+    thumbnailUrl: "https://images.unsplash.com/photo-1508615039623-a25651266b91?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-003",
+    name: "계층형 트리",
+    score: 0.72,
+    confidence: "medium",
+    label: "restructure",
+    thumbnailUrl: "https://images.unsplash.com/photo-1551288049-bbda03a24d5d?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-004",
+    name: "4-Grid 핵심 요약",
+    score: 0.65,
+    confidence: "low",
+    label: "reject",
+    thumbnailUrl: "https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-005",
+    name: "타임라인 로드맵",
+    score: 0.91,
+    confidence: "high",
+    label: "use_as_is",
+    thumbnailUrl: "https://images.unsplash.com/photo-1531403009284-440f080d1e12?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-006",
+    name: "순환형 다이어그램",
+    score: 0.78,
+    confidence: "medium",
+    label: "light_edit",
+    thumbnailUrl: "https://images.unsplash.com/photo-1557804506-669a67965ba0?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-007",
+    name: "수치 강조 카드",
+    score: 0.88,
+    confidence: "high",
+    label: "use_as_is",
+    thumbnailUrl: "https://images.unsplash.com/photo-1551288049-bbda03a24d5d?w=300&h=200&fit=crop",
+  },
+  {
+    id: "frame-008",
+    name: "좌우 대비 분석",
+    score: 0.62,
+    confidence: "low",
+    label: "restructure",
+    thumbnailUrl: "https://images.unsplash.com/photo-1454165833767-02a6ed8a687a?w=300&h=200&fit=crop",
+  },
+];
+
+export const MOCK_FRAME_CANDIDATES_SECTION1 = SAMPLE_FRAMES;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Normalized Content
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const MOCK_NORMALIZED_CONTENT: NormalizedContent = {
+  title: "DX 실행 체계 구축 방안",
+  sections: [
+    {
+      id: "section-1",
+      index: 1,
+      level: 2,
+      title: "DX 실행 필수 요건",
+      content_objects: [
+        { id: "co-1", type: "text_block", role: "summary", raw_payload: "조직 전반의 DX 역량 강화 필요", size_estimate: { line_count: 2 } },
+        { id: "co-2", type: "text_block", role: "detail", raw_payload: "전담 조직 구성 및 KPI 설정", size_estimate: { line_count: 3 } }
+      ]
+    }
+  ]
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Slide Plan (Phase Z 구조)
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const MOCK_SLIDE_PLAN: SlidePlan = {
+  id: "slide-001",
+  title: "DX 실행 체계 구축 방안",
+  layout_preset: "horizontal-2",
+  zones: [
+    {
+      id: "zone-left",
+      zone_id: "left",
+      section_ids: ["section-1"],
+      position: { x: 0, y: 0, width: 0.5, height: 1 },
+      internal_regions: [
+        {
+          id: "region-l1",
+          region_id: "content-1",
+          role: "primary",
+          content_type: "mixed",
+          ratio_estimate: 1,
+          content_unit_ids: ["co-1", "co-2"],
+          frame_match_strategy: {
+            kind: "frame_match",
+            frame_id: "frame-001",
+            display_strategy: "inline_full"
+          },
+          frame_candidates: SAMPLE_FRAMES
+        }
+      ]
+    },
+    {
+      id: "zone-right",
+      zone_id: "right",
+      section_ids: ["section-1"],
+      position: { x: 0.5, y: 0, width: 0.5, height: 1 },
+      internal_regions: [
+        {
+          id: "region-r1",
+          region_id: "content-2",
+          role: "secondary",
+          content_type: "text_block",
+          ratio_estimate: 1,
+          content_unit_ids: [],
+          frame_match_strategy: {
+            kind: "frame_match",
+            frame_id: "frame-002",
+            display_strategy: "inline_full"
+          },
+          frame_candidates: SAMPLE_FRAMES
+        }
+      ]
+    }
+  ],
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString()
+};

Front/client/src/pages/Home.tsx

@@ -2,7 +2,7 @@
  * Home - 메인 페이지 (Zone-Centric 슬라이드 빌더)
  */
 
-import { useState, useCallback, useMemo, useEffect } from "react";
+import { useState, useCallback, useMemo, useEffect, useRef } from "react";
 import { toast } from "sonner";
 import type { DesignAgentState, LayoutPresetId, Zone } from "../types/designAgent";
 import {
@@ -15,22 +15,39 @@ import {
   getSelectedRegion,
   moveSectionToZone,
   saveZoneSizes,
+  saveImageOverride,
+  saveTextOverride,
+  saveStructureOverride,
+  deriveUserOverridesKey,
+  applyPersistedNonFrameOverrides,
+  mergeSubmittedPipelineOverridesForRestore,
+  remapPersistedFramesToZoneFrames,
+  validateZoneGeometriesAgainstLayout,
 } from "../utils/slidePlanUtils";
 import {
   parseMdxFile,
   runPipeline,
   loadRun,
   computeZonePositions,
+  formatAiRepairHumanReviewMessage,
   type RunMeta,
   type PipelineOverrides,
 } from "../services/designAgentApi";
+import {
+  flushUserOverrides,
+  getUserOverrides,
+  saveUserOverrides,
+  type UserOverrides,
+} from "../services/userOverridesApi";
 
 import LeftMdxPanel from "../components/LeftMdxPanel";
 import SlideCanvas from "../components/SlideCanvas";
 import LayoutPanel from "../components/LayoutPanel";
 import FramePanel from "../components/FramePanel";
+import PipelineTracePanel from "../components/PipelineTracePanel";
+import BottomActions from "../components/BottomActions";
 import {
-  Sparkles, Download, Link2, Loader2,
+  Sparkles, Loader2,
   CheckCircle2, HelpCircle,
 } from "lucide-react";
 import { Button } from "@/components/ui/button";
@@ -45,7 +62,7 @@ const INITIAL_STATE: DesignAgentState = {
   error: null,
 };
 
-type RightPanelTab = "layout" | "frame";
+type RightPanelTab = "layout" | "frame" | "trace";
 
 export default function Home() {
   const [state, setState] = useState<DesignAgentState>(INITIAL_STATE);
@@ -62,6 +79,14 @@ export default function Home() {
   // section drag drop + frame 선택). null 이면 평소 모드 (final.html 표시).
   const [pendingLayout, setPendingLayout] = useState<LayoutPresetId | null>(null);
 
+  // IMP-52 u6 — restore-on-reopen: persisted user_overrides.json fetched at
+  // handleFileUpload time. layout / zone_geometries / zone_sections are
+  // seeded into userSelection immediately (so handleGenerate forwards them
+  // as CLI args). frames are stashed here because their on-disk key
+  // (unit_id = section_ids joined by "+") only maps to region.id after
+  // loadRun rebuilds the slidePlan — see handleGenerate post-loadRun.
+  const persistedOverridesRef = useRef<Partial<UserOverrides>>({});
+
   // pendingLayout 활성 시 effective slidePlan = pendingZones 가 swap 된 plan.
   // 그 외 = default state.slidePlan. 모든 zone / region lookup (handleFrameSelect /
   // getSelectedZone / SlideCanvas) 이 일관되게 이 effectiveSlidePlan 사용.
@@ -135,6 +160,31 @@ export default function Home() {
         }
         carriedZoneSections[targetPos].push(...zone.section_ids);
       });
+      // IMP-44 (#73) u4 — clear in-memory zone_geometries on layout flip.
+      // The persisted keys were valid for the *prior* preset; carrying them
+      // forward into the new preset would either trip the u1/u2 backend
+      // [override-warning] guards (foreign keys dropped, override_applied
+      // forced back to None) or partially apply on shared keys. Drop them
+      // up-front so the new layout starts from a clean even-split baseline,
+      // and persist a clear sentinel (null) so a subsequent reopen does not
+      // resurrect the stale snapshot from user_overrides.json.
+      const priorGeoms = p.userSelection.overrides.zone_geometries;
+      const hadPriorGeoms =
+        priorGeoms && typeof priorGeoms === "object" && Object.keys(priorGeoms).length > 0;
+      if (p.uploadedFile && hadPriorGeoms) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { zone_geometries: null });
+      }
+      // IMP-55 (#93) u12 — persist the marker reset to disk so a stale
+      // `manual_section_assignment: true` from a prior drag (written via
+      // u6's co-PUT) cannot survive the layout apply. The in-memory reset
+      // on line 192 protects the current session, but a page reload would
+      // re-seed from disk via u3's restore branch and re-arm the u7 gate.
+      // Unconditional — apply always resets, independent of hadPriorGeoms.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { manual_section_assignment: false });
+      }
       return {
         ...p,
         userSelection: {
@@ -143,6 +193,18 @@ export default function Home() {
             ...p.userSelection.overrides,
             layout_preset: layoutId,
             zone_sections: carriedZoneSections,
+            zone_geometries: {},
+            // IMP-55 (#93) u5 — reset the bool intent marker to `false` on
+            // layout apply. `carriedZoneSections` above is auto-carry (old
+            // zone.section_ids → new layout positions), NOT user drag-drop
+            // intent. Without this explicit reset the spread of
+            // `...p.userSelection.overrides` would carry a prior-drag `true`
+            // into the new layout, causing handleGenerate (u7) to forward
+            // auto-carried assignments as user overrides and re-trigger the
+            // PARTIAL_COVERAGE regression. The marker flips back to `true`
+            // only when the user actually drag-drops a section in the new
+            // layout (u6 handleSectionDrop).
+            manual_section_assignment: false,
           },
           selectedZoneId: null,
           selectedRegionId: null,
@@ -157,10 +219,27 @@ export default function Home() {
   // pending 모드 취소 → 평소 (final.html iframe) 모드 복귀.
   const handleCancelPendingLayout = useCallback(() => {
     setPendingLayout(null);
-    setState((p) => ({
+    setState((p) => {
-      ...p,
+      // IMP-55 (#93) u12 — persist marker=false to disk on cancel. In-memory
-      userSelection: createInitialUserSelection(p.slidePlan),
+      // the u3 seed via createInitialUserSelection already pins false (u5
-    }));
+      // contract), but if a prior drag-drop wrote `true` to disk via u6's
+      // co-PUT, that value would survive a reopen and re-arm the u7
+      // forwarding gate on the next page load. Symmetric with the apply
+      // path's disk PUT above.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { manual_section_assignment: false });
+      }
+      return {
+        ...p,
+        // IMP-55 (#93) u5 — cancel discards all pending overrides via
+        // `createInitialUserSelection`, whose u3 seed pins
+        // `manual_section_assignment: false`. In-memory reset is implicit
+        // via the seed; u12 adds the disk-side PUT above to keep persisted
+        // state consistent so a reopen does not re-arm the marker.
+        userSelection: createInitialUserSelection(p.slidePlan),
+      };
+    });
     setHasPendingChanges(false);
   }, []);
 
@@ -179,7 +258,22 @@ export default function Home() {
 
     try {
       const content = await parseMdxFile(file);
-      setState((p) => ({ ...p, normalizedContent: content, isLoading: false }));
+      // IMP-52 u6 — restore-on-reopen. Key = MDX stem (matches backend
+      // u2 fallback's Path(args.mdx_path).stem). getUserOverrides returns
+      // {} on miss / corrupt / network failure (u5 contract) so the upload
+      // path never fails on a fresh MDX.
+      const overridesKey = deriveUserOverridesKey(file.name);
+      const persisted = await getUserOverrides(overridesKey);
+      persistedOverridesRef.current = persisted;
+      setState((p) => ({
+        ...p,
+        normalizedContent: content,
+        // #98 Task 1 — selecting/uploading a MDX starts from a clean analysis
+        // state. Persisted overrides stay cached for explicit edit/regenerate
+        // paths, but they must not pre-seed the first "Generate" run.
+        userSelection: createInitialUserSelection(),
+        isLoading: false,
+      }));
       toast.success(`"${file.name}" 분석 완료 — 하단 버튼으로 슬라이드 생성하세요.`);
     } catch (err) {
       console.error(err);
@@ -190,27 +284,11 @@ export default function Home() {
     }
   }, []);
 
-  // 2026-05-14 — 좌측 패널의 03/04/05 fix list 클릭 또는 URL `?mdx=04` 변경 시
+  // 2026-05-14 — 좌측 패널의 01~05 fix list 클릭 또는 URL `?mdx=04` 변경 시
   // 호출되는 단일 callback. handleFileUpload 가 자동 분석 trigger.
-  const [selectedSample, setSelectedSample] = useState<"03" | "04" | "05" | null>(null);
+  const [selectedSample, setSelectedSample] = useState<"01" | "02" | "03" | "04" | "05" | null>(null);
 
-  // 2026-05-14 — mdx 별 slide-level CSS override (catalog/template 무변, frontend layer only).
+  const handleSelectSample = useCallback(async (which: "01" | "02" | "03" | "04" | "05") => {
-  // SlideCanvas 의 iframe onLoad 에서 동적 inject. 사용자 룰 : "보고용 슬라이드 결과물 단위"
-  // 변경. mdx04 의 default (rank 1 = process_product_two_way) 일 때만 적용 — 사용자 frame
-  // override 후 (rank 2 = bim_dx_comparison_table 등) 다른 frame 시 무적용.
-  const MDX04_DEFAULT_OVERRIDE_CSS = `
-    .slide-body {
-      grid-template-rows: 0.38fr 0.60fr !important;
-      gap: 1.5% !important;
-    }
-    .f29b__cell .text-line + .text-line { margin-top: 1px !important; }
-    .f29b__cell:nth-child(n+3) {
-      padding-top: 3px !important;
-      margin-top: 2px !important;
-    }
-  `.trim();
-
-  const handleSelectSample = useCallback(async (which: "03" | "04" | "05") => {
     try {
       const res = await fetch(`/api/sample-mdx?mdx=${encodeURIComponent(which)}`);
       if (!res.ok) return;
@@ -231,11 +309,11 @@ export default function Home() {
   }, []);
 
   // 페이지 첫 로드 시 데모용 mdx 자동 로드 — 상대방에게 mdx 파일 공유 안 해도 되게.
-  // URL query `?mdx=04` / `?mdx=05` 로 다른 sample 선택 가능. default = 03.
+  // URL query `?mdx=01`~`?mdx=05` 로 다른 sample 선택 가능. default = 03.
   // 사용자가 다른 파일을 직접 업로드하면 그것이 override 됨.
   useEffect(() => {
-    const which = (new URLSearchParams(window.location.search).get("mdx") as "03" | "04" | "05" | null) || "03";
+    const which = (new URLSearchParams(window.location.search).get("mdx") as "01" | "02" | "03" | "04" | "05" | null) || "03";
-    if (!["03", "04", "05"].includes(which)) return;
+    if (!["01", "02", "03", "04", "05"].includes(which)) return;
     handleSelectSample(which);
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
@@ -253,12 +331,15 @@ export default function Home() {
     // - layout : userSelection.overrides.layout_preset (default 와 다를 때만)
     // - frames : zone.section_ids → unit_id ("+".join). region.id 별 zone_frames lookup.
     //   pendingZones 의 region 도 동일 — 그 region 의 zone 의 sections 가 unit_id 결정.
+    const shouldUseUserOverrides = hasPendingChanges;
     const overrides: PipelineOverrides = {};
     const sourcePlan = effectiveSlidePlan;
-    if (sourcePlan && state.slidePlan) {
+    if (shouldUseUserOverrides && sourcePlan && state.slidePlan) {
-      const defaultLayout = state.slidePlan.layout_preset;
+      // 2026-05-22 demo hot-fix — 이전 비교 가드 (default !== override) 제거.
+      // restore loop 이 default = override 로 sync 시 override 안 보내고 backend
+      // default fallback 발생. user 가 명시한 layout 이 있으면 무조건 보냄.
       const overrideLayout = state.userSelection.overrides.layout_preset;
-      if (overrideLayout && overrideLayout !== defaultLayout) {
+      if (overrideLayout) {
         overrides.layout = overrideLayout;
       }
       const frames: Record<string, string> = {};
@@ -296,41 +377,78 @@ export default function Home() {
 
       // zone-geometry override — backend 의 build_layout_css 에 전달 (horizontal-2 /
       // vertical-2 만 적용). zone_id (top/bottom/...) → slide-body 내부 0~1 비율.
+      // IMP-44 (#73) u4 — validate against the active layout *before* the
+      // round-trip so foreign-preset keys never reach the backend. Mirrors
+      // the u1/u2 WARN+DROP guards on the frontend side: dropped keys surface
+      // as a toast (so the user knows why their resize "vanished"), and only
+      // the `kept` subset is forwarded. The active layout = the layout the
+      // backend will use, which is `overrides.layout` when the user has set
+      // one, else the default slidePlan preset (mirrors backend resolution).
       const zoneGeometries = state.userSelection.overrides.zone_geometries;
       if (zoneGeometries && Object.keys(zoneGeometries).length > 0) {
-        overrides.zoneGeometries = zoneGeometries;
+        const activeLayout = overrides.layout ?? sourcePlan.layout_preset;
+        const validation = validateZoneGeometriesAgainstLayout(
+          zoneGeometries,
+          activeLayout,
+        );
+        if (Object.keys(validation.dropped).length > 0) {
+          toast.error(
+            `zone_geometries layout-mismatch: dropped ${Object.keys(validation.dropped).join(", ")} (expected ${validation.expectedPositions.join(", ") || "—"}; layout=${activeLayout}).`,
+          );
+        }
+        if (Object.keys(validation.kept).length > 0) {
+          overrides.zoneGeometries = validation.kept;
+        }
       }
 
-      // IMP-08 B-3 : zoneSections forward only when the user diverged from
+      // IMP-55 (#93) u7 — Replace the IMP-08 B-3 self-compare with the bool
-      // the auto plan. Codex Stage 3 R3 B3 fix : `createInitialUserSelection`
+      // `manual_section_assignment` intent marker gate. The prior code built
-      // seeds `zone_sections` with the default placement, so a literal copy
+      // `defaultByZone` from `sourcePlan.zones` and compared against the
-      // would pollute backend assignment-source provenance even on a fresh
+      // user's `overrides.zone_sections`, but `sourcePlan === effectiveSlidePlan`
-      // re-render. Diff against `sourcePlan.zones[].section_ids` per zone and
+      // (Home.tsx:305) and `effectiveSlidePlan.zones === pendingZones`
-      // only emit zones whose section list differs.
+      // (Home.tsx:649), which is itself derived from
-      const userZoneSections = state.userSelection.overrides.zone_sections;
+      // `state.userSelection.overrides.zone_sections` via slidePlanUtils.ts.
-      if (userZoneSections) {
+      // The comparison was degenerate (user input vs itself), so real drag-drop
-        const defaultByZone = new Map<string, string[]>();
+      // swaps were classified `sameAsDefault` and silently dropped from
-        sourcePlan.zones.forEach((z) => {
+      // `overrides.zoneSections` — the exact regression IMP-55 fixes.
-          defaultByZone.set(z.zone_id, z.section_ids);
+      //   - true  → forward `zone_sections` filtered to zone_ids that exist in
-        });
+      //     `sourcePlan.zones` (cross-layout safety so foreign zone keys from a
-        const zoneSectionsDiff: Record<string, string[]> = {};
+      //     stale persisted layout never reach backend `--override-section-
-        for (const [zoneId, sids] of Object.entries(userZoneSections)) {
+      //     assignment`). u6 is the SOLE setter of true (real drag-drop).
-          if (!Array.isArray(sids)) continue;
+      //   - false → skip. Backend determines assignment from its own default
-          const cleaned = sids.filter((s) => typeof s === "string" && s.trim());
+      //     policy. u3 seeds false on first load, u5 resets false on layout
-          const defaults = defaultByZone.get(zoneId) ?? [];
+      //     apply auto-carry, u12 persists false so a stale disk `true` cannot
-          const sameAsDefault =
+      //     survive a reopen-after-apply window.
-            cleaned.length === defaults.length &&
+      // No `sameAsDefault` heuristic — the marker is the source of intent.
-            cleaned.every((sid, i) => sid === defaults[i]);
+      const manualMarker =
-          if (!sameAsDefault) {
+        state.userSelection.overrides.manual_section_assignment;
-            zoneSectionsDiff[zoneId] = cleaned;
+      if (manualMarker === true) {
+        const userZoneSections = state.userSelection.overrides.zone_sections;
+        if (userZoneSections) {
+          const validZoneIds = new Set(
+            sourcePlan.zones.map((z) => z.zone_id),
+          );
+          const zoneSectionsForward: Record<string, string[]> = {};
+          for (const [zoneId, sids] of Object.entries(userZoneSections)) {
+            if (!validZoneIds.has(zoneId)) continue;
+            if (!Array.isArray(sids)) continue;
+            const cleaned = sids.filter(
+              (s) => typeof s === "string" && s.trim(),
+            );
+            zoneSectionsForward[zoneId] = cleaned;
+          }
+          if (Object.keys(zoneSectionsForward).length > 0) {
+            overrides.zoneSections = zoneSectionsForward;
           }
-        }
-        if (Object.keys(zoneSectionsDiff).length > 0) {
-          overrides.zoneSections = zoneSectionsDiff;
         }
       }
     }
 
+    // #98 Task 4 — stale render guard. Once a new generate/regenerate starts,
+    // the previous final.html must no longer be treated as the current result.
+    // If the backend run later fails, keeping the old runMeta would resurrect
+    // the old iframe and make it look as if the new selection rendered.
+    setRunMeta(null);
     setState((p) => ({ ...p, isLoading: true }));
     setHasPendingChanges(false);  // 재생성 트리거 시 override pending flag reset
     setPendingLayout(null);       // pending layout 모드 종료
@@ -348,7 +466,36 @@ export default function Home() {
     toast.info(`Phase Z 파이프라인 실행 중... ${overrideSummary}`);
 
     try {
-      const result = await runPipeline(state.uploadedFile, overrides);
+      // IMP-52 u10 — Force-commit any pending debounced PUTs before backend
+      // reads user_overrides.json on pipeline entry. Without this, a user
+      // who changes an override (300ms debounce window) and immediately
+      // clicks Generate would race the PUT against /api/run; the u2
+      // fallback could then load a stale persisted document.
+      await flushUserOverrides();
+      const restoreOverrides = shouldUseUserOverrides
+        ? mergeSubmittedPipelineOverridesForRestore(
+            await getUserOverrides(deriveUserOverridesKey(state.uploadedFile.name)),
+            overrides,
+            state.userSelection.overrides.manual_section_assignment,
+          )
+        : {};
+      if (shouldUseUserOverrides) {
+        persistedOverridesRef.current = restoreOverrides;
+      }
+      // IMP-42 u4 — unconditional DIAG console.log on the handleGenerate
+      // entry-to-backend boundary. Surfaces the override payload + uploaded
+      // file name so the user can see exactly what crossed the wire when
+      // the pipeline fails silently. No env gate (silence is the bug).
+      console.log("[DIAG raw overrides]", {
+        file: state.uploadedFile.name,
+        overrides,
+      });
+      const result = await runPipeline(
+        state.uploadedFile,
+        shouldUseUserOverrides ? overrides : undefined,
+        undefined,
+        { ignoreUserOverrides: !shouldUseUserOverrides },
+      );
 
       if (!result.success || !result.final_html_exists) {
         const detail =
@@ -361,15 +508,51 @@ export default function Home() {
       }
 
       const { normalizedContent, slidePlan, runMeta } = await loadRun(result.run_id);
-      setState((p) => ({
+      // IMP-52 u6 — post-loadRun frame remap. persistedOverridesRef holds
-        ...p,
+      // the user_overrides.json read at handleFileUpload time. Frames there
-        normalizedContent,
+      // are keyed by unit_id (section_ids joined by "+"); the in-memory
-        slidePlan,
+      // zone_frames is keyed by region.id. Remap against the new slidePlan
-        userSelection: createInitialUserSelection(slidePlan),
+      // zones so SlideCanvas's override-vs-default preview indicator shows
-        isLoading: false,
+      // the user's persisted choice without forcing them to re-click.
-      }));
+      const restoredZoneFrames = shouldUseUserOverrides
+        ? remapPersistedFramesToZoneFrames(
+            slidePlan,
+            restoreOverrides.frames as Record<string, string> | undefined,
+          )
+        : {};
+      setState((p) => {
+        // IMP-52 u6 — restore-on-reopen: re-layer the persisted non-frame
+        // axes (layout / zone_geometries / zone_sections) onto the post-load
+        // `base`. `createInitialUserSelection` rebuilds from slidePlan and
+        // drops anything the backend fallback could not round-trip through
+        // a CLI arg — `zone_geometries` in particular has no slidePlan
+        // representation, so without this merge the user would see their
+        // resized zones revert on every Generate.
+        const cleanBase = createInitialUserSelection(slidePlan);
+        const base = shouldUseUserOverrides
+          ? applyPersistedNonFrameOverrides(cleanBase, restoreOverrides)
+          : cleanBase;
+        return {
+          ...p,
+          normalizedContent,
+          slidePlan,
+          userSelection: {
+            ...base,
+            overrides: {
+              ...base.overrides,
+              zone_frames: { ...base.overrides.zone_frames, ...restoredZoneFrames },
+            },
+          },
+          isLoading: false,
+        };
+      });
       setRunMeta(runMeta);
+      if (runMeta.status !== "PASS" || (runMeta.pipeline_trace?.warnings.length ?? 0) > 0) {
+        setRightTab("trace");
+      }
       toast.success(`run "${result.run_id}" 완료 — ${runMeta.status}`);
+      const aiReviewMsg = formatAiRepairHumanReviewMessage(runMeta.ai_repair_status);
+      if (aiReviewMsg) toast.error(aiReviewMsg);
     } catch (err) {
       console.error(err);
       toast.error(
@@ -377,16 +560,46 @@ export default function Home() {
       );
       setState((p) => ({ ...p, isLoading: false }));
     }
-  }, [state.uploadedFile]);
+  }, [state.uploadedFile, state.slidePlan, state.userSelection, pendingZones, pendingLayout, hasPendingChanges]);
 
   // ── 섹션 드래그 앤 드롭 (Zone으로 재배치) ──
   const handleSectionDrop = useCallback((sectionId: string, zoneId: string) => {
     setState((p) => {
       const newSelection = moveSectionToZone(p.userSelection, sectionId, zoneId);
-      return {
+      const zoneSelected = selectZone(newSelection, zoneId); // 이동된 존 자동 선택
-        ...p,
+      // IMP-55 (#93) u6 — flip the bool intent marker to `true` on real
-        userSelection: selectZone(newSelection, zoneId) // 이동된 존 자동 선택
+      // user drag-drop. Inverse of the u5 reset (layout apply/cancel
+      // auto-carry → false). handleGenerate (u7) gates `overrides.zoneSections`
+      // forwarding on this marker, so an unflipped drop would never reach
+      // the backend (the IMP-55 self-compare regression). The marker is
+      // flipped BEFORE persistence so the in-memory selection and the
+      // co-PUT body stay in sync atomically.
+      const finalSelection = {
+        ...zoneSelected,
+        overrides: {
+          ...zoneSelected.overrides,
+          manual_section_assignment: true,
+        },
       };
+      // IMP-52 u7 — persist the post-drop zone_sections snapshot. The on-disk
+      // schema axis (`zone_sections`) shares the in-memory shape (zone_id →
+      // section_ids), so we forward the full mutated value; the u4 PUT path
+      // replaces this axis atomically while preserving the foreign axes.
+      // p.uploadedFile gate skips persistence before any MDX is loaded —
+      // the demo-mode initial render path would otherwise PUT to the empty
+      // key. saveUserOverrides is debounced (300ms) and per-key coalesced.
+      // IMP-55 (#93) u6 — co-PUT `manual_section_assignment: true` in the
+      // SAME body so the disk file never has the post-drop zone_sections
+      // without the marker (would otherwise look like an unmotivated
+      // IMP-52 zone_sections write to the u9 backend fallback).
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, {
+          zone_sections: finalSelection.overrides.zone_sections,
+          manual_section_assignment: true,
+        });
+      }
+      return { ...p, userSelection: finalSelection };
     });
     setRightTab("frame");
     setHasPendingChanges(true);
@@ -412,10 +625,18 @@ export default function Home() {
 
   // ── Layout 선택 ──
   const handleLayoutSelect = useCallback((layoutId: string) => {
-    setState((p) => ({
+    setState((p) => {
-      ...p,
+      const newSelection = applyLayout(p.userSelection, layoutId as LayoutPresetId);
-      userSelection: applyLayout(p.userSelection, layoutId as LayoutPresetId)
+      // IMP-52 u7 — persist the selected layout preset id. The on-disk
-    }));
+      // `layout` axis is a single string; `applyLayout` validates the
+      // preset id before mutating the selection, so the value here is
+      // already the LayoutPresetId we want to round-trip.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { layout: layoutId });
+      }
+      return { ...p, userSelection: newSelection };
+    });
     setHasPendingChanges(true);
   }, []);
 
@@ -428,22 +649,64 @@ export default function Home() {
   }, []);
 
   const handleZoneResize = useCallback((geometries: Record<string, { x: number; y: number; w: number; h: number }>) => {
-    setState((p) => ({
+    setState((p) => {
-      ...p,
+      const mergedGeometries = {
-      userSelection: {
+        ...p.userSelection.overrides.zone_geometries,
-        ...p.userSelection,
+        ...geometries,
-        overrides: {
+      };
-          ...p.userSelection.overrides,
+      // IMP-52 u7 — persist the merged zone_geometries snapshot. Resize
-          zone_geometries: {
+      // gestures fire repeatedly during a drag; the 300ms u5 debounce
-            ...p.userSelection.overrides.zone_geometries,
+      // collapses them into a single PUT at gesture-end, so we don't
-            ...geometries
+      // need to gate on resize-finished here.
-          }
+      if (p.uploadedFile) {
-        }
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { zone_geometries: mergedGeometries });
       }
-    }));
+      return {
+        ...p,
+        userSelection: {
+          ...p.userSelection,
+          overrides: {
+            ...p.userSelection.overrides,
+            zone_geometries: mergedGeometries,
+          },
+        },
+      };
+    });
     setHasPendingChanges(true);
   }, []);
 
+  // IMP-51 (#79) u10 — wire SlideCanvas's user-content image drag/resize
+  // emit into the 5th persisted axis. Mirrors handleZoneResize exactly:
+  //   • merge the single (imageId → {x,y,w,h}) tick onto the prior
+  //     in-memory `image_overrides` map via the u11 `saveImageOverride`
+  //     helper so the immutable update path is shared with the test suite,
+  //   • forward the full merged snapshot through `saveUserOverrides`
+  //     (the u3 typed client) under the `image_overrides` key — the 300ms
+  //     debounce defined alongside `zone_geometries` collapses the
+  //     per-mousemove emits into one PUT at gesture-end,
+  //   • flip `hasPendingChanges` so the "선택대로 재생성하기" CTA appears.
+  // Coordinates are slide-absolute percent (0–100) from u8/u9 — passed
+  // through unchanged so the on-disk schema matches the SlideCanvas
+  // overlay, the stamper selector (u4), and the render-time CSS
+  // injector (u7) without any per-zone transform.
+  const handleImageResize = useCallback(
+    (imageId: string, geometry: { x: number; y: number; w: number; h: number }) => {
+      setState((p) => {
+        const nextSelection = saveImageOverride(p.userSelection, imageId, geometry);
+        if (p.uploadedFile) {
+          const key = deriveUserOverridesKey(p.uploadedFile.name);
+          void saveUserOverrides(key, {
+            image_overrides: nextSelection.overrides.image_overrides,
+          });
+        }
+        return { ...p, userSelection: nextSelection };
+      });
+      setHasPendingChanges(true);
+    },
+    [],
+  );
+
   // 편집 모드 텍스트 변경 시 hasPendingChanges 활성. useCallback 으로 reference 안정화 —
   // SlideCanvas 의 useEffect 가 매번 rerun 안 하도록 (resize drag 매 mousemove 마다
   // re-render 시 useEffect retrigger → iframe contentEditable 재설정 = 매우 느림).
@@ -451,6 +714,51 @@ export default function Home() {
     setHasPendingChanges(true);
   }, []);
 
+  // IMP-56 (#90) u15 — wire SlideCanvas u13 focusout capture into the new
+  // `text_overrides` persist axis. Mirrors handleImageResize: merge the
+  // (zoneId, textPath, value) tick via `saveTextOverride` (u15 pure helper)
+  // and schedule the 300ms-debounced PUT under the `text_overrides` axis.
+  // Per-axis coalescing in `saveUserOverrides` collapses rapid edits in
+  // the same line into a single PUT; per-key buckets isolate cross-MDX.
+  const handleTextEdit = useCallback(
+    (capture: { zoneId: string; textPath: string; value: string }) => {
+      setState((p) => {
+        const nextSelection = saveTextOverride(
+          p.userSelection, capture.zoneId, capture.textPath, capture.value,
+        );
+        if (p.uploadedFile) {
+          const key = deriveUserOverridesKey(p.uploadedFile.name);
+          void saveUserOverrides(key, {
+            text_overrides: nextSelection.overrides.text_overrides,
+          });
+        }
+        return { ...p, userSelection: nextSelection };
+      });
+      setHasPendingChanges(true);
+    },
+    [],
+  );
+
+  // IMP-56 (#90) u15 — wire SlideCanvas u14 structure overlay capture into
+  // the `structure_overrides` axis. Scope-locked to {slot_order,
+  // hidden_slots} — frame swap stays on the existing `frames` axis.
+  const handleStructureEdit = useCallback(
+    (zoneId: string, perZone: { slot_order?: string[]; hidden_slots?: string[] }) => {
+      setState((p) => {
+        const nextSelection = saveStructureOverride(p.userSelection, zoneId, perZone);
+        if (p.uploadedFile) {
+          const key = deriveUserOverridesKey(p.uploadedFile.name);
+          void saveUserOverrides(key, {
+            structure_overrides: nextSelection.overrides.structure_overrides,
+          });
+        }
+        return { ...p, userSelection: nextSelection };
+      });
+      setHasPendingChanges(true);
+    },
+    [],
+  );
+
   // pending mode 일 때 effectiveSlidePlan = pendingZones 가 swap 된 plan.
   // 그 외 = state.slidePlan. 모든 zone / region lookup 이 일관되게 이걸 사용 →
   // pending mode 의 region.id ("pending-region-N") 가 zone_frames key 로 들어가
@@ -462,17 +770,6 @@ export default function Home() {
     return state.slidePlan;
   }, [pendingZones, state.slidePlan, pendingLayout]);
 
-  // 2026-05-14 — slide-level CSS override 계산. mdx04 default (rank 1 = process_product_two_way)
-  // 일 때만 적용 (catalog 무변, slide 결과물에만 inject). 사용자 frame override 후 다른
-  // frame 시 무적용 (rank 2 의 frame visual 유지).
-  const slideOverrideCss = useMemo<string | undefined>(() => {
-    if (selectedSample !== "04") return undefined;
-    const zone04_2 = state.slidePlan?.zones.find((z) => z.zone_id === "bottom");
-    const frameId = zone04_2?.internal_regions[0]?.frame_match_strategy.frame_id;
-    if (frameId !== "process_product_two_way") return undefined;
-    return MDX04_DEFAULT_OVERRIDE_CSS;
-  }, [selectedSample, state.slidePlan]);
-
   // ── Frame 선택 ──
   const handleFrameSelect = useCallback((frameId: string) => {
     const zone = getSelectedZone(effectiveSlidePlan, state.userSelection);
@@ -483,10 +780,40 @@ export default function Home() {
       return;
     }
 
-    setState((p) => ({
+    setState((p) => {
-      ...p,
+      const newSelection = applyFrame(p.userSelection, region.id, frameId);
-      userSelection: applyFrame(p.userSelection, region.id, frameId)
+      // IMP-52 u7 — persist frames keyed by `unit_id`. The on-disk schema
-    }));
+      // uses `unit_id = zone.section_ids.join("+")` (the same convention
+      // handleGenerate uses when forwarding `overrides.frames` to the
+      // backend CLI). `zone_frames` is keyed by region.id, so we walk
+      // the effectiveSlidePlan zones to translate. Only true user
+      // overrides are persisted — `createInitialUserSelection` pre-fills
+      // `zone_frames[region.id]` with `region.frame_match_strategy.frame_id`
+      // (backend default) for every region, so we mirror handleGenerate's
+      // `overrideFrameId !== defaultFrameId` gate to avoid leaking defaults
+      // into user_overrides.json. Zones with no sections are skipped.
+      if (p.uploadedFile && effectiveSlidePlan) {
+        const framesByUnitId: Record<string, string> = {};
+        for (const z of effectiveSlidePlan.zones) {
+          const r = z.internal_regions[0];
+          if (!r) continue;
+          if (!Array.isArray(z.section_ids) || z.section_ids.length === 0) continue;
+          const unitId = z.section_ids.join("+");
+          const overrideId = newSelection.overrides.zone_frames?.[r.id];
+          const defaultFrameId = r.frame_match_strategy.frame_id;
+          if (
+            typeof overrideId === "string" &&
+            overrideId.length > 0 &&
+            overrideId !== defaultFrameId
+          ) {
+            framesByUnitId[unitId] = overrideId;
+          }
+        }
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { frames: framesByUnitId });
+      }
+      return { ...p, userSelection: newSelection };
+    });
     setHasPendingChanges(true);
   }, [effectiveSlidePlan, state.userSelection]);
 
@@ -527,6 +854,41 @@ export default function Home() {
               >
                 {runMeta.status}
               </span>
+              {runMeta.filtered_section_ids.length > 0 && (
+                <details className="relative">
+                  <summary className="text-[10px] font-bold px-1.5 py-0.5 bg-amber-100 text-amber-700 rounded uppercase tracking-wider cursor-pointer list-none">
+                    Filtered: {runMeta.filtered_section_ids.length}
+                  </summary>
+                  <div className="absolute top-full mt-1 left-0 z-50 bg-white border border-slate-200 rounded shadow-lg p-3 w-96 max-h-96 overflow-y-auto">
+                    {runMeta.filtered_section_reasons.map((r, i) => (
+                      <div key={i} className="mb-2 pb-2 border-b border-slate-100 last:border-0 last:mb-0 last:pb-0 text-[11px]">
+                        <div className="font-mono text-slate-700">{r.section_ids.join(", ")}</div>
+                        <div className="text-slate-500">selection_state: <span className="font-mono">{r.selection_state}</span></div>
+                        {r.merge_type && <div className="text-slate-500">merge_type: <span className="font-mono">{r.merge_type}</span></div>}
+                        {r.template_id && <div className="text-slate-500">template_id: <span className="font-mono">{r.template_id}</span></div>}
+                        {r.v4_label && <div className="text-slate-500">v4_label: <span className="font-mono">{r.v4_label}</span></div>}
+                        {r.phase_z_status && <div className="text-slate-500">phase_z_status: <span className="font-mono">{r.phase_z_status}</span></div>}
+                        {r.score !== null && <div className="text-slate-500">score: <span className="font-mono">{r.score}</span></div>}
+                        {r.source && <div className="text-slate-500">source: <span className="font-mono">{r.source}</span></div>}
+                        {r.position && <div className="text-slate-500">position: <span className="font-mono">{r.position}</span></div>}
+                        <ul className="mt-1 list-disc list-inside text-slate-600">
+                          {r.filter_reasons.map((reason, j) => <li key={j} className="font-mono">{reason}</li>)}
+                        </ul>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+              )}
+              {(runMeta.pipeline_trace?.warnings.length ?? 0) > 0 && (
+                <button
+                  type="button"
+                  className="text-[10px] font-bold px-1.5 py-0.5 bg-red-100 text-red-700 rounded uppercase tracking-wider"
+                  onClick={() => setRightTab("trace")}
+                  title={runMeta.pipeline_trace?.warnings.join(" / ")}
+                >
+                  Trace: {runMeta.pipeline_trace?.warnings.length}
+                </button>
+              )}
             </>
           )}
         </div>
@@ -577,8 +939,7 @@ export default function Home() {
             slidePlan={effectiveSlidePlan}
             normalizedContent={state.normalizedContent}
             userSelection={state.userSelection}
-            finalHtmlUrl={runMeta?.final_html_url}
+            finalHtmlUrl={state.isLoading ? undefined : runMeta?.final_html_url}
-            slideOverrideCss={slideOverrideCss}
             isPipelineRunning={state.isLoading}
             isPendingLayout={!!pendingLayout}
             pendingLayoutId={pendingLayout}
@@ -594,6 +955,11 @@ export default function Home() {
             onSectionDrop={handleSectionDrop}
             onLayoutResize={handleLayoutResize}
             onZoneResize={handleZoneResize}
+            imageOverrides={state.userSelection.overrides.image_overrides}
+            onImageResize={handleImageResize}
+            onTextEdit={handleTextEdit}
+            structureOverrides={state.userSelection.overrides.structure_overrides}
+            onStructureEdit={handleStructureEdit}
           />
         </main>
 
@@ -602,6 +968,7 @@ export default function Home() {
           <div className="flex-shrink-0 flex p-1 bg-slate-50 border-b border-slate-200 m-2 rounded-lg">
             <button className={`flex-1 py-1.5 text-[10px] font-black uppercase tracking-widest rounded-md transition-all ${rightTab === "frame" ? "bg-white text-blue-600 shadow-sm" : "text-slate-400"}`} onClick={() => setRightTab("frame")}>Frame</button>
             <button className={`flex-1 py-1.5 text-[10px] font-black uppercase tracking-widest rounded-md transition-all ${rightTab === "layout" ? "bg-white text-blue-600 shadow-sm" : "text-slate-400"}`} onClick={() => setRightTab("layout")}>Layout</button>
+            <button className={`flex-1 py-1.5 text-[10px] font-black uppercase tracking-widest rounded-md transition-all ${rightTab === "trace" ? "bg-white text-blue-600 shadow-sm" : "text-slate-400"}`} onClick={() => setRightTab("trace")}>Trace</button>
           </div>
           <div className="flex-1 overflow-hidden">
             {rightTab === "frame" ? (
@@ -613,7 +980,7 @@ export default function Home() {
                 onFrameSelect={handleFrameSelect}
                 onNoDesignToggle={() => {}}
               />
-            ) : (
+            ) : rightTab === "layout" ? (
               <LayoutPanel
                 selectedZone={selectedZone}
                 userSelection={state.userSelection}
@@ -623,6 +990,8 @@ export default function Home() {
                 pipelineSelectedLayoutId={state.slidePlan?.layout_preset}
                 pendingLayoutId={pendingLayout}
               />
+            ) : (
+              <PipelineTracePanel trace={runMeta?.pipeline_trace} aiTrace={runMeta?.ai_trace} />
             )}
           </div>
         </aside>
@@ -636,11 +1005,13 @@ export default function Home() {
             <span className="text-[10px] font-bold text-slate-500 uppercase tracking-tighter">Phase Z Engine Active</span>
           </div>
         </div>
-        <div className="flex items-center gap-3">
+        <BottomActions
-          <Button variant="outline" onClick={() => toast.info("연동하기 기능은 준비 중입니다.")} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"><Link2 className="w-3.5 h-3.5" />Connect</Button>
+          slidePlan={state.slidePlan}
-          <Button variant="outline" onClick={() => toast.info("다운로드 기능은 준비 중입니다.")} disabled={!state.slidePlan} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"><Download className="w-3.5 h-3.5" />Download</Button>
+          runMeta={runMeta}
-          <Button onClick={() => toast.success("슬라이드 설정이 확정되었습니다.")} disabled={!state.slidePlan || state.isLoading} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest bg-slate-900 hover:bg-slate-800"><Sparkles className="w-3.5 h-3.5" />Finalize Slide</Button>
+          uploadedFile={state.uploadedFile}
-        </div>
+          isLoading={state.isLoading}
+          onGenerate={handleGenerate}
+        />
       </footer>
     </div>
   );

Front/client/src/services/applicationMode.ts

@@ -0,0 +1,64 @@
+// ─── IMP-41 u2 — application_mode helper (issue #70) ────────────────────────
+// Pure deterministic helpers for forwarding backend Step 9
+// `unit.application_candidates[]` to the FramePanel V4-label badge tooltip.
+//
+// Keyed by backend `application_mode` VALUE (NOT V4 label) — preserves the
+// AI-isolation contract: tooltip text is a read-only display of backend
+// authority, never re-derived on the frontend from V4 label.
+//
+// Source of truth = src/phase_z2_pipeline.py APPLICATION_MODE_BY_V4_LABEL
+// (:107-112) emitted via _application_candidates_for_unit() (:3071-3092)
+// onto unit.application_candidates[] in step09_application_plan.json.
+
+/** Backend application_mode enumeration (verbatim from APPLICATION_MODE_BY_V4_LABEL). */
+export type ApplicationMode =
+  | 'direct_insert'
+  | 'same_frame_with_adjustment'
+  | 'layout_or_region_change'
+  | 'exclude';
+
+/** Korean consequence phrases per issue #70 spec item #2. Keyed by mode VALUE. */
+export const APPLICATION_MODE_TOOLTIP_KR: Record<ApplicationMode, string> = {
+  direct_insert: '코드 직접 적용',
+  same_frame_with_adjustment: 'AI 보강 필요',
+  layout_or_region_change: 'AI restructure 필요',
+  exclude: 'render path 제외',
+};
+
+/**
+ * Compose the V4-label badge tooltip title. When `applicationMode` resolves
+ * to a known mode the title shows the Korean consequence + raw mode token;
+ * otherwise (undefined or unknown — legacy fixtures pre-IMP-32) it falls
+ * back to the raw V4 label string per Stage 2 contract.
+ */
+export function buildBadgeTitle(
+  label: string,
+  applicationMode: string | undefined,
+): string {
+  const consequence = applicationMode
+    ? APPLICATION_MODE_TOOLTIP_KR[applicationMode as ApplicationMode]
+    : undefined;
+  return consequence
+    ? `${consequence} (${applicationMode})`
+    : `V4 label: ${label}`;
+}
+
+/**
+ * Build a Map<template_id, applicationCandidate> from a Step 9
+ * `unit.application_candidates[]` array. Entries with a non-string or empty
+ * `template_id` are skipped. First occurrence wins on duplicate keys.
+ * Pure — does NOT sort, slice, or filter by label/confidence.
+ */
+export function mergeApplicationCandidates(
+  applicationCandidates: unknown,
+): Map<string, any> {
+  const out = new Map<string, any>();
+  if (!Array.isArray(applicationCandidates)) return out;
+  for (const ac of applicationCandidates) {
+    const key = (ac as any)?.template_id;
+    if (typeof key === 'string' && key.length > 0 && !out.has(key)) {
+      out.set(key, ac);
+    }
+  }
+  return out;
+}

Front/client/src/services/designAgentApi.ts

@@ -20,6 +20,8 @@ import {
   MOCK_FRAME_CANDIDATES_SECTION1,
 } from "../data/mockDesignAgentData";
 
+import { mergeApplicationCandidates } from "./applicationMode";
+
 /** 네트워크 지연 시뮬레이션 */
 const simulateDelay = (ms: number = 800) =>
   new Promise((resolve) => setTimeout(resolve, ms));
@@ -207,6 +209,58 @@ export async function exportSlidePlan(slidePlan: SlidePlan, userSelection: any):
 //   step20_slide_status.json       → 최종 상태 (PASS / RENDERED_WITH_VISUAL_REGRESSION / ...)
 // ─────────────────────────────────────────────────────────────────────────────
 
+// IMP-10 D-1 : verbatim mirror of step20_slide_status.json.data.filtered_section_reasons[]
+// schema (src/phase_z2_pipeline.py:2217-2278). `source` / `position` only present on
+// the override-uncovered additive variant. Strings rendered verbatim — no enum redefinition.
+export interface FilteredSectionReason {
+  section_ids: string[];
+  merge_type: string | null;
+  template_id: string | null;
+  v4_label: string | null;
+  phase_z_status: string | null;
+  score: number | null;
+  selection_state: string;
+  filter_reasons: string[];
+  source?: string;
+  position?: string | null;
+}
+
+export interface AiRepairStatus {
+  status: "ok" | "applied" | "unsupported_kind" | "coverage_violated" | "error" | string;
+  counts: {
+    total: number;
+    applied: number;
+    no_proposal: number;
+    no_zone_match: number;
+    unsupported_kind: number;
+    error: number;
+  };
+  // IMP-92 u3 — per-kind operational error aggregates plumbed from Step 12
+  // (u2 classify_operational_error). Optional for backward compatibility
+  // with pre-u3 payloads — u5 formatter treats absence as silent.
+  api_error_kinds?: {
+    quota: number;
+    billing: number;
+    auth: number;
+    other: number;
+  };
+  unsupported_kind_records: Array<{
+    unit_index?: number | null;
+    source_section_ids: string[];
+    apply_status: string;
+  }>;
+  error_records: Array<{
+    unit_index?: number | null;
+    source_section_ids: string[];
+    error: string;
+    // IMP-92 u3 — per-record operational error kind (quota|billing|auth|other|null).
+    api_error_kind?: string | null;
+  }>;
+  coverage_status: string;
+  dropped_section_ids: string[];
+  human_review_required: boolean;
+}
+
 export interface RunMeta {
   run_id: string;
   mdx_path: string;
@@ -214,11 +268,110 @@ export interface RunMeta {
   status: "PASS" | "RENDERED_WITH_VISUAL_REGRESSION" | "PARTIAL_COVERAGE" | "ABORTED" | string;
   visual_check_passed: boolean;
   full_mdx_coverage: boolean;
+  filtered_section_ids: string[];                       // step20 filtered_section_ids
+  filtered_section_reasons: FilteredSectionReason[];    // step20 filtered_section_reasons
   preview_url: string;     // /data/runs/{runId}/preview.png
   final_html_url: string;  // /data/runs/{runId}/final.html
   layout_candidates: string[]; // step07 layout_candidates list
   region_layout_candidates_by_zone: Record<string, string[]>;       // step08 placeholder
   display_strategy_candidates_by_zone: Record<string, string[]>;    // step08 placeholder
+  ai_repair_status: AiRepairStatus | null;
+  pipeline_trace: PipelineTraceSummary | null;
+  ai_trace: AiTraceSummary | null;
+}
+
+export interface PipelineTraceSection {
+  id: string;
+  title: string;
+  child_ids: string[];
+  state: "rendered" | "render_blocked" | "filtered" | "covered_not_rendered" | "uncovered";
+  reasons: string[];
+}
+
+export interface PipelineTraceUnit {
+  unit_id: string;
+  source_section_ids: string[];
+  merge_type: string | null;
+  selected_frame: string | null;
+  label: string | null;
+  candidate_count: number;
+  selection_path: string | null;
+  warnings: string[];
+}
+
+export interface PipelineTraceZone {
+  position: string;
+  source_section_ids: string[];
+  template_id: string | null;
+  slot_status: "filled" | "empty";
+  slot_key_count: number;
+  warnings: string[];
+}
+
+export interface PipelineTraceSummary {
+  sections: PipelineTraceSection[];
+  units: PipelineTraceUnit[];
+  zones: PipelineTraceZone[];
+  status: string;
+  warnings: string[];
+}
+
+export interface AiTraceUnit {
+  unit_index: number | null;
+  source_section_ids: string[];
+  frame_template_id: string | null;
+  route_hint: string | null;
+  provisional: boolean;
+  ai_called: boolean;
+  skip_reason: string | null;
+  apply_status: string | null;
+  api_error_kind: string | null;
+  error: string | null;
+}
+
+export interface AiTraceSummary {
+  artifact_present: boolean;
+  ai_enabled: boolean | null;
+  status: string;
+  ai_called_count: number;
+  eligible_count: number;
+  skipped_count: number;
+  error_count: number;
+  skip_reasons: Record<string, number>;
+  provider: string | null;
+  model: string | null;
+  coverage_status: string | null;
+  human_review_required: boolean;
+  units: AiTraceUnit[];
+  warnings: string[];
+}
+
+// IMP-92 u5 — Operational-only AI repair message formatter.
+//
+// Per the #84 operational-vs-non-operational replacement-plan contract, this
+// returns a user-visible toast string ONLY when ai_repair_status carries one
+// of the three actionable Anthropic API error kinds plumbed by u3
+// (quota / billing / auth). Non-operational AI failures (validation,
+// coverage_violated, unsupported_kind, or generic "other" API errors) return
+// null so the auto-pipeline stays silent per feedback_auto_pipeline_first.
+// Messages mirror the issue body copy contract exactly (429/402/401 →
+// quota/billing/auth Korean strings).
+export function formatAiRepairHumanReviewMessage(
+  ai: AiRepairStatus | null | undefined,
+): string | null {
+  if (!ai) return null;
+  const kinds = ai.api_error_kinds;
+  if (!kinds) return null;
+  if (kinds.quota > 0) {
+    return `API quota 부족 — 충전 필요 (${kinds.quota}건)`;
+  }
+  if (kinds.billing > 0) {
+    return `API billing 문제 — 결제 정보 확인 (${kinds.billing}건)`;
+  }
+  if (kinds.auth > 0) {
+    return `API key 무효 — .env 확인 (${kinds.auth}건)`;
+  }
+  return null;
 }
 
 export interface LoadRunResult {
@@ -260,13 +413,27 @@ export interface PipelineOverrides {
 
 export async function runPipeline(
   file: File,
-  overrides?: PipelineOverrides
+  overrides?: PipelineOverrides,
+  // IMP-43 (#72) u6 — optional prev RUN_ID for incremental rerun. When set,
+  // the vite plugin forwards `--reuse-from <PREV_RUN_ID>` to the backend
+  // and the pipeline resumes at Step 7 (Step 0/1/2/5/6 artifacts copied
+  // from the prior run). When omitted / empty, the POST body is
+  // byte-identical to pre-u6 (no reuseFromRunId key → no flag forwarded).
+  reuseFromRunId?: string,
+  options?: { ignoreUserOverrides?: boolean },
 ): Promise<RunPipelineResult> {
   const content = await file.text();
+  const body: Record<string, unknown> = {
+    filename: file.name,
+    content,
+    overrides,
+  };
+  if (reuseFromRunId) body.reuseFromRunId = reuseFromRunId;
+  if (options?.ignoreUserOverrides) body.ignoreUserOverrides = true;
   const res = await fetch("/api/run", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ filename: file.name, content, overrides }),
+    body: JSON.stringify(body),
   });
   const data = (await res.json()) as RunPipelineResult;
   if (!res.ok && !data.run_id) {
@@ -342,12 +509,417 @@ function classifyConfidence(score: number): "high" | "medium" | "low" {
   return "low";
 }
 
+const TOP_N_FRAMES = 6;
+
+function getCandidateTemplateId(c: any): string | null {
+  const id = c?.template_id ?? c?.frame_template_id ?? c?.id;
+  return typeof id === "string" && id.length > 0 ? id : null;
+}
+
+function normalizeRawCandidate(c: any): any | null {
+  const templateId = getCandidateTemplateId(c);
+  if (!templateId) return null;
+  return {
+    ...c,
+    template_id: templateId,
+    label: c.label ?? c.v4_label,
+    confidence: c.confidence ?? c.score,
+    rank: c.rank ?? c.v4_rank,
+  };
+}
+
+function mergeMissingCandidateFields(existing: any, incoming: any): any {
+  const merged = { ...existing };
+  for (const [key, value] of Object.entries(incoming)) {
+    if (value === undefined || value === null || value === "") continue;
+    if (merged[key] === undefined || merged[key] === null || merged[key] === "") {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+
+function pushCandidate(candidateMap: Map<string, any>, c: any): void {
+  const normalized = normalizeRawCandidate(c);
+  if (!normalized) return;
+  const key = normalized.template_id;
+  const prior = candidateMap.get(key);
+  candidateMap.set(key, prior ? mergeMissingCandidateFields(prior, normalized) : normalized);
+}
+
+function candidatesMatchingTemplate(unit: any, templateId: string | null): any[] {
+  if (!templateId) return [];
+  const sources = [
+    unit?.sorted_candidate_evidence,
+    unit?.candidate_evidence,
+    unit?.v4_candidates,
+    unit?.v4_all_judgments,
+    unit?.application_candidates,
+  ];
+  return sources
+    .flatMap((source) => (Array.isArray(source) ? source : []))
+    .filter((c) => getCandidateTemplateId(c) === templateId);
+}
+
+function compositionUnitToCandidate(compositionUnit: any | null | undefined): any | null {
+  if (!compositionUnit) return null;
+  const templateId = getCandidateTemplateId(compositionUnit);
+  if (!templateId) return null;
+  return {
+    template_id: templateId,
+    frame_id: compositionUnit.frame_id,
+    frame_number: compositionUnit.frame_number,
+    confidence: compositionUnit.confidence ?? compositionUnit.score ?? 0,
+    label: compositionUnit.label ?? "reject",
+    v4_label: compositionUnit.label,
+    phase_z_status: compositionUnit.phase_z_status,
+    candidate_status: compositionUnit.candidate_status,
+    coverage_state:
+      compositionUnit.coverage_state ??
+      (compositionUnit.rationale?.ai_adaptation_required === true
+        ? "requires_adaptation"
+        : undefined),
+    route_hint:
+      compositionUnit.rationale?.ai_adaptation_required === true
+        ? "ai_adaptation_required"
+        : undefined,
+    decision: "selected",
+    reason: compositionUnit.selection_path ?? compositionUnit.fallback_reason,
+    capacity_fit: compositionUnit.rationale?.capacity_fit,
+  };
+}
+
+export function buildFrameCandidatesForUnit(
+  unit: any,
+  compositionUnit?: any | null,
+): FrameCandidate[] {
+  const candidateMap = new Map<string, any>();
+  const currentDefault =
+    typeof unit?.current_default_candidate === "string"
+      ? unit.current_default_candidate
+      : null;
+
+  candidatesMatchingTemplate(unit, currentDefault).forEach((c) => pushCandidate(candidateMap, c));
+  pushCandidate(candidateMap, compositionUnitToCandidate(compositionUnit));
+
+  const sortedCandidateEvidence = Array.isArray(unit?.sorted_candidate_evidence)
+    ? unit.sorted_candidate_evidence
+    : [];
+  const candidateEvidence = Array.isArray(unit?.candidate_evidence)
+    ? unit.candidate_evidence
+    : [];
+  const primaryEvidence =
+    sortedCandidateEvidence.length > 0 ? sortedCandidateEvidence : candidateEvidence;
+
+  primaryEvidence.forEach((c: any) => pushCandidate(candidateMap, c));
+  (Array.isArray(unit?.v4_candidates) ? unit.v4_candidates : []).forEach((c: any) => pushCandidate(candidateMap, c));
+  (Array.isArray(unit?.v4_all_judgments) ? unit.v4_all_judgments : []).forEach((c: any) => pushCandidate(candidateMap, c));
+  (Array.isArray(unit?.application_candidates) ? unit.application_candidates : []).forEach((c: any) => pushCandidate(candidateMap, c));
+
+  const applicationModeMap = mergeApplicationCandidates(unit?.application_candidates);
+
+  return Array.from(candidateMap.values())
+    .slice(0, TOP_N_FRAMES)
+    .map((c: any) => {
+      const appMatch = applicationModeMap.get(c.template_id);
+      const numericScore = Number(c.confidence ?? c.score ?? 0);
+      const frameNumber = Number(c.frame_number);
+      return {
+        id: c.template_id,
+        name: c.template_id,
+        score: Number.isFinite(numericScore) ? numericScore : 0,
+        confidence: classifyConfidence(Number.isFinite(numericScore) ? numericScore : 0),
+        label: (c.label ?? c.v4_label ?? "reject") as FrameCandidate["label"],
+        thumbnailUrl:
+          Number.isFinite(frameNumber) && frameNumber > 0
+            ? `/frame-preview/${String(frameNumber).padStart(2, "0")}`
+            : undefined,
+        catalogRegistered: c.catalog_registered,
+        minHeightPx: c.min_height_px ?? undefined,
+        rank: c.rank,
+        frameId: c.frame_id,
+        v4Label: c.v4_label,
+        phaseZStatus: c.phase_z_status,
+        coverageState: c.coverage_state ?? c.coverageState,
+        candidateStatus: c.candidate_status ?? c.candidateStatus,
+        filteredForDirectExecution: c.filtered_for_direct_execution,
+        routeHint: c.route_hint,
+        decision: c.decision,
+        reason: c.reason,
+        capacityFit: c.capacity_fit,
+        applicationMode: appMatch?.application_mode ?? c.application_mode,
+        autoApplicable: appMatch?.auto_applicable ?? c.auto_applicable,
+        delegatedTo: appMatch?.delegated_to ?? c.delegated_to ?? null,
+      };
+    });
+}
+
 /**
  * 실제 Phase Z run 산출물을 로드하여 frontend type 으로 변환.
  *
  * @example
  *   const { normalizedContent, slidePlan, runMeta } = await loadRun("mdx03_f29_fix_check");
  */
+function arrayOfStrings(value: unknown): string[] {
+  return Array.isArray(value) ? value.filter((v): v is string => typeof v === "string") : [];
+}
+
+function slotPayloadStatus(zone: any): { status: "filled" | "empty"; keyCount: number } {
+  const payload = zone?.slot_payload;
+  const keys = payload && typeof payload === "object" && !Array.isArray(payload)
+    ? Object.keys(payload).filter((key) => key !== "_truncated_count")
+    : [];
+  const templateId = zone?.template_id ?? zone?.v4_template_id ?? null;
+  return {
+    status: templateId === "__empty__" || keys.length === 0 ? "empty" : "filled",
+    keyCount: keys.length,
+  };
+}
+
+function pushReason(map: Map<string, string[]>, id: string, reason: string): void {
+  if (!id || !reason) return;
+  const reasons = map.get(id) ?? [];
+  if (!reasons.includes(reason)) reasons.push(reason);
+  map.set(id, reasons);
+}
+
+function formatFilteredReason(reason: any): string {
+  const parts = [
+    reason?.selection_state,
+    reason?.merge_type,
+    reason?.template_id,
+    reason?.v4_label,
+    reason?.phase_z_status,
+    ...(Array.isArray(reason?.filter_reasons) ? reason.filter_reasons : []),
+  ].filter((value): value is string => typeof value === "string" && value.length > 0);
+  return parts.join(" / ") || "filtered";
+}
+
+export function buildPipelineTraceSummary(args: {
+  normalized: any;
+  compositionPlan: any;
+  applicationPlan: any;
+  slotPayload: any;
+  slideStatus: any;
+}): PipelineTraceSummary {
+  const slideData = args.slideStatus?.data ?? {};
+  const rendered = new Set(arrayOfStrings(slideData.content_rendered_section_ids));
+  const blocked = new Set(arrayOfStrings(slideData.render_blocked_section_ids));
+  const filtered = new Set(arrayOfStrings(slideData.filtered_section_ids));
+  const covered = new Set(arrayOfStrings(slideData.covered_section_ids));
+  const sectionReasons = new Map<string, string[]>();
+
+  (Array.isArray(slideData.filtered_section_reasons) ? slideData.filtered_section_reasons : [])
+    .forEach((reason: any) => {
+      arrayOfStrings(reason?.section_ids).forEach((id) => {
+        pushReason(sectionReasons, id, formatFilteredReason(reason));
+      });
+    });
+
+  (Array.isArray(slideData.adapter_needed_units) ? slideData.adapter_needed_units : [])
+    .forEach((unit: any) => {
+      const reason = unit?.reason ?? "adapter_needed";
+      arrayOfStrings(unit?.source_section_ids).forEach((id) => {
+        pushReason(sectionReasons, id, String(reason));
+      });
+    });
+
+  filtered.forEach((id) => pushReason(sectionReasons, id, "filtered"));
+
+  const sections = (Array.isArray(args.normalized?.data?.sections) ? args.normalized.data.sections : [])
+    .map((section: any, index: number): PipelineTraceSection => {
+      const id = section.section_id ?? `section-${index + 1}`;
+      const childIds = Array.isArray(section.sub_sections)
+        ? section.sub_sections
+            .map((sub: any, subIndex: number) => sub.section_id ?? `${id}-sub-${subIndex + 1}`)
+            .filter(Boolean)
+        : [];
+      let state: PipelineTraceSection["state"] = "uncovered";
+      if (rendered.has(id)) state = "rendered";
+      else if (blocked.has(id)) state = "render_blocked";
+      else if (filtered.has(id)) state = "filtered";
+      else if (covered.has(id)) state = "covered_not_rendered";
+      return {
+        id,
+        title: section.title ?? "",
+        child_ids: childIds,
+        state,
+        reasons: sectionReasons.get(id) ?? [],
+      };
+    });
+
+  const compositionByUnit = new Map<string, any>();
+  const selectedUnits = Array.isArray(args.compositionPlan?.data?.selected_units)
+    ? args.compositionPlan.data.selected_units
+    : [];
+  selectedUnits.forEach((unit: any) => {
+    const unitId = arrayOfStrings(unit.source_section_ids).join("+");
+    if (unitId) compositionByUnit.set(unitId, unit);
+  });
+
+  const appUnits = Array.isArray(args.applicationPlan?.data?.units)
+    ? args.applicationPlan.data.units
+    : [];
+  const units = appUnits.map((unit: any): PipelineTraceUnit => {
+    const sectionIds = typeof unit.unit_id === "string"
+      ? unit.unit_id.split("+").filter(Boolean)
+      : arrayOfStrings(unit.source_section_ids);
+    const compositionUnit = compositionByUnit.get(sectionIds.join("+"));
+    const warnings: string[] = [];
+    if (sectionIds.length > 1) warnings.push("merged_sections");
+    const selectionPath = unit.selection_path ?? compositionUnit?.selection_path ?? null;
+    if (typeof selectionPath === "string" && selectionPath.includes("fallback")) warnings.push(selectionPath);
+    const candidateCount = buildFrameCandidatesForUnit(unit, compositionUnit).length;
+    if (candidateCount === 0) warnings.push("no_frame_candidates");
+
+    return {
+      unit_id: sectionIds.join("+") || unit.unit_id || "",
+      source_section_ids: sectionIds,
+      merge_type: unit.merge_type ?? compositionUnit?.merge_type ?? null,
+      selected_frame:
+        unit.current_default_candidate ??
+        unit.template_id ??
+        compositionUnit?.frame_template_id ??
+        null,
+      label: unit.label ?? compositionUnit?.label ?? null,
+      candidate_count: candidateCount,
+      selection_path: selectionPath,
+      warnings,
+    };
+  });
+
+  const adapterByPosition = new Map<string, any>();
+  (Array.isArray(slideData.adapter_needed_units) ? slideData.adapter_needed_units : [])
+    .forEach((unit: any) => {
+      if (unit.position) adapterByPosition.set(unit.position, unit);
+    });
+
+  const zones = (Array.isArray(args.slotPayload?.data?.per_zone) ? args.slotPayload.data.per_zone : [])
+    .map((zone: any, index: number): PipelineTraceZone => {
+      const { status, keyCount } = slotPayloadStatus(zone);
+      const adapterNeeded = adapterByPosition.get(zone.position);
+      const appUnit = appUnits[index] ?? {};
+      const sectionIds = arrayOfStrings(adapterNeeded?.source_section_ids).length > 0
+        ? arrayOfStrings(adapterNeeded.source_section_ids)
+        : typeof appUnit.unit_id === "string"
+          ? appUnit.unit_id.split("+").filter(Boolean)
+          : [];
+      const warnings: string[] = [];
+      if (zone.template_id === "__empty__") warnings.push("__empty__");
+      if (status === "empty") warnings.push("empty_slot_payload");
+      if (adapterNeeded) warnings.push(adapterNeeded.reason ?? "adapter_needed");
+      return {
+        position: zone.position ?? `zone-${index}`,
+        source_section_ids: sectionIds,
+        template_id: zone.template_id ?? null,
+        slot_status: status,
+        slot_key_count: keyCount,
+        warnings,
+      };
+    });
+
+  const warnings = [
+    ...arrayOfStrings(slideData.filtered_section_ids).map((id) => `filtered:${id}`),
+    ...arrayOfStrings(slideData.render_blocked_section_ids).map((id) => `render_blocked:${id}`),
+  ];
+  if ((slideData.adapter_needed_count ?? 0) > 0) {
+    warnings.push(`adapter_needed:${slideData.adapter_needed_count}`);
+  }
+
+  return {
+    sections,
+    units,
+    zones,
+    status: slideData.overall ?? "UNKNOWN",
+    warnings,
+  };
+}
+
+export function buildAiTraceSummary(
+  aiRepairArtifact: any | null,
+  aiRepairStatus: AiRepairStatus | null | undefined,
+): AiTraceSummary {
+  if (!aiRepairArtifact?.data) {
+    return {
+      artifact_present: false,
+      ai_enabled: null,
+      status: aiRepairStatus?.status ?? "missing_artifact",
+      ai_called_count: 0,
+      eligible_count: 0,
+      skipped_count: 0,
+      error_count: 0,
+      skip_reasons: {},
+      provider: null,
+      model: null,
+      coverage_status: aiRepairStatus?.coverage_status ?? null,
+      human_review_required: aiRepairStatus?.human_review_required ?? false,
+      units: [],
+      warnings: ["step12_ai_repair.json missing"],
+    };
+  }
+
+  const rawUnits = Array.isArray(aiRepairArtifact.data.per_unit)
+    ? aiRepairArtifact.data.per_unit
+    : [];
+  const units: AiTraceUnit[] = rawUnits.map((unit: any) => ({
+    unit_index: typeof unit.unit_index === "number" ? unit.unit_index : null,
+    source_section_ids: arrayOfStrings(unit.source_section_ids),
+    frame_template_id: unit.frame_template_id ?? null,
+    route_hint: unit.route_hint ?? null,
+    provisional: unit.provisional === true,
+    ai_called: unit.ai_called === true,
+    skip_reason: unit.skip_reason ?? null,
+    apply_status: unit.apply_status ?? null,
+    api_error_kind: unit.api_error_kind ?? null,
+    error: unit.error ?? null,
+  }));
+
+  const skipReasons: Record<string, number> = {};
+  units.forEach((unit) => {
+    const key = unit.skip_reason ?? (unit.ai_called ? "called" : "unknown");
+    skipReasons[key] = (skipReasons[key] ?? 0) + 1;
+  });
+  const warnings: string[] = [];
+  units
+    .filter((unit) => unit.error)
+    .forEach((unit) => warnings.push(`error:${unit.unit_index ?? "?"}`));
+  units
+    .filter((unit) => unit.api_error_kind)
+    .forEach((unit) => warnings.push(`api_${unit.api_error_kind}:${unit.unit_index ?? "?"}`));
+  if (units.some((unit) => unit.skip_reason === "router_short_circuit")) {
+    warnings.push("router_short_circuit");
+  }
+  const eligibleUnits = units.filter(
+    (unit) => unit.provisional && unit.route_hint === "ai_adaptation_required",
+  );
+  const aiEnabled =
+    units.some((unit) => unit.ai_called)
+      ? true
+      : eligibleUnits.length > 0 && eligibleUnits.every((unit) => unit.skip_reason === "router_short_circuit")
+        ? false
+        : null;
+
+  return {
+    artifact_present: true,
+    ai_enabled: aiEnabled,
+    status: aiRepairStatus?.status ?? aiRepairArtifact.step_status ?? "unknown",
+    ai_called_count: units.filter((unit) => unit.ai_called).length,
+    eligible_count: units.filter((unit) => unit.provisional && unit.route_hint === "ai_adaptation_required").length,
+    skipped_count: units.filter((unit) => !unit.ai_called).length,
+    error_count: units.filter((unit) => !!unit.error).length,
+    skip_reasons: skipReasons,
+    provider: "anthropic",
+    model: null,
+    coverage_status:
+      aiRepairStatus?.coverage_status ??
+      aiRepairArtifact.data.coverage_invariant?.status ??
+      null,
+    human_review_required: aiRepairStatus?.human_review_required ?? false,
+    units,
+    warnings,
+  };
+}
+
 export async function loadRun(runId: string): Promise<LoadRunResult> {
   console.log(`[Phase Z] loadRun: ${runId}`);
   const base = `/data/runs/${runId}`;
@@ -359,6 +931,14 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
     }
     return res.json();
   };
+  const fetchJsonOptional = async (path: string) => {
+    const res = await fetch(`${base}/${path}`);
+    if (res.status === 404) return null;
+    if (!res.ok) {
+      throw new Error(`Failed to fetch ${path}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  };
   const fetchText = async (path: string) => {
     const res = await fetch(`${base}/${path}`);
     if (!res.ok) {
@@ -371,21 +951,28 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
     mdxSource,
     upload,
     normalized,
+    compositionPlan,
     layout,
     zoneRegion,
     applicationPlan,
+    slotPayload,
     slideStatus,
+    aiRepair,
   ] = await Promise.all([
     fetchText("steps/step01_mdx_source.md"),
     fetchJson("steps/step01_mdx_upload.json"),
     fetchJson("steps/step02_normalized.json"),
+    fetchJson("steps/step06_composition_plan.json"),
     fetchJson("steps/step07_layout.json"),
     fetchJson("steps/step08_zone_region_ratios.json"),
     fetchJson("steps/step09_application_plan.json"),
+    fetchJson("steps/step12_slot_payload.json"),
     fetchJson("steps/step20_slide_status.json"),
+    fetchJsonOptional("steps/step12_ai_repair.json"),
   ]);
 
   // ── RunMeta ──
+  const aiRepairStatus = (slideStatus.data?.ai_repair_status ?? null) as AiRepairStatus | null;
   const runMeta: RunMeta = {
     run_id: upload.data?.run_id ?? runId,
     mdx_path: upload.data?.mdx_path ?? "",
@@ -393,6 +980,8 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
     status: slideStatus.data?.overall ?? "UNKNOWN",
     visual_check_passed: slideStatus.data?.visual_check_passed ?? false,
     full_mdx_coverage: slideStatus.data?.full_mdx_coverage ?? false,
+    filtered_section_ids: slideStatus.data?.filtered_section_ids ?? [],
+    filtered_section_reasons: slideStatus.data?.filtered_section_reasons ?? [],
     preview_url: `${base}/preview.png`,
     final_html_url: `${base}/final.html`,
     layout_candidates: layout.data?.layout_candidates ?? [],
@@ -408,6 +997,15 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
         z.display_strategy_candidates ?? [],
       ])
     ),
+    ai_repair_status: aiRepairStatus,
+    pipeline_trace: buildPipelineTraceSummary({
+      normalized,
+      compositionPlan,
+      applicationPlan,
+      slotPayload,
+      slideStatus,
+    }),
+    ai_trace: buildAiTraceSummary(aiRepair, aiRepairStatus),
   };
 
   // ── NormalizedContent ──
@@ -462,6 +1060,16 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
   const layoutPreset = (layout.data?.layout_preset ?? "single") as LayoutPresetId;
   const positions = computeZonePositions(layoutPreset);
   const units: any[] = applicationPlan.data?.units ?? [];
+  const compositionUnitsById = new Map<string, any>();
+  const selectedUnits = compositionPlan.data?.selected_units;
+  if (Array.isArray(selectedUnits)) {
+    selectedUnits.forEach((unit: any) => {
+      const unitId = Array.isArray(unit.source_section_ids)
+        ? unit.source_section_ids.join("+")
+        : "";
+      if (unitId) compositionUnitsById.set(unitId, unit);
+    });
+  }
 
   const zones = units.map((unit: any, idx: number) => {
     const posEntry = positions[idx] ?? {
@@ -477,23 +1085,110 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
     // sort 우선순위 = label (use_as_is > light_edit > restructure > reject) + confidence desc.
     // 모두 reject 인 경우 confidence desc 만 적용 (사용자 명시).
     const TOP_N_FRAMES = 6;
+    // IMP-39 u4 (issue #68) — local LABEL_PRIORITY is now a documentation
+    // mirror of templates/phase_z2/catalog/ranking_sort_policy.yaml (u1).
+    // Primary ordering arrives pre-sorted from the backend selector
+    // (src/phase_z2_pipeline.py lookup_v4_match_with_fallback :1186-1196 +
+    // _build_application_plan_unit u3 payload fields). This constant is read
+    // ONLY on the warn-fallback path below (legacy fixtures pre-u3 / payload
+    // missing). Kept verbatim so the fallback ordering matches u1/u2 contract.
     const LABEL_PRIORITY: Record<string, number> = {
       use_as_is: 0,
       light_edit: 1,
       restructure: 2,
       reject: 3,
     };
-    const rawSource = (unit.v4_all_judgments?.length > 0)
+    // IMP-29 u2 — source priority (deterministic, no LLM):
-      ? unit.v4_all_judgments
+    //   1) unit.candidate_evidence (IMP-05 L2 canonical, 14 fields per entry)
-      : (unit.v4_candidates ?? []);
+    //   2) unit.v4_all_judgments   (pre-IMP-05 audit array)
-    const v4Source = [...rawSource].sort((a: any, b: any) => {
+    //   3) unit.v4_candidates      (legacy minimal)
-      const lp = (LABEL_PRIORITY[a.label] ?? 99) - (LABEL_PRIORITY[b.label] ?? 99);
+    // fallback_chain alias is intentionally NOT read (Stage 2 guardrail).
-      if (lp !== 0) return lp;
+    const candidateMap = new Map<string, any>();
-      return (b.confidence ?? 0) - (a.confidence ?? 0);
+    const pushCandidate = (c: any) => {
-    });
+      if (!c) return;
+      const key = c.template_id ?? c.id ?? c.frame_id;
+      if (!key) return;
+      if (!candidateMap.has(key)) candidateMap.set(key, c);
+    };
+
+    // IMP-39 u4 (issue #68) — primary path: consume the backend Step 9
+    // payload as the single source of ordering truth.
+    //   • ``unit.sorted_candidate_evidence`` = policy-sorted selector trace
+    //     (src/phase_z2_pipeline.py :4163, alias of selection_trace[
+    //     "candidates"] sorted by u2 at :1186-1196). Same IMP-05 L2 schema
+    //     consumed below (template_id, label, confidence, frame_number,
+    //     frame_id, rank, catalog_registered, capacity_fit, route_hint, ...).
+    //   • ``unit.ranking_sort_policy`` = full single-source policy dict
+    //     (policy_type / label_priority / unknown_label_priority /
+    //     tie_break_axes) forwarded for telemetry + fallback parity check.
+    // When both are present we feed sorted_candidate_evidence through the
+    // existing dedup map (first occurrence wins, mirrors backend
+    // ``seen_template_ids`` semantics at :1204-1236) and SKIP the local
+    // re-sort — backend "rank 1" then equals frontend frame_candidates[0]
+    // by construction (Stage 1 root-cause fix).
+    const sortedCandidateEvidence: any[] | null = Array.isArray(
+      unit.sorted_candidate_evidence,
+    )
+      ? unit.sorted_candidate_evidence
+      : null;
+    const rankingSortPolicy = unit.ranking_sort_policy ?? null;
+    const backendPolicyPayloadPresent =
+      sortedCandidateEvidence !== null &&
+      sortedCandidateEvidence.length > 0 &&
+      rankingSortPolicy !== null;
+
+    let v4Source: any[];
+    if (backendPolicyPayloadPresent) {
+      // Emergency fix (2026-05-26) — sorted_candidate_evidence 는 primary (rank order)
+      // 로 먼저 push (first-wins dedup map 이 순서 보존). 그 후 v4_all_judgments +
+      // v4_candidates 도 push 해서 후보 pool 채움 (reject 포함, max TOP_N_FRAMES).
+      // 이전 버그: sorted_candidate_evidence 만 사용 → "선택된 후보 1개" 만 frontend panel
+      // 에 surface, 나머지 reject/light_edit/restructure 후보 사라짐.
+      sortedCandidateEvidence!.forEach(pushCandidate);
+      (unit.v4_all_judgments ?? []).forEach(pushCandidate);
+      (unit.v4_candidates ?? []).forEach(pushCandidate);
+      v4Source = Array.from(candidateMap.values());
+    } else {
+      // IMP-39 u4 — warn-fallback path. Legacy fixtures predating u3 (or
+      // any code path that strips the payload) lack the backend-sorted
+      // evidence; ordering then derives from local LABEL_PRIORITY mirror.
+      // Warning surfaces drift in dev console without hard-failing the UI
+      // (graceful: production sample audit deck remains renderable).
+      if (typeof console !== "undefined" && typeof console.warn === "function") {
+        console.warn(
+          `[IMP-39 u4] unit ${unit.unit_id ?? "<unknown>"}: backend payload ` +
+            "missing ranking_sort_policy / sorted_candidate_evidence — " +
+            "falling back to local LABEL_PRIORITY (legacy fixture path).",
+        );
+      }
+      const candidateEvidence = Array.isArray(unit.candidate_evidence)
+        ? unit.candidate_evidence
+        : [];
+      candidateEvidence.forEach(pushCandidate);
+      (unit.v4_all_judgments ?? []).forEach(pushCandidate);
+      (unit.v4_candidates ?? []).forEach(pushCandidate);
+      const rawSource = Array.from(candidateMap.values());
+      v4Source = [...rawSource].sort((a: any, b: any) => {
+        const lp =
+          (LABEL_PRIORITY[a.label] ?? 99) - (LABEL_PRIORITY[b.label] ?? 99);
+        if (lp !== 0) return lp;
+        return (b.confidence ?? 0) - (a.confidence ?? 0);
+      });
+    }
+    // ─── IMP-41 u4 — application_candidates enrichment (issue #70) ───────────
+    // Backend Step 9 emits `unit.application_candidates[]` (src/phase_z2_pipeline.py
+    // _application_candidates_for_unit, :3071-3092) one entry per v4 candidate with
+    // application_mode / auto_applicable / delegated_to derived from
+    // APPLICATION_MODE_BY_V4_LABEL (:107-112). Indexing delegated to the pure
+    // helper `mergeApplicationCandidates` (services/applicationMode.ts) keyed
+    // by template_id. Enrichment ONLY — does NOT alter candidate source
+    // priority, sorting, or TOP_N_FRAMES slicing.
+    const applicationModeMap = mergeApplicationCandidates(unit.application_candidates);
     const frameCandidates: FrameCandidate[] = v4Source
       .slice(0, TOP_N_FRAMES)
-      .map((c: any) => ({
+      .map((c: any) => {
+        const appMatch = applicationModeMap.get(c.template_id);
+        return ({
         id: c.template_id,
         name: c.template_id,
         score: c.confidence ?? 0,
@@ -505,9 +1200,44 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
             ? `/frame-preview/${String(c.frame_number).padStart(2, "0")}`
             : undefined,
         // backend step09 의 catalog_registered (frame_contracts.yaml 등록 여부).
-        // v4_all_judgments 에만 있음. v4_candidates fallback 시 undefined.
+        // candidate_evidence 및 v4_all_judgments 에 있음. v4_candidates fallback 시 undefined.
         catalogRegistered: c.catalog_registered,
-      }));
+        // backend step09 의 min_height_px (frame_contracts.yaml visual_hints.min_height_px).
+        // logical 1280x720 px 좌표계. contract 미등록 또는 visual_hints 부재 시 undefined.
+        // v4_all_judgments 에만 있음. candidate_evidence / v4_candidates fallback 시 undefined (graceful).
+        minHeightPx: c.min_height_px ?? undefined,
+        // ─── IMP-05 L2 candidate_evidence fields (IMP-29 u2) ─────────────────
+        // Populated when source = unit.candidate_evidence; otherwise silently
+        // undefined for legacy fixtures (pre-IMP-05 fallback path).
+        rank: c.rank,
+        frameId: c.frame_id,
+        v4Label: c.v4_label,
+        phaseZStatus: c.phase_z_status,
+        coverageState: c.coverage_state ?? c.coverageState,
+        candidateStatus: c.candidate_status ?? c.candidateStatus,
+        filteredForDirectExecution: c.filtered_for_direct_execution,
+        routeHint: c.route_hint,
+        decision: c.decision,
+        reason: c.reason,
+        capacityFit: c.capacity_fit,
+        // ─── IMP-41 u2 — application_mode forwarding (issue #70) ───────────
+        // Source = unit.application_candidates[] indexed by template_id above.
+        // Optional fields — undefined when no matching application_candidate
+        // (legacy fixtures pre-IMP-32 or candidates filtered out at Step 9).
+        applicationMode: appMatch?.application_mode,
+        autoApplicable: appMatch?.auto_applicable,
+        delegatedTo: appMatch?.delegated_to ?? null,
+      });
+      });
+
+    const mergedFrameCandidates = buildFrameCandidatesForUnit(
+      unit,
+      compositionUnitsById.get(unit.unit_id),
+    );
+    const effectiveFrameCandidates =
+      mergedFrameCandidates.length > 0 ? mergedFrameCandidates : frameCandidates;
+    const defaultFrameId =
+      unit.current_default_candidate ?? effectiveFrameCandidates[0]?.id ?? null;
 
     const displayStrategy = (
       runMeta.display_strategy_candidates_by_zone[posEntry.name]?.[0] ??
@@ -533,10 +1263,10 @@ export async function loadRun(runId: string): Promise<LoadRunResult> {
           content_unit_ids: [],
           frame_match_strategy: {
             kind: "frame_match" as const,
-            frame_id: unit.current_default_candidate ?? null,
+            frame_id: defaultFrameId,
             display_strategy: displayStrategy,
           },
-          frame_candidates: frameCandidates,
+          frame_candidates: effectiveFrameCandidates,
         },
       ],
       region_layout_type: regionId,

Front/client/src/services/userOverridesApi.ts

@@ -0,0 +1,287 @@
+// IMP-52 u5 — typed frontend client for `/api/user-overrides/:key` (GET + PUT).
+//
+// The on-disk schema (KNOWN_AXES) and endpoint contract are owned by:
+//   • src/user_overrides_io.py            (Python — backend pipeline fallback, u1/u2)
+//   • Front/vite.config.ts (handleGet/PutUserOverrides, u3/u4)
+// This module is the typed view used by Home.tsx restore-on-reopen (u6) and
+// the four mutation handlers (u7). It does NOT own the schema — any change
+// to KNOWN_AXES must land in u1/u4 first, then reflect here.
+//
+// IMP-51 (#79) u3 — added `image_overrides` (5th axis). `image_id` → percent-
+// of-slide {x,y,w,h}. Mirrors src/user_overrides_io.py KNOWN_AXES (u1) and
+// Front/vite.config.ts KNOWN_USER_OVERRIDES_AXES (u2). Backend stamper +
+// render-time CSS injection ride on u4~u7; the SlideCanvas drag/resize
+// handles that drive this axis ride on u8~u11.
+//
+// Contract (Stage 2 unit u5 summary):
+//   • Typed `getUserOverrides(key)` → returns `Partial<UserOverrides>` from
+//     the GET endpoint. Missing / corrupt / non-object payloads degrade to
+//     `{}` so the frontend reopen flow never crashes on a fresh MDX.
+//   • Typed `saveUserOverrides(key, partial)` → schedules a 300ms-debounced
+//     PUT carrying ONLY the axes the user has mutated since the last flush.
+//     Per-axis coalescing: a later call overwrites the same axis in the
+//     pending payload; axes the user did not mutate are NOT sent (the
+//     server-side merge in u4 preserves them on disk).
+//   • Per-key debounce buckets — rapid edits to MDX "03" do not delay the
+//     flush for MDX "04".
+//   • Explicit clear sentinel: `partial[axis] = null` forwards to the PUT
+//     body verbatim so u4 `mergeUserOverrides` can `delete` the axis on disk.
+//   • `flushUserOverrides()` / `flushUserOverrides(key)` force an immediate
+//     PUT (used by tests + Home.tsx Generate flow to ensure outstanding
+//     writes commit before pipeline run).
+
+const ENDPOINT_BASE = "/api/user-overrides";
+const DEBOUNCE_MS = 300;
+
+// ── Schema (mirror of backend KNOWN_AXES; see header comment) ───────────────
+
+/** unit_id → template_id. unit_id = source_section_ids joined by "+". */
+export type FramesOverride = Record<string, string>;
+
+/** zone_id → 0-1 normalized geometry inside slide-body. */
+export type ZoneGeometryOverride = {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+};
+export type ZoneGeometriesOverride = Record<string, ZoneGeometryOverride>;
+
+/** zone_id → ordered list of section_ids assigned to that zone. */
+export type ZoneSectionsOverride = Record<string, string[]>;
+
+/**
+ * IMP-51 #79 u3 — image_id → percent-of-slide geometry. Matches the user-
+ * content image selector `.slide img[data-image-role="user-content"]`
+ * (stamper in u4) and the render-time CSS injection map (u7). Coordinates
+ * are slide-absolute percent (0–100) so SlideCanvas drag handles (u8~u11)
+ * map 1:1 with the persisted axis without per-zone transforms.
+ */
+export type ImageOverride = {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+};
+export type ImageOverridesOverride = Record<string, ImageOverride>;
+
+/**
+ * IMP-55 #93 u1 — bool intent marker that gates whether persisted
+ * `zone_sections` are consumed by the backend pipeline. Frontend sets
+ * `true` only on a real user drag-drop (Home.tsx handleSectionDrop, u6)
+ * and `false` on layout apply/cancel auto-carry (u5/u12). Mirrors the
+ * Python KNOWN_AXES (`manual_section_assignment`) added in u1 and the
+ * Vite KNOWN_USER_OVERRIDES_AXES allowlist entry added in u1.
+ */
+export type ManualSectionAssignmentOverride = boolean;
+
+/**
+ * IMP-56 #90 u10 — Step-22 text-edit persist axis. Keyed by `zone_id`; the
+ * inner mapping is `text_path` (= `{slot_key}.{line_index}`) → line value.
+ * The `text_path` stamp is emitted by `src/text_path_stamper.py` (u8) and
+ * applied at Step 13 (u9); the value is consumed by `text_override_resolver`
+ * (u4) and applied at Step 12 (u5). Stale paths (frame swap / layout
+ * regression between sessions) are tolerated by the backend resolver as
+ * `skipped`, NOT raised — so the on-disk axis is forward-compat with layout
+ * and frame churn. Mirrors Python `KNOWN_AXES` entry (u1) and Vite
+ * `KNOWN_USER_OVERRIDES_AXES` allowlist entry (u3).
+ */
+export type TextOverridesPerZone = Record<string, string>;
+export type TextOverridesOverride = Record<string, TextOverridesPerZone>;
+
+/**
+ * IMP-56 #90 u10 — Step-22 structure-edit persist axis. Keyed by `zone_id`;
+ * the inner mapping is SCOPE-LOCKED to `{slot_order, hidden_slots}` — slot
+ * reorder + slot hide only. Frame swap stays on the existing `frames` axis;
+ * the `structure_override_resolver` (u6) rejects frame-swap-shaped inner
+ * keys at the validate gate so Phase Z's no-AI-HTML-structure invariant
+ * holds across this persisted axis too. Per-slot `list[str]` line content
+ * is NEVER mutated by the u7 Step-12 apply — that is the `text_overrides`
+ * axis above. Mirrors Python `KNOWN_AXES` entry (u2) and Vite
+ * `KNOWN_USER_OVERRIDES_AXES` allowlist entry (u3).
+ */
+export type StructureOverridePerZone = {
+  slot_order?: string[];
+  hidden_slots?: string[];
+};
+export type StructureOverridesOverride = Record<string, StructureOverridePerZone>;
+
+/** Full on-disk schema. All axes optional — file may carry any subset. */
+export interface UserOverrides {
+  layout: string;
+  frames: FramesOverride;
+  zone_geometries: ZoneGeometriesOverride;
+  zone_sections: ZoneSectionsOverride;
+  image_overrides: ImageOverridesOverride;
+  manual_section_assignment: ManualSectionAssignmentOverride;
+  text_overrides: TextOverridesOverride;
+  structure_overrides: StructureOverridesOverride;
+}
+
+/** Partial-mutation payload. `null` is the explicit clear sentinel (mirrors u4). */
+export type UserOverridesPartial = {
+  [K in keyof UserOverrides]?: UserOverrides[K] | null;
+};
+
+// ── Per-key debounce buckets ────────────────────────────────────────────────
+
+type PendingBucket = {
+  partial: UserOverridesPartial;
+  timer: ReturnType<typeof setTimeout> | null;
+  waiters: Array<{
+    resolve: (merged: Partial<UserOverrides>) => void;
+    reject: (err: unknown) => void;
+  }>;
+};
+
+const buckets = new Map<string, PendingBucket>();
+
+function getBucket(key: string): PendingBucket {
+  let b = buckets.get(key);
+  if (!b) {
+    b = { partial: {}, timer: null, waiters: [] };
+    buckets.set(key, b);
+  }
+  return b;
+}
+
+// ── GET ─────────────────────────────────────────────────────────────────────
+
+/**
+ * Fetch the persisted user_overrides for `key` (MDX stem). Returns `{}` on
+ * any failure mode (network error, 4xx/5xx, non-object body) so the caller
+ * can use it unconditionally during MDX reopen without branching on
+ * error paths.
+ */
+export async function getUserOverrides(
+  key: string,
+): Promise<Partial<UserOverrides>> {
+  let res: Response;
+  try {
+    res = await fetch(`${ENDPOINT_BASE}/${encodeURIComponent(key)}`, {
+      method: "GET",
+      headers: { Accept: "application/json" },
+    });
+  } catch {
+    return {};
+  }
+  if (!res.ok) return {};
+
+  let parsed: unknown;
+  try {
+    parsed = await res.json();
+  } catch {
+    return {};
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return {};
+  }
+  return parsed as Partial<UserOverrides>;
+}
+
+// ── PUT (debounced) ─────────────────────────────────────────────────────────
+
+async function flushBucket(
+  key: string,
+  bucket: PendingBucket,
+): Promise<void> {
+  const payload = bucket.partial;
+  const waiters = bucket.waiters;
+  bucket.partial = {};
+  bucket.timer = null;
+  bucket.waiters = [];
+
+  let merged: Partial<UserOverrides> = {};
+  try {
+    const res = await fetch(`${ENDPOINT_BASE}/${encodeURIComponent(key)}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+    if (res.ok) {
+      try {
+        const parsed = (await res.json()) as unknown;
+        if (
+          typeof parsed === "object" &&
+          parsed !== null &&
+          !Array.isArray(parsed)
+        ) {
+          merged = parsed as Partial<UserOverrides>;
+        }
+      } catch {
+        // server returned 200 with non-JSON body → treat as empty merged
+      }
+    } else {
+      const err = new Error(`PUT ${ENDPOINT_BASE}/${key} → ${res.status}`);
+      waiters.forEach((w) => w.reject(err));
+      return;
+    }
+  } catch (err) {
+    waiters.forEach((w) => w.reject(err));
+    return;
+  }
+  waiters.forEach((w) => w.resolve(merged));
+}
+
+/**
+ * Schedule a debounced PUT to persist the mutated axes. Resolves with the
+ * server-side merged document when the debounced PUT eventually fires.
+ * Multiple rapid calls for the same `key` coalesce into a single PUT;
+ * a later call's value for a given axis overrides an earlier pending value.
+ * Calls for different `key`s are isolated.
+ */
+export function saveUserOverrides(
+  key: string,
+  partial: UserOverridesPartial,
+): Promise<Partial<UserOverrides>> {
+  const bucket = getBucket(key);
+  // Per-axis coalescing — later mutations replace earlier pending values.
+  for (const axis of Object.keys(partial) as Array<keyof UserOverridesPartial>) {
+    bucket.partial[axis] = partial[axis] as never;
+  }
+  const p = new Promise<Partial<UserOverrides>>((resolve, reject) => {
+    bucket.waiters.push({ resolve, reject });
+  });
+  if (bucket.timer !== null) clearTimeout(bucket.timer);
+  bucket.timer = setTimeout(() => {
+    void flushBucket(key, bucket);
+  }, DEBOUNCE_MS);
+  return p;
+}
+
+/**
+ * Force-flush pending debounced writes. With no arg, flushes ALL pending
+ * keys (used before pipeline runs so the backend reads the latest file).
+ * With a key, flushes only that key's bucket.
+ *
+ * Resolves after every flushed bucket's PUT completes. Per-bucket errors
+ * are swallowed at the flush level — the original caller's
+ * saveUserOverrides() promise still rejects to its owner via the waiter.
+ */
+export async function flushUserOverrides(key?: string): Promise<void> {
+  const targets: Array<[string, PendingBucket]> = [];
+  if (key !== undefined) {
+    const b = buckets.get(key);
+    if (b && b.timer !== null) targets.push([key, b]);
+  } else {
+    buckets.forEach((b, k) => {
+      if (b.timer !== null) targets.push([k, b]);
+    });
+  }
+  const flushPromises = targets.map(([k, b]) => {
+    if (b.timer !== null) {
+      clearTimeout(b.timer);
+      b.timer = null;
+    }
+    return flushBucket(k, b);
+  });
+  await Promise.all(flushPromises);
+}
+
+/** Test-only — clears all pending buckets without firing PUTs. */
+export function __resetUserOverridesBuckets_FOR_TEST(): void {
+  buckets.forEach((b) => {
+    if (b.timer !== null) clearTimeout(b.timer);
+  });
+  buckets.clear();
+}

Front/client/src/types/designAgent.ts

@@ -116,6 +116,23 @@ export interface InternalRegion {
   frame_candidates: FrameCandidate[];
 }
 
+/** IMP-05 L2 candidate_evidence.capacity_fit — backend capacity vs. content shape audit.
+ *  Source = src/phase_z2_pipeline.py compute_capacity_fit(). All fields optional —
+ *  frontend tolerates absence for pre-IMP-05 fixtures and contract-less templates. */
+export interface CapacityFitEvidence {
+  item_count?: number | null;
+  source_shape?: string | null;
+  capacity?: {
+    strict?: number | null;
+    min?: number | null;
+    max?: number | null;
+    truncate_at?: number | null;
+    pad_to?: number | null;
+  } | null;
+  fit_status?: string | null;
+  mismatch_reason?: string | null;
+}
+
 /** 프레임 후보 (V4 매칭 결과) */
 export interface FrameCandidate {
   id: string;
@@ -127,6 +144,54 @@ export interface FrameCandidate {
   /** backend frame_contracts.yaml 에 catalog 등록 여부. false 면 사용자가 override
    *  시도해도 Step 7-A 가 skip (render path 미연결). UI 회색 + "render path 미적용" 표시. */
   catalogRegistered?: boolean;
+  /** IMP-11 D-2 — frame contract visual_hints.min_height_px (logical 1280x720 px).
+   *  Source = templates/phase_z2/catalog/frame_contracts.yaml visual_hints.min_height_px.
+   *  Undefined when contract unregistered or visual_hints absent (frontend tolerates undefined). */
+  minHeightPx?: number;
+
+  // ─── IMP-05 L2 candidate_evidence fields (IMP-29 u1) ───────────────────────
+  // Source = src/phase_z2_pipeline.py lookup_v4_match_with_fallback() candidate_trace.
+  // All fields optional — pre-IMP-05 fixtures fall back to v4_all_judgments/v4_candidates
+  // (deterministic, no LLM) and silently leave these undefined.
+
+  /** Candidate rank in V4 chain (1-based; 1 = primary). */
+  rank?: number;
+  /** Figma frame node id (backend `frame_id`). Distinct from `id` (= template_id). */
+  frameId?: string;
+  /** Alias of `label`. Kept separate for Codex IMP-05 L2 schema parity. */
+  v4Label?: 'use_as_is' | 'light_edit' | 'restructure' | 'reject';
+  /** Phase Z status enum (e.g. "auto_renderable", "fallback_candidate"). Open vocabulary. */
+  phaseZStatus?: string;
+  /** T21.6 coverage-state contract for candidate UX. */
+  coverageState?: 'covered_native' | 'covered_via_expand' | 'requires_adaptation' | 'unsupported' | string;
+  /** Backend 3-status pool classification (auto/adaptation/blocked). */
+  candidateStatus?: string;
+  /** True when status is outside MVP1_ALLOWED_STATUSES (= excluded from direct render path). */
+  filteredForDirectExecution?: boolean;
+  /** Execution route mapped from `label` (direct_render / deterministic_minor_adjustment /
+   *  ai_adaptation_required / design_reference_only). Null on unknown labels. */
+  routeHint?: 'direct_render' | 'deterministic_minor_adjustment' | 'ai_adaptation_required' | 'design_reference_only' | null;
+  /** Selection outcome ("selected" or "skipped"). */
+  decision?: 'selected' | 'skipped';
+  /** Human-readable rationale (e.g. "primary_selected", "fallback_selected",
+   *  "duplicate_template_id", "skipped_no_contract", "capacity_mismatch:...",
+   *  "phase_z_status_not_allowed:..."). */
+  reason?: string | null;
+  /** Capacity vs. content shape audit (compute_capacity_fit output). */
+  capacityFit?: CapacityFitEvidence | null;
+
+  // ─── IMP-41 application_mode forwarding (issue #70 u1) ─────────────────────
+  // Source = src/phase_z2_pipeline.py APPLICATION_MODE_BY_V4_LABEL (:107-112),
+  // emitted by _application_candidates_for_unit() into Step 9
+  // unit.application_candidates[]. Optional — legacy fixtures pre-IMP-32 omit
+  // these and the FramePanel tooltip falls back to the raw V4 label.
+
+  /** Application mode mapped from V4 label by backend (authoritative). */
+  applicationMode?: 'direct_insert' | 'same_frame_with_adjustment' | 'layout_or_region_change' | 'exclude';
+  /** True when backend marks the candidate as automatically applicable. */
+  autoApplicable?: boolean;
+  /** Delegation target step / actor (e.g. "step10_contract_check", "human_review"). */
+  delegatedTo?: string | null;
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -145,6 +210,36 @@ export interface UserSelection {
     zone_sections: Record<string, string[]>; // zoneId -> sectionIds[]
     zone_sizes: Record<string, number[]>; // layoutGroupId -> [size1, size2, ...]
     zone_geometries: Record<string, { x: number; y: number; w: number; h: number }>; // zone_id -> geometry
+    // IMP-51 (#79) u11 — image_id → slide-absolute percent geometry (0–100
+    // on each axis). image_id is stamped by `src/image_id_stamper.py` (u4)
+    // on user-content `<img>` tags; the same key is consumed by the u7 CSS
+    // injector and the SlideCanvas u8 overlay. Shape mirrors the on-disk
+    // `image_overrides` axis (KNOWN_AXES, src/user_overrides_io.py u1) and
+    // the typed-client `ImageOverridesOverride` (services/userOverridesApi.ts u3).
+    image_overrides: Record<string, { x: number; y: number; w: number; h: number }>;
+    // IMP-55 (#93) u3 — bool intent marker gating whether the backend
+    // consumes persisted `zone_sections` as a user override. Set to `true`
+    // only by the real drag-drop path (Home.tsx handleSectionDrop, u6); set
+    // back to `false` by the layout apply/cancel auto-carry path (u5/u12).
+    // handleGenerate (u7) reads this flag to decide whether to forward
+    // `overrides.zoneSections` to the backend, replacing the pre-IMP-55
+    // self-compare against `effectiveSlidePlan`. Seeded `false` in
+    // `createInitialUserSelection` and only restored on reopen when the
+    // persisted value is a real boolean (slidePlanUtils.ts u3 layering).
+    // Mirrors the on-disk axis added in u1 — Python KNOWN_AXES
+    // (src/user_overrides_io.py), Vite KNOWN_USER_OVERRIDES_AXES
+    // (Front/vite.config.ts), and `ManualSectionAssignmentOverride`
+    // (services/userOverridesApi.ts).
+    manual_section_assignment: boolean;
+    // IMP-56 #90 u10/u15 — Step-22 text + structure persist axes. Mirrors
+    // services/userOverridesApi.ts (`TextOverridesOverride` /
+    // `StructureOverridesOverride`). `text_overrides[zoneId][textPath] = value`
+    // is fed by SlideCanvas u13 focusout capture + Home u15 autosave;
+    // `structure_overrides[zoneId] = {slot_order, hidden_slots}` is fed by
+    // u14 overlay + u15 autosave. Both seeded `{}` in createInitialUserSelection
+    // and restored on reopen via applyPersistedNonFrameOverrides.
+    text_overrides: Record<string, Record<string, string>>;
+    structure_overrides: Record<string, { slot_order?: string[]; hidden_slots?: string[] }>;
   };
 }
 

Front/client/src/utils/slidePlanUtils.ts

@@ -1,8 +1,304 @@
 import type { UserSelection, SlidePlan, Zone, InternalRegion, LayoutPresetId } from "../types/designAgent";
+import type {
+  StructureOverridePerZone,
+  StructureOverridesOverride,
+  TextOverridesOverride,
+  TextOverridesPerZone,
+  UserOverrides,
+} from "../services/userOverridesApi";
+import { computeZonePositions } from "../services/designAgentApi";
+
+// ?€?€?€ IMP-52 u6 ??restore-on-reopen helpers (pure, exported for testing) ?€?€?€?€
+// These helpers compose persisted `user_overrides.json` payloads (typed by
+// the u5 service) onto the in-memory `UserSelection`. They live here rather
+// than inline in Home.tsx so vitest can drive them in a node environment
+// without booting React or pulling in the radix-ui / lucide UI deps that
+// Home.tsx requires. Home.tsx wires these into:
+//   ??handleFileUpload (pre-Generate layout / zone_geometries / zone_sections
+//     seed so handleGenerate's CLI-args build picks them up)
+//   ??handleGenerate post-loadRun (frame remap unit_id ??region.id over the
+//     freshly built slidePlan)
+// The on-disk schema and clear-sentinel semantics are owned by:
+//   ??src/user_overrides_io.py (KNOWN_AXES, u1)
+//   ??Front/vite.config.ts mergeUserOverrides (u4)
+//   ??Front/client/src/services/userOverridesApi.ts (UserOverrides type, u5)
+// Any KNOWN_AXES drift must land in those files first.
 
 /**
- * Phase Z 초기 선택 상태 생성
+ * Derive the `/api/user-overrides/:key` MDX-stem key from a filename.
- * SlidePlan의 결과를 초기 값으로 사용 (Step 11까지의 결과 반영)
+ * Strips a trailing `.mdx` (case-insensitive). The key matches the Python
+ * `Path(args.mdx_path).stem` derivation used by the backend fallback (u2),
+ * so the same persisted file is read from both ends without translation.
+ */
+export function deriveUserOverridesKey(filename: string): string {
+  if (filename === "") return "";
+  const basename = filename.split(/[\\/]/).pop() ?? filename;
+  const noExt = basename.replace(/\.mdx$/i, "");
+  return noExt.replace(/[^A-Za-z0-9_.-]/g, "_");
+}
+
+export interface SubmittedPipelineOverridesForRestore {
+  layout?: string;
+  frames?: Record<string, string>;
+  zoneGeometries?: Record<string, ZoneGeometryValue>;
+  zoneSections?: Record<string, string[]>;
+}
+
+function _copyStringMap(raw: unknown): Record<string, string> | undefined {
+  if (!_isPlainObject(raw)) return undefined;
+  const out: Record<string, string> = {};
+  for (const [k, v] of Object.entries(raw)) {
+    if (k && typeof v === "string" && v.length > 0) out[k] = v;
+  }
+  return Object.keys(out).length > 0 ? out : undefined;
+}
+
+function _copyZoneSections(raw: unknown): Record<string, string[]> | undefined {
+  if (!_isPlainObject(raw)) return undefined;
+  const out: Record<string, string[]> = {};
+  for (const [zoneId, sids] of Object.entries(raw)) {
+    if (!zoneId || !Array.isArray(sids)) continue;
+    const cleaned = sids.filter((sid) => typeof sid === "string" && sid.trim());
+    if (cleaned.length > 0) out[zoneId] = cleaned;
+  }
+  return Object.keys(out).length > 0 ? out : undefined;
+}
+
+function _copyZoneGeometries(raw: unknown): Record<string, ZoneGeometryValue> | undefined {
+  if (!_isPlainObject(raw)) return undefined;
+  const out: Record<string, ZoneGeometryValue> = {};
+  for (const [zoneId, geom] of Object.entries(raw)) {
+    if (!zoneId || !_isPlainObject(geom)) continue;
+    const { x, y, w, h } = geom;
+    if (
+      typeof x === "number" &&
+      typeof y === "number" &&
+      typeof w === "number" &&
+      typeof h === "number"
+    ) {
+      out[zoneId] = { x, y, w, h };
+    }
+  }
+  return Object.keys(out).length > 0 ? out : undefined;
+}
+
+/**
+ * Build the post-run restore document from the latest persisted payload plus
+ * the exact override payload submitted to `/api/run`.
+ *
+ * The generated HTML is driven by the submitted override payload, so the
+ * frontend state rebuilt after `loadRun()` must prefer that same payload over
+ * any stale layout/frame/zone axes that were read at file-upload time. Other
+ * persisted axes (text/image/structure edits) are preserved.
+ */
+export function mergeSubmittedPipelineOverridesForRestore(
+  persisted: Partial<UserOverrides> | null | undefined,
+  submitted: SubmittedPipelineOverridesForRestore | null | undefined,
+  manualSectionAssignment: boolean,
+): Partial<UserOverrides> {
+  const next: Partial<UserOverrides> = { ...(persisted ?? {}) };
+
+  // These axes are owned by the current Generate payload. Clear stale values
+  // first so an older user_overrides file cannot reappear in the UI after a
+  // successful render with a different explicit override.
+  delete next.layout;
+  delete next.frames;
+  delete next.zone_geometries;
+  delete next.zone_sections;
+  next.manual_section_assignment = false;
+
+  if (!submitted || typeof submitted !== "object") return next;
+
+  if (typeof submitted.layout === "string" && submitted.layout.length > 0) {
+    next.layout = submitted.layout;
+  }
+
+  const frames = _copyStringMap(submitted.frames);
+  if (frames) next.frames = frames;
+
+  const zoneGeometries = _copyZoneGeometries(submitted.zoneGeometries);
+  if (zoneGeometries) next.zone_geometries = zoneGeometries;
+
+  if (manualSectionAssignment === true) {
+    const zoneSections = _copyZoneSections(submitted.zoneSections);
+    next.zone_sections = zoneSections ?? {};
+    next.manual_section_assignment = true;
+  }
+
+  return next;
+}
+
+const LAYOUT_PRESET_IDS = new Set<string>([
+  "single",
+  "horizontal-2",
+  "vertical-2",
+  "top-1-bottom-2",
+  "top-2-bottom-1",
+  "left-1-right-2",
+  "left-2-right-1",
+  "grid-2x2",
+]);
+
+/**
+ * Layer the three non-frame axes from a persisted `user_overrides.json`
+ * payload onto an existing `UserSelection`. Foreign / unrecognized payload
+ * shapes are silently ignored ??the u5 GET path already returns `{}` on
+ * corrupt files, but we revalidate here so hand-edited files or future
+ * forward-compat axes cannot poison the in-memory state.
+ *
+ * Frames are NOT layered here because the on-disk key (`unit_id` =
+ * section_ids joined by `+`) only resolves after the slidePlan zones are
+ * known. Use `remapPersistedFramesToZoneFrames` in the post-loadRun step.
+ */
+export function applyPersistedNonFrameOverrides(
+  selection: UserSelection,
+  persisted: Partial<UserOverrides> | null | undefined,
+): UserSelection {
+  if (!persisted || typeof persisted !== "object") return selection;
+  const next = { ...selection.overrides };
+  if (typeof persisted.layout === "string" && LAYOUT_PRESET_IDS.has(persisted.layout)) {
+    next.layout_preset = persisted.layout as LayoutPresetId;
+  }
+  if (
+    persisted.zone_geometries &&
+    typeof persisted.zone_geometries === "object" &&
+    !Array.isArray(persisted.zone_geometries)
+  ) {
+    next.zone_geometries = { ...persisted.zone_geometries };
+  }
+  if (
+    persisted.zone_sections &&
+    typeof persisted.zone_sections === "object" &&
+    !Array.isArray(persisted.zone_sections)
+  ) {
+    next.zone_sections = { ...persisted.zone_sections };
+  }
+  // IMP-51 (#79) u11 ??layer the 5th persisted axis (`image_overrides`) by
+  // the same array / non-object guard the zone_geometries branch uses. The
+  // u3 typed client (services/userOverridesApi.ts) shape and the on-disk
+  // KNOWN_AXES entry (src/user_overrides_io.py u1) are both flat dicts
+  // (image_id ??{x,y,w,h} percent-of-slide), so a shallow copy is enough.
+  if (
+    persisted.image_overrides &&
+    typeof persisted.image_overrides === "object" &&
+    !Array.isArray(persisted.image_overrides)
+  ) {
+    next.image_overrides = { ...persisted.image_overrides };
+  }
+  // IMP-55 (#93) u3 ??restore the bool intent marker only when the persisted
+  // value is a real `boolean`. A missing axis, `null` (the u4 clear sentinel
+  // observed post-flush), or any non-boolean shape (string "true", 1, {})
+  // intentionally falls through to the `createInitialUserSelection` seed of
+  // `false`. This is the fail-closed half of the marker contract: the
+  // backend pipeline (u9) consumes persisted `zone_sections` only when
+  // `manual_section_assignment is True`, so anything other than a real
+  // `true` MUST end up as `false` in memory to avoid resurrecting stale
+  // auto-carry assignments as user intent. Both `true` and `false` are
+  // restored verbatim (the explicit `false` from u12's apply/cancel write
+  // is meaningful ??it pins the marker off across reopens).
+  if (typeof persisted.manual_section_assignment === "boolean") {
+    next.manual_section_assignment = persisted.manual_section_assignment;
+  }
+  // IMP-56 (#90) u15 ??layer the two Step-22 persist axes through the
+  // u10 extract helpers; their `_isPlainObject` + dedupe gates already
+  // sanitize foreign / hand-edited payloads, so reopen never poisons
+  // memory with non-string values or non-list slot_order entries.
+  next.text_overrides = extractPersistedTextOverrides(persisted);
+  next.structure_overrides = extractPersistedStructureOverrides(persisted);
+  return { ...selection, overrides: next };
+}
+
+// ?€?€?€ IMP-56 #90 u10 ??typed extract helpers for the two new persist axes ?€?€?€
+// Pure helpers that defensively sanitize Step-22 text_overrides and
+// structure_overrides payloads off a `Partial<UserOverrides>` (typed by u10's
+// userOverridesApi extension). They mirror the backend validation gates
+// (`text_override_resolver` u4 / `structure_override_resolver` u6) on the
+// frontend so a hand-edited or schema-drift payload cannot poison memory.
+// Layering onto `UserSelection.overrides` arrives in u14~u16; until then
+// capture / autosave / restore wiring units consume these as typed.
+
+function _isPlainObject(x: unknown): x is Record<string, unknown> {
+  return !!x && typeof x === "object" && !Array.isArray(x);
+}
+
+function _dedupeStringList(arr: unknown): string[] {
+  if (!Array.isArray(arr)) return [];
+  const seen = new Set<string>();
+  const out: string[] = [];
+  for (const k of arr) {
+    if (typeof k === "string" && k.length > 0 && !seen.has(k)) {
+      seen.add(k);
+      out.push(k);
+    }
+  }
+  return out;
+}
+
+export function extractPersistedTextOverrides(
+  persisted: Partial<UserOverrides> | null | undefined,
+): TextOverridesOverride {
+  const raw = persisted?.text_overrides;
+  if (!_isPlainObject(raw)) return {};
+  const out: TextOverridesOverride = {};
+  for (const [zoneId, perZone] of Object.entries(raw)) {
+    if (!zoneId || !_isPlainObject(perZone)) continue;
+    const safe: TextOverridesPerZone = {};
+    for (const [textPath, value] of Object.entries(perZone)) {
+      if (textPath && typeof value === "string") safe[textPath] = value;
+    }
+    out[zoneId] = safe;
+  }
+  return out;
+}
+
+export function extractPersistedStructureOverrides(
+  persisted: Partial<UserOverrides> | null | undefined,
+): StructureOverridesOverride {
+  const raw = persisted?.structure_overrides;
+  if (!_isPlainObject(raw)) return {};
+  const out: StructureOverridesOverride = {};
+  for (const [zoneId, perZone] of Object.entries(raw)) {
+    if (!zoneId || !_isPlainObject(perZone)) continue;
+    const safe: StructureOverridePerZone = {};
+    if (Array.isArray(perZone.slot_order)) safe.slot_order = _dedupeStringList(perZone.slot_order);
+    if (Array.isArray(perZone.hidden_slots)) safe.hidden_slots = _dedupeStringList(perZone.hidden_slots);
+    out[zoneId] = safe;
+  }
+  return out;
+}
+
+/**
+ * Remap persisted frames (`unit_id` ??template_id) to the in-memory
+ * `zone_frames` (region.id ??template_id) using the freshly built
+ * slidePlan zones. `unit_id` follows handleGenerate's convention:
+ * `zone.section_ids.join("+")`. Persisted entries whose unit_id no longer
+ * matches any zone (e.g. user changed zone_sections between sessions) are
+ * silently dropped.
+ */
+export function remapPersistedFramesToZoneFrames(
+  slidePlan: SlidePlan | null | undefined,
+  framesByUnitId: Record<string, string> | null | undefined,
+): Record<string, string> {
+  if (!slidePlan || !framesByUnitId || typeof framesByUnitId !== "object") {
+    return {};
+  }
+  const out: Record<string, string> = {};
+  for (const zone of slidePlan.zones) {
+    const region = zone.internal_regions[0];
+    if (!region) continue;
+    if (!Array.isArray(zone.section_ids) || zone.section_ids.length === 0) continue;
+    const unitId = zone.section_ids.join("+");
+    const templateId = framesByUnitId[unitId];
+    if (typeof templateId === "string" && templateId.length > 0) {
+      out[region.id] = templateId;
+    }
+  }
+  return out;
+}
+
+/**
+ * Phase Z 珥덇린 ?좏깮 ?곹깭 ?앹꽦
+ * SlidePlan??寃곌낵瑜?珥덇린 媛믪쑝濡??ъ슜 (Step 11源뚯???寃곌낵 諛섏쁺)
  */
 export function createInitialUserSelection(slidePlan?: SlidePlan | null): UserSelection {
   const initialSections: Record<string, string[]> = {};
@@ -10,16 +306,16 @@ export function createInitialUserSelection(slidePlan?: SlidePlan | null): UserSe
 
   if (slidePlan) {
     slidePlan.zones.forEach(zone => {
-      // 1. 모든 섹션을 각자의 지정된 존에 할당 (초안 배치)
+      // 1. 紐⑤뱺 ?뱀뀡??媛곸옄??吏€?뺣맂 議댁뿉 ?좊떦 (珥덉븞 諛곗튂)
       initialSections[zone.zone_id] = [...zone.section_ids];
 
-      // 2. 각 리전의 기본 frame.
+      // 2. 媛?由ъ쟾??湲곕낯 frame.
-      // 2026-05-14 — backend frame_match_strategy.frame_id 가 있을 때만 init.
+      // 2026-05-14 ??backend frame_match_strategy.frame_id 媛€ ?덉쓣 ?뚮쭔 init.
-      //   null 인 경우 (backend current_default_candidate=None 등) frame_candidates[0]
+      //   null ??寃쎌슦 (backend current_default_candidate=None ?? frame_candidates[0]
-      //   로 자동 채우지 않음 → SlideCanvas 의 preview overlay 트리거 조건
+      //   濡??먮룞 梨꾩슦吏€ ?딆쓬 ??SlideCanvas ??preview overlay ?몃━嫄?議곌굔
-      //   (override !== default) 안 발동. 사용자가 직접 frame 클릭해야 preview 보임.
+      //   (override !== default) ??諛쒕룞. ?ъ슜?먭? 吏곸젒 frame ?대┃?댁빞 preview 蹂댁엫.
-      //   배경 : 04-1 같은 case 에서 backend selection_path=rank_1 (env toggle 통과)
+      //   諛곌꼍 : 04-1 媛숈? case ?먯꽌 backend selection_path=rank_1 (env toggle ?듦낵)
-      //   이어도 current_default=None 이면 default 와 override mismatch 로 preview 강제 발동.
+      //   ?댁뼱??current_default=None ?대㈃ default ?€ override mismatch 濡?preview 媛뺤젣 諛쒕룞.
       zone.internal_regions.forEach(region => {
         const topFrameId = region.frame_match_strategy.frame_id;
         if (topFrameId) {
@@ -39,6 +335,24 @@ export function createInitialUserSelection(slidePlan?: SlidePlan | null): UserSe
       zone_sections: initialSections,
       zone_sizes: {},
       zone_geometries: {},
+      // IMP-51 (#79) u11 ??image_overrides axis starts empty; entries land
+      // here via `saveImageOverride` (SlideCanvas drag/resize handler) and
+      // are seeded on reopen via `applyPersistedNonFrameOverrides`.
+      image_overrides: {},
+      // IMP-56 (#90) u15 ??Step-22 axes seeded empty. Entries land here
+      // via `saveTextOverride` (u13 focusout capture) and
+      // `saveStructureOverride` (u14 overlay) and are restored on reopen
+      // via `applyPersistedNonFrameOverrides`.
+      text_overrides: {},
+      structure_overrides: {},
+      // IMP-55 (#93) u3 ??bool intent marker seeded `false` so a fresh
+      // MDX open (no persisted file, or persisted file with axis absent)
+      // never forwards `overrides.zoneSections` to the backend. The marker
+      // flips to `true` only via the real drag-drop path (Home.tsx u6) and
+      // is reset to `false` by layout apply/cancel auto-carry (u5/u12).
+      // `applyPersistedNonFrameOverrides` may restore a persisted boolean
+      // verbatim on reopen ??see the bool-only guard there.
+      manual_section_assignment: false,
     },
   };
 }
@@ -60,6 +374,86 @@ export function saveZoneGeometry(
   };
 }
 
+/**
+ * IMP-51 (#79) u11 ??record a single `image_id` ??slide-absolute percent
+ * geometry on the in-memory selection. Mirrors `saveZoneGeometry` but on
+ * the 5th persisted axis (`image_overrides`); the SlideCanvas drag/resize
+ * handler (u8) emits one entry per pointer move, and u10's Home wiring
+ * funnels each emit through this helper before scheduling the debounced
+ * PUT. Pure / immutable ??returns a fresh `UserSelection`; the input is
+ * never mutated. Existing entries for the same `imageId` are replaced.
+ */
+export function saveImageOverride(
+  selection: UserSelection,
+  imageId: string,
+  geometry: { x: number; y: number; w: number; h: number },
+): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      image_overrides: {
+        ...selection.overrides.image_overrides,
+        [imageId]: geometry,
+      },
+    },
+  };
+}
+
+/**
+ * IMP-56 (#90) u15 ??record a single text-line capture (zone_id, text_path,
+ * value) onto the in-memory selection's `text_overrides` axis. Mirrors
+ * `saveImageOverride` (pure / immutable). u13's focusout capture emits one
+ * entry per finished edit; Home u15's handler funnels each emit through this
+ * helper before scheduling the debounced PUT (`saveUserOverrides` 300ms).
+ */
+export function saveTextOverride(
+  selection: UserSelection,
+  zoneId: string,
+  textPath: string,
+  value: string,
+): UserSelection {
+  const prevZone = selection.overrides.text_overrides[zoneId] ?? {};
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      text_overrides: {
+        ...selection.overrides.text_overrides,
+        [zoneId]: { ...prevZone, [textPath]: value },
+      },
+    },
+  };
+}
+
+/**
+ * IMP-56 (#90) u15 ??record a single structure capture (zone_id ??
+ * {slot_order, hidden_slots}) onto the in-memory selection's
+ * `structure_overrides` axis. Scope-locked to slot reorder + hide (frame
+ * swap stays on the `frames` axis). u14's overlay emits one entry per
+ * user mutation; Home u15's handler funnels each emit through this
+ * helper before scheduling the debounced PUT.
+ */
+export function saveStructureOverride(
+  selection: UserSelection,
+  zoneId: string,
+  perZone: StructureOverridePerZone,
+): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      structure_overrides: {
+        ...selection.overrides.structure_overrides,
+        [zoneId]: {
+          ...(perZone.slot_order !== undefined && { slot_order: [...perZone.slot_order] }),
+          ...(perZone.hidden_slots !== undefined && { hidden_slots: [...perZone.hidden_slots] }),
+        },
+      },
+    },
+  };
+}
+
 export function saveZoneSizes(selection: UserSelection, groupId: string, sizes: number[]): UserSelection {
   return {
     ...selection,
@@ -74,7 +468,7 @@ export function saveZoneSizes(selection: UserSelection, groupId: string, sizes:
 }
 
 /**
- * 특정 섹션을 새로운 존으로 이동 (Drag & Drop)
+ * ?뱀젙 ?뱀뀡???덈줈??議댁쑝濡??대룞 (Drag & Drop)
  */
 export function moveSectionToZone(
   selection: UserSelection, 
@@ -83,12 +477,12 @@ export function moveSectionToZone(
 ): UserSelection {
   const newZoneSections = { ...selection.overrides.zone_sections };
   
-  // 1. 모든 존에서 해당 섹션 제거 (이동 전 위치 클리어)
+  // 1. 紐⑤뱺 議댁뿉???대떦 ?뱀뀡 ?쒓굅 (?대룞 ???꾩튂 ?대━??
   Object.keys(newZoneSections).forEach(zid => {
     newZoneSections[zid] = newZoneSections[zid].filter(id => id !== sectionId);
   });
 
-  // 2. 타겟 존에 섹션 추가
+  // 2. ?€寃?議댁뿉 ?뱀뀡 異붽?
   if (!newZoneSections[targetZoneId]) {
     newZoneSections[targetZoneId] = [];
   }
@@ -109,7 +503,7 @@ export function selectZone(selection: UserSelection, zoneId: string | null): Use
   return {
     ...selection,
     selectedZoneId: zoneId,
-    selectedRegionId: null, // Zone이 바뀌면 Region 선택 해제
+    selectedRegionId: null, // Zone??諛붾€뚮㈃ Region ?좏깮 ?댁젣
   };
 }
 
@@ -144,16 +538,16 @@ export function applyFrame(selection: UserSelection, regionId: string, frameId:
 }
 
 /**
- * 현재 선택된 Zone 객체 반환
+ * ?꾩옱 ?좏깮??Zone 媛앹껜 諛섑솚
  */
 export function getSelectedZone(slidePlan: SlidePlan | null, selection: UserSelection): Zone | null {
   if (!slidePlan || !selection.selectedZoneId) return null;
-  // id 또는 zone_id 매칭
+  // id ?먮뒗 zone_id 留ㅼ묶
   return slidePlan.zones.find(z => z.id === selection.selectedZoneId || z.zone_id === selection.selectedZoneId) || null;
 }
 
 /**
- * 현재 선택된 Region 객체 반환
+ * ?꾩옱 ?좏깮??Region 媛앹껜 諛섑솚
  */
 export function getSelectedRegion(zone: Zone | null, selection: UserSelection): InternalRegion | null {
   if (!zone || !selection.selectedRegionId) return null;
@@ -161,16 +555,90 @@ export function getSelectedRegion(zone: Zone | null, selection: UserSelection):
 }
 
 /**
- * 특정 Zone에 할당된 섹션 ID 목록 반환 (오버라이드 우선)
+ * ?뱀젙 Zone???좊떦???뱀뀡 ID 紐⑸줉 諛섑솚 (?ㅻ쾭?쇱씠???곗꽑)
  */
 export function getSectionsForZone(zone: Zone, selection: UserSelection): string[] {
   return selection.overrides.zone_sections[zone.zone_id] || zone.section_ids;
 }
 
 /**
- * 최종 유효 레이아웃 ID 반환
+ * 理쒖쥌 ?좏슚 ?덉씠?꾩썐 ID 諛섑솚
  */
 export function getEffectiveLayoutId(slidePlan: SlidePlan | null, selection: UserSelection): LayoutPresetId {
   if (selection.overrides.layout_preset) return selection.overrides.layout_preset;
   return slidePlan?.layout_preset || 'single';
 }
+
+// ?€?€?€ IMP-44 (#73) u3 ??zone_geometries layout-mismatch validation ?€?€?€?€?€?€?€?€?€?€?€
+// Pure helper paired with the backend [override-warning] guards added in u1
+// (1-D horizontal-2 / vertical-2 branches of `build_layout_css`) and u2 (2-D
+// `_override_to_grid_tracks` call site). Same WARN+DROP / KEEP-known contract,
+// but expressed on the frontend so handleGenerate (u4) can validate against
+// the active layout *before* forwarding and surface a toast on dropped keys.
+//
+// Source of truth for expected positions = `computeZonePositions(layoutPreset)`
+// (designAgentApi.ts), which mirrors backend `layouts.yaml` (positions field).
+// Unknown layout (null / undefined / not in LAYOUT_PRESET_IDS) ??fail-safe
+// drop-all: caller has no contract for projecting geometries onto an unknown
+// preset, so we keep zero keys rather than passing them through verbatim.
+
+export interface ZoneGeometryValue {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+
+export interface ZoneGeometriesValidationResult {
+  kept: Record<string, ZoneGeometryValue>;
+  dropped: Record<string, ZoneGeometryValue>;
+  expectedPositions: string[];
+  valid: boolean;
+}
+
+export function validateZoneGeometriesAgainstLayout(
+  geoms: Record<string, ZoneGeometryValue> | null | undefined,
+  layoutPreset: LayoutPresetId | string | null | undefined,
+): ZoneGeometriesValidationResult {
+  const kept: Record<string, ZoneGeometryValue> = {};
+  const dropped: Record<string, ZoneGeometryValue> = {};
+  const safeGeoms =
+    geoms && typeof geoms === "object" && !Array.isArray(geoms) ? geoms : null;
+
+  // Unknown-layout fail-safe ??drop everything; no expected positions known.
+  if (typeof layoutPreset !== "string" || !LAYOUT_PRESET_IDS.has(layoutPreset)) {
+    if (safeGeoms) {
+      for (const [k, v] of Object.entries(safeGeoms)) {
+        dropped[k] = v;
+      }
+    }
+    return {
+      kept,
+      dropped,
+      expectedPositions: [],
+      valid: Object.keys(dropped).length === 0,
+    };
+  }
+
+  const expectedPositions = computeZonePositions(
+    layoutPreset as LayoutPresetId,
+  ).map((p) => p.name);
+  const expectedSet = new Set(expectedPositions);
+
+  if (safeGeoms) {
+    for (const [k, v] of Object.entries(safeGeoms)) {
+      if (expectedSet.has(k)) {
+        kept[k] = v;
+      } else {
+        dropped[k] = v;
+      }
+    }
+  }
+
+  return {
+    kept,
+    dropped,
+    expectedPositions,
+    valid: Object.keys(dropped).length === 0,
+  };
+}

Front/client/tests/frame_candidate_merge.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { buildFrameCandidatesForUnit } from "../src/services/designAgentApi";
+
+describe("buildFrameCandidatesForUnit (#98 Task 2)", () => {
+  it("merges sorted evidence, v4 candidates, all judgments, and app candidates up to six", () => {
+    const unit = {
+      unit_id: "03-1",
+      current_default_candidate: "frame_a",
+      sorted_candidate_evidence: [
+        { template_id: "frame_a", frame_number: 1, label: "use_as_is", confidence: 0.9, rank: 1, coverage_state: "covered_native", candidate_status: "auto_renderable" },
+      ],
+      v4_candidates: [
+        { template_id: "frame_b", frame_number: 2, label: "light_edit", confidence: 0.8 },
+      ],
+      v4_all_judgments: [
+        { template_id: "frame_c", frame_number: 3, label: "reject", confidence: 0.7, coverage_state: "requires_adaptation", candidate_status: "ai_adaptation_required" },
+        { template_id: "frame_d", frame_number: 4, label: "reject", confidence: 0.6 },
+        { template_id: "frame_e", frame_number: 5, label: "reject", confidence: 0.5 },
+        { template_id: "frame_f", frame_number: 6, label: "reject", confidence: 0.4 },
+        { template_id: "frame_g", frame_number: 7, label: "reject", confidence: 0.3 },
+      ],
+      application_candidates: [
+        { template_id: "frame_b", application_mode: "same_frame_with_adjustment", auto_applicable: true },
+      ],
+    };
+
+    const candidates = buildFrameCandidatesForUnit(unit);
+    expect(candidates.map((c) => c.id)).toEqual([
+      "frame_a",
+      "frame_b",
+      "frame_c",
+      "frame_d",
+      "frame_e",
+      "frame_f",
+    ]);
+    expect(candidates).toHaveLength(6);
+    expect(candidates[1].applicationMode).toBe("same_frame_with_adjustment");
+    expect(candidates[0].coverageState).toBe("covered_native");
+    expect(candidates[2].coverageState).toBe("requires_adaptation");
+    expect(candidates[2].candidateStatus).toBe("ai_adaptation_required");
+  });
+
+  it("surfaces generic fallback from composition when Step 9 has no V4 sources", () => {
+    const unit = {
+      unit_id: "05-1+05-2",
+      current_default_candidate: null,
+      sorted_candidate_evidence: [],
+      candidate_evidence: [],
+      v4_candidates: [],
+      v4_all_judgments: [],
+      application_candidates: [],
+    };
+    const compositionUnit = {
+      source_section_ids: ["05-1", "05-2"],
+      frame_template_id: "three_parallel_requirements",
+      frame_id: "1171281190",
+      label: "reject",
+      score: 0,
+      phase_z_status: "fallback_candidate",
+      selection_path: "generic_fallback",
+      rationale: { ai_adaptation_required: true },
+    };
+
+    const candidates = buildFrameCandidatesForUnit(unit, compositionUnit);
+    expect(candidates).toHaveLength(1);
+    expect(candidates[0]).toMatchObject({
+      id: "three_parallel_requirements",
+      label: "reject",
+      coverageState: "requires_adaptation",
+      routeHint: "ai_adaptation_required",
+      decision: "selected",
+      reason: "generic_fallback",
+    });
+  });
+});

Front/client/tests/handle_generate_diag.test.ts

@@ -0,0 +1,117 @@
+// IMP-42 u4 — Source-slice coverage for the unconditional handleGenerate
+// DIAG console.log on the frontend → backend boundary (issue #71).
+//
+// Scope (Stage 2 unit u4 contract):
+//   1) A single `console.log("[DIAG raw overrides]", ...)` call exists
+//      inside handleGenerate and precedes the runPipeline call site.
+//   2) The DIAG call is unconditional — not wrapped in `if (...)` / `?:` /
+//      env-var gate / `__DEV__`-style guard. "Silence is the bug" per
+//      Stage 1 scope-lock (Codex #3) and the Step 13 backend mirror
+//      already landed in u3.
+//   3) The DIAG payload carries shape-only metadata — uploaded file name
+//      and the override payload object — without referencing raw MDX
+//      content or any other sample-specific identifier (RULE 0).
+//
+// Why source-slice (per Stage 2 plan): Home.tsx handleGenerate is wired to
+// React state, toast, and a 700-line component tree; the cheapest way to
+// pin a single-line surface and prove placement relative to runPipeline is
+// to read the source and assert ordering. No React rendering, no fetch
+// mock, no DOM. Mirrors the existing pure-helper pattern in
+// tests/imp41_application_mode.test.ts.
+
+import { describe, it, expect } from "vitest";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+const HOME_TSX_PATH = resolve(__dirname, "..", "src", "pages", "Home.tsx");
+const HOME_TSX_SOURCE = readFileSync(HOME_TSX_PATH, "utf-8");
+
+// Locate the handleGenerate callback body. The closing brace of
+// useCallback's `async () => { ... }` is the next line whose indent matches
+// the opening `useCallback(async () => {` exactly — but a simpler proxy is
+// "from the handleGenerate keyword to the next useCallback declaration or
+// the end-of-file." This is sufficient to scope every assertion below to
+// the right function body.
+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 in Home.tsx");
+  }
+  // End at the next top-level `const ` that begins a new useCallback /
+  // useMemo / hook binding. handleGenerate is followed by additional
+  // hooks (handleFileUpload sibling pattern); slicing to the next
+  // declaration is more than enough to capture the full body.
+  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_SOURCE);
+
+describe("handleGenerate [DIAG raw overrides] (IMP-42 u4)", () => {
+  it("emits exactly one console.log labelled '[DIAG raw overrides]' inside handleGenerate", () => {
+    const matches = HANDLE_GENERATE_BODY.match(
+      /console\.log\(\s*"\[DIAG raw overrides\]"/g,
+    );
+    expect(matches).not.toBeNull();
+    // Exactly one DIAG site per Stage 2 contract — multiple calls would
+    // either be a copy-paste regression or evidence that the helper
+    // moved without removing the old site.
+    expect(matches?.length).toBe(1);
+  });
+
+  it("places the DIAG console.log before the runPipeline call site", () => {
+    const diagIdx = HANDLE_GENERATE_BODY.indexOf('console.log("[DIAG raw overrides]"');
+    const runPipelineIdx = HANDLE_GENERATE_BODY.indexOf(
+      "runPipeline(",
+    );
+    expect(diagIdx).toBeGreaterThan(-1);
+    expect(runPipelineIdx).toBeGreaterThan(-1);
+    expect(diagIdx).toBeLessThan(runPipelineIdx);
+  });
+
+  it("is unconditional — no env-var gate or if-guard wraps the DIAG call", () => {
+    // Slice the 80 chars immediately preceding the DIAG console.log and
+    // confirm none of the common gating patterns appear directly above.
+    const diagIdx = HANDLE_GENERATE_BODY.indexOf('console.log("[DIAG raw overrides]"');
+    const preface = HANDLE_GENERATE_BODY.slice(Math.max(0, diagIdx - 200), diagIdx);
+    // Stage 1 contract: silence is the bug. Any gate here is a regression.
+    expect(preface).not.toMatch(/if\s*\([^)]*\)\s*$/m);
+    expect(preface).not.toMatch(/process\.env/);
+    expect(preface).not.toMatch(/import\.meta\.env/);
+    expect(preface).not.toMatch(/__DEV__/);
+    expect(preface).not.toMatch(/DIAG_VERBOSE/i);
+    expect(preface).not.toMatch(/DEBUG/);
+  });
+
+  it("forwards the file name and overrides object as shape-only payload", () => {
+    // The DIAG payload must include the uploaded file name (so the user
+    // can correlate the log line with the MDX they uploaded) and the
+    // overrides object (so the user can see what crossed the wire).
+    // It must NOT spread MDX text content or any other large blob —
+    // sample-agnostic and reviewable in a single log line.
+    const diagIdx = HANDLE_GENERATE_BODY.indexOf('console.log("[DIAG raw overrides]"');
+    const window = HANDLE_GENERATE_BODY.slice(diagIdx, diagIdx + 300);
+    // Both fields appear in the payload object literal.
+    expect(window).toMatch(/file:\s*state\.uploadedFile\.name/);
+    expect(window).toMatch(/\boverrides\b/);
+    // Sanity: the payload does not pass MDX raw content / a File blob.
+    expect(window).not.toMatch(/mdxContent|rawMdx|normalizedContent/);
+  });
+
+  it("runs after flushUserOverrides() so the persisted PUT is already committed", () => {
+    // Ordering invariant from IMP-52 u10 (already in place):
+    //   flushUserOverrides() → DIAG → runPipeline
+    // Asserts the DIAG sits between the flush and the network call so the
+    // logged overrides match what backend reads from disk.
+    const flushIdx = HANDLE_GENERATE_BODY.indexOf("await flushUserOverrides()");
+    const diagIdx = HANDLE_GENERATE_BODY.indexOf('console.log("[DIAG raw overrides]"');
+    const runPipelineIdx = HANDLE_GENERATE_BODY.indexOf(
+      "runPipeline(",
+    );
+    expect(flushIdx).toBeGreaterThan(-1);
+    expect(diagIdx).toBeGreaterThan(flushIdx);
+    expect(diagIdx).toBeLessThan(runPipelineIdx);
+  });
+});

Front/client/tests/imp41_application_mode.test.ts

@@ -0,0 +1,123 @@
+// IMP-41 u3 — Vitest coverage for application_mode helper (issue #70).
+//
+// Scope (Stage 2 unit u3 contract):
+//   1) buildBadgeTitle: composite output for each known mode + legacy fallback
+//      (undefined applicationMode) + unknown fallback (string not in
+//      APPLICATION_MODE_TOOLTIP_KR).
+//   2) mergeApplicationCandidates: array → Map<template_id, candidate>
+//      semantics, including skip-missing-key and empty-input.
+//
+// Pure helper unit test — no React, no DOM, no fetch. Aligns with the
+// AI-isolation contract: assertions key by backend application_mode VALUE,
+// never by V4 label.
+
+import { describe, it, expect } from "vitest";
+import {
+  buildBadgeTitle,
+  mergeApplicationCandidates,
+  APPLICATION_MODE_TOOLTIP_KR,
+} from "../src/services/applicationMode";
+
+describe("buildBadgeTitle (IMP-41 u3)", () => {
+  it("returns composite '<consequence> (<mode>)' for direct_insert", () => {
+    expect(buildBadgeTitle("use_as_is", "direct_insert")).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.direct_insert} (direct_insert)`,
+    );
+  });
+
+  it("returns composite output for same_frame_with_adjustment", () => {
+    expect(
+      buildBadgeTitle("light_edit", "same_frame_with_adjustment"),
+    ).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.same_frame_with_adjustment} (same_frame_with_adjustment)`,
+    );
+  });
+
+  it("returns composite output for layout_or_region_change", () => {
+    expect(
+      buildBadgeTitle("restructure", "layout_or_region_change"),
+    ).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.layout_or_region_change} (layout_or_region_change)`,
+    );
+  });
+
+  it("returns composite output for exclude", () => {
+    expect(buildBadgeTitle("reject", "exclude")).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.exclude} (exclude)`,
+    );
+  });
+
+  it("falls back to 'V4 label: <label>' when applicationMode is undefined (legacy fixtures pre-IMP-32)", () => {
+    expect(buildBadgeTitle("use_as_is", undefined)).toBe("V4 label: use_as_is");
+  });
+
+  it("falls back to 'V4 label: <label>' when applicationMode is an unknown string", () => {
+    expect(buildBadgeTitle("light_edit", "some_future_mode")).toBe(
+      "V4 label: light_edit",
+    );
+  });
+});
+
+describe("mergeApplicationCandidates (IMP-41 u3)", () => {
+  it("returns empty Map when input is undefined", () => {
+    const result = mergeApplicationCandidates(undefined);
+    expect(result).toBeInstanceOf(Map);
+    expect(result.size).toBe(0);
+  });
+
+  it("returns empty Map when input is null", () => {
+    const result = mergeApplicationCandidates(null);
+    expect(result.size).toBe(0);
+  });
+
+  it("returns empty Map when input is not an array", () => {
+    expect(mergeApplicationCandidates({ template_id: "f01" }).size).toBe(0);
+    expect(mergeApplicationCandidates("f01").size).toBe(0);
+    expect(mergeApplicationCandidates(42).size).toBe(0);
+  });
+
+  it("returns empty Map when input is an empty array", () => {
+    expect(mergeApplicationCandidates([]).size).toBe(0);
+  });
+
+  it("keys entries by template_id and preserves the candidate payload", () => {
+    const ac1 = {
+      template_id: "f01",
+      label: "use_as_is",
+      application_mode: "direct_insert",
+      auto_applicable: true,
+      delegated_to: null,
+    };
+    const ac2 = {
+      template_id: "f17",
+      label: "light_edit",
+      application_mode: "same_frame_with_adjustment",
+      auto_applicable: false,
+      delegated_to: "step10_contract_check",
+    };
+    const result = mergeApplicationCandidates([ac1, ac2]);
+    expect(result.size).toBe(2);
+    expect(result.get("f01")).toBe(ac1);
+    expect(result.get("f17")).toBe(ac2);
+  });
+
+  it("skips entries with missing or non-string template_id", () => {
+    const result = mergeApplicationCandidates([
+      { label: "use_as_is" }, // missing template_id
+      { template_id: "", label: "light_edit" }, // empty string
+      { template_id: 17, label: "restructure" }, // non-string
+      { template_id: "f29", label: "reject" }, // valid
+    ]);
+    expect(result.size).toBe(1);
+    expect(result.has("f29")).toBe(true);
+    expect(result.has("")).toBe(false);
+  });
+
+  it("keeps the first occurrence on duplicate template_id keys (deterministic)", () => {
+    const first = { template_id: "f01", label: "use_as_is" };
+    const second = { template_id: "f01", label: "reject" };
+    const result = mergeApplicationCandidates([first, second]);
+    expect(result.size).toBe(1);
+    expect(result.get("f01")).toBe(first);
+  });
+});

Front/client/tests/imp47b_human_review_toast.test.tsx

@@ -0,0 +1,257 @@
+// IMP-92 u5 — Frontend AI repair operational-only formatter test surface.
+//
+// Scope (Stage 2 unit u5 contract):
+//   1) formatAiRepairHumanReviewMessage(...) surfaces a user-facing toast
+//      ONLY on the three operational Anthropic API error kinds (quota /
+//      billing / auth) classified by Step 12 u2
+//      (classify_operational_error) and aggregated through u3
+//      ai_repair_status.api_error_kinds.
+//   2) Non-operational AI failures (validation / coverage_violated /
+//      unsupported_kind / generic "other") return null so the
+//      auto-pipeline stays silent per feedback_auto_pipeline_first and
+//      the #84 operational-vs-non-operational replacement-plan contract.
+//   3) Replaces the prior IMP-47B u11 surface — previously rendered toasts
+//      for error / coverage_violated / unsupported_kind. After IMP-92 the
+//      ONLY operational reaches the user; non-operational stays silent.
+//
+// Pure-function unit test (no React Testing Library required — vitest is
+// already in devDependencies; @testing-library/* is NOT installed). The
+// Home.tsx wiring is a 2-line site (`Home.tsx:438`) that calls this helper
+// after `setRunMeta(...)`; covering the helper covers the user-visible
+// message text directly without DOM rendering.
+//
+// The test file path is preserved from IMP-47B u11 (Stage 2 plan
+// `Front/client/tests/imp47b_human_review_toast.test.tsx`); the assertions
+// inside reflect the IMP-92 u5 operational-only contract.
+
+import { describe, it, expect } from "vitest";
+import {
+  formatAiRepairHumanReviewMessage,
+  type AiRepairStatus,
+} from "../src/services/designAgentApi";
+
+const baseCounts = {
+  total: 0,
+  applied: 0,
+  no_proposal: 0,
+  no_zone_match: 0,
+  unsupported_kind: 0,
+  error: 0,
+};
+
+const zeroKinds = { quota: 0, billing: 0, auth: 0, other: 0 };
+
+describe("formatAiRepairHumanReviewMessage (IMP-92 u5 — operational-only)", () => {
+  it("returns null when ai_repair_status is null / undefined", () => {
+    expect(formatAiRepairHumanReviewMessage(null)).toBeNull();
+    expect(formatAiRepairHumanReviewMessage(undefined)).toBeNull();
+  });
+
+  it("returns null on success / no-AI path (no operational kind present)", () => {
+    const ok: AiRepairStatus = {
+      status: "ok",
+      counts: { ...baseCounts },
+      api_error_kinds: { ...zeroKinds },
+      unsupported_kind_records: [],
+      error_records: [],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: false,
+    };
+    expect(formatAiRepairHumanReviewMessage(ok)).toBeNull();
+
+    const applied: AiRepairStatus = {
+      ...ok,
+      status: "applied",
+      counts: { ...baseCounts, total: 1, applied: 1 },
+    };
+    expect(formatAiRepairHumanReviewMessage(applied)).toBeNull();
+  });
+
+  it("surfaces quota operational alert (Anthropic 429 / RateLimitError)", () => {
+    const ai: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 2, error: 2 },
+      api_error_kinds: { quota: 2, billing: 0, auth: 0, other: 0 },
+      unsupported_kind_records: [],
+      error_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          error: "RateLimitError: rate_limit_exceeded",
+          api_error_kind: "quota",
+        },
+        {
+          unit_index: 1,
+          source_section_ids: ["03-2"],
+          error: "RateLimitError: rate_limit_exceeded",
+          api_error_kind: "quota",
+        },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(ai);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("API quota");
+    expect(msg).toContain("충전 필요");
+    expect(msg).toContain("2");
+  });
+
+  it("surfaces billing operational alert (Anthropic 402 / PermissionDeniedError)", () => {
+    const ai: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 1, error: 1 },
+      api_error_kinds: { quota: 0, billing: 1, auth: 0, other: 0 },
+      unsupported_kind_records: [],
+      error_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          error: "PermissionDeniedError: insufficient credits",
+          api_error_kind: "billing",
+        },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(ai);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("API billing");
+    expect(msg).toContain("결제 정보 확인");
+    expect(msg).toContain("1");
+  });
+
+  it("surfaces auth operational alert (Anthropic 401 / AuthenticationError)", () => {
+    const ai: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 1, error: 1 },
+      api_error_kinds: { quota: 0, billing: 0, auth: 1, other: 0 },
+      unsupported_kind_records: [],
+      error_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          error: "AuthenticationError: invalid x-api-key",
+          api_error_kind: "auth",
+        },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(ai);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("API key 무효");
+    expect(msg).toContain(".env");
+    expect(msg).toContain("1");
+  });
+
+  it("returns null on generic non-operational 'other' API error (silent)", () => {
+    const ai: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 1, error: 1 },
+      api_error_kinds: { quota: 0, billing: 0, auth: 0, other: 1 },
+      unsupported_kind_records: [],
+      error_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          error: "ValidationError: proposal failed schema",
+          api_error_kind: "other",
+        },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    expect(formatAiRepairHumanReviewMessage(ai)).toBeNull();
+  });
+
+  it("returns null on coverage_violated (non-operational, silent)", () => {
+    const ai: AiRepairStatus = {
+      status: "coverage_violated",
+      counts: { ...baseCounts, total: 1, applied: 1 },
+      api_error_kinds: { ...zeroKinds },
+      unsupported_kind_records: [],
+      error_records: [],
+      coverage_status: "violated",
+      dropped_section_ids: ["03-2"],
+      human_review_required: true,
+    };
+    expect(formatAiRepairHumanReviewMessage(ai)).toBeNull();
+  });
+
+  it("returns null on unsupported_kind (non-operational, silent)", () => {
+    const ai: AiRepairStatus = {
+      status: "unsupported_kind",
+      counts: { ...baseCounts, total: 1, unsupported_kind: 1 },
+      api_error_kinds: { ...zeroKinds },
+      unsupported_kind_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          apply_status: "unsupported_kind_for_reject_route:builder_options_patch",
+        },
+      ],
+      error_records: [],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    expect(formatAiRepairHumanReviewMessage(ai)).toBeNull();
+  });
+
+  it("returns null on legacy ai_repair_status without api_error_kinds (pre-u3 runs)", () => {
+    // Backward-compat: payloads emitted before u3 plumbing landed don't
+    // carry api_error_kinds. Operational-only contract treats the absence
+    // as "no operational signal" → silent (no toast).
+    const legacy: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 1, error: 1 },
+      // api_error_kinds intentionally omitted
+      unsupported_kind_records: [],
+      error_records: [
+        { unit_index: 0, source_section_ids: ["03-1"], error: "timeout" },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    expect(formatAiRepairHumanReviewMessage(legacy)).toBeNull();
+  });
+
+  it("prioritises quota when multiple operational kinds co-occur", () => {
+    // Defensive: a run that accumulated quota + billing errors across
+    // multiple AI repair attempts surfaces the quota line first (the
+    // most-frequently actionable per the issue body ordering).
+    const ai: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 2, error: 2 },
+      api_error_kinds: { quota: 1, billing: 1, auth: 0, other: 0 },
+      unsupported_kind_records: [],
+      error_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          error: "RateLimitError",
+          api_error_kind: "quota",
+        },
+        {
+          unit_index: 1,
+          source_section_ids: ["03-2"],
+          error: "PermissionDeniedError",
+          api_error_kind: "billing",
+        },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(ai);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("API quota");
+  });
+});

Front/client/tests/imp84_framepanel_reject_silent.test.ts

@@ -0,0 +1,122 @@
+// IMP-#84 u1 — FramePanel reject silent-automation contract.
+//
+// Stage 2 unit u1 scope:
+//   1) `applyFrameSelection(candidate, onFrameSelect)` invokes onFrameSelect
+//      with candidate.id verbatim for EVERY V4 label
+//      (use_as_is / light_edit / restructure / reject) — no window.confirm
+//      gate, no label-conditional branch, no frame swap.
+//   2) Source-presence checks pin the FramePanel.tsx wiring so the runtime
+//      button → handler → helper chain stays intact even though we cannot
+//      mount React (no jsdom / RTL / happy-dom in Front devDependencies —
+//      verified against the IMP-56 u20 `imp90_bottom_actions.test.ts` and
+//      IMP-92 u5 `imp47b_human_review_toast.test.tsx` precedent that
+//      explicitly skip DOM mounting).
+//   3) No `window.confirm` substring remains in FramePanel.tsx after u1.
+//
+// Out of scope (Stage 2 exit-report contract):
+//   - Home.tsx:523-524 `toast.error(aiReviewMsg)` (#92 operational-only).
+//   - FramePanel reject badge/tooltip read-only labels at L102/L147/L156
+//     (no popup trigger; preserved as silent operator hint).
+//   - Backend `zone.provisional` emission (handled by u2 template-only).
+
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, it, expect, vi } from "vitest";
+import { applyFrameSelection } from "../src/components/FramePanel";
+import type { FrameCandidate } from "../src/types/designAgent";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FRAME_PANEL_SOURCE = readFileSync(
+  resolve(__dirname, "../src/components/FramePanel.tsx"),
+  "utf-8",
+);
+
+function makeCandidate(
+  label: FrameCandidate["label"],
+  id: string,
+): FrameCandidate {
+  return {
+    id,
+    name: `Frame ${id}`,
+    score: 0.5,
+    confidence: "medium",
+    label,
+  };
+}
+
+describe("applyFrameSelection (IMP-#84 u1 — silent-automation contract)", () => {
+  it("forwards candidate.id to onFrameSelect for use_as_is label", () => {
+    const onFrameSelect = vi.fn();
+    applyFrameSelection(makeCandidate("use_as_is", "frame_a"), onFrameSelect);
+    expect(onFrameSelect).toHaveBeenCalledTimes(1);
+    expect(onFrameSelect).toHaveBeenCalledWith("frame_a");
+  });
+
+  it("forwards candidate.id to onFrameSelect for light_edit label", () => {
+    const onFrameSelect = vi.fn();
+    applyFrameSelection(makeCandidate("light_edit", "frame_b"), onFrameSelect);
+    expect(onFrameSelect).toHaveBeenCalledTimes(1);
+    expect(onFrameSelect).toHaveBeenCalledWith("frame_b");
+  });
+
+  it("forwards candidate.id to onFrameSelect for restructure label", () => {
+    const onFrameSelect = vi.fn();
+    applyFrameSelection(makeCandidate("restructure", "frame_c"), onFrameSelect);
+    expect(onFrameSelect).toHaveBeenCalledTimes(1);
+    expect(onFrameSelect).toHaveBeenCalledWith("frame_c");
+  });
+
+  it("forwards candidate.id to onFrameSelect for reject label — no popup, no frame swap", () => {
+    // Reject is the silent-automation pivot case: prior IMP-47B u11 gated
+    // this path with window.confirm; post-IMP-#84 the helper invokes
+    // onFrameSelect with the reject frame.id directly. Backend / AI 격리
+    // contract handles AI 재구성 (content-only, frame preserved).
+    const onFrameSelect = vi.fn();
+    applyFrameSelection(makeCandidate("reject", "frame_d"), onFrameSelect);
+    expect(onFrameSelect).toHaveBeenCalledTimes(1);
+    expect(onFrameSelect).toHaveBeenCalledWith("frame_d");
+  });
+
+  it("does not call onFrameSelect more than once per invocation", () => {
+    const onFrameSelect = vi.fn();
+    applyFrameSelection(makeCandidate("reject", "frame_e"), onFrameSelect);
+    applyFrameSelection(makeCandidate("use_as_is", "frame_f"), onFrameSelect);
+    expect(onFrameSelect).toHaveBeenCalledTimes(2);
+    expect(onFrameSelect).toHaveBeenNthCalledWith(1, "frame_e");
+    expect(onFrameSelect).toHaveBeenNthCalledWith(2, "frame_f");
+  });
+});
+
+describe("FramePanel.tsx source — silent-automation wiring pins (IMP-#84 u1)", () => {
+  it("has no window.confirm(...) call (popup removed; narrative mentions in comments are allowed)", () => {
+    // Match the call form `window.confirm(` rather than the bare substring
+    // so that explanatory comments documenting the removed popup are not
+    // flagged. A re-introduced call would carry an opening paren.
+    expect(FRAME_PANEL_SOURCE).not.toMatch(/\bwindow\.confirm\s*\(/);
+  });
+
+  it("does not embed the legacy reject-confirm Korean prompt body", () => {
+    // Prior IMP-47B u11 string fragment; absence guards against re-introduction.
+    expect(FRAME_PANEL_SOURCE).not.toContain("V4 reject 라벨입니다");
+    expect(FRAME_PANEL_SOURCE).not.toContain("계속하시겠습니까?");
+  });
+
+  it("wires the button onClick to handleFrameSelect(candidate)", () => {
+    expect(FRAME_PANEL_SOURCE).toContain(
+      "onClick={() => handleFrameSelect(candidate)}",
+    );
+  });
+
+  it("delegates handleFrameSelect body to applyFrameSelection", () => {
+    expect(FRAME_PANEL_SOURCE).toContain(
+      "applyFrameSelection(candidate, onFrameSelect)",
+    );
+  });
+
+  it("exports applyFrameSelection as a named export for caller-independent reuse", () => {
+    expect(FRAME_PANEL_SOURCE).toMatch(
+      /export function applyFrameSelection\(/,
+    );
+  });
+});

Front/client/tests/imp90_bottom_actions.test.ts

@@ -0,0 +1,90 @@
+// IMP-56 (#90) u20 — vitest coverage for the pure request builders exported
+// by `BottomActions`. The React component itself is not rendered (jsdom /
+// @testing-library NOT in Front devDependencies — verified against the prior
+// u14 `imp90_structure_overlay.test.tsx` pattern); we test the deterministic
+// pieces that drive the network payload sent to the u18 / u19 middlewares.
+//
+// Upstream / downstream contracts (verified by prior units):
+//   - u18 /api/connect : body shape = { run_id, slug } (Front/vite.config.ts
+//          handleConnectMirror — `imp90_connect_endpoint.test.ts`).
+//   - u19 /api/export  : body shape = { run_id }; response = raw text/html
+//          with `Content-Disposition: attachment; filename="<run_id>.html"`
+//          (Front/vite.config.ts handleExportStandalone —
+//          `imp90_export_endpoint.test.ts`).
+//
+// u20 scope: builders only. Any drift in URL or JSON shape fails here before
+// the request leaves the client. Toast / fetch / blob plumbing is not tested
+// (it would require jsdom + a fetch mock; the existing server-side tests
+// already pin the wire contract).
+
+import { describe, it, expect } from "vitest";
+import {
+  buildConnectRequest,
+  buildExportRequest,
+  buildDownloadFilename,
+} from "../src/components/BottomActions";
+
+describe("buildConnectRequest", () => {
+  it("targets /api/connect", () => {
+    const { url } = buildConnectRequest("run_42", "mdx_03");
+    expect(url).toBe("/api/connect");
+  });
+
+  it("emits { run_id, slug } JSON body — matches u18 middleware shape", () => {
+    const { body } = buildConnectRequest("run_42", "mdx_03");
+    expect(JSON.parse(body)).toEqual({ run_id: "run_42", slug: "mdx_03" });
+  });
+
+  it("preserves zero-length and unicode run_id verbatim (server validates)", () => {
+    const { body } = buildConnectRequest("", "x");
+    expect(JSON.parse(body)).toEqual({ run_id: "", slug: "x" });
+    const { body: uni } = buildConnectRequest("런", "슬러그");
+    expect(JSON.parse(uni)).toEqual({ run_id: "런", slug: "슬러그" });
+  });
+
+  it("does not leak extra keys (frame swap / overrides etc.)", () => {
+    const { body } = buildConnectRequest("r", "s");
+    expect(Object.keys(JSON.parse(body)).sort()).toEqual(["run_id", "slug"]);
+  });
+});
+
+describe("buildExportRequest", () => {
+  it("targets /api/export", () => {
+    const { url } = buildExportRequest("run_42");
+    expect(url).toBe("/api/export");
+  });
+
+  it("emits { run_id } JSON body — matches u19 middleware shape", () => {
+    const { body } = buildExportRequest("run_42");
+    expect(JSON.parse(body)).toEqual({ run_id: "run_42" });
+  });
+
+  it("does not leak extra keys (slug / format etc.)", () => {
+    const { body } = buildExportRequest("r");
+    expect(Object.keys(JSON.parse(body))).toEqual(["run_id"]);
+  });
+
+  it("preserves zero-length and unicode run_id verbatim (server validates)", () => {
+    expect(JSON.parse(buildExportRequest("").body)).toEqual({ run_id: "" });
+    expect(JSON.parse(buildExportRequest("런").body)).toEqual({ run_id: "런" });
+  });
+});
+
+describe("buildDownloadFilename", () => {
+  it("returns <run_id>.html for the a[download] click chain", () => {
+    expect(buildDownloadFilename("run_42")).toBe("run_42.html");
+  });
+
+  it("appends exactly one .html suffix even when run_id already ends in .html", () => {
+    // The server-side `Content-Disposition` already carries the same
+    // filename; we mirror it verbatim so browser default behavior wins.
+    // We intentionally do NOT strip a trailing `.html` — run_id is the
+    // backend's `Path(args.mdx_path).stem`-style key, which never contains
+    // a dot suffix (validated by `isValidUserOverridesKey` at u18/u19).
+    expect(buildDownloadFilename("foo.html")).toBe("foo.html.html");
+  });
+
+  it("returns just .html for empty run_id (server rejects upstream)", () => {
+    expect(buildDownloadFilename("")).toBe(".html");
+  });
+});

Front/client/tests/imp90_connect_endpoint.test.ts

@@ -0,0 +1,282 @@
+// IMP-56 (#90) u18 — vitest coverage for the vite POST /api/connect
+// middleware and its supporting mirrorDirRecursive helper.
+//
+// Scope:
+//   1) mirrorDirRecursive (pure helper):
+//      - absent src → returns 0 (no-throw, no dst creation).
+//      - file-only src → flat copy + count.
+//      - nested src → recursive copy + count.
+//      - overwrites pre-existing dst files (cel mirror semantics).
+//   2) handleConnectMirror (POST):
+//      - method != POST → false (chain continues; next middleware may handle).
+//      - invalid JSON / non-object body → 400.
+//      - missing run_id or slug → 400.
+//      - invalid run_id or slug (key gate / path traversal) → 400.
+//      - final.html missing → 404.
+//      - success without run-assets dir → 200, assets_copied: 0, html copy ok.
+//      - success with run-assets dir → 200, assets_copied = file count, dst dir
+//        populated.
+//      - dstSlidesDir auto-created when celRoot/public/slides missing.
+//
+// Tests exercise the pure handler with mock req/res — no real vite server.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import {
+  handleConnectMirror,
+  mirrorDirRecursive,
+} from "../../vite.config";
+
+function makeMockRes() {
+  const state = {
+    statusCode: 0,
+    headers: {} as Record<string, string>,
+    body: "",
+    ended: false,
+  };
+  return {
+    state,
+    res: {
+      writeHead(status: number, headers?: Record<string, string>) {
+        state.statusCode = status;
+        if (headers) state.headers = headers;
+      },
+      end(body?: string) {
+        state.body = body ?? "";
+        state.ended = true;
+      },
+    },
+  };
+}
+
+function makeMockReq(opts: {
+  method?: string;
+}): EventEmitter & { method?: string; send: (body: string) => void } {
+  const ee = new EventEmitter() as EventEmitter & {
+    method?: string;
+    send: (body: string) => void;
+  };
+  ee.method = opts.method;
+  ee.send = (body: string) => {
+    if (body.length > 0) ee.emit("data", Buffer.from(body, "utf-8"));
+    ee.emit("end");
+  };
+  return ee;
+}
+
+function seedRun(daRoot: string, runId: string, htmlBody: string): string {
+  const runDir = path.join(daRoot, "data", "runs", runId, "phase_z2");
+  fs.mkdirSync(runDir, { recursive: true });
+  const html = path.join(runDir, "final.html");
+  fs.writeFileSync(html, htmlBody, "utf-8");
+  return runDir;
+}
+
+describe("mirrorDirRecursive (IMP-56 #90 u18)", () => {
+  let tmp: string;
+
+  beforeEach(() => {
+    tmp = fs.mkdtempSync(path.join(os.tmpdir(), "imp90-u18-mirror-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmp, { recursive: true, force: true });
+  });
+
+  it("returns 0 and does not throw when src absent", () => {
+    const dst = path.join(tmp, "dst");
+    const n = mirrorDirRecursive(path.join(tmp, "missing"), dst);
+    expect(n).toBe(0);
+    expect(fs.existsSync(dst)).toBe(false);
+  });
+
+  it("returns 0 when src exists but is a file (not a directory)", () => {
+    const srcFile = path.join(tmp, "src.txt");
+    fs.writeFileSync(srcFile, "x", "utf-8");
+    const dst = path.join(tmp, "dst");
+    const n = mirrorDirRecursive(srcFile, dst);
+    expect(n).toBe(0);
+    expect(fs.existsSync(dst)).toBe(false);
+  });
+
+  it("flat-copies file entries and returns the file count", () => {
+    const src = path.join(tmp, "src");
+    fs.mkdirSync(src);
+    fs.writeFileSync(path.join(src, "a.css"), "/*a*/", "utf-8");
+    fs.writeFileSync(path.join(src, "b.png"), "PNG", "utf-8");
+    const dst = path.join(tmp, "dst");
+    const n = mirrorDirRecursive(src, dst);
+    expect(n).toBe(2);
+    expect(fs.readFileSync(path.join(dst, "a.css"), "utf-8")).toBe("/*a*/");
+    expect(fs.readFileSync(path.join(dst, "b.png"), "utf-8")).toBe("PNG");
+  });
+
+  it("recurses into nested directories and counts only files", () => {
+    const src = path.join(tmp, "src");
+    fs.mkdirSync(path.join(src, "nested", "deep"), { recursive: true });
+    fs.writeFileSync(path.join(src, "root.txt"), "r", "utf-8");
+    fs.writeFileSync(path.join(src, "nested", "n.txt"), "n", "utf-8");
+    fs.writeFileSync(path.join(src, "nested", "deep", "d.txt"), "d", "utf-8");
+    const dst = path.join(tmp, "dst");
+    const n = mirrorDirRecursive(src, dst);
+    expect(n).toBe(3);
+    expect(fs.readFileSync(path.join(dst, "nested", "deep", "d.txt"), "utf-8"))
+      .toBe("d");
+  });
+
+  it("overwrites pre-existing files in dst (cel mirror semantics)", () => {
+    const src = path.join(tmp, "src");
+    fs.mkdirSync(src);
+    fs.writeFileSync(path.join(src, "a.css"), "NEW", "utf-8");
+    const dst = path.join(tmp, "dst");
+    fs.mkdirSync(dst);
+    fs.writeFileSync(path.join(dst, "a.css"), "OLD", "utf-8");
+    mirrorDirRecursive(src, dst);
+    expect(fs.readFileSync(path.join(dst, "a.css"), "utf-8")).toBe("NEW");
+  });
+});
+
+describe("handleConnectMirror (IMP-56 #90 u18)", () => {
+  let daRoot: string;
+  let celRoot: string;
+
+  beforeEach(() => {
+    daRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp90-u18-da-"));
+    celRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp90-u18-cel-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(daRoot, { recursive: true, force: true });
+    fs.rmSync(celRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != POST", () => {
+    const req = makeMockReq({ method: "GET" });
+    const { res, state } = makeMockRes();
+    const handled = handleConnectMirror(req, res, daRoot, celRoot);
+    expect(handled).toBe(false);
+    expect(state.ended).toBe(false);
+  });
+
+  it("returns 400 on invalid JSON body", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    const handled = handleConnectMirror(req, res, daRoot, celRoot);
+    expect(handled).toBe(true);
+    req.send("{not-json}");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("invalid JSON");
+  });
+
+  it("returns 400 when body is not a JSON object (array root)", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify(["not", "an", "object"]));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("body must be a JSON object");
+  });
+
+  it("returns 400 when run_id or slug is missing", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "abc" })); // slug missing
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("missing run_id or slug");
+  });
+
+  it("returns 400 when run_id contains path traversal", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "../escape", slug: "03" }));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("invalid run_id or slug");
+  });
+
+  it("returns 400 when slug contains a forward slash", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "valid_id", slug: "03/etc" }));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("invalid run_id or slug");
+  });
+
+  it("returns 404 when final.html does not exist for run_id", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "ghost_run", slug: "03" }));
+    expect(state.statusCode).toBe(404);
+    expect(JSON.parse(state.body).error).toBe("final.html not found");
+  });
+
+  it("copies final.html to cel/public/slides/<slug>.html on success", () => {
+    seedRun(daRoot, "mdx03_run", "<html>03</html>");
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "mdx03_run", slug: "03" }));
+
+    expect(state.statusCode).toBe(200);
+    const dstHtml = path.join(celRoot, "public", "slides", "03.html");
+    expect(fs.existsSync(dstHtml)).toBe(true);
+    expect(fs.readFileSync(dstHtml, "utf-8")).toBe("<html>03</html>");
+    const body = JSON.parse(state.body);
+    expect(body.success).toBe(true);
+    expect(body.run_id).toBe("mdx03_run");
+    expect(body.slug).toBe("03");
+    expect(body.assets_copied).toBe(0);
+    expect(body.html_target).toBe(dstHtml);
+  });
+
+  it("auto-creates cel/public/slides when missing", () => {
+    seedRun(daRoot, "mdx04_run", "<html>04</html>");
+    expect(fs.existsSync(path.join(celRoot, "public", "slides"))).toBe(false);
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "mdx04_run", slug: "04" }));
+    expect(state.statusCode).toBe(200);
+    expect(fs.existsSync(path.join(celRoot, "public", "slides", "04.html"))).toBe(true);
+  });
+
+  it("mirrors assets/ recursively when present in the run dir", () => {
+    const runDir = seedRun(daRoot, "mdx05_run", "<html>05</html>");
+    fs.mkdirSync(path.join(runDir, "assets", "css"), { recursive: true });
+    fs.writeFileSync(path.join(runDir, "assets", "main.css"), "*{}", "utf-8");
+    fs.writeFileSync(path.join(runDir, "assets", "css", "extra.css"), "p{}", "utf-8");
+
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "mdx05_run", slug: "05" }));
+
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body).assets_copied).toBe(2);
+    expect(fs.readFileSync(path.join(celRoot, "public", "slides", "assets", "main.css"), "utf-8"))
+      .toBe("*{}");
+    expect(fs.readFileSync(path.join(celRoot, "public", "slides", "assets", "css", "extra.css"), "utf-8"))
+      .toBe("p{}");
+  });
+
+  it("overwrites pre-existing cel slide html (re-Connect semantics)", () => {
+    seedRun(daRoot, "mdx03_run", "NEW");
+    const dstSlidesDir = path.join(celRoot, "public", "slides");
+    fs.mkdirSync(dstSlidesDir, { recursive: true });
+    fs.writeFileSync(path.join(dstSlidesDir, "03.html"), "OLD", "utf-8");
+
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleConnectMirror(req, res, daRoot, celRoot);
+    req.send(JSON.stringify({ run_id: "mdx03_run", slug: "03" }));
+
+    expect(state.statusCode).toBe(200);
+    expect(fs.readFileSync(path.join(dstSlidesDir, "03.html"), "utf-8")).toBe("NEW");
+  });
+});

Front/client/tests/imp90_edit_mode_gating.test.tsx

@@ -0,0 +1,219 @@
+// IMP-90 (#90) u12 — vitest coverage for `computeEditModeGates`, the pure
+// helper that drives SlideCanvas's mutually-exclusive gesture gating.
+// u11 introduced the `EditMode` enum + toolbar; u12 splits the prior
+// `isEditMode` shim (which fired ALL gates whenever any edit mode was
+// active) into 5 per-gate booleans:
+//   textEditing       — designMode + contentEditable (text mode only).
+//   imageSelection    — in-iframe user-content image click listener
+//                       (image-zone mode only).
+//   iframePointerAuto — iframe pointer-events:auto so in-iframe gestures
+//                       (text caret OR image click) can reach the doc.
+//                       text mode + image-zone mode; structure stays
+//                       pe:none because u14 will overlay React controls.
+//   zoneGestures      — zone resize 8-handle ring + drag perimeter strips
+//                       + canDrag in handleZoneMouseDown
+//                       (image-zone mode only).
+//   imageOverlay      — React-side image edit overlay (image-zone only).
+//
+// Mutually-exclusive contract (from the issue body's "discriminated edit
+// mode"): no editMode value enables both `textEditing` and either
+// `imageSelection` or `zoneGestures` simultaneously. structure mode is
+// the no-op placeholder — u14 will plant the structure overlay there.
+// pendingLayout fully suppresses every gate (mirrors the existing
+// useEffect that forces editMode='off' on pendingLayout entry).
+//
+// Scope guard: this test exercises the pure helper only — no React
+// rendering, no DOM. testing-library/react is NOT in devDependencies
+// (verified in Front/package.json); helper-level coverage is the
+// established u11 pattern.
+
+import { describe, it, expect } from "vitest";
+import {
+  computeEditModeGates,
+  type EditMode,
+  type EditModeGates,
+} from "../src/components/SlideCanvas";
+
+const ALL_MODES: EditMode[] = ["off", "text", "structure", "image-zone"];
+
+describe("computeEditModeGates (IMP-90 u12) — pendingLayout suppression", () => {
+  it.each<EditMode>(ALL_MODES)(
+    "pendingLayout=true forces every gate false (editMode=%s)",
+    (mode) => {
+      const g = computeEditModeGates(mode, true);
+      expect(g).toEqual<EditModeGates>({
+        textEditing: false,
+        imageSelection: false,
+        iframePointerAuto: false,
+        zoneGestures: false,
+        imageOverlay: false,
+      });
+    }
+  );
+});
+
+describe("computeEditModeGates (IMP-90 u12) — off baseline", () => {
+  it("editMode=off pendingLayout=false: every gate false", () => {
+    expect(computeEditModeGates("off", false)).toEqual<EditModeGates>({
+      textEditing: false,
+      imageSelection: false,
+      iframePointerAuto: false,
+      zoneGestures: false,
+      imageOverlay: false,
+    });
+  });
+});
+
+describe("computeEditModeGates (IMP-90 u12) — text mode", () => {
+  const g = computeEditModeGates("text", false);
+
+  it("textEditing = true (designMode + contentEditable activate)", () => {
+    expect(g.textEditing).toBe(true);
+  });
+  it("iframePointerAuto = true (caret needs to reach the doc)", () => {
+    expect(g.iframePointerAuto).toBe(true);
+  });
+  it("imageSelection = false (no in-iframe image click listener)", () => {
+    expect(g.imageSelection).toBe(false);
+  });
+  it("zoneGestures = false (no zone resize / drag affordances)", () => {
+    expect(g.zoneGestures).toBe(false);
+  });
+  it("imageOverlay = false (no React-side image overlay)", () => {
+    expect(g.imageOverlay).toBe(false);
+  });
+});
+
+describe("computeEditModeGates (IMP-90 u12) — structure mode", () => {
+  const g = computeEditModeGates("structure", false);
+
+  // structure mode is the u14 placeholder — no gestures here yet. All five
+  // gates stay false so the iframe and React overlays remain quiescent
+  // until u14 plants the structure overlay on the React layer.
+  it("every gate false (u14 will plant the structure overlay later)", () => {
+    expect(g).toEqual<EditModeGates>({
+      textEditing: false,
+      imageSelection: false,
+      iframePointerAuto: false,
+      zoneGestures: false,
+      imageOverlay: false,
+    });
+  });
+});
+
+describe("computeEditModeGates (IMP-90 u12) — image-zone mode", () => {
+  const g = computeEditModeGates("image-zone", false);
+
+  it("textEditing = false (contentEditable would steal image clicks)", () => {
+    expect(g.textEditing).toBe(false);
+  });
+  it("imageSelection = true (in-iframe img click → selectedImageId)", () => {
+    expect(g.imageSelection).toBe(true);
+  });
+  it("iframePointerAuto = true (so image clicks reach the doc)", () => {
+    expect(g.iframePointerAuto).toBe(true);
+  });
+  it("zoneGestures = true (zone resize + drag affordances visible)", () => {
+    expect(g.zoneGestures).toBe(true);
+  });
+  it("imageOverlay = true (React-side overlay renders the drag handles)", () => {
+    expect(g.imageOverlay).toBe(true);
+  });
+});
+
+describe("computeEditModeGates (IMP-90 u12) — mutually exclusive contract", () => {
+  it("text mode never co-activates image-zone gates (imageSelection / zoneGestures / imageOverlay)", () => {
+    const g = computeEditModeGates("text", false);
+    expect(g.textEditing).toBe(true);
+    expect(g.imageSelection).toBe(false);
+    expect(g.zoneGestures).toBe(false);
+    expect(g.imageOverlay).toBe(false);
+  });
+
+  it("image-zone mode never co-activates text gates (textEditing)", () => {
+    const g = computeEditModeGates("image-zone", false);
+    expect(g.imageSelection).toBe(true);
+    expect(g.textEditing).toBe(false);
+  });
+
+  it.each<EditMode>(ALL_MODES)(
+    "for every editMode (%s), textEditing AND zoneGestures are NEVER both true",
+    (mode) => {
+      const g = computeEditModeGates(mode, false);
+      expect(g.textEditing && g.zoneGestures).toBe(false);
+    }
+  );
+
+  it.each<EditMode>(ALL_MODES)(
+    "for every editMode (%s), textEditing AND imageOverlay are NEVER both true",
+    (mode) => {
+      const g = computeEditModeGates(mode, false);
+      expect(g.textEditing && g.imageOverlay).toBe(false);
+    }
+  );
+
+  it.each<EditMode>(ALL_MODES)(
+    "for every editMode (%s), textEditing AND imageSelection are NEVER both true",
+    (mode) => {
+      const g = computeEditModeGates(mode, false);
+      expect(g.textEditing && g.imageSelection).toBe(false);
+    }
+  );
+});
+
+describe("computeEditModeGates (IMP-90 u12) — iframePointerAuto coupling", () => {
+  // pe:auto is the iframe-side prerequisite for ANY in-iframe gesture
+  // (text caret OR image click). The helper must NOT advertise an
+  // in-iframe gate as active while pe is none, or those gestures would
+  // be silently swallowed by the wrapper.
+  it.each<EditMode>(ALL_MODES)(
+    "textEditing → iframePointerAuto (editMode=%s)",
+    (mode) => {
+      const g = computeEditModeGates(mode, false);
+      if (g.textEditing) expect(g.iframePointerAuto).toBe(true);
+    }
+  );
+  it.each<EditMode>(ALL_MODES)(
+    "imageSelection → iframePointerAuto (editMode=%s)",
+    (mode) => {
+      const g = computeEditModeGates(mode, false);
+      if (g.imageSelection) expect(g.iframePointerAuto).toBe(true);
+    }
+  );
+});
+
+describe("computeEditModeGates (IMP-90 u12) — referential transparency", () => {
+  it("multiple calls with the same inputs return equal output", () => {
+    const a = computeEditModeGates("image-zone", false);
+    const b = computeEditModeGates("image-zone", false);
+    const c = computeEditModeGates("image-zone", false);
+    expect(a).toEqual(b);
+    expect(b).toEqual(c);
+  });
+
+  it("does not mutate captured state across calls (independent invocations)", () => {
+    const a = computeEditModeGates("text", false);
+    const _b = computeEditModeGates("image-zone", false);
+    // a must still reflect text mode after b's call.
+    expect(a.textEditing).toBe(true);
+    expect(a.imageSelection).toBe(false);
+  });
+});
+
+describe("computeEditModeGates (IMP-90 u12) — gate truthtable snapshot", () => {
+  // Snapshot for human-readable inspection — the per-mode flag layout
+  // is the contract u13 (text capture) and u14 (structure overlay)
+  // will build against. Any change requires updating both this test
+  // AND the consuming gates in SlideCanvas.tsx.
+  it("non-pendingLayout truthtable matches the u12 contract", () => {
+    const rows = (["off", "text", "structure", "image-zone"] as EditMode[]).map(
+      (m) => ({ mode: m, ...computeEditModeGates(m, false) })
+    );
+    expect(rows).toEqual([
+      { mode: "off", textEditing: false, imageSelection: false, iframePointerAuto: false, zoneGestures: false, imageOverlay: false },
+      { mode: "text", textEditing: true, imageSelection: false, iframePointerAuto: true, zoneGestures: false, imageOverlay: false },
+      { mode: "structure", textEditing: false, imageSelection: false, iframePointerAuto: false, zoneGestures: false, imageOverlay: false },
+      { mode: "image-zone", textEditing: false, imageSelection: true, iframePointerAuto: true, zoneGestures: true, imageOverlay: true },
+    ]);
+  });
+});

Front/client/tests/imp90_edit_mode_state.test.tsx

@@ -0,0 +1,133 @@
+// IMP-90 (#90) u11 — vitest coverage for the discriminated EditMode enum
+// and its pure transition helper `nextEditMode`. Replaces the prior single
+// `isEditMode` boolean state. u11 introduces ONLY the state surface + the
+// toolbar UI; gesture gating per mode is u12 (mutually exclusive) and must
+// not regress this contract.
+//
+// Scope (Stage 2 unit u11 contract):
+//   1) EDIT_MODES is the canonical ['text','structure','image-zone'] list
+//      in toolbar render order. 'off' is intentionally excluded from the
+//      iterable because it is the implicit baseline (no button); the
+//      toolbar only renders the three active modes per the u11 design.
+//   2) nextEditMode is a pure (current, requested) -> EditMode mapping
+//      with three rules:
+//        - requested === 'off'              -> 'off'   (explicit exit)
+//        - requested === current            -> 'off'   (toggle exit)
+//        - requested !== current && != 'off'-> requested (mode switch)
+//   3) The helper is referentially transparent — no side effects, no
+//      React, no useState, no DOM. SlideCanvas wires it as the useState
+//      updater callback (`setEditMode((prev) => nextEditMode(prev, m))`),
+//      so covering the helper here covers every toolbar click outcome
+//      directly without DOM rendering. (@testing-library/react is NOT in
+//      devDependencies; this mirrors the imp47b_human_review_toast pattern.)
+//   4) The exported EditMode type union must contain exactly the four
+//      members 'off' | 'text' | 'structure' | 'image-zone'. The runtime
+//      EDIT_MODES list intentionally excludes 'off' (see (1) above).
+//
+// Forward-compat note: u12 will discriminate per-mode gating but MUST NOT
+// alter the (current, requested) -> next contract verified here. Any
+// change to the toggle/switch/exit semantics is a scope-violation against
+// the u11 binding contract.
+
+import { describe, it, expect } from "vitest";
+import {
+  EDIT_MODES,
+  nextEditMode,
+  type EditMode,
+} from "../src/components/SlideCanvas";
+
+describe("EDIT_MODES (IMP-90 u11 — toolbar render order)", () => {
+  it("contains exactly the three active modes in toolbar order", () => {
+    expect(EDIT_MODES).toEqual(["text", "structure", "image-zone"]);
+  });
+
+  it("excludes 'off' — baseline is implicit, no toolbar button", () => {
+    expect(EDIT_MODES).not.toContain("off" as EditMode);
+  });
+
+  it("has length 3", () => {
+    expect(EDIT_MODES.length).toBe(3);
+  });
+});
+
+describe("nextEditMode (IMP-90 u11 — pure transition helper)", () => {
+  describe("explicit 'off' request always exits", () => {
+    it.each<EditMode>(["off", "text", "structure", "image-zone"])(
+      "current=%s, requested=off -> off",
+      (current) => {
+        expect(nextEditMode(current, "off")).toBe("off");
+      }
+    );
+  });
+
+  describe("clicking the active mode toggles back to 'off'", () => {
+    it.each<EditMode>(["text", "structure", "image-zone"])(
+      "current=%s, requested=%s -> off",
+      (mode) => {
+        expect(nextEditMode(mode, mode)).toBe("off");
+      }
+    );
+  });
+
+  describe("clicking a different mode switches", () => {
+    const cases: Array<[EditMode, EditMode]> = [
+      ["off", "text"],
+      ["off", "structure"],
+      ["off", "image-zone"],
+      ["text", "structure"],
+      ["text", "image-zone"],
+      ["structure", "text"],
+      ["structure", "image-zone"],
+      ["image-zone", "text"],
+      ["image-zone", "structure"],
+    ];
+    it.each(cases)("current=%s, requested=%s -> requested", (current, requested) => {
+      expect(nextEditMode(current, requested)).toBe(requested);
+    });
+  });
+
+  it("is referentially transparent — multiple calls with same inputs return same output", () => {
+    const a = nextEditMode("text", "structure");
+    const b = nextEditMode("text", "structure");
+    const c = nextEditMode("text", "structure");
+    expect(a).toBe("structure");
+    expect(b).toBe("structure");
+    expect(c).toBe("structure");
+  });
+
+  it("never returns a value outside the EditMode union", () => {
+    const all: EditMode[] = ["off", "text", "structure", "image-zone"];
+    for (const current of all) {
+      for (const requested of all) {
+        const result = nextEditMode(current, requested);
+        expect(all).toContain(result);
+      }
+    }
+  });
+
+  it("preserves toggle semantics under repeated identical clicks", () => {
+    // off -> text -> off -> text -> off (toggle behavior)
+    let m: EditMode = "off";
+    m = nextEditMode(m, "text");
+    expect(m).toBe("text");
+    m = nextEditMode(m, "text");
+    expect(m).toBe("off");
+    m = nextEditMode(m, "text");
+    expect(m).toBe("text");
+    m = nextEditMode(m, "text");
+    expect(m).toBe("off");
+  });
+
+  it("preserves switch semantics across distinct mode clicks", () => {
+    // off -> text -> structure -> image-zone -> off (via toggle)
+    let m: EditMode = "off";
+    m = nextEditMode(m, "text");
+    expect(m).toBe("text");
+    m = nextEditMode(m, "structure");
+    expect(m).toBe("structure");
+    m = nextEditMode(m, "image-zone");
+    expect(m).toBe("image-zone");
+    m = nextEditMode(m, "image-zone");
+    expect(m).toBe("off");
+  });
+});

Front/client/tests/imp90_export_endpoint.test.ts

@@ -0,0 +1,255 @@
+// IMP-56 (#90) u19 — vitest coverage for the vite POST /api/export
+// middleware and its supporting inlineAssetsAsDataUrls helper.
+//
+// Scope:
+//   1) inlineAssetsAsDataUrls (pure helper):
+//      - no url(assets/...) refs → passthrough.
+//      - single PNG ref → inlined as base64 data: URL with image/png mime.
+//      - multiple refs → all inlined.
+//      - SVG ref → image/svg+xml mime.
+//      - missing asset file → left as-is (no throw, no rewrite).
+//      - data:/http:/ URLs (non-asset) → untouched.
+//   2) handleExportStandalone (POST):
+//      - method != POST → false (chain continues; next middleware may handle).
+//      - invalid JSON / non-object body → 400.
+//      - missing run_id → 400.
+//      - invalid run_id (key gate / path traversal) → 400.
+//      - final.html missing → 404.
+//      - success → 200 with Content-Disposition: attachment; filename=...,
+//        Content-Type: text/html; charset=utf-8, body = inlined HTML.
+//
+// Tests exercise the pure handler with mock req/res — no real vite server.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import {
+  handleExportStandalone,
+  inlineAssetsAsDataUrls,
+} from "../../vite.config";
+
+function makeMockRes() {
+  const state = {
+    statusCode: 0,
+    headers: {} as Record<string, string>,
+    body: "",
+    ended: false,
+  };
+  return {
+    state,
+    res: {
+      writeHead(status: number, headers?: Record<string, string>) {
+        state.statusCode = status;
+        if (headers) state.headers = headers;
+      },
+      end(body?: string) {
+        state.body = body ?? "";
+        state.ended = true;
+      },
+    },
+  };
+}
+
+function makeMockReq(opts: {
+  method?: string;
+}): EventEmitter & { method?: string; send: (body: string) => void } {
+  const ee = new EventEmitter() as EventEmitter & {
+    method?: string;
+    send: (body: string) => void;
+  };
+  ee.method = opts.method;
+  ee.send = (body: string) => {
+    if (body.length > 0) ee.emit("data", Buffer.from(body, "utf-8"));
+    ee.emit("end");
+  };
+  return ee;
+}
+
+function seedRun(
+  daRoot: string,
+  runId: string,
+  htmlBody: string,
+  assets?: Record<string, Buffer | string>,
+): string {
+  const runDir = path.join(daRoot, "data", "runs", runId, "phase_z2");
+  fs.mkdirSync(runDir, { recursive: true });
+  const html = path.join(runDir, "final.html");
+  fs.writeFileSync(html, htmlBody, "utf-8");
+  if (assets) {
+    for (const [rel, buf] of Object.entries(assets)) {
+      const dst = path.join(runDir, "assets", rel);
+      fs.mkdirSync(path.dirname(dst), { recursive: true });
+      fs.writeFileSync(dst, buf);
+    }
+  }
+  return runDir;
+}
+
+describe("inlineAssetsAsDataUrls (IMP-56 #90 u19)", () => {
+  let tmp: string;
+
+  beforeEach(() => {
+    tmp = fs.mkdtempSync(path.join(os.tmpdir(), "imp90-u19-inline-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmp, { recursive: true, force: true });
+  });
+
+  it("returns html unchanged when no url(assets/...) refs are present", () => {
+    const html = "<html><style>body{color:red;}</style><body>hi</body></html>";
+    expect(inlineAssetsAsDataUrls(html, tmp)).toBe(html);
+  });
+
+  it("inlines a single PNG asset as a base64 data: URL with image/png mime", () => {
+    fs.mkdirSync(path.join(tmp, "frame_x"), { recursive: true });
+    const pngBytes = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+    fs.writeFileSync(path.join(tmp, "frame_x", "a.png"), pngBytes);
+    const html = "background: url(assets/frame_x/a.png);";
+    const out = inlineAssetsAsDataUrls(html, tmp);
+    expect(out).toContain(`url("data:image/png;base64,${pngBytes.toString("base64")}")`);
+    expect(out).not.toContain("url(assets/frame_x/a.png)");
+  });
+
+  it("inlines multiple refs across the same HTML body", () => {
+    fs.mkdirSync(path.join(tmp, "f"), { recursive: true });
+    fs.writeFileSync(path.join(tmp, "f", "one.png"), Buffer.from("ONE"));
+    fs.writeFileSync(path.join(tmp, "f", "two.png"), Buffer.from("TWO"));
+    const html = "a{background:url(assets/f/one.png)} b{background:url(assets/f/two.png)}";
+    const out = inlineAssetsAsDataUrls(html, tmp);
+    expect(out).toContain(`data:image/png;base64,${Buffer.from("ONE").toString("base64")}`);
+    expect(out).toContain(`data:image/png;base64,${Buffer.from("TWO").toString("base64")}`);
+  });
+
+  it("uses image/svg+xml mime for .svg refs", () => {
+    fs.mkdirSync(path.join(tmp, "f"), { recursive: true });
+    fs.writeFileSync(path.join(tmp, "f", "icon.svg"), "<svg/>", "utf-8");
+    const html = "url(assets/f/icon.svg)";
+    const out = inlineAssetsAsDataUrls(html, tmp);
+    expect(out).toContain("data:image/svg+xml;base64,");
+  });
+
+  it("leaves the ref untouched when the asset file is missing", () => {
+    const html = "url(assets/missing/file.png)";
+    const out = inlineAssetsAsDataUrls(html, tmp);
+    expect(out).toBe(html);
+  });
+
+  it("does not touch data: or http(s): url() values (only matches assets/...)", () => {
+    const html =
+      "x{background:url(data:image/png;base64,AAA)} " +
+      "y{background:url(https://cdn.x/a.png)}";
+    expect(inlineAssetsAsDataUrls(html, tmp)).toBe(html);
+  });
+
+  it("handles quoted url(...) refs (single and double quotes)", () => {
+    fs.mkdirSync(path.join(tmp, "q"), { recursive: true });
+    fs.writeFileSync(path.join(tmp, "q", "k.png"), Buffer.from("K"));
+    const html =
+      "a{background:url('assets/q/k.png')} b{background:url(\"assets/q/k.png\")}";
+    const out = inlineAssetsAsDataUrls(html, tmp);
+    const data = `data:image/png;base64,${Buffer.from("K").toString("base64")}`;
+    expect(out.split(data).length - 1).toBe(2);
+  });
+});
+
+describe("handleExportStandalone (IMP-56 #90 u19)", () => {
+  let daRoot: string;
+
+  beforeEach(() => {
+    daRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp90-u19-da-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(daRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != POST", () => {
+    const req = makeMockReq({ method: "GET" });
+    const { res, state } = makeMockRes();
+    const handled = handleExportStandalone(req, res, daRoot);
+    expect(handled).toBe(false);
+    expect(state.ended).toBe(false);
+  });
+
+  it("returns 400 on invalid JSON body", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    const handled = handleExportStandalone(req, res, daRoot);
+    expect(handled).toBe(true);
+    req.send("{nope");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("invalid JSON");
+  });
+
+  it("returns 400 when body is not a JSON object (array root)", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify(["x"]));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("body must be a JSON object");
+  });
+
+  it("returns 400 when run_id is missing", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify({}));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("missing run_id");
+  });
+
+  it("returns 400 when run_id contains path traversal", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify({ run_id: "../escape" }));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body).error).toBe("invalid run_id");
+  });
+
+  it("returns 404 when final.html does not exist for run_id", () => {
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify({ run_id: "ghost_run" }));
+    expect(state.statusCode).toBe(404);
+    expect(JSON.parse(state.body).error).toBe("final.html not found");
+  });
+
+  it("returns 200 with text/html body + Content-Disposition on success", () => {
+    seedRun(daRoot, "mdx03_run", "<html><body>03</body></html>");
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify({ run_id: "mdx03_run" }));
+    expect(state.statusCode).toBe(200);
+    expect(state.headers["Content-Type"]).toBe("text/html; charset=utf-8");
+    expect(state.headers["Content-Disposition"]).toBe(
+      'attachment; filename="mdx03_run.html"',
+    );
+    expect(state.body).toBe("<html><body>03</body></html>");
+  });
+
+  it("inlines assets in final.html when run dir has assets/", () => {
+    const pngBytes = Buffer.from("PNGDATA");
+    seedRun(
+      daRoot,
+      "mdx05_run",
+      "<html><body><div style=\"background: url(assets/f/x.png)\"></div></body></html>",
+      { "f/x.png": pngBytes },
+    );
+    const req = makeMockReq({ method: "POST" });
+    const { res, state } = makeMockRes();
+    handleExportStandalone(req, res, daRoot);
+    req.send(JSON.stringify({ run_id: "mdx05_run" }));
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toContain(
+      `data:image/png;base64,${pngBytes.toString("base64")}`,
+    );
+    expect(state.body).not.toContain("url(assets/f/x.png)");
+  });
+});

Front/client/tests/imp90_structure_overlay.test.tsx

@@ -0,0 +1,150 @@
+// IMP-90 (#90) u14 — vitest coverage for the pure helpers exported by
+// `StructureEditOverlay`. The React component itself is not rendered
+// (jsdom / @testing-library NOT in Front devDependencies — verified in
+// `Front/package.json`); we test the deterministic pieces that drive its
+// JSX: `resolveEffectiveSlotOrder` (effective-order resolution under
+// override) and `moveItem` (immutable reorder primitive).
+//
+// Upstream / downstream contracts (verified by prior units):
+//   - u2  KNOWN_AXES += structure_overrides (Python backend).
+//   - u3  vite allowlist += structure_overrides.
+//   - u6  structure_override_resolver — inner shape locked to
+//         {slot_order, hidden_slots}; frame swap REJECTED to existing
+//         frames axis.
+//   - u10 typed-client `StructureOverridePerZone` + extract helper.
+//   - u15 (next) will debounce + PUT the emitted capture.
+//
+// u14 scope: pure helpers only. React render path is verified by Codex
+// auditor via static read of the JSX (no runtime test possible without
+// jsdom). Tests below are intentionally side-effect-free.
+
+import { describe, it, expect } from "vitest";
+import {
+  resolveEffectiveSlotOrder,
+  moveItem,
+} from "../src/components/StructureEditOverlay";
+
+// ─────────────────────────────────────────────────────────────────────
+// resolveEffectiveSlotOrder
+// ─────────────────────────────────────────────────────────────────────
+
+describe("resolveEffectiveSlotOrder — no override", () => {
+  it("returns a fresh copy of the discovered keys when slotOrder is undefined", () => {
+    const discovered = ["a", "b", "c"];
+    const out = resolveEffectiveSlotOrder(discovered, undefined);
+    expect(out).toEqual(["a", "b", "c"]);
+    expect(out).not.toBe(discovered);
+  });
+  it("returns a fresh copy when slotOrder is null", () => {
+    const out = resolveEffectiveSlotOrder(["a", "b"], null);
+    expect(out).toEqual(["a", "b"]);
+  });
+  it("returns a fresh copy when slotOrder is empty []", () => {
+    const out = resolveEffectiveSlotOrder(["a", "b"], []);
+    expect(out).toEqual(["a", "b"]);
+  });
+  it("handles empty discovered list (no slots in zone)", () => {
+    expect(resolveEffectiveSlotOrder([], undefined)).toEqual([]);
+    expect(resolveEffectiveSlotOrder([], ["x"])).toEqual([]);
+  });
+});
+
+describe("resolveEffectiveSlotOrder — full override", () => {
+  it("reorders all discovered keys per slotOrder", () => {
+    expect(
+      resolveEffectiveSlotOrder(["a", "b", "c"], ["c", "a", "b"]),
+    ).toEqual(["c", "a", "b"]);
+  });
+  it("is idempotent when slotOrder matches discovered order", () => {
+    expect(
+      resolveEffectiveSlotOrder(["a", "b", "c"], ["a", "b", "c"]),
+    ).toEqual(["a", "b", "c"]);
+  });
+});
+
+describe("resolveEffectiveSlotOrder — partial / drift override", () => {
+  it("appends missing discovered keys in backend order at the tail", () => {
+    // user reordered b -> first, but c was added later by backend.
+    expect(
+      resolveEffectiveSlotOrder(["a", "b", "c"], ["b", "a"]),
+    ).toEqual(["b", "a", "c"]);
+  });
+  it("drops override entries that no longer exist in discovered keys", () => {
+    // user had slot 'x' before; backend dropped it.
+    expect(
+      resolveEffectiveSlotOrder(["a", "b"], ["x", "a", "b"]),
+    ).toEqual(["a", "b"]);
+  });
+  it("dedupes duplicate entries within slotOrder", () => {
+    expect(
+      resolveEffectiveSlotOrder(["a", "b", "c"], ["a", "a", "b"]),
+    ).toEqual(["a", "b", "c"]);
+  });
+  it("dedupe + drop + append all together (stress)", () => {
+    expect(
+      resolveEffectiveSlotOrder(
+        ["a", "b", "c", "d"],
+        ["d", "x", "d", "a", "ghost"],
+      ),
+    ).toEqual(["d", "a", "b", "c"]);
+  });
+  it("ignores non-string entries in slotOrder", () => {
+    const bogus = ["a", null as unknown as string, undefined as unknown as string, "b"];
+    expect(resolveEffectiveSlotOrder(["a", "b"], bogus)).toEqual(["a", "b"]);
+  });
+});
+
+// ─────────────────────────────────────────────────────────────────────
+// moveItem
+// ─────────────────────────────────────────────────────────────────────
+
+describe("moveItem — happy paths", () => {
+  it("moves index 0 down by 1 (swap with index 1)", () => {
+    expect(moveItem(["a", "b", "c"], 0, 1)).toEqual(["b", "a", "c"]);
+  });
+  it("moves index 2 up by 1 (swap with index 1)", () => {
+    expect(moveItem(["a", "b", "c"], 2, -1)).toEqual(["a", "c", "b"]);
+  });
+  it("moves across larger delta (swap with target)", () => {
+    expect(moveItem(["a", "b", "c", "d"], 0, 2)).toEqual(["c", "b", "a", "d"]);
+  });
+});
+
+describe("moveItem — bounds", () => {
+  it("no-op (fresh copy) when moving first up", () => {
+    const src = ["a", "b", "c"];
+    const out = moveItem(src, 0, -1);
+    expect(out).toEqual(["a", "b", "c"]);
+    expect(out).not.toBe(src);
+  });
+  it("no-op when moving last down", () => {
+    expect(moveItem(["a", "b", "c"], 2, 1)).toEqual(["a", "b", "c"]);
+  });
+  it("no-op when index negative", () => {
+    expect(moveItem(["a", "b"], -1, 1)).toEqual(["a", "b"]);
+  });
+  it("no-op when index past end", () => {
+    expect(moveItem(["a", "b"], 5, -1)).toEqual(["a", "b"]);
+  });
+  it("no-op when target falls out of range from large delta", () => {
+    expect(moveItem(["a", "b", "c"], 1, 99)).toEqual(["a", "b", "c"]);
+  });
+  it("no-op on empty array (any index)", () => {
+    expect(moveItem<string>([], 0, 1)).toEqual([]);
+  });
+});
+
+describe("moveItem — immutability", () => {
+  it("never mutates the input array", () => {
+    const src = ["a", "b", "c"];
+    moveItem(src, 0, 1);
+    expect(src).toEqual(["a", "b", "c"]);
+  });
+  it("returns a new reference even when no-op", () => {
+    const src = ["a", "b"];
+    expect(moveItem(src, 0, -1)).not.toBe(src);
+  });
+  it("preserves T-typed values (number array)", () => {
+    expect(moveItem([1, 2, 3], 0, 1)).toEqual([2, 1, 3]);
+  });
+});

Front/client/tests/imp90_text_edit_capture.test.tsx

@@ -0,0 +1,259 @@
+// IMP-90 (#90) u13 — vitest coverage for `deriveTextEditCapture`, the pure
+// helper that resolves a contentEditable focusout target into the
+// (zone_id, text_path, value) capture tuple emitted by SlideCanvas.
+//
+// Upstream contract (verified by prior units):
+//   - u8 `src/text_path_stamper.py` stamps `data-text-path="{slot_key}.{
+//     line_index}"` on every rendered text-line opening tag at Step 13.
+//   - u9 wires the stamper into `render_slide` so the final.html consumed
+//     by SlideCanvas's iframe carries those attributes.
+//   - Phase Z slide-base wraps every zone in `.zone[data-zone-position]`
+//     (verified at SlideCanvas.tsx onLoad measure block).
+//
+// u13 scope: derive the capture tuple from any descendant of a stamped
+// line, OR the stamped line itself. Non-stamped targets (slide-base
+// title/footer, decorative spans outside the zone tree) return null so
+// the focusout handler silently skips them — never crashes.
+//
+// Forward-compat note: u15 will debounce + PUT the capture; u15 MUST NOT
+// alter the (target) -> {zoneId, textPath, value} | null contract verified
+// here. Any change to the resolution semantics is a scope-violation
+// against the u13 binding contract.
+//
+// jsdom is NOT in devDependencies (verified in Front/package.json); this
+// test mocks `TextEditCaptureTarget` with structurally-typed objects per
+// the established u11/u12 pure-helper pattern.
+
+import { describe, it, expect } from "vitest";
+import {
+  deriveTextEditCapture,
+  type TextEditCapture,
+  type TextEditCaptureTarget,
+} from "../src/components/SlideCanvas";
+
+// --- minimal closest-aware mock builders -----------------------------
+// Each node only needs to know which selectors it matches and its
+// parent chain — `closest` is implemented by walking parent pointers.
+
+interface MockNodeSpec {
+  matches: string[];
+  attrs?: Record<string, string>;
+  text?: string | null;
+  parent?: MockNode | null;
+}
+interface MockNode extends TextEditCaptureTarget {
+  matches(sel: string): boolean;
+  parent: MockNode | null;
+}
+function makeNode(spec: MockNodeSpec): MockNode {
+  const node: MockNode = {
+    parent: spec.parent ?? null,
+    matches(sel: string) {
+      return spec.matches.includes(sel);
+    },
+    closest(sel: string): TextEditCaptureTarget | null {
+      let cur: MockNode | null = node;
+      while (cur) {
+        if (cur.matches(sel)) return cur;
+        cur = cur.parent;
+      }
+      return null;
+    },
+    getAttribute(name: string): string | null {
+      return spec.attrs?.[name] ?? null;
+    },
+    textContent: spec.text === undefined ? null : spec.text,
+  };
+  return node;
+}
+
+// Canonical zone + line scaffold used across happy-path tests.
+// `null` for any field is preserved verbatim so edge cases (missing attr /
+// null textContent) can exercise the helper's defensive branches.
+function makeZoneLineScaffold(opts: {
+  zoneId?: string | null;
+  textPath?: string | null;
+  lineText?: string | null;
+}) {
+  const zone = makeNode({
+    matches: [".zone[data-zone-position]"],
+    attrs: opts.zoneId === null ? {} : { "data-zone-position": opts.zoneId ?? "top" },
+  });
+  const line = makeNode({
+    matches: ["[data-text-path]"],
+    attrs:
+      opts.textPath === null
+        ? {}
+        : { "data-text-path": opts.textPath ?? "row_1_left_body.0" },
+    text: opts.lineText === undefined ? "hello world" : opts.lineText,
+    parent: zone,
+  });
+  return { zone, line };
+}
+
+describe("deriveTextEditCapture (IMP-90 u13) — null inputs / non-stamped", () => {
+  it("returns null when target is null", () => {
+    expect(deriveTextEditCapture(null)).toBeNull();
+  });
+
+  it("returns null when no ancestor has data-text-path (e.g., slide title)", () => {
+    const title = makeNode({
+      matches: [".slide-title"],
+      text: "Phase Z 슬라이드",
+    });
+    expect(deriveTextEditCapture(title)).toBeNull();
+  });
+
+  it("returns null when the stamped line has no enclosing zone", () => {
+    // Decorative line stamped by the future u8 but rendered outside a
+    // zone (e.g., footer pill). u13 silently skips — caller never sees
+    // a half-resolved capture.
+    const orphanLine = makeNode({
+      matches: ["[data-text-path]"],
+      attrs: { "data-text-path": "footer.0" },
+      text: "결론",
+    });
+    expect(deriveTextEditCapture(orphanLine)).toBeNull();
+  });
+});
+
+describe("deriveTextEditCapture (IMP-90 u13) — happy path", () => {
+  it("resolves (zoneId, textPath, value) when target IS the stamped line", () => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      lineText: "분석 결과",
+    });
+    expect(deriveTextEditCapture(line)).toEqual<TextEditCapture>({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      value: "분석 결과",
+    });
+  });
+
+  it("walks up to the stamped line when target is a nested descendant", () => {
+    const { zone, line } = makeZoneLineScaffold({
+      zoneId: "bottom_l",
+      textPath: "left_body.2",
+      lineText: "wrapped",
+    });
+    // emulate a SPAN inside the stamped line (e.g., bold inline span)
+    const innerSpan = makeNode({
+      matches: ["span.highlight"],
+      text: "ignored — closest walks to the line",
+      parent: line,
+    });
+    void zone;
+    expect(deriveTextEditCapture(innerSpan)).toEqual<TextEditCapture>({
+      zoneId: "bottom_l",
+      textPath: "left_body.2",
+      value: "wrapped",
+    });
+  });
+
+  it("preserves the line's textContent without HTML normalization", () => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: "primary",
+      textPath: "headline.0",
+      lineText: "  spaced   inner   words  ",
+    });
+    // u13 trims outer whitespace but does NOT collapse interior whitespace
+    // — value mirrors what user typed, modulo blur-edge trim.
+    expect(deriveTextEditCapture(line)?.value).toBe("spaced   inner   words");
+  });
+
+  it("returns empty string when textContent is null (edge: empty line)", () => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      lineText: null,
+    });
+    expect(deriveTextEditCapture(line)?.value).toBe("");
+  });
+
+  it("returns empty string when textContent is whitespace-only", () => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      lineText: "   \n  \t  ",
+    });
+    expect(deriveTextEditCapture(line)?.value).toBe("");
+  });
+});
+
+describe("deriveTextEditCapture (IMP-90 u13) — missing attribute defensiveness", () => {
+  it("returns null when data-text-path attribute is absent on the matched line", () => {
+    // Should not happen with the u8 stamper, but a downstream mutation
+    // (e.g., user pasting a fresh element) could create a stamped-class
+    // node without the actual attribute. u13 stays defensive.
+    const zone = makeNode({
+      matches: [".zone[data-zone-position]"],
+      attrs: { "data-zone-position": "top" },
+    });
+    const lineNoPath = makeNode({
+      matches: ["[data-text-path]"],
+      attrs: {},
+      text: "hello",
+      parent: zone,
+    });
+    expect(deriveTextEditCapture(lineNoPath)).toBeNull();
+  });
+
+  it("returns null when data-zone-position attribute is absent on the matched zone", () => {
+    const zoneNoId = makeNode({
+      matches: [".zone[data-zone-position]"],
+      attrs: {},
+    });
+    const line = makeNode({
+      matches: ["[data-text-path]"],
+      attrs: { "data-text-path": "row_1_left_body.0" },
+      text: "hello",
+      parent: zoneNoId,
+    });
+    expect(deriveTextEditCapture(line)).toBeNull();
+  });
+});
+
+describe("deriveTextEditCapture (IMP-90 u13) — referential transparency", () => {
+  it("multiple calls with the same target return equal captures", () => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      lineText: "stable",
+    });
+    const a = deriveTextEditCapture(line);
+    const b = deriveTextEditCapture(line);
+    expect(a).toEqual(b);
+    expect(a).not.toBe(b); // fresh objects each call (caller-friendly)
+  });
+
+  it("does not mutate the target element (attrs / parent / textContent unchanged)", () => {
+    const { line, zone } = makeZoneLineScaffold({
+      zoneId: "top",
+      textPath: "row_1_left_body.0",
+      lineText: "immutable",
+    });
+    deriveTextEditCapture(line);
+    expect(line.getAttribute("data-text-path")).toBe("row_1_left_body.0");
+    expect(line.textContent).toBe("immutable");
+    expect(zone.getAttribute("data-zone-position")).toBe("top");
+  });
+});
+
+describe("deriveTextEditCapture (IMP-90 u13) — zone id pass-through", () => {
+  // u13 does not validate the zone id shape — Phase Z slide-base owns the
+  // canonical zone position vocabulary, and u15 / pipeline-side resolver
+  // (u4) re-validate downstream. u13 just forwards whatever the stamped
+  // DOM declared.
+  const ZONE_IDS = ["top", "bottom_l", "bottom_r", "primary", "secondary"];
+  it.each(ZONE_IDS)("preserves zone id '%s' verbatim", (zid) => {
+    const { line } = makeZoneLineScaffold({
+      zoneId: zid,
+      textPath: `${zid}.0`,
+      lineText: "x",
+    });
+    const cap = deriveTextEditCapture(line);
+    expect(cap?.zoneId).toBe(zid);
+    expect(cap?.textPath).toBe(`${zid}.0`);
+  });
+});

Front/client/tests/pipeline_trace_summary.test.ts

@@ -0,0 +1,176 @@
+import { describe, expect, it } from "vitest";
+import { buildAiTraceSummary, buildPipelineTraceSummary } from "../src/services/designAgentApi";
+
+describe("#98 Task 6 pipeline trace summary", () => {
+  it("connects sections, units, zones, and render-blocked warnings", () => {
+    const trace = buildPipelineTraceSummary({
+      normalized: {
+        data: {
+          sections: [
+            { section_id: "01-1", title: "S1" },
+            { section_id: "01-2", title: "S2" },
+          ],
+        },
+      },
+      compositionPlan: {
+        data: {
+          selected_units: [
+            {
+              source_section_ids: ["01-1"],
+              frame_template_id: "frame_a",
+              label: "use_as_is",
+              selection_path: "rank_1",
+            },
+            {
+              source_section_ids: ["01-2"],
+              frame_template_id: "frame_b",
+              label: "use_as_is",
+              selection_path: "provisional_rank_1",
+            },
+          ],
+        },
+      },
+      applicationPlan: {
+        data: {
+          units: [
+            {
+              unit_id: "01-1",
+              current_default_candidate: "frame_a",
+              sorted_candidate_evidence: [
+                { template_id: "frame_a", label: "use_as_is", confidence: 0.9 },
+              ],
+            },
+            {
+              unit_id: "01-2",
+              current_default_candidate: "frame_b",
+              sorted_candidate_evidence: [
+                { template_id: "frame_b", label: "use_as_is", confidence: 0.8 },
+              ],
+            },
+          ],
+        },
+      },
+      slotPayload: {
+        data: {
+          per_zone: [
+            { position: "top", template_id: "frame_a", slot_payload: { title: "S1" } },
+            { position: "bottom", template_id: "__empty__", slot_payload: {} },
+          ],
+        },
+      },
+      slideStatus: {
+        data: {
+          overall: "PARTIAL_COVERAGE",
+          covered_section_ids: ["01-1", "01-2"],
+          content_rendered_section_ids: ["01-1"],
+          filtered_section_ids: ["01-2"],
+          render_blocked_section_ids: ["01-2"],
+          adapter_needed_count: 1,
+          adapter_needed_units: [
+            {
+              position: "bottom",
+              source_section_ids: ["01-2"],
+              reason: "fit_error",
+            },
+          ],
+        },
+      },
+    });
+
+    expect(trace.sections.map((section) => [section.id, section.state])).toEqual([
+      ["01-1", "rendered"],
+      ["01-2", "render_blocked"],
+    ]);
+    expect(trace.sections[1].reasons).toEqual([
+      "fit_error",
+      "filtered",
+    ]);
+    expect(trace.units.map((unit) => [unit.unit_id, unit.candidate_count])).toEqual([
+      ["01-1", 1],
+      ["01-2", 1],
+    ]);
+    expect(trace.zones[1]).toMatchObject({
+      position: "bottom",
+      source_section_ids: ["01-2"],
+      template_id: "__empty__",
+      slot_status: "empty",
+      warnings: ["__empty__", "empty_slot_payload", "fit_error"],
+    });
+    expect(trace.warnings).toContain("render_blocked:01-2");
+    expect(trace.warnings).toContain("adapter_needed:1");
+  });
+});
+
+describe("#98 Task 7 AI trace summary", () => {
+  it("summarizes AI called/skipped/error state from step12_ai_repair", () => {
+    const trace = buildAiTraceSummary(
+      {
+        step_status: "done",
+        data: {
+          per_unit: [
+            {
+              unit_index: 0,
+              source_section_ids: ["04-1"],
+              frame_template_id: "frame_reject",
+              route_hint: "ai_adaptation_required",
+              provisional: true,
+              ai_called: false,
+              skip_reason: "router_short_circuit",
+              apply_status: "no_proposal",
+              api_error_kind: null,
+              error: null,
+            },
+            {
+              unit_index: 1,
+              source_section_ids: ["04-2"],
+              frame_template_id: "frame_auto",
+              route_hint: "direct_render",
+              provisional: false,
+              ai_called: false,
+              skip_reason: "not_provisional",
+              apply_status: "no_proposal",
+              api_error_kind: null,
+              error: null,
+            },
+          ],
+          coverage_invariant: { status: "ok" },
+        },
+      },
+      {
+        status: "ok",
+        counts: { total: 2, applied: 0, no_proposal: 2, no_zone_match: 0, unsupported_kind: 0, error: 0 },
+        unsupported_kind_records: [],
+        error_records: [],
+        coverage_status: "ok",
+        dropped_section_ids: [],
+        human_review_required: false,
+      },
+    );
+
+    expect(trace.artifact_present).toBe(true);
+    expect(trace.ai_enabled).toBe(false);
+    expect(trace.ai_called_count).toBe(0);
+    expect(trace.eligible_count).toBe(1);
+    expect(trace.skip_reasons).toEqual({
+      router_short_circuit: 1,
+      not_provisional: 1,
+    });
+    expect(trace.warnings).toContain("router_short_circuit");
+    expect(trace.units[0]).toMatchObject({
+      source_section_ids: ["04-1"],
+      route_hint: "ai_adaptation_required",
+      provisional: true,
+      ai_called: false,
+      skip_reason: "router_short_circuit",
+    });
+  });
+
+  it("surfaces missing step12 AI artifact as an explicit warning", () => {
+    const trace = buildAiTraceSummary(null, null);
+
+    expect(trace.artifact_present).toBe(false);
+    expect(trace.ai_enabled).toBeNull();
+    expect(trace.status).toBe("missing_artifact");
+    expect(trace.warnings).toEqual(["step12_ai_repair.json missing"]);
+  });
+});

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\");");
+  });
+});

Front/client/tests/run_pipeline_reuse_from.test.ts

@@ -0,0 +1,278 @@
+// IMP-43 (#72) u6 — /api/run reuseFromRunId forwarding coverage.
+//
+// Stage 2 unit scope:
+//   1) Front/client/src/services/designAgentApi.ts `runPipeline`:
+//      • accepts an optional 3rd arg `reuseFromRunId: string`.
+//      • includes `reuseFromRunId` in the POST body when truthy.
+//      • OMITS `reuseFromRunId` from the body when absent / empty / undefined
+//        → byte-identical to the pre-u6 POST contract (absent flag = full
+//        pipeline; backend u1 guard never sees an empty PREV_RUN_ID).
+//      • leaves `filename`, `content`, and `overrides` untouched alongside
+//        the new field (no payload-shape regression).
+//   2) Front/vite.config.ts `/api/run` handler:
+//      • declares `reuseFromRunId?: string` in the payload type so a typed
+//        client cannot send a payload the server silently drops.
+//      • destructures `reuseFromRunId` from `payload` (sibling of
+//        `overrides`, NOT nested under it — the backend u1 post-merge
+//        guard treats reuse as a pipeline mode, not an override).
+//      • forwards `--reuse-from <PREV_RUN_ID>` to spawn cliArgs guarded by
+//        a truthy check (empty string / undefined ⇒ no flag, per Stage 2
+//        contract: invalid CLI args must never reach argparse).
+//      • places the forward block AFTER the `--override-section-assignment`
+//        loop so the spawn argv preserves backend argparse's no-positional-
+//        before-flag expectation and so `--override-frame` (still allowed
+//        by the u1 guard) is positioned ahead of `--reuse-from`.
+//
+// runPipeline is exercised with a duck-typed `File` plus a `vi.stubGlobal`
+// fetch mock — mirrors the user_overrides_service.test.ts pattern. The
+// vite handler is source-sliced (mirrors handle_generate_diag.test.ts)
+// because the handler spawns python and a real /api/run round-trip is
+// out of unit-test scope.
+
+import { afterEach, beforeEach, describe, expect, it, vi, type Mock } from "vitest";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { runPipeline } from "../src/services/designAgentApi";
+
+// ---------------------------------------------------------------------------
+// vite.config.ts source — read once for the handler source-slice assertions.
+// Path: Front/client/tests/ → Front/vite.config.ts (two levels up).
+// ---------------------------------------------------------------------------
+const VITE_CONFIG_PATH = resolve(__dirname, "..", "..", "vite.config.ts");
+const VITE_CONFIG_SOURCE = readFileSync(VITE_CONFIG_PATH, "utf-8");
+
+// ---------------------------------------------------------------------------
+// fetch mock — minimal Response stub mirroring runPipeline's `.ok` + `.json()`
+// + `.status` surface. Same shape as the user_overrides_service.test.ts
+// helper so the two test files stay drift-free.
+// ---------------------------------------------------------------------------
+type MockResponse = {
+  ok: boolean;
+  status: number;
+  json: () => Promise<unknown>;
+};
+
+function mockResponse(body: unknown, ok = true, status = 200): MockResponse {
+  return { ok, status, json: async () => body };
+}
+
+const SUCCESS_BODY = {
+  success: true,
+  run_id: "test_run_id_20260524",
+  exit_code: 0,
+  final_html_exists: true,
+  preview_exists: true,
+  stdout: "",
+  stderr: "",
+};
+
+// Duck-typed File — runPipeline reads only `.name` and `.text()`. Avoids a
+// hard dependency on the global File constructor (varies across node /
+// jsdom / happy-dom test environments).
+function makeFakeFile(name: string, content: string): File {
+  return {
+    name,
+    text: async () => content,
+  } as unknown as File;
+}
+
+let fetchMock: Mock;
+
+beforeEach(() => {
+  fetchMock = vi.fn();
+  vi.stubGlobal("fetch", fetchMock);
+});
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+function lastPostBody(): Record<string, unknown> {
+  const lastCall = fetchMock.mock.calls.at(-1);
+  if (!lastCall) throw new Error("fetch was not called");
+  const init = lastCall[1] as RequestInit | undefined;
+  if (!init?.body) throw new Error("fetch was called without a body");
+  return JSON.parse(String(init.body));
+}
+
+// ============================================================================
+// runPipeline (designAgentApi.ts) — forwarding/omission coverage
+// ============================================================================
+
+describe("runPipeline reuseFromRunId forwarding (IMP-43 #72 u6)", () => {
+  it("posts to /api/run via POST with JSON content-type", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(makeFakeFile("03.mdx", "# title"));
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const [url, init] = fetchMock.mock.calls[0];
+    expect(url).toBe("/api/run");
+    expect((init as RequestInit).method).toBe("POST");
+    expect((init as RequestInit).headers).toMatchObject({
+      "Content-Type": "application/json",
+    });
+  });
+
+  it("includes reuseFromRunId in the POST body when provided", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(
+      makeFakeFile("03.mdx", "# title"),
+      undefined,
+      "mdx03_20260524080000",
+    );
+    const body = lastPostBody();
+    expect(body.reuseFromRunId).toBe("mdx03_20260524080000");
+    expect(body.filename).toBe("03.mdx");
+    expect(body.content).toBe("# title");
+  });
+
+  it("omits reuseFromRunId when 3rd arg is undefined (pre-u6 byte-identical)", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(makeFakeFile("03.mdx", "# title"));
+    const body = lastPostBody();
+    expect("reuseFromRunId" in body).toBe(false);
+    // Pre-u6 contract: filename/content are the only keys when overrides
+    // is undefined (JSON.stringify drops undefined values; pre-u6 emitted
+    // `JSON.stringify({filename, content, overrides})` with the same
+    // drop-undefined behaviour, so the wire body is byte-identical).
+    expect(Object.keys(body).sort()).toEqual(["content", "filename"]);
+  });
+
+  it("omits reuseFromRunId but keeps overrides when only overrides provided", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(makeFakeFile("03.mdx", "# title"), {
+      frames: { "03-1": "frame_07" },
+    });
+    const body = lastPostBody();
+    expect("reuseFromRunId" in body).toBe(false);
+    expect(Object.keys(body).sort()).toEqual([
+      "content",
+      "filename",
+      "overrides",
+    ]);
+    expect(body.overrides).toEqual({ frames: { "03-1": "frame_07" } });
+  });
+
+  it("omits reuseFromRunId when passed an empty string (truthy guard)", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(makeFakeFile("03.mdx", "# title"), undefined, "");
+    const body = lastPostBody();
+    expect("reuseFromRunId" in body).toBe(false);
+  });
+
+  it("forwards reuseFromRunId alongside frame overrides (the only u1-permitted combo)", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(
+      makeFakeFile("03.mdx", "# title"),
+      { frames: { "03-1+03-2": "frame_07" } },
+      "mdx03_20260524080000",
+    );
+    const body = lastPostBody();
+    expect(body.overrides).toEqual({ frames: { "03-1+03-2": "frame_07" } });
+    expect(body.reuseFromRunId).toBe("mdx03_20260524080000");
+  });
+
+  it("returns the parsed RunPipelineResult on success", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    const res = await runPipeline(
+      makeFakeFile("03.mdx", "# title"),
+      undefined,
+      "mdx03_20260524080000",
+    );
+    expect(res.success).toBe(true);
+    expect(res.run_id).toBe("test_run_id_20260524");
+  });
+
+  it("includes ignoreUserOverrides only when clean generate requests it", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(
+      makeFakeFile("03.mdx", "# title"),
+      undefined,
+      undefined,
+      { ignoreUserOverrides: true },
+    );
+    const cleanBody = lastPostBody();
+    expect(cleanBody.ignoreUserOverrides).toBe(true);
+
+    fetchMock.mockResolvedValueOnce(mockResponse(SUCCESS_BODY));
+    await runPipeline(makeFakeFile("03.mdx", "# title"));
+    const normalBody = lastPostBody();
+    expect("ignoreUserOverrides" in normalBody).toBe(false);
+  });
+});
+
+// ============================================================================
+// /api/run handler (vite.config.ts) — source-slice forwarding contract
+// ============================================================================
+
+describe("/api/run handler reuseFromRunId source-slice (IMP-43 #72 u6)", () => {
+  it("declares reuseFromRunId?: string on the /api/run payload type", () => {
+    // Payload type at the top of the /api/run handler body. The
+    // optional-string declaration is the single source-of-truth for what
+    // shape the handler accepts; a typed frontend client (u5 saveUserOverrides
+    // sibling pattern) cannot silently send a payload the server drops.
+    expect(VITE_CONFIG_SOURCE).toMatch(/reuseFromRunId\?:\s*string\s*;/);
+  });
+
+  it("declares ignoreUserOverrides?: boolean on the /api/run payload type", () => {
+    expect(VITE_CONFIG_SOURCE).toMatch(/ignoreUserOverrides\?:\s*boolean\s*;/);
+  });
+
+  it("destructures reuseFromRunId from payload alongside filename/content/overrides", () => {
+    expect(VITE_CONFIG_SOURCE).toMatch(
+      /const\s*\{\s*filename\s*,\s*content\s*,\s*overrides\s*,\s*reuseFromRunId\s*,\s*ignoreUserOverrides\s*\}\s*=\s*payload\s*;/,
+    );
+  });
+
+  it("forwards --reuse-from <PREV_RUN_ID> after the override-section-assignment loop", () => {
+    // Stage 2 contract: reuse_from is a pipeline mode, not an override.
+    // The forward block must sit AFTER the last override loop so the spawn
+    // argv preserves the order documented in the u1 backend post-merge
+    // guard (overrides parsed first; reuse_from precondition runs against
+    // the merged overrides view).
+    const reuseFromIdx = VITE_CONFIG_SOURCE.indexOf('"--reuse-from"');
+    const zoneSectionsIdx = VITE_CONFIG_SOURCE.indexOf(
+      '"--override-section-assignment"',
+    );
+    expect(reuseFromIdx).toBeGreaterThan(-1);
+    expect(zoneSectionsIdx).toBeGreaterThan(-1);
+    expect(reuseFromIdx).toBeGreaterThan(zoneSectionsIdx);
+  });
+
+  it("guards the forward with a truthy check on reuseFromRunId", () => {
+    // Empty string / undefined ⇒ no flag pushed (Stage 2 contract: invalid
+    // CLI args must never reach argparse — the backend u1 guard would
+    // fail-closed with `reuse_artifact_missing` on the empty PREV_RUN_ID).
+    const reuseFromIdx = VITE_CONFIG_SOURCE.indexOf('"--reuse-from"');
+    expect(reuseFromIdx).toBeGreaterThan(-1);
+    const preface = VITE_CONFIG_SOURCE.slice(
+      Math.max(0, reuseFromIdx - 200),
+      reuseFromIdx,
+    );
+    expect(preface).toMatch(/if\s*\(\s*reuseFromRunId/);
+    expect(preface).toMatch(/typeof\s+reuseFromRunId\s*===\s*"string"/);
+  });
+
+  it("pushes reuseFromRunId as the --reuse-from argument value (no string interpolation)", () => {
+    // The CLI value must be the raw PREV_RUN_ID — no `=` join, no quoting
+    // (spawn is shell:false). Mirrors the `--override-layout` shape.
+    const reuseFromIdx = VITE_CONFIG_SOURCE.indexOf('"--reuse-from"');
+    expect(reuseFromIdx).toBeGreaterThan(-1);
+    // Window spans both before (`cliArgs.push(`) and after
+    // (`reuseFromRunId)`) the literal so the full push expression is
+    // captured.
+    const window = VITE_CONFIG_SOURCE.slice(
+      Math.max(0, reuseFromIdx - 100),
+      reuseFromIdx + 200,
+    );
+    expect(window).toMatch(
+      /cliArgs\.push\(\s*"--reuse-from"\s*,\s*reuseFromRunId\s*\)/,
+    );
+  });
+
+  it("forwards --ignore-user-overrides only for clean generate requests", () => {
+    const ignoreIdx = VITE_CONFIG_SOURCE.indexOf('"--ignore-user-overrides"');
+    expect(ignoreIdx).toBeGreaterThan(-1);
+    const guardWindow = VITE_CONFIG_SOURCE.slice(Math.max(0, ignoreIdx - 160), ignoreIdx);
+    expect(guardWindow).toMatch(/ignoreUserOverrides\s*===\s*true/);
+  });
+});

Front/client/tests/user_overrides_endpoint.test.ts

@@ -0,0 +1,851 @@
+// IMP-52 u3/u4 — vitest coverage for the vite `/api/user-overrides/:key`
+// GET and PUT endpoints and their supporting helpers.
+//
+// Scope:
+//   u3 (read path):
+//     1) isValidUserOverridesKey: accept MDX-stem keys (03, 03__DX_BIM,
+//        a-b.c), reject empty / leading-dot / `..` / `/` / `\` /
+//        disallowed chars. Mirrors src/user_overrides_io.validate_key so
+//        backend (u2) and frontend endpoint (u3) agree on every key.
+//     2) userOverridesPath: returns <root>/data/user_overrides/<key>.json.
+//     3) handleGetUserOverrides: method != GET → false (next chained for
+//        PUT); invalid key → 400; missing file → 200 {}; corrupt JSON /
+//        non-object root → 200 {} (graceful degrade per u1 load contract);
+//        valid object JSON → 200 with parsed payload echoed back.
+//
+//   u4 (write path):
+//     4) mergeUserOverrides: only KNOWN_USER_OVERRIDES_AXES mutated;
+//        foreign top-level keys preserved; null clears axis; non-axis
+//        partial keys dropped (allowlist).
+//     5) atomicWriteUserOverrides: tmp + rename; parent dir auto-created.
+//     6) handlePutUserOverrides: method != PUT → false (next chained);
+//        invalid key → 400; invalid JSON → 400; non-object body → 400;
+//        success → 200 with merged result; partial-merge preserves axes
+//        not in payload; foreign-key preserve on disk; allowlist drops
+//        unknown payload keys; explicit null clears; corrupt existing →
+//        recover to clean state.
+//
+// Tests exercise the pure handlers with mock req/res — no real vite server.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import {
+  KNOWN_USER_OVERRIDES_AXES,
+  USER_OVERRIDES_KEY_RE,
+  atomicWriteUserOverrides,
+  handleGetUserOverrides,
+  handlePutUserOverrides,
+  isValidUserOverridesKey,
+  mergeUserOverrides,
+  userOverridesPath,
+} from "../../vite.config";
+
+// ---------------------------------------------------------------------------
+// mock res helper — captures writeHead(status, headers) + end(body) so the
+// handler can be invoked synchronously without spawning a TCP socket.
+// ---------------------------------------------------------------------------
+function makeMockRes() {
+  const state = {
+    statusCode: 0,
+    headers: {} as Record<string, string>,
+    body: "",
+    ended: false,
+  };
+  return {
+    state,
+    res: {
+      writeHead(status: number, headers?: Record<string, string>) {
+        state.statusCode = status;
+        if (headers) state.headers = headers;
+      },
+      end(body?: string) {
+        state.body = body ?? "";
+        state.ended = true;
+      },
+    },
+  };
+}
+
+describe("USER_OVERRIDES_KEY_RE (IMP-52 u3)", () => {
+  it("matches Python validate_key regex literally", () => {
+    // The pattern locked in src/user_overrides_io.py:_KEY_RE — any drift here
+    // means backend pipeline fallback (u2) and the vite endpoint disagree on
+    // which keys are routable, which is the single failure mode that would
+    // silently lose persisted overrides.
+    expect(USER_OVERRIDES_KEY_RE.source).toBe(
+      "^[A-Za-z0-9_][A-Za-z0-9_.\\-]*$",
+    );
+  });
+});
+
+describe("isValidUserOverridesKey (IMP-52 u3)", () => {
+  it("accepts MDX-stem-style keys actually used in samples/mdx/", () => {
+    // 03 / 04 / 05 are the wired sample MDXs (vite.config.ts:SAMPLE_MDX_MAP).
+    expect(isValidUserOverridesKey("03")).toBe(true);
+    expect(isValidUserOverridesKey("04")).toBe(true);
+    expect(isValidUserOverridesKey("05")).toBe(true);
+    // Stage 1 EVIDENCE references 03__DX_BIM... — must round-trip.
+    expect(isValidUserOverridesKey("03__DX_BIM")).toBe(true);
+    expect(isValidUserOverridesKey("a-b.c")).toBe(true);
+    expect(isValidUserOverridesKey("a")).toBe(true);
+    expect(isValidUserOverridesKey("_leading_underscore")).toBe(true);
+    expect(isValidUserOverridesKey("9starts_with_digit")).toBe(true);
+  });
+
+  it("rejects empty and whitespace-only keys", () => {
+    expect(isValidUserOverridesKey("")).toBe(false);
+  });
+
+  it("rejects path-traversal substrings", () => {
+    // `..` rejected explicitly even if the rest of the regex would allow it
+    // — `a..b` would otherwise pass the char class.
+    expect(isValidUserOverridesKey("..")).toBe(false);
+    expect(isValidUserOverridesKey("a..b")).toBe(false);
+    expect(isValidUserOverridesKey("../escape")).toBe(false);
+  });
+
+  it("rejects path separators", () => {
+    expect(isValidUserOverridesKey("a/b")).toBe(false);
+    expect(isValidUserOverridesKey("a\\b")).toBe(false);
+    expect(isValidUserOverridesKey("/")).toBe(false);
+    expect(isValidUserOverridesKey("\\")).toBe(false);
+  });
+
+  it("rejects keys starting with a non-word character", () => {
+    expect(isValidUserOverridesKey(".hidden")).toBe(false);
+    expect(isValidUserOverridesKey("-leading-dash")).toBe(false);
+  });
+
+  it("rejects characters outside [A-Za-z0-9_.-]", () => {
+    expect(isValidUserOverridesKey("a b")).toBe(false);
+    expect(isValidUserOverridesKey("a:b")).toBe(false);
+    expect(isValidUserOverridesKey("a*b")).toBe(false);
+    expect(isValidUserOverridesKey("a%2Fb")).toBe(false);
+  });
+});
+
+describe("userOverridesPath (IMP-52 u3)", () => {
+  it("resolves <root>/data/user_overrides/<key>.json regardless of OS sep", () => {
+    const root = path.join("X:", "design_agent");
+    const got = userOverridesPath(root, "03");
+    expect(got).toBe(path.join(root, "data", "user_overrides", "03.json"));
+  });
+});
+
+describe("handleGetUserOverrides (IMP-52 u3)", () => {
+  let tmpRoot: string;
+  let overridesDir: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u3-"));
+    overridesDir = path.join(tmpRoot, "data", "user_overrides");
+    fs.mkdirSync(overridesDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != GET", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "PUT", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(false);
+    // Crucial for u4: PUT must reach its own middleware unobstructed.
+    expect(state.ended).toBe(false);
+    expect(state.statusCode).toBe(0);
+  });
+
+  it("returns 400 on invalid key (path traversal)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/../escape" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid key" });
+  });
+
+  it("returns 400 on invalid key (missing key segment)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+  });
+
+  it("returns 200 {} on missing file (graceful degrade)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+  });
+
+  it("returns 200 {} on corrupt JSON (graceful degrade)", () => {
+    fs.writeFileSync(path.join(overridesDir, "03.json"), "{not json", "utf-8");
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+  });
+
+  it("returns 200 {} when JSON root is not an object", () => {
+    // Mirrors u1 load() which treats non-object roots as corrupt — covers
+    // both arrays and primitives so the frontend never receives a shape
+    // the typed service (u5) can't deserialize.
+    fs.writeFileSync(
+      path.join(overridesDir, "arr.json"),
+      JSON.stringify([1, 2, 3]),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/arr" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+
+    fs.writeFileSync(path.join(overridesDir, "num.json"), "42", "utf-8");
+    const { res: res2, state: state2 } = makeMockRes();
+    handleGetUserOverrides({ method: "GET", url: "/num" }, res2, tmpRoot);
+    expect(state2.statusCode).toBe(200);
+    expect(state2.body).toBe("{}");
+  });
+
+  it("returns 200 with parsed JSON object on hit", () => {
+    const payload = {
+      layout: "two_zone_split",
+      frames: { "03-1+03-2": "frame_07" },
+      zone_geometries: {
+        top: { x: 0.05, y: 0.1, w: 0.9, h: 0.3 },
+      },
+      zone_sections: { top: ["03-1", "03-2"] },
+    };
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify(payload),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.headers["Content-Type"]).toBe(
+      "application/json; charset=utf-8",
+    );
+    expect(JSON.parse(state.body)).toEqual(payload);
+  });
+
+  it("preserves foreign top-level keys in the response", () => {
+    // Forward-compat with future axes (e.g., zone_sizes, image_overrides).
+    // u1 save() preserves them on the disk side; u3 GET must surface them
+    // so the frontend service (u5) can decide whether to act on them.
+    const payload = {
+      layout: "single_zone",
+      zone_sizes: { top: 0.42 }, // not part of KNOWN_AXES yet
+      custom_extension: { foo: "bar" },
+    };
+    fs.writeFileSync(
+      path.join(overridesDir, "future.json"),
+      JSON.stringify(payload),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    handleGetUserOverrides({ method: "GET", url: "/future" }, res, tmpRoot);
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual(payload);
+  });
+
+  it("strips the leading slash and ignores query string when keying", () => {
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "x" }),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    handleGetUserOverrides(
+      { method: "GET", url: "/03?ts=1747884800" },
+      res,
+      tmpRoot,
+    );
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual({ layout: "x" });
+  });
+});
+
+// ---------------------------------------------------------------------------
+// IMP-52 u4 — PUT endpoint coverage
+// ---------------------------------------------------------------------------
+
+describe("KNOWN_USER_OVERRIDES_AXES (IMP-52 u4 + IMP-56 #90 u3 allowlist sync)", () => {
+  it("matches the Python KNOWN_AXES tuple in src/user_overrides_io.py", () => {
+    // The on-disk schema is shared with backend pipeline fallback (u2).
+    // Any drift here means a PUT could write an axis that the Python
+    // load() ignores, or vice-versa, silently losing user overrides.
+    // IMP-56 #90 u3 closes the prior `slide_css` gap (IMP-45 #74) and
+    // pre-wires `text_overrides` (IMP-56 #90 u1) +
+    // `structure_overrides` (IMP-56 #90 u2) — full 9-axis mirror of the
+    // Python tuple, same order.
+    expect(KNOWN_USER_OVERRIDES_AXES).toEqual([
+      "layout",
+      "zone_geometries",
+      "zone_sections",
+      "frames",
+      "image_overrides",
+      "slide_css",
+      "manual_section_assignment",
+      "text_overrides",
+      "structure_overrides",
+    ]);
+  });
+
+  it("includes the 3 axes added by IMP-56 #90 u3 (allowlist sync)", () => {
+    // Spot-check the diff in addition to the full-equality assertion so a
+    // future edit that drops one of the new axes fails with a localized
+    // error rather than a 9-vs-N tuple-diff that obscures intent.
+    expect(KNOWN_USER_OVERRIDES_AXES).toContain("slide_css");
+    expect(KNOWN_USER_OVERRIDES_AXES).toContain("text_overrides");
+    expect(KNOWN_USER_OVERRIDES_AXES).toContain("structure_overrides");
+    expect(KNOWN_USER_OVERRIDES_AXES.length).toBe(9);
+  });
+});
+
+describe("mergeUserOverrides (IMP-55 #93 u1) — manual_section_assignment bool axis", () => {
+  it("merges bool true / false literally and clears on null", () => {
+    // The PUT handler must treat the bool axis like any other allowlisted
+    // axis: replace on write, preserve when absent, delete on null. Tests
+    // both true→false flip and explicit null-clear so the backend (u9)
+    // sees the exact frontend intent.
+    let merged = mergeUserOverrides({}, { manual_section_assignment: true });
+    expect(merged.manual_section_assignment).toBe(true);
+
+    merged = mergeUserOverrides(merged, { manual_section_assignment: false });
+    expect(merged.manual_section_assignment).toBe(false);
+
+    merged = mergeUserOverrides(merged, { manual_section_assignment: null });
+    expect("manual_section_assignment" in merged).toBe(false);
+  });
+
+  it("preserves bool axis when partial touches only a sibling axis", () => {
+    const existing = { manual_section_assignment: true, layout: "old" };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.manual_section_assignment).toBe(true);
+    expect(merged.layout).toBe("new");
+  });
+});
+
+describe("mergeUserOverrides (IMP-52 u4)", () => {
+  it("only mutates KNOWN_AXES present in partial", () => {
+    const existing = {
+      layout: "old",
+      frames: { "03-1": "frame_01" },
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.layout).toBe("new");
+    // axes not in partial are preserved
+    expect(merged.frames).toEqual({ "03-1": "frame_01" });
+    expect(merged.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+    expect(merged.zone_sections).toEqual({ top: ["03-1"] });
+  });
+
+  it("preserves foreign top-level keys in existing", () => {
+    // Forward-compat: future axes (zone_sizes, schema_version, etc.) on
+    // disk must survive PUT writes that only touch the 5 in-scope axes.
+    // `image_overrides` is no longer a foreign key after IMP-51 #79 u2 —
+    // it joined KNOWN_USER_OVERRIDES_AXES — so we probe with axes that
+    // are still NOT in the allowlist.
+    const existing = {
+      layout: "old",
+      zone_sizes: { top: 0.42 },
+      schema_version: 2,
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.zone_sizes).toEqual({ top: 0.42 });
+    expect(merged.schema_version).toBe(2);
+  });
+
+  it("clears axis when partial value is null (explicit clear)", () => {
+    const existing = { layout: "x", frames: { "03-1": "f01" } };
+    const merged = mergeUserOverrides(existing, { layout: null });
+    expect("layout" in merged).toBe(false);
+    expect(merged.frames).toEqual({ "03-1": "f01" });
+  });
+
+  it("drops non-axis keys in partial (allowlist)", () => {
+    // PUT payload may carry junk fields (typo, malicious key); allowlist
+    // ensures only the 5 axes can be written to disk.
+    const merged = mergeUserOverrides(
+      {},
+      { layout: "x", random_key: "evil", __proto__: "x" } as Record<
+        string,
+        unknown
+      >,
+    );
+    expect(merged.layout).toBe("x");
+    expect("random_key" in merged).toBe(false);
+  });
+
+  it("merges all 5 axes when present in partial", () => {
+    const merged = mergeUserOverrides(
+      {},
+      {
+        layout: "two_zone_split",
+        frames: { "03-1+03-2": "frame_07" },
+        zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+        zone_sections: { top: ["03-1", "03-2"] },
+        image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+      },
+    );
+    expect(Object.keys(merged).sort()).toEqual([
+      "frames",
+      "image_overrides",
+      "layout",
+      "zone_geometries",
+      "zone_sections",
+    ]);
+  });
+
+  it("preserves image_overrides when absent from partial (5th axis IMP-51 #79 u2)", () => {
+    // Sibling axis of layout/frames/zone_geometries/zone_sections: a PUT
+    // that touches only layout must NOT erase the image_overrides map
+    // already on disk. Mirrors the partial-merge invariant for the 4
+    // pre-existing axes.
+    const existing = {
+      layout: "old",
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.image_overrides).toEqual({
+      "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 },
+    });
+    expect(merged.layout).toBe("new");
+  });
+
+  it("clears image_overrides when partial value is null (explicit clear)", () => {
+    // Same null-sentinel contract as the 4 sibling axes — `null` removes
+    // the axis from disk so the next render reverts to baseline (no
+    // user image position/size override).
+    const existing = {
+      layout: "x",
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    };
+    const merged = mergeUserOverrides(existing, { image_overrides: null });
+    expect("image_overrides" in merged).toBe(false);
+    expect(merged.layout).toBe("x");
+  });
+
+  it("does not mutate the existing input", () => {
+    const existing = { layout: "old", frames: { a: "b" } };
+    const snapshot = JSON.parse(JSON.stringify(existing));
+    mergeUserOverrides(existing, { layout: "new", layout_evil: "x" } as Record<
+      string,
+      unknown
+    >);
+    expect(existing).toEqual(snapshot);
+  });
+});
+
+describe("atomicWriteUserOverrides (IMP-52 u4)", () => {
+  let tmpRoot: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u4-aw-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("creates parent dir if missing and writes JSON content", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    expect(fs.existsSync(path.dirname(filePath))).toBe(false);
+    atomicWriteUserOverrides(filePath, { layout: "x" });
+    expect(fs.existsSync(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "x",
+    });
+  });
+
+  it("leaves no .tmp residue after a successful write", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    atomicWriteUserOverrides(filePath, { layout: "x" });
+    const dirContents = fs.readdirSync(path.dirname(filePath));
+    expect(dirContents).toEqual(["03.json"]);
+  });
+
+  it("overwrites an existing file atomically", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    atomicWriteUserOverrides(filePath, { layout: "v1" });
+    atomicWriteUserOverrides(filePath, { layout: "v2" });
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "v2",
+    });
+  });
+});
+
+// req mock — EventEmitter with method/url + a `send(body)` helper that
+// emits the data chunk and then `end`, mirroring the node IncomingMessage
+// flow used by vite's dev middlewares.
+function makeMockReq(opts: {
+  method?: string;
+  url?: string;
+}): EventEmitter & { method?: string; url?: string; send: (body: string) => void } {
+  const ee = new EventEmitter() as EventEmitter & {
+    method?: string;
+    url?: string;
+    send: (body: string) => void;
+  };
+  ee.method = opts.method;
+  ee.url = opts.url;
+  ee.send = (body: string) => {
+    if (body.length > 0) ee.emit("data", Buffer.from(body, "utf-8"));
+    ee.emit("end");
+  };
+  return ee;
+}
+
+describe("handlePutUserOverrides (IMP-52 u4)", () => {
+  let tmpRoot: string;
+  let overridesDir: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u4-"));
+    overridesDir = path.join(tmpRoot, "data", "user_overrides");
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != PUT", () => {
+    const req = makeMockReq({ method: "GET", url: "/03" });
+    const { res, state } = makeMockRes();
+    const handled = handlePutUserOverrides(req, res, tmpRoot);
+    expect(handled).toBe(false);
+    expect(state.ended).toBe(false);
+  });
+
+  it("returns 400 on invalid key", () => {
+    const req = makeMockReq({ method: "PUT", url: "/../escape" });
+    const { res, state } = makeMockRes();
+    const handled = handlePutUserOverrides(req, res, tmpRoot);
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid key" });
+  });
+
+  it("returns 400 on invalid JSON body", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("{not json");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid JSON" });
+    // file MUST NOT have been created on parse failure
+    expect(fs.existsSync(path.join(overridesDir, "03.json"))).toBe(false);
+  });
+
+  it("returns 400 when JSON body is an array", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify([1, 2, 3]));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({
+      error: "body must be a JSON object",
+    });
+  });
+
+  it("returns 400 when JSON body is a primitive", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("42");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({
+      error: "body must be a JSON object",
+    });
+  });
+
+  it("creates the override file on first PUT and returns merged body", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    const payload = { layout: "two_zone_split" };
+    req.send(JSON.stringify(payload));
+
+    expect(state.statusCode).toBe(200);
+    expect(state.headers["Content-Type"]).toBe(
+      "application/json; charset=utf-8",
+    );
+    expect(JSON.parse(state.body)).toEqual({ layout: "two_zone_split" });
+
+    const filePath = path.join(overridesDir, "03.json");
+    expect(fs.existsSync(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "two_zone_split",
+    });
+  });
+
+  it("partial-merges: axes absent from payload are preserved on disk", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({
+        layout: "old",
+        frames: { "03-1": "frame_01" },
+        zone_sections: { top: ["03-1"] },
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "new" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({
+      layout: "new",
+      frames: { "03-1": "frame_01" },
+      zone_sections: { top: ["03-1"] },
+    });
+  });
+
+  it("preserves foreign top-level keys on disk (forward-compat)", () => {
+    // `image_overrides` is no longer a foreign key after IMP-51 #79 u2;
+    // probe with axes that are still NOT in KNOWN_USER_OVERRIDES_AXES.
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "future.json"),
+      JSON.stringify({
+        layout: "old",
+        zone_sizes: { top: 0.42 },
+        schema_version: 2,
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/future" });
+    const { res } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "new" }));
+
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "future.json"), "utf-8"),
+    );
+    expect(onDisk.zone_sizes).toEqual({ top: 0.42 });
+    expect(onDisk.schema_version).toBe(2);
+    expect(onDisk.layout).toBe("new");
+  });
+
+  it("persists image_overrides partial-merge and preserves sibling axes (IMP-51 #79 u2)", () => {
+    // 5th axis end-to-end PUT round-trip: writing only image_overrides
+    // must NOT touch the 4 sibling axes already on disk. Mirrors the
+    // existing partial-merge test for layout above.
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({
+        layout: "two_zone_split",
+        frames: { "03-1": "frame_01" },
+        zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+        zone_sections: { top: ["03-1"] },
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(
+      JSON.stringify({
+        image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+      }),
+    );
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    });
+  });
+
+  it("drops non-axis payload keys (allowlist enforced at write)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    req.send(
+      JSON.stringify({
+        layout: "two_zone_split",
+        random_evil_key: "should not persist",
+      }),
+    );
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "two_zone_split" });
+    expect("random_evil_key" in onDisk).toBe(false);
+  });
+
+  it("clears an axis when payload sets it to null", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "old", frames: { "03-1": "f01" } }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: null }));
+
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect("layout" in onDisk).toBe(false);
+    expect(onDisk.frames).toEqual({ "03-1": "f01" });
+  });
+
+  it("recovers from corrupt existing file (graceful degrade)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      "{this is not JSON",
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "recovered" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "recovered" });
+  });
+
+  it("treats array-rooted existing file as empty (graceful degrade)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify(["not", "an", "object"]),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "recovered" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "recovered" });
+  });
+
+  it("strips the leading slash and ignores query string when keying", () => {
+    const req = makeMockReq({
+      method: "PUT",
+      url: "/03?ts=1747884800",
+    });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "x" }));
+
+    expect(state.statusCode).toBe(200);
+    expect(fs.existsSync(path.join(overridesDir, "03.json"))).toBe(true);
+  });
+
+  it("accepts an empty body as a no-op partial (no axes mutated)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "kept" }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("");
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "kept" });
+  });
+
+  it("accepts a chunked PUT body (concatenates data events)", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    const body = JSON.stringify({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+    });
+    // Emit in two halves to simulate a fragmented HTTP body.
+    const half = Math.floor(body.length / 2);
+    req.emit("data", Buffer.from(body.slice(0, half), "utf-8"));
+    req.emit("data", Buffer.from(body.slice(half), "utf-8"));
+    req.emit("end");
+
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+    });
+  });
+});

Front/client/tests/user_overrides_restore.test.ts

@@ -0,0 +1,706 @@
+// IMP-52 u6 — vitest coverage for restore-on-reopen helpers used by
+// `Home.tsx` to layer persisted `user_overrides.json` payloads onto the
+// in-memory `UserSelection` and `slidePlan`.
+//
+// Scope (Stage 2 unit u6 contract):
+//   1) deriveUserOverridesKey(filename) — MDX-stem key derivation that
+//      matches backend u2 fallback's `Path(args.mdx_path).stem`. Strips
+//      `.mdx` case-insensitively; preserves everything else.
+//   2) applyPersistedNonFrameOverrides(selection, persisted) — layers
+//      layout / zone_geometries / zone_sections onto an existing selection.
+//      Frames are NOT layered here (unit_id key requires slidePlan).
+//      Foreign / unrecognized payloads degrade silently (no throw, no
+//      partial mutation).
+//   3) remapPersistedFramesToZoneFrames(slidePlan, framesByUnitId) —
+//      remaps frames (unit_id → template_id) to zone_frames (region.id →
+//      template_id). Stale unit_ids (no matching zone) drop silently;
+//      zones without internal_regions[0] or without section_ids are
+//      skipped without throwing.
+//
+// All helpers are pure; tests run in vitest's default node environment
+// without RTL / jsdom. Home.tsx wiring sites (handleFileUpload pre-Generate
+// seed + handleGenerate post-loadRun frame remap) are 1-line call sites that
+// these helpers cover end-to-end.
+
+import { describe, it, expect } from "vitest";
+import type {
+  LayoutPresetId,
+  SlidePlan,
+  UserSelection,
+  Zone,
+} from "../src/types/designAgent";
+import {
+  applyPersistedNonFrameOverrides,
+  createInitialUserSelection,
+  deriveUserOverridesKey,
+  remapPersistedFramesToZoneFrames,
+  saveImageOverride,
+  saveTextOverride,
+  saveStructureOverride,
+} from "../src/utils/slidePlanUtils";
+
+// ─── Fixtures ───────────────────────────────────────────────────────────────
+
+function makeSelection(overrides?: Partial<UserSelection["overrides"]>): UserSelection {
+  return {
+    selectedSectionId: null,
+    selectedZoneId: null,
+    selectedRegionId: null,
+    overrides: {
+      layout_preset: undefined,
+      zone_frames: {},
+      zone_sections: {},
+      zone_sizes: {},
+      zone_geometries: {},
+      // IMP-51 (#79) u11 — keep the fixture in sync with the 5th persisted
+      // axis declared on `UserSelection.overrides`. Empty by default so the
+      // existing IMP-52 cases remain unchanged in shape.
+      image_overrides: {},
+      // IMP-55 (#93) u3 — bool intent marker is REQUIRED on
+      // `UserSelection.overrides` (not optional). Default to `false` so every
+      // pre-existing fixture matches the `createInitialUserSelection` seed
+      // and stays compile-clean after u3 widened the type.
+      manual_section_assignment: false,
+      // IMP-56 (#90) u15 — keep the fixture in sync with the two Step-22
+      // persist axes declared on `UserSelection.overrides`. Empty by
+      // default so pre-existing cases retain their shape.
+      text_overrides: {},
+      structure_overrides: {},
+      ...overrides,
+    },
+  };
+}
+
+function makeZone(
+  partial: { id: string; zone_id: string; section_ids: string[]; region_id?: string },
+): Zone {
+  return {
+    id: partial.id,
+    zone_id: partial.zone_id,
+    section_ids: partial.section_ids,
+    position: { x: 0, y: 0, width: 1, height: 1 },
+    internal_regions: [
+      {
+        id: partial.region_id ?? `${partial.id}-r0`,
+        region_id: "region-single",
+        role: "primary",
+        content_type: "text_block",
+        ratio_estimate: 1,
+        content_unit_ids: [],
+        frame_match_strategy: {
+          kind: "frame_match",
+          frame_id: null,
+          display_strategy: "inline_full",
+        },
+        frame_candidates: [],
+      },
+    ],
+  };
+}
+
+function makeSlidePlan(zones: Zone[], layout: LayoutPresetId = "single"): SlidePlan {
+  return {
+    id: "plan-1",
+    title: "test plan",
+    layout_preset: layout,
+    zones,
+  };
+}
+
+// ─── deriveUserOverridesKey ─────────────────────────────────────────────────
+
+describe("deriveUserOverridesKey (IMP-52 u6)", () => {
+  it("strips trailing .mdx", () => {
+    expect(deriveUserOverridesKey("03__DX_BIM_value_chain.mdx")).toBe(
+      "03__DX_BIM_value_chain",
+    );
+  });
+
+  it("strips .MDX case-insensitively", () => {
+    expect(deriveUserOverridesKey("04_demo.MDX")).toBe("04_demo");
+    expect(deriveUserOverridesKey("05_intro.Mdx")).toBe("05_intro");
+  });
+
+  it("returns the filename unchanged when no .mdx suffix", () => {
+    expect(deriveUserOverridesKey("03__DX_BIM_value_chain")).toBe(
+      "03__DX_BIM_value_chain",
+    );
+    expect(deriveUserOverridesKey("notes.txt")).toBe("notes.txt");
+  });
+
+  it("only strips the final .mdx, preserves dots inside the stem", () => {
+    expect(deriveUserOverridesKey("05.2_layer.mdx")).toBe("05.2_layer");
+  });
+
+  it("returns empty string for empty input", () => {
+    expect(deriveUserOverridesKey("")).toBe("");
+  });
+
+  it("matches backend Path(args.mdx_path).stem for the canonical demo MDXs", () => {
+    // These are the three canonical samples loaded by /api/sample-mdx; the
+    // key on both ends must agree so a write from frontend (PUT) is found
+    // by backend (u2 fallback on next pipeline run).
+    expect(deriveUserOverridesKey("03_demo.mdx")).toBe("03_demo");
+    expect(deriveUserOverridesKey("04_demo.mdx")).toBe("04_demo");
+    expect(deriveUserOverridesKey("05_demo.mdx")).toBe("05_demo");
+  });
+});
+
+// ─── applyPersistedNonFrameOverrides ────────────────────────────────────────
+
+describe("applyPersistedNonFrameOverrides (IMP-52 u6)", () => {
+  it("layers layout / zone_geometries / zone_sections", () => {
+    const sel = makeSelection();
+    const persisted = {
+      layout: "horizontal-2",
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.4 } },
+      zone_sections: { top: ["03-1"], bottom: ["03-2"] },
+    } as const;
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.4 },
+    });
+    expect(next.overrides.zone_sections).toEqual({
+      top: ["03-1"],
+      bottom: ["03-2"],
+    });
+  });
+
+  it("does NOT layer frames (frames need post-loadRun remap)", () => {
+    const sel = makeSelection({ zone_frames: { "r-existing": "tpl-existing" } });
+    const persisted = {
+      frames: { "03-1+03-2": "tpl-persisted" },
+    };
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    // zone_frames is untouched here; the post-loadRun remap step owns it.
+    expect(next.overrides.zone_frames).toEqual({ "r-existing": "tpl-existing" });
+  });
+
+  it("rejects layout values outside the 8 known preset ids", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      layout: "rogue-layout" as unknown as string,
+    });
+    // Stays at the original — preset whitelist guards against hand-edited
+    // files or future schema drift.
+    expect(next.overrides.layout_preset).toBe("single");
+  });
+
+  it("ignores zone_geometries when the payload axis is an array", () => {
+    const sel = makeSelection({ zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } } });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      zone_geometries: [] as unknown as Record<string, { x: number; y: number; w: number; h: number }>,
+    });
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+  });
+
+  it("returns the selection unchanged when persisted is null / undefined / non-object", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    expect(applyPersistedNonFrameOverrides(sel, null)).toEqual(sel);
+    expect(applyPersistedNonFrameOverrides(sel, undefined)).toEqual(sel);
+  });
+
+  it("returns the selection unchanged when persisted is empty {}", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    const next = applyPersistedNonFrameOverrides(sel, {});
+    expect(next.overrides.layout_preset).toBe("single");
+    expect(next.overrides.zone_geometries).toEqual({});
+    expect(next.overrides.zone_sections).toEqual({});
+  });
+
+  it("returns a NEW selection object (no mutation of input)", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, { layout: "vertical-2" });
+    expect(next).not.toBe(sel);
+    expect(next.overrides).not.toBe(sel.overrides);
+    // Input still pristine.
+    expect(sel.overrides.layout_preset).toBeUndefined();
+  });
+});
+
+// ─── remapPersistedFramesToZoneFrames ───────────────────────────────────────
+
+describe("remapPersistedFramesToZoneFrames (IMP-52 u6)", () => {
+  it("maps unit_id (section_ids joined by +) to region.id", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+      makeZone({ id: "z-bot", zone_id: "bottom", section_ids: ["03-2", "03-3"], region_id: "r-bot" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "tpl-a",
+      "03-2+03-3": "tpl-b",
+    });
+    expect(remapped).toEqual({
+      "r-top": "tpl-a",
+      "r-bot": "tpl-b",
+    });
+  });
+
+  it("silently drops persisted entries whose unit_id matches no zone", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "tpl-a",
+      "stale-section-id": "tpl-stale", // user changed zone_sections between sessions
+    });
+    expect(remapped).toEqual({ "r-top": "tpl-a" });
+  });
+
+  it("returns {} when slidePlan is null / undefined", () => {
+    expect(remapPersistedFramesToZoneFrames(null, { "03-1": "tpl-a" })).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(undefined, { "03-1": "tpl-a" })).toEqual({});
+  });
+
+  it("returns {} when framesByUnitId is null / undefined / {}", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    expect(remapPersistedFramesToZoneFrames(plan, null)).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(plan, undefined)).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(plan, {})).toEqual({});
+  });
+
+  it("skips zones with empty section_ids (no unit_id to derive)", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-empty", zone_id: "empty", section_ids: [], region_id: "r-empty" }),
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "": "tpl-should-not-match-empty-join",
+      "03-1": "tpl-a",
+    });
+    expect(remapped).toEqual({ "r-top": "tpl-a" });
+  });
+
+  it("skips zones without internal_regions[0]", () => {
+    const plan: SlidePlan = {
+      id: "plan-x",
+      title: "no regions",
+      layout_preset: "single",
+      zones: [
+        {
+          id: "z-bare",
+          zone_id: "bare",
+          section_ids: ["03-1"],
+          position: { x: 0, y: 0, width: 1, height: 1 },
+          internal_regions: [],
+        },
+      ],
+    };
+    expect(remapPersistedFramesToZoneFrames(plan, { "03-1": "tpl-a" })).toEqual({});
+  });
+
+  it("ignores persisted entries with empty / non-string template_id", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "" as unknown as string,
+    });
+    expect(remapped).toEqual({});
+  });
+
+  it("preserves the user-selected template even when slidePlan layout would imply a different default", () => {
+    // Backend u2 fallback should already have applied the user's frame
+    // override via CLI args, but if the plan's default frame_match_strategy
+    // disagrees, the post-loadRun remap still surfaces the user's choice
+    // for the SlideCanvas override-vs-default preview indicator.
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "user-chosen-tpl",
+    });
+    expect(remapped["r-top"]).toBe("user-chosen-tpl");
+  });
+});
+
+// ─── IMP-51 (#79) u11 — image_overrides axis ────────────────────────────────
+// New 5th persisted axis. The on-disk schema (KNOWN_AXES,
+// src/user_overrides_io.py u1), the typed client
+// (services/userOverridesApi.ts u3 ImageOverridesOverride), the Vite
+// allowlist (vite.config.ts u2), and the backend CLI flag (--override-image
+// in src/phase_z2_pipeline.py u5) all expect `image_id` → percent-of-slide
+// geometry. u11 owns the in-memory mirror on `UserSelection.overrides`
+// (declared in types/designAgent.ts) plus the three pure helpers that
+// Home.tsx (u10) wires:
+//   • applyPersistedNonFrameOverrides — restore-on-reopen layer.
+//   • createInitialUserSelection — fresh-slide initializer.
+//   • saveImageOverride — single-image record helper invoked by the
+//     SlideCanvas u8 drag/resize handler.
+
+describe("image_overrides axis — applyPersistedNonFrameOverrides (IMP-51 u11)", () => {
+  it("layers a flat image_overrides dict onto the selection", () => {
+    const sel = makeSelection();
+    const persisted = {
+      image_overrides: {
+        "img-abc1234567": { x: 10, y: 15, w: 30.5, h: 25 },
+        "img-deadbeef00": { x: 50, y: 50, w: 40, h: 40 },
+      },
+    };
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    expect(next.overrides.image_overrides).toEqual({
+      "img-abc1234567": { x: 10, y: 15, w: 30.5, h: 25 },
+      "img-deadbeef00": { x: 50, y: 50, w: 40, h: 40 },
+    });
+    // Untouched axes stay at their fixture defaults so the round-trip is
+    // safe to interleave with the other four axes.
+    expect(next.overrides.zone_geometries).toEqual({});
+    expect(next.overrides.zone_sections).toEqual({});
+    expect(next.overrides.layout_preset).toBeUndefined();
+  });
+
+  it("ignores image_overrides when the payload axis is an array", () => {
+    const sel = makeSelection({
+      image_overrides: { "img-existing00": { x: 1, y: 2, w: 30, h: 40 } },
+    });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      image_overrides: [] as unknown as Record<
+        string,
+        { x: number; y: number; w: number; h: number }
+      >,
+    });
+    // Same guard the zone_geometries branch uses — array payloads from a
+    // hand-edited file are rejected and the prior in-memory value stays.
+    expect(next.overrides.image_overrides).toEqual({
+      "img-existing00": { x: 1, y: 2, w: 30, h: 40 },
+    });
+  });
+
+  it("ignores image_overrides when the payload axis is null", () => {
+    const sel = makeSelection({
+      image_overrides: { "img-existing00": { x: 0, y: 0, w: 100, h: 100 } },
+    });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      image_overrides: null,
+    });
+    expect(next.overrides.image_overrides).toEqual({
+      "img-existing00": { x: 0, y: 0, w: 100, h: 100 },
+    });
+  });
+
+  it("layers image_overrides alongside the four IMP-52 axes in one call", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      layout: "horizontal-2",
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.4 } },
+      zone_sections: { top: ["03-1"] },
+      image_overrides: { "img-abc1234567": { x: 25, y: 25, w: 50, h: 50 } },
+    });
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.4 },
+    });
+    expect(next.overrides.zone_sections).toEqual({ top: ["03-1"] });
+    expect(next.overrides.image_overrides).toEqual({
+      "img-abc1234567": { x: 25, y: 25, w: 50, h: 50 },
+    });
+  });
+
+  it("seeds an empty image_overrides on a fresh selection (createInitialUserSelection)", () => {
+    const sel = createInitialUserSelection();
+    expect(sel.overrides.image_overrides).toEqual({});
+    // Mirrors the shape Home.tsx receives before any user interaction —
+    // SlideCanvas u8 expects the axis to exist (not undefined) so its
+    // `Object.entries(measured + persisted)` merge never crashes.
+  });
+});
+
+describe("image_overrides axis — saveImageOverride (IMP-51 u11)", () => {
+  const ID_A = "img-abc1234567";
+  const ID_B = "img-deadbeef00";
+
+  it("adds a new image_id entry on an empty axis", () => {
+    const sel = makeSelection();
+    const next = saveImageOverride(sel, ID_A, { x: 10, y: 15, w: 30.5, h: 25 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 10, y: 15, w: 30.5, h: 25 },
+    });
+  });
+
+  it("replaces an existing entry under the same image_id (most recent drag wins)", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 0, y: 0, w: 20, h: 20 } },
+    });
+    const next = saveImageOverride(sel, ID_A, { x: 50, y: 50, w: 30, h: 30 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 50, y: 50, w: 30, h: 30 },
+    });
+  });
+
+  it("preserves sibling image_id entries when adding a new one", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 10, y: 10, w: 20, h: 20 } },
+    });
+    const next = saveImageOverride(sel, ID_B, { x: 60, y: 60, w: 30, h: 30 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 10, y: 10, w: 20, h: 20 },
+      [ID_B]: { x: 60, y: 60, w: 30, h: 30 },
+    });
+  });
+
+  it("does NOT touch the other four override axes", () => {
+    const sel = makeSelection({
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+      zone_frames: { "r-top": "tpl-a" },
+      layout_preset: "horizontal-2",
+    });
+    const next = saveImageOverride(sel, ID_A, { x: 10, y: 10, w: 20, h: 20 });
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+    expect(next.overrides.zone_sections).toEqual({ top: ["03-1"] });
+    expect(next.overrides.zone_frames).toEqual({ "r-top": "tpl-a" });
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+  });
+
+  it("returns a NEW selection object (no input mutation)", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 0, y: 0, w: 10, h: 10 } },
+    });
+    const before = { ...sel.overrides.image_overrides };
+    const next = saveImageOverride(sel, ID_B, { x: 30, y: 30, w: 20, h: 20 });
+    expect(next).not.toBe(sel);
+    expect(next.overrides).not.toBe(sel.overrides);
+    expect(next.overrides.image_overrides).not.toBe(sel.overrides.image_overrides);
+    // Input still pristine.
+    expect(sel.overrides.image_overrides).toEqual(before);
+  });
+});
+
+// ─── IMP-55 (#93) u3 — manual_section_assignment bool axis ──────────────────
+// Restore-on-reopen / seed coverage for the bool intent marker. Production
+// branch lives at `slidePlanUtils.ts` — `applyPersistedNonFrameOverrides`
+// guards with `typeof persisted.manual_section_assignment === "boolean"`,
+// and `createInitialUserSelection` seeds the axis to `false`. The marker
+// gates whether `handleGenerate` (u7) forwards `overrides.zoneSections`
+// to the backend; the pipeline (u9) consumes persisted `zone_sections`
+// only when the marker is exactly `true`, so any non-boolean payload MUST
+// end up `false` in memory (fail-closed).
+
+describe("manual_section_assignment axis — applyPersistedNonFrameOverrides (IMP-55 #93 u3)", () => {
+  it("restores literal true verbatim", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      manual_section_assignment: true,
+    });
+    expect(next.overrides.manual_section_assignment).toBe(true);
+  });
+
+  it("restores literal false verbatim (u12 apply/cancel write must survive reopen)", () => {
+    // Seed `true` so the assertion proves `false` overwrites; a truthiness
+    // check instead of `typeof === \"boolean\"` would silently keep `true`
+    // and resurrect stale auto-carry assignments as user intent.
+    const sel = makeSelection({ manual_section_assignment: true });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      manual_section_assignment: false,
+    });
+    expect(next.overrides.manual_section_assignment).toBe(false);
+  });
+
+  it("leaves the in-memory marker unchanged when the persisted axis is absent", () => {
+    const sel = makeSelection({ manual_section_assignment: true });
+    const next = applyPersistedNonFrameOverrides(sel, { layout: "horizontal-2" });
+    expect(next.overrides.manual_section_assignment).toBe(true);
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+  });
+
+  it.each([
+    ["null clear sentinel", null],
+    ['string "true"', "true"],
+    ['string "false"', "false"],
+    ["number 1", 1],
+    ["number 0", 0],
+    ["object {}", {}],
+    ["array []", []],
+  ])("ignores non-boolean payload (%s) — keeps prior in-memory value", (_label, payload) => {
+    const sel = makeSelection({ manual_section_assignment: true });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      manual_section_assignment: payload as unknown as boolean,
+    });
+    expect(next.overrides.manual_section_assignment).toBe(true);
+  });
+
+  it("seeds an empty selection with manual_section_assignment=false (createInitialUserSelection)", () => {
+    const sel = createInitialUserSelection();
+    expect(sel.overrides.manual_section_assignment).toBe(false);
+  });
+
+  it("returns a NEW selection object (no input mutation) when restoring the marker", () => {
+    const sel = makeSelection({ manual_section_assignment: false });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      manual_section_assignment: true,
+    });
+    expect(next).not.toBe(sel);
+    expect(next.overrides).not.toBe(sel.overrides);
+    // Input still pristine — proves the helper does not flip the fixture.
+    expect(sel.overrides.manual_section_assignment).toBe(false);
+  });
+
+  it("layers the bool axis alongside other persisted axes in a single call", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      layout: "vertical-2",
+      zone_sections: { top: ["03-1"], bottom: ["03-2"] },
+      manual_section_assignment: true,
+    });
+    expect(next.overrides.layout_preset).toBe("vertical-2");
+    expect(next.overrides.zone_sections).toEqual({
+      top: ["03-1"],
+      bottom: ["03-2"],
+    });
+    expect(next.overrides.manual_section_assignment).toBe(true);
+  });
+});
+
+// ─── IMP-56 (#90) u15 — text_overrides + structure_overrides axes ───────────
+// Pure helpers wired by Home.tsx into the SlideCanvas u13 focusout capture
+// (text) and u14 structure overlay emit (structure). Tests cover:
+//   • saveTextOverride / saveStructureOverride immutability + merge semantics
+//   • createInitialUserSelection seeding the two new axes empty
+//   • applyPersistedNonFrameOverrides layering via the u10 extract helpers
+
+describe("text_overrides axis — saveTextOverride (IMP-56 u15)", () => {
+  it("records a fresh (zoneId, textPath, value) tuple", () => {
+    const sel = makeSelection();
+    const next = saveTextOverride(sel, "top", "row_1_left_body.0", "분석 결과");
+    expect(next.overrides.text_overrides).toEqual({
+      top: { "row_1_left_body.0": "분석 결과" },
+    });
+  });
+
+  it("merges within the same zone without erasing prior text_paths", () => {
+    const sel = makeSelection({
+      text_overrides: { top: { "row_1_left_body.0": "기존" } },
+    });
+    const next = saveTextOverride(sel, "top", "row_1_left_body.1", "신규");
+    expect(next.overrides.text_overrides.top).toEqual({
+      "row_1_left_body.0": "기존",
+      "row_1_left_body.1": "신규",
+    });
+  });
+
+  it("overwrites the same textPath value within a zone", () => {
+    const sel = makeSelection({
+      text_overrides: { top: { "headline.0": "v1" } },
+    });
+    const next = saveTextOverride(sel, "top", "headline.0", "v2");
+    expect(next.overrides.text_overrides.top).toEqual({ "headline.0": "v2" });
+  });
+
+  it("does not mutate the input selection (immutable contract)", () => {
+    const sel = makeSelection({
+      text_overrides: { top: { "headline.0": "before" } },
+    });
+    saveTextOverride(sel, "top", "headline.0", "after");
+    expect(sel.overrides.text_overrides).toEqual({
+      top: { "headline.0": "before" },
+    });
+  });
+
+  it("seeds an empty text_overrides on a fresh selection", () => {
+    const sel = createInitialUserSelection();
+    expect(sel.overrides.text_overrides).toEqual({});
+  });
+});
+
+describe("structure_overrides axis — saveStructureOverride (IMP-56 u15)", () => {
+  it("records a fresh (zoneId → {slot_order, hidden_slots}) tuple", () => {
+    const sel = makeSelection();
+    const next = saveStructureOverride(sel, "top", {
+      slot_order: ["b", "a"],
+      hidden_slots: ["c"],
+    });
+    expect(next.overrides.structure_overrides).toEqual({
+      top: { slot_order: ["b", "a"], hidden_slots: ["c"] },
+    });
+  });
+
+  it("replaces an existing zone entry verbatim (no merge within zone)", () => {
+    const sel = makeSelection({
+      structure_overrides: { top: { slot_order: ["a", "b"], hidden_slots: [] } },
+    });
+    const next = saveStructureOverride(sel, "top", {
+      slot_order: ["b", "a"],
+      hidden_slots: ["a"],
+    });
+    expect(next.overrides.structure_overrides.top).toEqual({
+      slot_order: ["b", "a"],
+      hidden_slots: ["a"],
+    });
+  });
+
+  it("keeps unrelated zones intact when updating one zone", () => {
+    const sel = makeSelection({
+      structure_overrides: {
+        top: { slot_order: ["x"], hidden_slots: [] },
+        bottom_l: { slot_order: ["y"], hidden_slots: ["z"] },
+      },
+    });
+    const next = saveStructureOverride(sel, "top", {
+      slot_order: ["x", "x2"],
+      hidden_slots: [],
+    });
+    expect(next.overrides.structure_overrides.bottom_l).toEqual({
+      slot_order: ["y"],
+      hidden_slots: ["z"],
+    });
+  });
+
+  it("does not mutate the input perZone object after save", () => {
+    const sel = makeSelection();
+    const perZone = { slot_order: ["a"], hidden_slots: ["b"] };
+    const next = saveStructureOverride(sel, "top", perZone);
+    perZone.slot_order.push("MUTATED");
+    expect(next.overrides.structure_overrides.top.slot_order).toEqual(["a"]);
+  });
+
+  it("seeds an empty structure_overrides on a fresh selection", () => {
+    const sel = createInitialUserSelection();
+    expect(sel.overrides.structure_overrides).toEqual({});
+  });
+});
+
+describe("Step-22 axes — applyPersistedNonFrameOverrides restore (IMP-56 u15)", () => {
+  it("layers persisted text_overrides through the u10 extract helper", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      text_overrides: {
+        top: { "row_1_left_body.0": "복원" },
+      },
+    });
+    expect(next.overrides.text_overrides).toEqual({
+      top: { "row_1_left_body.0": "복원" },
+    });
+  });
+
+  it("layers persisted structure_overrides through the u10 extract helper", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      structure_overrides: {
+        top: { slot_order: ["b", "a"], hidden_slots: ["c"] },
+      },
+    });
+    expect(next.overrides.structure_overrides).toEqual({
+      top: { slot_order: ["b", "a"], hidden_slots: ["c"] },
+    });
+  });
+
+  it("drops non-object payloads silently (no throw, axis stays empty)", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      text_overrides: "garbage" as unknown as Record<string, Record<string, string>>,
+      structure_overrides: ["bad"] as unknown as Record<
+        string,
+        { slot_order?: string[]; hidden_slots?: string[] }
+      >,
+    });
+    expect(next.overrides.text_overrides).toEqual({});
+    expect(next.overrides.structure_overrides).toEqual({});
+  });
+});

Front/client/tests/user_overrides_service.test.ts

@@ -0,0 +1,625 @@
+// IMP-52 u5 — vitest coverage for the typed frontend client at
+// `Front/client/src/services/userOverridesApi.ts`.
+//
+// Scope (Stage 2 unit u5 contract):
+//   1) getUserOverrides:
+//      • 200 with object body → typed payload echoed.
+//      • 200 with array / primitive / non-JSON body → {} (graceful).
+//      • 4xx / 5xx → {}.
+//      • fetch reject (network) → {} (no throw to caller).
+//   2) saveUserOverrides:
+//      • Single call: PUT fires after exactly 300 ms with the mutated-axis
+//        partial as body (NOT a full snapshot of UserOverrides).
+//      • Rapid coalescing: N calls in <300 ms window collapse to ONE PUT
+//        carrying the union of mutated axes.
+//      • Per-axis later-wins: later call's value replaces earlier pending
+//        value for the same axis; axes the user did not touch stay absent.
+//      • null sentinel: forwarded verbatim so u4 mergeUserOverrides can
+//        `delete` the axis on disk.
+//      • Per-key isolation: rapid edits to "03" do not delay flush of "04".
+//      • Promise resolves with the server-side merged document.
+//      • Promise rejects on 4xx/5xx and on fetch reject.
+//   3) flushUserOverrides:
+//      • No arg → flushes all pending buckets immediately (no 300 ms wait).
+//      • Specific key → flushes only that bucket; other buckets stay
+//        pending.
+//      • No-op when no buckets are pending.
+//
+// All tests mock `fetch` and use `vi.useFakeTimers()` to make the 300 ms
+// debounce deterministic — no real wall-clock waits.
+
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+  type Mock,
+} from "vitest";
+import {
+  __resetUserOverridesBuckets_FOR_TEST,
+  flushUserOverrides,
+  getUserOverrides,
+  saveUserOverrides,
+  type UserOverridesPartial,
+} from "../src/services/userOverridesApi";
+
+// ---------------------------------------------------------------------------
+// fetch mock — minimal Response stub with the two methods the service uses
+// (.ok / .status / .json()). We track the call log so debounce + coalescing
+// can be asserted by counting PUTs and inspecting their bodies.
+// ---------------------------------------------------------------------------
+
+type MockResponse = {
+  ok: boolean;
+  status: number;
+  json: () => Promise<unknown>;
+};
+
+function mockResponse(body: unknown, ok = true, status = 200): MockResponse {
+  return {
+    ok,
+    status,
+    json: async () => body,
+  };
+}
+
+let fetchMock: Mock;
+
+beforeEach(() => {
+  fetchMock = vi.fn();
+  vi.stubGlobal("fetch", fetchMock);
+  vi.useFakeTimers();
+  __resetUserOverridesBuckets_FOR_TEST();
+});
+
+afterEach(() => {
+  vi.useRealTimers();
+  vi.unstubAllGlobals();
+  __resetUserOverridesBuckets_FOR_TEST();
+});
+
+// Microtask-flushing helper. vi.advanceTimersByTime fires timers, but the
+// promise chain inside flushBucket (await fetch → await res.json() → resolve
+// waiters) needs the microtask queue to drain before assertions run.
+async function drainMicrotasks(): Promise<void> {
+  // Multiple ticks because each `await` in flushBucket adds another tick.
+  for (let i = 0; i < 4; i++) {
+    await Promise.resolve();
+  }
+}
+
+function lastPutBody(): unknown {
+  const lastCall = fetchMock.mock.calls.at(-1);
+  if (!lastCall) throw new Error("fetch was not called");
+  const init = lastCall[1] as RequestInit | undefined;
+  if (!init?.body) throw new Error("fetch was called without a body");
+  return JSON.parse(String(init.body));
+}
+
+function putCallsCount(): number {
+  return fetchMock.mock.calls.filter(
+    (call) => (call[1] as RequestInit | undefined)?.method === "PUT",
+  ).length;
+}
+
+// ============================================================================
+// getUserOverrides
+// ============================================================================
+
+describe("getUserOverrides (IMP-52 u5)", () => {
+  it("issues GET against /api/user-overrides/<key>", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse({ layout: "x" }));
+    await getUserOverrides("03");
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const [url, init] = fetchMock.mock.calls[0];
+    expect(url).toBe("/api/user-overrides/03");
+    expect((init as RequestInit).method).toBe("GET");
+  });
+
+  it("returns the parsed object on 200 with object body", async () => {
+    const payload = {
+      layout: "two_zone_split",
+      frames: { "03-1+03-2": "frame_07" },
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1", "03-2"] },
+    };
+    fetchMock.mockResolvedValueOnce(mockResponse(payload));
+    const got = await getUserOverrides("03");
+    expect(got).toEqual(payload);
+  });
+
+  it("returns {} when JSON root is an array (mirrors u3 graceful degrade)", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse([1, 2, 3]));
+    expect(await getUserOverrides("03")).toEqual({});
+  });
+
+  it("returns {} when JSON root is a primitive", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(42));
+    expect(await getUserOverrides("03")).toEqual({});
+  });
+
+  it("returns {} when JSON root is null", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse(null));
+    expect(await getUserOverrides("03")).toEqual({});
+  });
+
+  it("returns {} on 4xx (invalid key path from u3)", async () => {
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({ error: "invalid key" }, false, 400),
+    );
+    expect(await getUserOverrides("..")).toEqual({});
+  });
+
+  it("returns {} on 5xx", async () => {
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({ error: "boom" }, false, 500),
+    );
+    expect(await getUserOverrides("03")).toEqual({});
+  });
+
+  it("returns {} when response.json() throws (non-JSON body)", async () => {
+    fetchMock.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: async () => {
+        throw new SyntaxError("Unexpected token");
+      },
+    });
+    expect(await getUserOverrides("03")).toEqual({});
+  });
+
+  it("returns {} when fetch rejects (network error) — does NOT throw", async () => {
+    fetchMock.mockRejectedValueOnce(new Error("network down"));
+    await expect(getUserOverrides("03")).resolves.toEqual({});
+  });
+});
+
+// ============================================================================
+// saveUserOverrides — debounce + coalescing
+// ============================================================================
+
+describe("saveUserOverrides (IMP-52 u5) — debounce", () => {
+  it("does NOT fire fetch before 300 ms have elapsed", async () => {
+    fetchMock.mockResolvedValue(mockResponse({ layout: "two_zone_split" }));
+    void saveUserOverrides("03", { layout: "two_zone_split" });
+
+    vi.advanceTimersByTime(299);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(0);
+  });
+
+  it("fires exactly one PUT at the 300 ms boundary", async () => {
+    fetchMock.mockResolvedValue(mockResponse({ layout: "two_zone_split" }));
+    void saveUserOverrides("03", { layout: "two_zone_split" });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+
+    const lastCall = fetchMock.mock.calls.at(-1)!;
+    expect(lastCall[0]).toBe("/api/user-overrides/03");
+    expect((lastCall[1] as RequestInit).method).toBe("PUT");
+    expect((lastCall[1] as RequestInit).headers).toMatchObject({
+      "Content-Type": "application/json",
+    });
+    expect(lastPutBody()).toEqual({ layout: "two_zone_split" });
+  });
+
+  it("PUT body contains ONLY the mutated axis (not a full snapshot)", async () => {
+    // The frontend handler only knows the axis it just mutated; the server
+    // is responsible for partial-merge against axes already on disk.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", {
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+    });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["zone_geometries"]);
+    expect("layout" in body).toBe(false);
+    expect("frames" in body).toBe(false);
+    expect("zone_sections" in body).toBe(false);
+  });
+
+  it("coalesces N rapid calls into a SINGLE PUT after the debounce", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "old" });
+    vi.advanceTimersByTime(100);
+    void saveUserOverrides("03", { frames: { "03-1": "frame_01" } });
+    vi.advanceTimersByTime(100);
+    void saveUserOverrides("03", { zone_sections: { top: ["03-1"] } });
+    vi.advanceTimersByTime(100);
+
+    // After 300 ms total (but the timer was reset each call to start the
+    // 300 ms window over), so we need one more 300 ms to fire.
+    expect(putCallsCount()).toBe(0);
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+
+    // All three axes accumulated.
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(body).toEqual({
+      layout: "old",
+      frames: { "03-1": "frame_01" },
+      zone_sections: { top: ["03-1"] },
+    });
+  });
+
+  it("per-axis later-wins: same axis mutated twice keeps the LAST value", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "first" });
+    void saveUserOverrides("03", { layout: "second" });
+    void saveUserOverrides("03", { layout: "final" });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({ layout: "final" });
+  });
+
+  it("forwards null sentinel verbatim (explicit clear)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: null });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(lastPutBody()).toEqual({ layout: null });
+  });
+
+  it("null can override a prior non-null pending value for the same axis", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "two_zone_split" });
+    void saveUserOverrides("03", { layout: null });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(lastPutBody()).toEqual({ layout: null });
+  });
+
+  it("resolves the caller promise with the server-merged document", async () => {
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({
+        layout: "two_zone_split",
+        // server's view includes axes preserved on disk that the partial
+        // PUT did NOT carry — confirms we surface the full merged state.
+        frames: { "03-1": "frame_01" },
+      }),
+    );
+    const p = saveUserOverrides("03", { layout: "two_zone_split" });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    await expect(p).resolves.toEqual({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+    });
+  });
+
+  it("rejects all coalesced waiters on 5xx response", async () => {
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({ error: "write failed" }, false, 500),
+    );
+    const p1 = saveUserOverrides("03", { layout: "x" });
+    const p2 = saveUserOverrides("03", { frames: { "03-1": "f01" } });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    await expect(p1).rejects.toThrow(/500/);
+    await expect(p2).rejects.toThrow(/500/);
+  });
+
+  it("rejects waiters on fetch network error", async () => {
+    fetchMock.mockRejectedValueOnce(new Error("ECONNRESET"));
+    const p = saveUserOverrides("03", { layout: "x" });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    await expect(p).rejects.toThrow("ECONNRESET");
+  });
+
+  it("after a successful flush, a new save starts a fresh debounce window", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "first" });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({ layout: "first" });
+
+    void saveUserOverrides("03", { layout: "second" });
+    vi.advanceTimersByTime(299);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1); // not fired yet
+    vi.advanceTimersByTime(1);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(2);
+    expect(lastPutBody()).toEqual({ layout: "second" });
+  });
+});
+
+// ============================================================================
+// saveUserOverrides — per-key isolation
+// ============================================================================
+
+describe("saveUserOverrides (IMP-52 u5) — per-key isolation", () => {
+  it("rapid edits to key A do not delay key B's flush", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    // Schedule a save on "03"
+    void saveUserOverrides("03", { layout: "x" });
+    // Schedule a save on "04" at t=0
+    void saveUserOverrides("04", { layout: "y" });
+
+    vi.advanceTimersByTime(150);
+    // Keep extending "03"'s window
+    void saveUserOverrides("03", { layout: "x2" });
+
+    // "04" should still fire at t=300 (untouched after first call)
+    vi.advanceTimersByTime(150); // t=300
+    await drainMicrotasks();
+
+    const puts = fetchMock.mock.calls.filter(
+      (c) => (c[1] as RequestInit).method === "PUT",
+    );
+    expect(puts.length).toBe(1);
+    expect(puts[0][0]).toBe("/api/user-overrides/04");
+    expect(JSON.parse(String((puts[0][1] as RequestInit).body))).toEqual({
+      layout: "y",
+    });
+  });
+
+  it("each key's PUT carries only that key's mutated axes", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "for-03" });
+    void saveUserOverrides("04", { frames: { "04-1": "frame_05" } });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    const puts = fetchMock.mock.calls.filter(
+      (c) => (c[1] as RequestInit).method === "PUT",
+    );
+    expect(puts.length).toBe(2);
+
+    const byUrl = new Map(
+      puts.map((c) => [
+        c[0],
+        JSON.parse(String((c[1] as RequestInit).body)) as Record<
+          string,
+          unknown
+        >,
+      ]),
+    );
+    expect(byUrl.get("/api/user-overrides/03")).toEqual({ layout: "for-03" });
+    expect(byUrl.get("/api/user-overrides/04")).toEqual({
+      frames: { "04-1": "frame_05" },
+    });
+  });
+});
+
+// ============================================================================
+// flushUserOverrides
+// ============================================================================
+
+describe("flushUserOverrides (IMP-52 u5)", () => {
+  it("with no arg, flushes ALL pending buckets immediately (no 300 ms wait)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "x" });
+    void saveUserOverrides("04", { layout: "y" });
+
+    expect(putCallsCount()).toBe(0);
+    const flushP = flushUserOverrides();
+    await drainMicrotasks();
+    await flushP;
+
+    expect(putCallsCount()).toBe(2);
+  });
+
+  it("with a key arg, flushes only that bucket; others stay pending", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "x" });
+    void saveUserOverrides("04", { layout: "y" });
+
+    await flushUserOverrides("03");
+    await drainMicrotasks();
+
+    const puts = fetchMock.mock.calls.filter(
+      (c) => (c[1] as RequestInit).method === "PUT",
+    );
+    expect(puts.length).toBe(1);
+    expect(puts[0][0]).toBe("/api/user-overrides/03");
+
+    // "04" should still fire at the regular 300 ms boundary.
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(2);
+  });
+
+  it("is a no-op when no buckets are pending", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    await flushUserOverrides();
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+
+  it("resolves the original saveUserOverrides promise via the in-flight PUT", async () => {
+    fetchMock.mockResolvedValueOnce(mockResponse({ layout: "flushed" }));
+    const savePromise = saveUserOverrides("03", { layout: "flushed" });
+    const flushPromise = flushUserOverrides();
+    await drainMicrotasks();
+    await flushPromise;
+    await expect(savePromise).resolves.toEqual({ layout: "flushed" });
+  });
+
+  it("propagates PUT failure as caller rejection (flush itself swallows)", async () => {
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({ error: "boom" }, false, 500),
+    );
+    const savePromise = saveUserOverrides("03", { layout: "x" });
+    // flush itself should not throw — the original waiter takes the rejection.
+    const flushPromise = flushUserOverrides();
+    await drainMicrotasks();
+    await expect(flushPromise).resolves.toBeUndefined();
+    await expect(savePromise).rejects.toThrow(/500/);
+  });
+});
+
+// ============================================================================
+// type-level export sanity check (compile-time evidence; runtime no-op)
+// ============================================================================
+
+describe("UserOverridesPartial type (IMP-52 u5)", () => {
+  it("permits per-axis null sentinels and partial keys", () => {
+    // Compile-time only — if any of these stops being a valid assignment,
+    // the test suite fails at build with a TS error before this assertion
+    // runs. The expect() is a placebo to keep vitest happy.
+    const a: UserOverridesPartial = { layout: "x" };
+    const b: UserOverridesPartial = { layout: null };
+    const c: UserOverridesPartial = { frames: { unit: "tmpl" } };
+    const d: UserOverridesPartial = {};
+    const e: UserOverridesPartial = {
+      image_overrides: { "img-1": { x: 10, y: 20, w: 30, h: 25 } },
+    };
+    const f: UserOverridesPartial = { image_overrides: null };
+    expect([a, b, c, d, e, f]).toHaveLength(6);
+  });
+});
+
+// ============================================================================
+// IMP-51 #79 u3 — image_overrides axis (5th axis) parity coverage
+//
+// Same debounce / coalescing / clear / per-key isolation guarantees as the
+// 4 sibling axes (layout / frames / zone_geometries / zone_sections), but
+// asserted explicitly so a regression in the type or the runtime allowlist
+// fails here instead of in a downstream u8~u11 handler.
+// ============================================================================
+
+describe("saveUserOverrides (IMP-51 #79 u3) — image_overrides axis", () => {
+  it("PUT body carries only image_overrides when that is the sole mutated axis", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", {
+      image_overrides: { "img-1": { x: 10, y: 20, w: 30, h: 25 } },
+    });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["image_overrides"]);
+    expect(body.image_overrides).toEqual({
+      "img-1": { x: 10, y: 20, w: 30, h: 25 },
+    });
+    expect("layout" in body).toBe(false);
+    expect("frames" in body).toBe(false);
+    expect("zone_geometries" in body).toBe(false);
+    expect("zone_sections" in body).toBe(false);
+  });
+
+  it("per-axis later-wins: same image_id mutated twice keeps the LAST value", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", {
+      image_overrides: { "img-1": { x: 0, y: 0, w: 50, h: 50 } },
+    });
+    void saveUserOverrides("03", {
+      image_overrides: { "img-1": { x: 25, y: 25, w: 30, h: 30 } },
+    });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({
+      image_overrides: { "img-1": { x: 25, y: 25, w: 30, h: 30 } },
+    });
+  });
+
+  it("forwards null sentinel verbatim (clear all image_overrides on disk)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { image_overrides: null });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(lastPutBody()).toEqual({ image_overrides: null });
+  });
+
+  it("coalesces with sibling axes in a single PUT", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { layout: "two_zone_split" });
+    void saveUserOverrides("03", {
+      image_overrides: { "img-1": { x: 10, y: 20, w: 30, h: 25 } },
+    });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({
+      layout: "two_zone_split",
+      image_overrides: { "img-1": { x: 10, y: 20, w: 30, h: 25 } },
+    });
+  });
+});
+
+// ============================================================================
+// IMP-55 #93 u1 — manual_section_assignment axis (7th axis) parity coverage
+//
+// The bool intent marker rides on the same per-axis coalescing rails as the
+// 6 sibling axes. These tests lock the typed client behavior so a regression
+// in the boolean serialization (e.g., coercion to "true" string, dropped
+// `false` due to truthy filtering) fails here instead of in Home.tsx (u6/u7)
+// or the backend gate (u9~u11).
+// ============================================================================
+
+describe("saveUserOverrides (IMP-55 #93 u1) — manual_section_assignment axis", () => {
+  it("PUT body carries only manual_section_assignment when it is the sole mutated axis", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { manual_section_assignment: true });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["manual_section_assignment"]);
+    expect(body.manual_section_assignment).toBe(true);
+  });
+
+  it("later-wins coalesces true → false within a single debounce window", async () => {
+    // Drag-then-cancel inside 300 ms — server must see only the final
+    // `false`, not a transient `true` that would re-enable backend
+    // consumption of stale zone_sections.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { manual_section_assignment: true });
+    void saveUserOverrides("03", { manual_section_assignment: false });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({ manual_section_assignment: false });
+  });
+
+  it("forwards null sentinel verbatim (explicit clear)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", { manual_section_assignment: null });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(lastPutBody()).toEqual({ manual_section_assignment: null });
+  });
+
+  it("coalesces with zone_sections sibling into a single PUT (drag-drop pair)", async () => {
+    // Real-world drag flow (u6): one save() sets the bool + zone_sections
+    // together. Asserts both axes survive coalescing as a single PUT body.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03", {
+      zone_sections: { left: ["03-2"], right: ["03-1"] },
+      manual_section_assignment: true,
+    });
+
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(putCallsCount()).toBe(1);
+    expect(lastPutBody()).toEqual({
+      zone_sections: { left: ["03-2"], right: ["03-1"] },
+      manual_section_assignment: true,
+    });
+  });
+});

Front/client/tests/user_overrides_write.test.ts

@@ -0,0 +1,862 @@
+// IMP-52 u10 — Frontend write-side regression coverage.
+//
+// Stage 2 unit u10 contract:
+//   1) All 4 in-scope mutation handlers persist their axis.
+//   2) zone_sizes is NOT persisted (handleLayoutResize stays in-memory).
+//   3) Write-before-Generate ordering — flushUserOverrides forces pending
+//      PUTs to commit before the pipeline run begins.
+//   4) Restore-on-reopen end-to-end — getUserOverrides → non-frame layering
+//      and post-loadRun frame remap compose into a single restored state.
+//
+// React Testing Library is NOT installed in this repo (devDependencies has
+// vitest only). Home.tsx's mutation handlers live inside `useCallback`
+// closures so they cannot be invoked from a test without mounting the
+// component. We cover them with two complementary tactics:
+//   • Source-pattern grep on Home.tsx that pins the exact wiring shape per
+//     handler. A regression that drops or rewires a `saveUserOverrides`
+//     call fails here loudly.
+//   • End-to-end mocked-fetch tests on the `userOverridesApi` flow with the
+//     payload shapes that Home.tsx produces — proves the contract the
+//     handlers depend on still holds.
+//
+// File extension is `.ts` (no JSX). All tests run in vitest's default node
+// environment; fetch is stubbed with vi.stubGlobal and timers are faked so
+// the 300ms debounce in `saveUserOverrides` is deterministic.
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+  type Mock,
+} from "vitest";
+import {
+  __resetUserOverridesBuckets_FOR_TEST,
+  flushUserOverrides,
+  getUserOverrides,
+  saveUserOverrides,
+  type UserOverridesPartial,
+} from "../src/services/userOverridesApi";
+import {
+  applyPersistedNonFrameOverrides,
+  createInitialUserSelection,
+  deriveUserOverridesKey,
+  mergeSubmittedPipelineOverridesForRestore,
+  remapPersistedFramesToZoneFrames,
+} from "../src/utils/slidePlanUtils";
+import type { SlidePlan, Zone } from "../src/types/designAgent";
+
+// ─── Source-pattern regression ─────────────────────────────────────────────
+// Without RTL we can't dispatch a click and read `fetch.mock.calls`. Instead
+// we read Home.tsx as text and assert each in-scope handler closure contains
+// the exact wiring that Stage 2 u7 specified. This is brittle in a good way:
+// if a handler is renamed or its `saveUserOverrides` call is moved/removed,
+// the assertion fires with a clear "X handler does not persist Y axis"
+// message instead of silently regressing in prod.
+
+const HOME_TSX_PATH = path.resolve(
+  __dirname,
+  "..",
+  "src",
+  "pages",
+  "Home.tsx",
+);
+const HOME_TSX = fs.readFileSync(HOME_TSX_PATH, "utf-8");
+
+/**
+ * Slice the `const <name> = useCallback(...)` block out of Home.tsx. The
+ * handlers are well-formed and end either at the next `const handle...`
+ * declaration or at the next top-level `const ` at 2-space indent.
+ */
+function sliceHandler(source: string, name: string): string {
+  const start = source.indexOf(`const ${name} = useCallback(`);
+  if (start === -1) {
+    throw new Error(`handler "${name}" not found in Home.tsx`);
+  }
+  // Find the next handler / top-level const after `start`.
+  const nextHandler = source.indexOf("\n  const handle", start + 1);
+  const nextConst = source.indexOf("\n  const ", start + 1);
+  const candidates = [nextHandler, nextConst].filter((i) => i > start);
+  const end = candidates.length > 0 ? Math.min(...candidates) : source.length;
+  return source.slice(start, end);
+}
+
+/**
+ * IMP-55 #93 u8 — strip JS/TS line + block comments so source-pattern
+ * regex checks assert against LIVE code only. The u5 / u7 docblocks in
+ * Home.tsx intentionally reference removed identifiers (e.g. `defaultByZone`,
+ * `sameAsDefault`, `zoneSectionsDiff`) and the marker axis name in prose to
+ * document the Stage 1 root cause for future readers — those references are
+ * documentation, not behavior, and must not trigger negative-match guards.
+ * Strips `// ...` to EOL and `/* ... *​/` (incl. multi-line) — keeps string
+ * literals intact because we only consume the result for regex-match tests.
+ */
+function stripComments(source: string): string {
+  return source
+    .replace(/\/\*[\s\S]*?\*\//g, "")
+    .replace(/\/\/.*$/gm, "");
+}
+
+describe("Home.tsx write-side wiring (IMP-52 u10) — source pattern", () => {
+  it("handleSectionDrop persists zone_sections behind uploadedFile gate", () => {
+    const block = sliceHandler(HOME_TSX, "handleSectionDrop");
+    // gate
+    expect(block).toMatch(/if\s*\(\s*p\.uploadedFile\s*\)/);
+    // axis key + value source
+    expect(block).toMatch(
+      /saveUserOverrides\([\s\S]*?zone_sections:\s*finalSelection\.overrides\.zone_sections/,
+    );
+    // key derivation
+    expect(block).toMatch(/deriveUserOverridesKey\(p\.uploadedFile\.name\)/);
+  });
+
+  it("handleLayoutSelect persists `layout` axis behind uploadedFile gate", () => {
+    const block = sliceHandler(HOME_TSX, "handleLayoutSelect");
+    expect(block).toMatch(/if\s*\(\s*p\.uploadedFile\s*\)/);
+    expect(block).toMatch(
+      /saveUserOverrides\([\s\S]*?layout:\s*layoutId\s*\}/,
+    );
+    expect(block).toMatch(/deriveUserOverridesKey\(p\.uploadedFile\.name\)/);
+  });
+
+  it("handleZoneResize persists merged zone_geometries behind uploadedFile gate", () => {
+    const block = sliceHandler(HOME_TSX, "handleZoneResize");
+    expect(block).toMatch(/if\s*\(\s*p\.uploadedFile\s*\)/);
+    // merged geometry (not the partial delta) is persisted so the on-disk
+    // axis is a complete snapshot of all currently-resized zones.
+    expect(block).toMatch(
+      /saveUserOverrides\([\s\S]*?zone_geometries:\s*mergedGeometries/,
+    );
+    expect(block).toMatch(/deriveUserOverridesKey\(p\.uploadedFile\.name\)/);
+  });
+
+  it("handleFrameSelect persists frames-by-unit_id with default-frame gate", () => {
+    const block = sliceHandler(HOME_TSX, "handleFrameSelect");
+    expect(block).toMatch(/if\s*\(\s*p\.uploadedFile\s*&&\s*effectiveSlidePlan\s*\)/);
+    // unit_id derivation matches handleGenerate's CLI-forwarding contract
+    expect(block).toMatch(/z\.section_ids\.join\(\s*"\+"\s*\)/);
+    // default-frame gate (rewind fix from Codex #17 / Claude #18)
+    expect(block).toMatch(/overrideId\s*!==\s*defaultFrameId/);
+    // axis key
+    expect(block).toMatch(
+      /saveUserOverrides\([\s\S]*?frames:\s*framesByUnitId/,
+    );
+  });
+
+  it("handleLayoutResize does NOT call saveUserOverrides (zone_sizes excluded)", () => {
+    const block = sliceHandler(HOME_TSX, "handleLayoutResize");
+    expect(block).not.toMatch(/saveUserOverrides/);
+    // Sanity: handleLayoutResize still writes zone_sizes in-memory.
+    expect(block).toMatch(/saveZoneSizes/);
+  });
+
+  it("handleGenerate does NOT call saveUserOverrides (read-only re: persistence layer)", () => {
+    const block = sliceHandler(HOME_TSX, "handleGenerate");
+    // handleGenerate forwards overrides through runPipeline → /api/run, not
+    // through /api/user-overrides. The persistence layer is owned by the
+    // four mutation handlers; Generate must not introduce a competing
+    // write path that could clobber a partially-edited bucket.
+    expect(block).not.toMatch(/saveUserOverrides\(/);
+  });
+
+  it("no handler in Home.tsx persists the zone_sizes axis", () => {
+    // Top-level regression: searching the whole file rules out a future
+    // accidental wiring inside a new handler we forgot to enumerate above.
+    expect(HOME_TSX).not.toMatch(
+      /saveUserOverrides\([\s\S]{0,200}?zone_sizes\s*:/,
+    );
+  });
+});
+
+// ─── Payload-shape contract via mocked fetch ───────────────────────────────
+// Drive `saveUserOverrides` with the exact payload shapes each in-scope
+// handler produces in Home.tsx. Asserts that (a) the PUT body matches what
+// the on-disk schema (u1 / u4) accepts and (b) the partial-axis contract
+// holds — only the mutated axis is sent, never a full snapshot.
+
+type MockResponse = {
+  ok: boolean;
+  status: number;
+  json: () => Promise<unknown>;
+};
+
+function mockResponse(body: unknown, ok = true, status = 200): MockResponse {
+  return { ok, status, json: async () => body };
+}
+
+let fetchMock: Mock;
+
+beforeEach(() => {
+  fetchMock = vi.fn();
+  vi.stubGlobal("fetch", fetchMock);
+  vi.useFakeTimers();
+  __resetUserOverridesBuckets_FOR_TEST();
+});
+
+afterEach(() => {
+  vi.useRealTimers();
+  vi.unstubAllGlobals();
+  __resetUserOverridesBuckets_FOR_TEST();
+});
+
+async function drainMicrotasks(): Promise<void> {
+  for (let i = 0; i < 4; i++) {
+    await Promise.resolve();
+  }
+}
+
+function lastPutBody(): unknown {
+  const lastCall = fetchMock.mock.calls.at(-1);
+  if (!lastCall) throw new Error("fetch was not called");
+  const init = lastCall[1] as RequestInit | undefined;
+  if (!init?.body) throw new Error("fetch called without a body");
+  return JSON.parse(String(init.body));
+}
+
+describe("save payload contract per axis (IMP-52 u10)", () => {
+  it("section-drop payload: PUT body carries only zone_sections", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    // Shape produced by handleSectionDrop after moveSectionToZone.
+    const payload: UserOverridesPartial = {
+      zone_sections: {
+        top: ["03-1", "03-2"],
+        bottom: ["03-3"],
+      },
+    };
+    void saveUserOverrides("03_demo", payload);
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["zone_sections"]);
+    expect(body.zone_sections).toEqual(payload.zone_sections);
+  });
+
+  it("layout-select payload: PUT body carries only `layout` (string)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { layout: "two-column" });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["layout"]);
+    expect(body.layout).toBe("two-column");
+  });
+
+  it("zone-resize payload: PUT body carries only zone_geometries (merged snapshot)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    const merged = {
+      top: { x: 0, y: 0, w: 1, h: 0.42 },
+      bottom_l: { x: 0, y: 0.42, w: 0.5, h: 0.58 },
+      bottom_r: { x: 0.5, y: 0.42, w: 0.5, h: 0.58 },
+    };
+    void saveUserOverrides("03_demo", { zone_geometries: merged });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["zone_geometries"]);
+    expect(body.zone_geometries).toEqual(merged);
+  });
+
+  it("frame-select payload: PUT body carries only frames (unit_id → template_id)", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    // Shape produced by handleFrameSelect after the default-frame gate:
+    // only zones the user explicitly chose a non-default frame for.
+    const framesByUnitId = {
+      "03-1": "process_product_two_way",
+      "03-2+03-3": "three_parallel_requirements",
+    };
+    void saveUserOverrides("03_demo", { frames: framesByUnitId });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["frames"]);
+    expect(body.frames).toEqual(framesByUnitId);
+  });
+
+  it("frame-select payload with empty framesByUnitId still PUTs (replaces axis with {})", async () => {
+    // When the user reverts the last frame override back to the backend
+    // default, handleFrameSelect computes `framesByUnitId = {}`. The PUT
+    // path still fires so the on-disk `frames` axis is cleared to the empty
+    // object via u4's partial-merge replace semantics. Foreign axes
+    // (layout / zone_geometries / zone_sections) remain on disk.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { frames: {} });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(lastPutBody()).toEqual({ frames: {} });
+  });
+});
+
+// ─── zone_sizes axis is not part of the on-disk schema ─────────────────────
+
+describe("zone_sizes axis exclusion (IMP-52 u10)", () => {
+  it("UserOverridesPartial type does not include zone_sizes at compile time", () => {
+    // Compile-time check: this assignment must be a TS error. The runtime
+    // assertion below is a placebo; the meaningful evidence is that the
+    // suite *builds*. If a future schema bump adds zone_sizes to
+    // UserOverrides, this comment serves as the migration touchpoint.
+    // @ts-expect-error — zone_sizes is intentionally not part of UserOverridesPartial
+    const _bad: UserOverridesPartial = { zone_sizes: { layout_group_1: [0.5, 0.5] } };
+    void _bad;
+    expect(true).toBe(true);
+  });
+
+  it("Home.tsx never imports a write helper that would persist zone_sizes", () => {
+    // handleLayoutResize delegates to saveZoneSizes (in-memory), not
+    // saveUserOverrides. Cross-check the import line and the handler body.
+    expect(HOME_TSX).toMatch(/import\s*\{[^}]*\bsaveZoneSizes\b[^}]*\}\s*from\s*"\.\.\/utils\/slidePlanUtils"/);
+    const block = sliceHandler(HOME_TSX, "handleLayoutResize");
+    expect(block).toMatch(/saveZoneSizes\(/);
+    expect(block).not.toMatch(/saveUserOverrides/);
+  });
+});
+
+// ─── Write-before-Generate ordering ────────────────────────────────────────
+// The four mutation handlers schedule debounced PUTs (300ms). If the user
+// hits Generate before the debounce fires, the persistence layer must not
+// drop the pending writes. `flushUserOverrides` is the contract: callers can
+// force-commit pending buckets before pipeline kickoff so the backend u2
+// fallback reads the latest file.
+
+describe("write-before-Generate ordering (IMP-52 u10)", () => {
+  // The service-level tests below prove the `flushUserOverrides` contract in
+  // isolation. The two source-pattern checks here pin the *real* Generate
+  // call site so a future refactor that drops the flush — re-exposing the
+  // 300ms debounce race against `runPipeline` / the u2 backend fallback —
+  // fails loudly. Without React Testing Library we cannot dispatch a click
+  // on the Generate button, so we read Home.tsx as text and assert (a) the
+  // import names `flushUserOverrides`, (b) the `handleGenerate` closure
+  // awaits the flush before it awaits `runPipeline`.
+
+  it("Home.tsx imports flushUserOverrides from userOverridesApi", () => {
+    expect(HOME_TSX).toMatch(
+      /import\s*\{[^}]*\bflushUserOverrides\b[^}]*\}\s*from\s*"\.\.\/services\/userOverridesApi"/,
+    );
+  });
+
+  it("handleGenerate awaits flushUserOverrides before awaiting runPipeline", () => {
+    const block = sliceHandler(HOME_TSX, "handleGenerate");
+    expect(block).toMatch(/await\s+flushUserOverrides\s*\(\s*\)/);
+    expect(block).toMatch(/await\s+runPipeline\s*\(/);
+    const flushIdx = block.search(/await\s+flushUserOverrides\s*\(/);
+    const runIdx = block.search(/await\s+runPipeline\s*\(/);
+    expect(flushIdx).toBeGreaterThan(-1);
+    expect(runIdx).toBeGreaterThan(-1);
+    expect(flushIdx).toBeLessThan(runIdx);
+  });
+
+  it("flushUserOverrides commits a pending PUT before its 300ms debounce fires", async () => {
+    fetchMock.mockResolvedValue(mockResponse({ layout: "two-column" }));
+    const savePromise = saveUserOverrides("03_demo", { layout: "two-column" });
+
+    // Without flush, the PUT would not fire for another 300ms.
+    expect(fetchMock).not.toHaveBeenCalled();
+
+    const flushPromise = flushUserOverrides();
+    await drainMicrotasks();
+    await flushPromise;
+
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const [url, init] = fetchMock.mock.calls[0];
+    expect(url).toBe("/api/user-overrides/03_demo");
+    expect((init as RequestInit).method).toBe("PUT");
+
+    // Caller's promise resolves with the server-merged document — so a
+    // pre-Generate `await flushUserOverrides()` can be paired with
+    // `await savePromise` for stronger ordering if needed.
+    await expect(savePromise).resolves.toEqual({ layout: "two-column" });
+  });
+
+  it("flushUserOverrides (no arg) flushes pending writes across multiple MDX keys", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { layout: "two-column" });
+    void saveUserOverrides("04_demo", { frames: { "04-1": "tpl_a" } });
+    void saveUserOverrides("05_demo", {
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+    });
+
+    await flushUserOverrides();
+    await drainMicrotasks();
+
+    const putUrls = fetchMock.mock.calls
+      .filter((c) => (c[1] as RequestInit).method === "PUT")
+      .map((c) => c[0]);
+    expect(putUrls).toEqual(
+      expect.arrayContaining([
+        "/api/user-overrides/03_demo",
+        "/api/user-overrides/04_demo",
+        "/api/user-overrides/05_demo",
+      ]),
+    );
+    expect(putUrls).toHaveLength(3);
+  });
+
+  it("flushUserOverrides is a no-op when no writes are pending", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    await flushUserOverrides();
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+
+  it("post-flush, a new save schedules a fresh 300ms debounce window", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { layout: "two-column" });
+    await flushUserOverrides();
+    await drainMicrotasks();
+    expect(
+      fetchMock.mock.calls.filter(
+        (c) => (c[1] as RequestInit).method === "PUT",
+      ),
+    ).toHaveLength(1);
+
+    // Second save after Generate completes — must not piggy-back on the
+    // already-flushed bucket; must re-arm a fresh debounce.
+    void saveUserOverrides("03_demo", { layout: "hero-detail" });
+    vi.advanceTimersByTime(299);
+    await drainMicrotasks();
+    expect(
+      fetchMock.mock.calls.filter(
+        (c) => (c[1] as RequestInit).method === "PUT",
+      ),
+    ).toHaveLength(1);
+    vi.advanceTimersByTime(1);
+    await drainMicrotasks();
+    expect(
+      fetchMock.mock.calls.filter(
+        (c) => (c[1] as RequestInit).method === "PUT",
+      ),
+    ).toHaveLength(2);
+  });
+});
+
+// ─── Restore-on-reopen — end-to-end compose ────────────────────────────────
+// u6 covers the helpers in isolation. This test wires them together with a
+// mocked GET response in the order Home.tsx invokes them at file-upload
+// time (key derive → fetch persisted → layer non-frame axes pre-loadRun →
+// remap frames post-loadRun) to pin the integration contract.
+
+function makeZone(partial: {
+  id: string;
+  zone_id: string;
+  section_ids: string[];
+  default_frame_id?: string | null;
+}): Zone {
+  return {
+    id: partial.id,
+    zone_id: partial.zone_id,
+    section_ids: partial.section_ids,
+    position: { x: 0, y: 0, width: 1, height: 1 },
+    internal_regions: [
+      {
+        id: `${partial.id}-r0`,
+        region_id: "region-single",
+        role: "primary",
+        content_type: "text_block",
+        ratio_estimate: 1,
+        content_unit_ids: [],
+        frame_match_strategy: {
+          kind: "frame_match",
+          frame_id: partial.default_frame_id ?? null,
+          display_strategy: "inline_full",
+        },
+        frame_candidates: [],
+      },
+    ],
+  };
+}
+
+describe("restore-on-reopen end-to-end (IMP-52 u10)", () => {
+  it("getUserOverrides → non-frame layer + post-load frame remap composes a restored selection", async () => {
+    // GET returns the persisted file for "03_demo". The `layout` value
+    // must be a real LayoutPresetId — applyPersistedNonFrameOverrides
+    // validates against the 8-preset whitelist (slidePlanUtils.ts:30).
+    fetchMock.mockResolvedValueOnce(
+      mockResponse({
+        layout: "horizontal-2",
+        frames: { "03-1": "process_product_two_way" },
+        zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.42 } },
+        zone_sections: { top: ["03-1"], bottom: ["03-2", "03-3"] },
+      }),
+    );
+
+    const key = deriveUserOverridesKey("03_demo.mdx");
+    expect(key).toBe("03_demo");
+
+    // Step 1: Home.tsx fetches at handleFileUpload time.
+    const persisted = await getUserOverrides(key);
+    expect(persisted.layout).toBe("horizontal-2");
+
+    // Step 2: pre-loadRun layering applies layout / zone_geometries /
+    // zone_sections onto a fresh selection. Frames are deferred because
+    // the unit_id key cannot be remapped without a slidePlan yet.
+    const seededSelection = applyPersistedNonFrameOverrides(
+      createInitialUserSelection(null),
+      persisted,
+    );
+    expect(seededSelection.overrides.layout_preset).toBe("horizontal-2");
+    expect(seededSelection.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.42 },
+    });
+    expect(seededSelection.overrides.zone_sections).toEqual({
+      top: ["03-1"],
+      bottom: ["03-2", "03-3"],
+    });
+    // Frames must NOT have been layered at this stage.
+    expect(seededSelection.overrides.zone_frames).toEqual({});
+
+    // Step 3: post-loadRun, Home.tsx has a slidePlan. Remap unit_id-keyed
+    // frames to region.id-keyed frames against the rebuilt plan.
+    const plan: SlidePlan = {
+      id: "plan-3",
+      title: "demo",
+      layout_preset: "horizontal-2",
+      zones: [
+        makeZone({
+          id: "z-top",
+          zone_id: "top",
+          section_ids: ["03-1"],
+          default_frame_id: "some_default_frame",
+        }),
+        makeZone({
+          id: "z-bot",
+          zone_id: "bottom",
+          section_ids: ["03-2", "03-3"],
+          default_frame_id: null,
+        }),
+      ],
+    };
+    const remapped = remapPersistedFramesToZoneFrames(
+      plan,
+      persisted.frames,
+    );
+    expect(remapped).toEqual({
+      "z-top-r0": "process_product_two_way",
+    });
+
+    // Step 4: post-loadRun merge — Home.tsx layers `remapped` onto
+    // `createInitialUserSelection(slidePlan)` so the SlideCanvas
+    // override-vs-default preview indicator surfaces the restored choice.
+    const finalSelection = {
+      ...applyPersistedNonFrameOverrides(
+        createInitialUserSelection(plan),
+        persisted,
+      ),
+    };
+    finalSelection.overrides = {
+      ...finalSelection.overrides,
+      zone_frames: { ...finalSelection.overrides.zone_frames, ...remapped },
+    };
+    expect(finalSelection.overrides.zone_frames["z-top-r0"]).toBe(
+      "process_product_two_way",
+    );
+    expect(finalSelection.overrides.layout_preset).toBe("horizontal-2");
+    expect(finalSelection.overrides.zone_sections).toEqual({
+      top: ["03-1"],
+      bottom: ["03-2", "03-3"],
+    });
+  });
+
+  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"));
+    expect(persisted).toEqual({});
+
+    const plan: SlidePlan = {
+      id: "plan-x",
+      title: "fresh",
+      layout_preset: "single",
+      zones: [
+        makeZone({ id: "z-only", zone_id: "main", section_ids: ["x-1"] }),
+      ],
+    };
+    const seeded = applyPersistedNonFrameOverrides(
+      createInitialUserSelection(plan),
+      persisted,
+    );
+    // No override applied → layout_preset, geometries, sections all from
+    // the slidePlan defaults; remap yields {} so no frames layered.
+    expect(seeded.overrides.layout_preset).toBe("single");
+    expect(seeded.overrides.zone_geometries).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(plan, persisted.frames)).toEqual({});
+  });
+});
+
+// ─── IMP-55 #93 u8 — manual_section_assignment intent marker contract ─────
+// Verifies four axes of the marker contract introduced in u3 (type) / u5
+// (apply reset) / u6 (drag flip + co-PUT) / u7 (generate gate):
+//   1) Drag dual-axis persistence — handleSectionDrop persists BOTH
+//      `zone_sections` AND `manual_section_assignment: true` in the SAME
+//      PUT body (co-PUT atomicity — disk never sees post-drop zone_sections
+//      without the marker).
+//   2) Apply / cancel reset — handleApplyPendingLayout writes explicit
+//      `manual_section_assignment: false` after the `...overrides` spread,
+//      and handleCancelPendingLayout relies on createInitialUserSelection
+//      (which u3 seeds to `false`) to drop a prior `true`.
+//   3) Marker-gated forwarding — handleGenerate gates `overrides.zoneSections`
+//      forwarding strictly on `manualMarker === true` (NOT truthiness, NOT
+//      `!= null`, NOT presence). u3-seeded `false` and absent values both
+//      skip forwarding.
+//   4) sameAsDefault NOT required — the Stage 1 anti-pattern (defaultByZone
+//      / sameAsDefault / zoneSectionsDiff self-compare loop) is gone from
+//      `handleGenerate` entirely; the marker is the source of intent.
+
+describe("IMP-55 #93 u8 — manual_section_assignment marker contract", () => {
+  it("handleSectionDrop sets marker true in-memory before persistence", () => {
+    const block = sliceHandler(HOME_TSX, "handleSectionDrop");
+    // finalSelection literal (built from zoneSelected, then marker = true)
+    // must occur BEFORE the saveUserOverrides call so the in-memory state
+    // and the PUT body source from the same overrides shape.
+    const markerIdx = block.search(/manual_section_assignment:\s*true/);
+    const saveIdx = block.search(/saveUserOverrides\(/);
+    expect(markerIdx).toBeGreaterThan(-1);
+    expect(saveIdx).toBeGreaterThan(-1);
+    expect(markerIdx).toBeLessThan(saveIdx);
+  });
+
+  it("handleSectionDrop co-PUTs zone_sections + manual_section_assignment:true (single body)", () => {
+    const block = sliceHandler(HOME_TSX, "handleSectionDrop");
+    // Single saveUserOverrides call carrying BOTH axes. The regex spans the
+    // call body to prove the two keys live in the same object literal — a
+    // future split into two PUTs would race the 300ms debounce and re-open
+    // the IMP-55 stale-disk window.
+    expect(block).toMatch(
+      /saveUserOverrides\([\s\S]*?zone_sections:[\s\S]*?manual_section_assignment:\s*true[\s\S]*?\)/,
+    );
+    // Exactly ONE saveUserOverrides call in the handler.
+    const calls = block.match(/saveUserOverrides\(/g) ?? [];
+    expect(calls.length).toBe(1);
+  });
+
+  it("handleApplyPendingLayout resets the marker to false in overrides literal", () => {
+    const block = sliceHandler(HOME_TSX, "handleApplyPendingLayout");
+    // After spreading `...p.userSelection.overrides`, the explicit
+    // `manual_section_assignment: false` overrides any prior-drag `true`.
+    // Without this the layout flip would carry the marker through, and u7
+    // would forward auto-carried assignments as user overrides → the
+    // PARTIAL_COVERAGE regression that motivated IMP-55.
+    expect(block).toMatch(/\.\.\.p\.userSelection\.overrides[\s\S]*?manual_section_assignment:\s*false/);
+  });
+
+  it("handleCancelPendingLayout uses createInitialUserSelection (u3 seeds false)", () => {
+    const block = sliceHandler(HOME_TSX, "handleCancelPendingLayout");
+    // Cancel discards all pending in-memory edits via the fresh-selection
+    // helper — the seed (u3) is the single source of truth for the
+    // in-memory marker on this path. u12 adds a separate disk-side
+    // saveUserOverrides PUT (covered by the u12 describe block below);
+    // the in-memory userSelection literal still has no explicit marker
+    // field — the seed handles it.
+    expect(block).toMatch(/createInitialUserSelection\(p\.slidePlan\)/);
+    // In-memory contract: no `manual_section_assignment` property appears
+    // inside the userSelection assignment. The only marker reference in
+    // live code lives inside the u12 saveUserOverrides(...) call body.
+    const codeOnly = stripComments(block);
+    expect(codeOnly).not.toMatch(
+      /userSelection:[\s\S]*?manual_section_assignment/,
+    );
+  });
+
+  it("handleGenerate gates overrides.zoneSections on manualMarker === true (strict bool)", () => {
+    const block = sliceHandler(HOME_TSX, "handleGenerate");
+    // Marker read AND strict-equality gate. `===` not `==`, not truthiness,
+    // not presence — so `false` / absent both skip forwarding (fail-closed).
+    expect(block).toMatch(/state\.userSelection\.overrides\.manual_section_assignment/);
+    expect(block).toMatch(/manualMarker\s*===\s*true/);
+    // The assignment to `overrides.zoneSections` must live INSIDE the
+    // marker-true branch.
+    const gateIdx = block.search(/if\s*\(\s*manualMarker\s*===\s*true\s*\)/);
+    const assignIdx = block.search(/overrides\.zoneSections\s*=/);
+    expect(gateIdx).toBeGreaterThan(-1);
+    expect(assignIdx).toBeGreaterThan(gateIdx);
+  });
+
+  it("handleGenerate filters forwarded zone_sections to valid zone_ids only (cross-layout safety)", () => {
+    const block = sliceHandler(HOME_TSX, "handleGenerate");
+    // A stale persisted layout could carry zone_ids that do not exist in
+    // the current sourcePlan (e.g. horizontal-2 `top`/`bottom` while the
+    // current layout is vertical-2 `left`/`right`). Those foreign keys
+    // must be dropped before reaching the backend `--override-section-
+    // assignment` so they cannot trigger PARTIAL_COVERAGE.
+    expect(block).toMatch(/validZoneIds\s*=\s*new Set\(\s*sourcePlan\.zones\.map\(\(z\)\s*=>\s*z\.zone_id\)/);
+    expect(block).toMatch(/if\s*\(!validZoneIds\.has\(zoneId\)\)\s*continue/);
+  });
+
+  it("handleGenerate no longer contains the IMP-08 B-3 self-compare anti-pattern", () => {
+    // Strip comments — the u7 docblock intentionally references the removed
+    // identifiers (`defaultByZone` / `sameAsDefault` / `zoneSectionsDiff`)
+    // in prose to explain the Stage 1 root cause for future readers; the
+    // regression we guard against is the LIVE code re-emerging.
+    const block = stripComments(sliceHandler(HOME_TSX, "handleGenerate"));
+    // The Stage 1 root cause: these identifiers compared user input against
+    // itself (sourcePlan === effectiveSlidePlan → zones === pendingZones,
+    // both derived from the same overrides.zone_sections). u7 deleted the
+    // entire block.
+    expect(block).not.toMatch(/\bdefaultByZone\b/);
+    expect(block).not.toMatch(/\bsameAsDefault\b/);
+    expect(block).not.toMatch(/\bzoneSectionsDiff\b/);
+  });
+
+  it("co-PUT payload contract: marker=true + zone_sections land in a single PUT body", async () => {
+    fetchMock.mockResolvedValue(mockResponse({}));
+    // Shape produced by handleSectionDrop after the u6 marker flip.
+    void saveUserOverrides("03_demo", {
+      zone_sections: { left: ["03-2"], right: ["03-1"] },
+      manual_section_assignment: true,
+    });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const body = lastPutBody() as Record<string, unknown>;
+    // Both axes in the same PUT body — exact equality, not arrayContaining,
+    // because any extra axis would mean a foreign mutation leaked through.
+    expect(Object.keys(body).sort()).toEqual(
+      ["manual_section_assignment", "zone_sections"].sort(),
+    );
+    expect(body.manual_section_assignment).toBe(true);
+    expect(body.zone_sections).toEqual({ left: ["03-2"], right: ["03-1"] });
+  });
+
+  it("co-PUT payload contract: marker=false carries explicitly through saveUserOverrides", async () => {
+    // u12 will add the apply/cancel explicit `false` PUT; the typed client
+    // must already propagate the literal `false` through the debounce
+    // bucket. A truthiness-based coalesce in the bucket merge would drop
+    // the value and re-open the stale-disk window. This locks the wire
+    // contract independently of the u12 caller-site write.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { manual_section_assignment: false });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["manual_section_assignment"]);
+    expect(body.manual_section_assignment).toBe(false);
+  });
+});
+
+// ─── IMP-55 #93 u12 — stale-disk marker reset on apply / cancel ───────────
+// u5 resets the in-memory marker on layout apply, and u3's seed via
+// `createInitialUserSelection` resets it on cancel. But the disk persists
+// independently — a prior drag wrote `true` via u6's co-PUT, so after a
+// page reload the u3 restore branch would re-seed `true` and the u7 gate
+// would forward auto-carried section assignments → PARTIAL_COVERAGE
+// regression. u12 closes that window by writing `manual_section_assignment:
+// false` to disk via saveUserOverrides on both apply and cancel paths.
+describe("IMP-55 #93 u12 — stale-disk marker reset on layout apply/cancel", () => {
+  it("handleApplyPendingLayout source contains a marker=false saveUserOverrides PUT", () => {
+    const block = sliceHandler(HOME_TSX, "handleApplyPendingLayout");
+    // Stripped-comment source so the u5 docblock prose doesn't satisfy the
+    // assertion — must be a real call expression.
+    const code = stripComments(block);
+    // Uploaded-file gate (mirrors the u6 / other handler pattern — the
+    // demo-mode initial render path must not PUT to an empty key).
+    expect(code).toMatch(
+      /if\s*\(\s*p\.uploadedFile\s*\)[\s\S]*?saveUserOverrides\([\s\S]*?manual_section_assignment:\s*false[\s\S]*?\)/,
+    );
+    expect(code).toMatch(/deriveUserOverridesKey\(p\.uploadedFile\.name\)/);
+  });
+
+  it("handleCancelPendingLayout source contains a marker=false saveUserOverrides PUT", () => {
+    const block = sliceHandler(HOME_TSX, "handleCancelPendingLayout");
+    const code = stripComments(block);
+    // Cancel handler converts from arrow-body to function-body for the
+    // disk PUT; the in-memory reset still comes from createInitialUserSelection.
+    expect(code).toMatch(
+      /if\s*\(\s*p\.uploadedFile\s*\)[\s\S]*?saveUserOverrides\([\s\S]*?manual_section_assignment:\s*false[\s\S]*?\)/,
+    );
+    expect(code).toMatch(/createInitialUserSelection\(p\.slidePlan\)/);
+  });
+
+  it("apply path PUT payload: marker=false carries alone (no auto-carry leakage)", async () => {
+    // The apply handler issues a dedicated PUT for the marker reset that is
+    // independent of the (conditional) zone_geometries PUT and of the
+    // in-memory zone_sections rewrite. The wire contract for this PUT must
+    // contain only the marker — if zone_sections leaked into the same body
+    // it would re-arm the u9 backend fallback gate against u12's intent.
+    fetchMock.mockResolvedValue(mockResponse({}));
+    void saveUserOverrides("03_demo", { manual_section_assignment: false });
+    vi.advanceTimersByTime(300);
+    await drainMicrotasks();
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    const body = lastPutBody() as Record<string, unknown>;
+    expect(Object.keys(body)).toEqual(["manual_section_assignment"]);
+    expect(body.manual_section_assignment).toBe(false);
+  });
+
+  it("apply path PUT is unconditional (does NOT gate on hadPriorGeoms)", () => {
+    // The u4 zone_geometries PUT inside handleApplyPendingLayout is
+    // conditional (`p.uploadedFile && hadPriorGeoms`). The u12 marker PUT
+    // must NOT inherit that gate — a stale disk `true` can exist without
+    // any prior zone_geometries, so the reset must always fire.
+    const code = stripComments(sliceHandler(HOME_TSX, "handleApplyPendingLayout"));
+    // Locate the marker PUT and verify its enclosing `if` clause is just
+    // `p.uploadedFile`, not the compound `... && hadPriorGeoms` guard.
+    const markerCallMatch = code.match(
+      /if\s*\(([^)]*)\)\s*\{[^}]*saveUserOverrides\([^)]*manual_section_assignment:\s*false[^)]*\)/,
+    );
+    expect(markerCallMatch).not.toBeNull();
+    if (markerCallMatch) {
+      expect(markerCallMatch[1].trim()).toBe("p.uploadedFile");
+    }
+  });
+});

Front/client/tests/zone_geometries_validation.test.ts

@@ -0,0 +1,222 @@
+// IMP-44 (#73) u3 — vitest coverage for `validateZoneGeometriesAgainstLayout`.
+//
+// Pairs with the backend [override-warning] guards added in u1 (1-D
+// horizontal-2 / vertical-2 branches of `build_layout_css`) and u2 (2-D
+// `_override_to_grid_tracks` call site). Same WARN+DROP unknown / KEEP known
+// contract; this helper lets handleGenerate (u4) validate against the active
+// layout before forwarding so the user sees a toast on dropped keys rather
+// than the backend silently even-splitting non-overridden zones with a false
+// `computation=user_override_geometry` signal.
+//
+// Cases (Stage 2 scope-lock):
+//   1) horizontal-2 → vertical-2 mismatch (all keys dropped)
+//   2) passthrough (all keys recognized)
+//   3) partial mix (some kept, some dropped)
+//   4) empty input ({} on a known layout)
+//   5) unknown-layout fail-safe (preset null / undefined / unknown string)
+
+import { describe, it, expect } from "vitest";
+import { validateZoneGeometriesAgainstLayout } from "../src/utils/slidePlanUtils";
+
+const g = (x: number, y: number, w: number, h: number) => ({ x, y, w, h });
+
+describe("validateZoneGeometriesAgainstLayout (IMP-44 u3)", () => {
+  // ── 1. mismatch ──────────────────────────────────────────────────────────
+  it("drops horizontal-2 keys when the active layout is vertical-2", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { top: g(0, 0, 1, 0.4), bottom: g(0, 0.4, 1, 0.6) },
+      "vertical-2",
+    );
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({
+      top: g(0, 0, 1, 0.4),
+      bottom: g(0, 0.4, 1, 0.6),
+    });
+    expect(result.expectedPositions).toEqual(["left", "right"]);
+    expect(result.valid).toBe(false);
+  });
+
+  it("drops vertical-2 keys when the active layout is horizontal-2", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { left: g(0, 0, 0.5, 1), right: g(0.5, 0, 0.5, 1) },
+      "horizontal-2",
+    );
+    expect(result.kept).toEqual({});
+    expect(Object.keys(result.dropped).sort()).toEqual(["left", "right"]);
+    expect(result.expectedPositions).toEqual(["top", "bottom"]);
+    expect(result.valid).toBe(false);
+  });
+
+  // ── 2. passthrough ───────────────────────────────────────────────────────
+  it("keeps all keys when every input key is in the active layout positions", () => {
+    const input = {
+      top: g(0, 0, 1, 0.4),
+      bottom: g(0, 0.4, 1, 0.6),
+    };
+    const result = validateZoneGeometriesAgainstLayout(input, "horizontal-2");
+    expect(result.kept).toEqual(input);
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual(["top", "bottom"]);
+    expect(result.valid).toBe(true);
+  });
+
+  it("passes a single 'primary' key through on the 'single' preset", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { primary: g(0, 0, 1, 1) },
+      "single",
+    );
+    expect(result.kept).toEqual({ primary: g(0, 0, 1, 1) });
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual(["primary"]);
+    expect(result.valid).toBe(true);
+  });
+
+  it("recognizes the 2-D preset positions reported by computeZonePositions (top-1-bottom-2)", () => {
+    const input = {
+      top: g(0, 0, 1, 0.5),
+      "bottom-left": g(0, 0.5, 0.5, 0.5),
+      "bottom-right": g(0.5, 0.5, 0.5, 0.5),
+    };
+    const result = validateZoneGeometriesAgainstLayout(input, "top-1-bottom-2");
+    expect(result.kept).toEqual(input);
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual([
+      "top",
+      "bottom-left",
+      "bottom-right",
+    ]);
+    expect(result.valid).toBe(true);
+  });
+
+  // ── 3. partial mix ───────────────────────────────────────────────────────
+  it("keeps known keys and drops unknown keys on a partial-mix input", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { top: g(0, 0, 1, 0.4), foo: g(0, 0, 1, 1) },
+      "horizontal-2",
+    );
+    expect(result.kept).toEqual({ top: g(0, 0, 1, 0.4) });
+    expect(result.dropped).toEqual({ foo: g(0, 0, 1, 1) });
+    expect(result.expectedPositions).toEqual(["top", "bottom"]);
+    expect(result.valid).toBe(false);
+  });
+
+  it("on a 2-D preset, keeps known 2-D track keys and drops legacy 1-D keys", () => {
+    // Simulates the user resizing under top-1-bottom-2, then flipping to
+    // grid-2x2 — legacy `bottom-left` stays valid; `top` (no longer a 2x2
+    // position) gets dropped.
+    const result = validateZoneGeometriesAgainstLayout(
+      {
+        top: g(0, 0, 1, 0.5),
+        "bottom-left": g(0, 0.5, 0.5, 0.5),
+        "top-left": g(0, 0, 0.5, 0.5),
+      },
+      "grid-2x2",
+    );
+    expect(result.kept).toEqual({
+      "bottom-left": g(0, 0.5, 0.5, 0.5),
+      "top-left": g(0, 0, 0.5, 0.5),
+    });
+    expect(result.dropped).toEqual({ top: g(0, 0, 1, 0.5) });
+    expect(result.expectedPositions).toEqual([
+      "top-left",
+      "top-right",
+      "bottom-left",
+      "bottom-right",
+    ]);
+    expect(result.valid).toBe(false);
+  });
+
+  // ── 4. empty input ───────────────────────────────────────────────────────
+  it("returns empty kept/dropped and valid=true on an empty {} input", () => {
+    const result = validateZoneGeometriesAgainstLayout({}, "horizontal-2");
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual(["top", "bottom"]);
+    expect(result.valid).toBe(true);
+  });
+
+  it("treats null / undefined geoms as empty input (no throw, valid=true on a known layout)", () => {
+    const nullResult = validateZoneGeometriesAgainstLayout(null, "vertical-2");
+    expect(nullResult.kept).toEqual({});
+    expect(nullResult.dropped).toEqual({});
+    expect(nullResult.expectedPositions).toEqual(["left", "right"]);
+    expect(nullResult.valid).toBe(true);
+
+    const undefResult = validateZoneGeometriesAgainstLayout(
+      undefined,
+      "vertical-2",
+    );
+    expect(undefResult.kept).toEqual({});
+    expect(undefResult.dropped).toEqual({});
+    expect(undefResult.expectedPositions).toEqual(["left", "right"]);
+    expect(undefResult.valid).toBe(true);
+  });
+
+  it("ignores array payloads (defensive against hand-edited persisted files)", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      [] as unknown as Record<string, { x: number; y: number; w: number; h: number }>,
+      "horizontal-2",
+    );
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual(["top", "bottom"]);
+    expect(result.valid).toBe(true);
+  });
+
+  // ── 5. unknown-layout fail-safe ──────────────────────────────────────────
+  it("drops every input key when layout is null (fail-safe)", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { top: g(0, 0, 1, 0.4), bottom: g(0, 0.4, 1, 0.6) },
+      null,
+    );
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({
+      top: g(0, 0, 1, 0.4),
+      bottom: g(0, 0.4, 1, 0.6),
+    });
+    expect(result.expectedPositions).toEqual([]);
+    expect(result.valid).toBe(false);
+  });
+
+  it("drops every input key when layout is undefined (fail-safe)", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { primary: g(0, 0, 1, 1) },
+      undefined,
+    );
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({ primary: g(0, 0, 1, 1) });
+    expect(result.expectedPositions).toEqual([]);
+    expect(result.valid).toBe(false);
+  });
+
+  it("drops every input key when layout is an unknown preset string (fail-safe)", () => {
+    const result = validateZoneGeometriesAgainstLayout(
+      { top: g(0, 0, 1, 0.4) },
+      "rogue-preset" as unknown as string,
+    );
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({ top: g(0, 0, 1, 0.4) });
+    expect(result.expectedPositions).toEqual([]);
+    expect(result.valid).toBe(false);
+  });
+
+  it("returns empty kept/dropped/expectedPositions when layout is unknown AND geoms is empty", () => {
+    const result = validateZoneGeometriesAgainstLayout({}, null);
+    expect(result.kept).toEqual({});
+    expect(result.dropped).toEqual({});
+    expect(result.expectedPositions).toEqual([]);
+    // No keys to drop ⇒ vacuously valid; handleGenerate (u4) gates the toast
+    // on `Object.keys(dropped).length > 0`, not `valid`, so this is safe.
+    expect(result.valid).toBe(true);
+  });
+
+  // ── purity / mutation safety ─────────────────────────────────────────────
+  it("does not mutate the input geometries object", () => {
+    const input = { top: g(0, 0, 1, 0.4), foo: g(0, 0, 1, 1) };
+    const inputKeysBefore = Object.keys(input).sort();
+    validateZoneGeometriesAgainstLayout(input, "horizontal-2");
+    expect(Object.keys(input).sort()).toEqual(inputKeysBefore);
+    // Sample value still pristine.
+    expect(input.top).toEqual(g(0, 0, 1, 0.4));
+  });
+});

Front/vite.config.ts

@@ -204,20 +204,545 @@ function vitePluginStorageProxy(): Plugin {
   };
 }
 
+// =============================================================================
+// IMP-52 u3/u4 — user_overrides.json persistence (MDX-stem keyed store).
+//
+// On-disk layout: <DESIGN_AGENT_ROOT>/data/user_overrides/<key>.json. Mirrors
+// the Python contract in src/user_overrides_io.py — same validate_key regex,
+// same graceful-degrade (corrupt → {}) so backend pipeline entry fallback
+// (u2) and the vite endpoints (u3 GET, u4 PUT) agree on every file.
+//
+// Helpers are named exports so vitest can drive handleGetUserOverrides /
+// handlePutUserOverrides with mock req/res without booting a real dev
+// server. vite still consumes the default `defineConfig` export below.
+// =============================================================================
+
+export const USER_OVERRIDES_KEY_RE = /^[A-Za-z0-9_][A-Za-z0-9_.\-]*$/;
+
+// The nine in-scope axes — full mirror of KNOWN_AXES in
+// src/user_overrides_io.py. Order matches the Python tuple verbatim so
+// a side-by-side audit reads as a no-op. Any payload key outside this
+// allowlist is silently dropped by the PUT handler (u4) so the on-disk
+// schema cannot drift from the backend pipeline (u2) contract. Foreign
+// top-level keys already on disk are preserved verbatim (see
+// mergeUserOverrides).
+// IMP-51 (#79) u2: added `image_overrides` (image_id → {x,y,w,h}
+// percent-of-slide coordinates).
+// IMP-55 (#93) u1: added `manual_section_assignment` (bool intent marker
+// — drag-drop sets true, layout apply/cancel sets false).
+// IMP-56 (#90) u3: allowlist sync — closes the prior `slide_css` gap
+// (IMP-45 #74; the Step-22 slide CSS edit path will write it from the
+// frontend) and pre-wires `text_overrides` (IMP-56 #90 u1, keyed by
+// {zone_id: {text_path: value}}) + `structure_overrides` (IMP-56 #90 u2,
+// keyed by {zone_id: {slot_order, hidden_slots}} — scope LOCKED to slot
+// reorder + hide; frame swap stays on the existing `frames` axis to
+// preserve Phase Z's no-AI-HTML-structure invariant) so the Step-22
+// capture path (u10~u17) can PUT either axis without a follow-on
+// allowlist edit.
+export const KNOWN_USER_OVERRIDES_AXES = [
+  "layout",
+  "zone_geometries",
+  "zone_sections",
+  "frames",
+  "image_overrides",
+  "slide_css",
+  "manual_section_assignment",
+  "text_overrides",
+  "structure_overrides",
+] as const;
+export type KnownUserOverridesAxis = (typeof KNOWN_USER_OVERRIDES_AXES)[number];
+
+// 1MB cap on PUT bodies. Override files in practice are < 10KB (5 axes,
+// each a small dict). The cap is a safety net against runaway client
+// loops, not a real schema constraint.
+const USER_OVERRIDES_PUT_MAX_BYTES = 1_000_000;
+
+export function isValidUserOverridesKey(key: string): boolean {
+  if (!key) return false;
+  if (key.includes("..")) return false;
+  if (key.includes("/") || key.includes("\\")) return false;
+  return USER_OVERRIDES_KEY_RE.test(key);
+}
+
+export function userOverridesPath(root: string, key: string): string {
+  return path.join(root, "data", "user_overrides", `${key}.json`);
+}
+
+// Minimal req/res shapes — node IncomingMessage / ServerResponse have many
+// fields the handler does not touch, so we accept a structural subset for
+// testability.
+type GetReqLike = { method?: string; url?: string };
+type PutReqLike = {
+  method?: string;
+  url?: string;
+  on(event: "data" | "end" | "error", cb: (...args: any[]) => void): unknown;
+};
+type ResLike = {
+  writeHead: (status: number, headers?: Record<string, string>) => void;
+  end: (body?: string) => void;
+};
+
+// IMP-52 u3 — GET /api/user-overrides/:key handler. Returns true when the
+// handler took over the response, false when the caller should `next()`.
+// Invariants:
+//   • method != GET           → false (chain continues; u4 PUT may handle)
+//   • invalid key             → 400 {"error":"invalid key"}
+//   • file missing            → 200 {}
+//   • file unreadable/corrupt → 200 {}  (graceful degrade, mirrors u1 load)
+//   • non-object JSON root    → 200 {}  (mirrors u1 load)
+//   • valid object JSON       → 200 with parsed JSON body
+export function handleGetUserOverrides(
+  req: GetReqLike,
+  res: ResLike,
+  root: string,
+): boolean {
+  if (req.method !== "GET") return false;
+
+  const url = req.url || "";
+  const key = url.split("?")[0].replace(/^\//, "");
+
+  if (!isValidUserOverridesKey(key)) {
+    res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ error: "invalid key" }));
+    return true;
+  }
+
+  const filePath = userOverridesPath(root, key);
+
+  if (!fs.existsSync(filePath)) {
+    res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+    res.end("{}");
+    return true;
+  }
+
+  let parsed: unknown;
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    parsed = JSON.parse(raw);
+  } catch {
+    res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+    res.end("{}");
+    return true;
+  }
+
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+    res.end("{}");
+    return true;
+  }
+
+  res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+  res.end(JSON.stringify(parsed));
+  return true;
+}
+
+// IMP-52 u4 — pure merge function. Mirrors src/user_overrides_io.save():
+//   • Only KNOWN_USER_OVERRIDES_AXES present in `partial` are mutated.
+//   • Axes absent from `partial` are preserved verbatim from `existing`.
+//   • Foreign top-level keys in `existing` (future axes like zone_sizes)
+//     are preserved verbatim — allowlist guards what the PUT writes, NOT
+//     what the file already holds.
+//   • `partial[axis] = null` is the explicit clear sentinel (remove key).
+//   • Any non-axis keys in `partial` are silently dropped (allowlist).
+export function mergeUserOverrides(
+  existing: Record<string, unknown>,
+  partial: Record<string, unknown>,
+): Record<string, unknown> {
+  const merged: Record<string, unknown> = { ...existing };
+  for (const axis of KNOWN_USER_OVERRIDES_AXES) {
+    if (!(axis in partial)) continue;
+    const value = partial[axis];
+    if (value === null) {
+      delete merged[axis];
+    } else {
+      merged[axis] = value;
+    }
+  }
+  return merged;
+}
+
+// IMP-52 u4 — atomic file write via tmp + rename. Mirrors the
+// `_atomic_write_json` semantics in src/user_overrides_io.py so a
+// crashed/interrupted PUT cannot leave a half-written .json on disk
+// (the next GET / pipeline-entry read would otherwise return {} via
+// graceful degrade, silently losing the user's prior overrides).
+export function atomicWriteUserOverrides(
+  filePath: string,
+  data: Record<string, unknown>,
+): void {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  const tmpName = path.join(
+    dir,
+    `.${path.basename(filePath)}.${process.pid}.${Date.now()}.tmp`,
+  );
+  try {
+    fs.writeFileSync(
+      tmpName,
+      JSON.stringify(data, null, 2) + "\n",
+      "utf-8",
+    );
+    fs.renameSync(tmpName, filePath);
+  } catch (err) {
+    try {
+      fs.unlinkSync(tmpName);
+    } catch {
+      // best-effort cleanup; the rename source may not exist on early failure
+    }
+    throw err;
+  }
+}
+
+// IMP-52 u4 — PUT /api/user-overrides/:key handler. Returns true when the
+// handler took over the response, false when the caller should `next()`.
+// Invariants:
+//   • method != PUT          → false (chain continues; GET runs first)
+//   • invalid key            → 400 {"error":"invalid key"}
+//   • body > 1MB             → 413 {"error":"payload too large"}
+//   • invalid JSON           → 400 {"error":"invalid JSON"}
+//   • non-object JSON root   → 400 {"error":"body must be a JSON object"}
+//   • write failure          → 500 {"error":"write failed: ..."}
+//   • success                → 200 with merged JSON body
+//
+// Existing-file read uses the same graceful-degrade rules as GET (corrupt
+// JSON / non-object root → treat as empty {}) so a PUT cannot fail solely
+// because a prior file is unparseable — the new payload replaces it.
+export function handlePutUserOverrides(
+  req: PutReqLike,
+  res: ResLike,
+  root: string,
+): boolean {
+  if (req.method !== "PUT") return false;
+
+  const url = req.url || "";
+  const key = url.split("?")[0].replace(/^\//, "");
+
+  if (!isValidUserOverridesKey(key)) {
+    res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ error: "invalid key" }));
+    return true;
+  }
+
+  let body = "";
+  let aborted = false;
+
+  req.on("data", (chunk: Buffer | string) => {
+    if (aborted) return;
+    body += typeof chunk === "string" ? chunk : chunk.toString();
+    if (body.length > USER_OVERRIDES_PUT_MAX_BYTES) {
+      aborted = true;
+      res.writeHead(413, {
+        "Content-Type": "application/json; charset=utf-8",
+      });
+      res.end(JSON.stringify({ error: "payload too large" }));
+    }
+  });
+
+  req.on("end", () => {
+    if (aborted) return;
+
+    let parsed: unknown;
+    try {
+      parsed = body.length > 0 ? JSON.parse(body) : {};
+    } catch {
+      res.writeHead(400, {
+        "Content-Type": "application/json; charset=utf-8",
+      });
+      res.end(JSON.stringify({ error: "invalid JSON" }));
+      return;
+    }
+
+    if (
+      typeof parsed !== "object" ||
+      parsed === null ||
+      Array.isArray(parsed)
+    ) {
+      res.writeHead(400, {
+        "Content-Type": "application/json; charset=utf-8",
+      });
+      res.end(JSON.stringify({ error: "body must be a JSON object" }));
+      return;
+    }
+
+    const partial = parsed as Record<string, unknown>;
+    const filePath = userOverridesPath(root, key);
+
+    // Load existing — corrupt / non-object → {} so the PUT still succeeds
+    // and recovers the file to a clean state. Mirrors u1 load() graceful
+    // degrade.
+    let existing: Record<string, unknown> = {};
+    if (fs.existsSync(filePath)) {
+      try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const ex = JSON.parse(raw);
+        if (
+          typeof ex === "object" &&
+          ex !== null &&
+          !Array.isArray(ex)
+        ) {
+          existing = ex as Record<string, unknown>;
+        }
+      } catch {
+        // corrupt → treat as empty
+      }
+    }
+
+    const merged = mergeUserOverrides(existing, partial);
+
+    try {
+      atomicWriteUserOverrides(filePath, merged);
+    } catch (err) {
+      res.writeHead(500, {
+        "Content-Type": "application/json; charset=utf-8",
+      });
+      res.end(JSON.stringify({ error: `write failed: ${String(err)}` }));
+      return;
+    }
+
+    res.writeHead(200, {
+      "Content-Type": "application/json; charset=utf-8",
+    });
+    res.end(JSON.stringify(merged));
+  });
+
+  req.on("error", () => {
+    if (aborted) return;
+    aborted = true;
+    res.writeHead(500, {
+      "Content-Type": "application/json; charset=utf-8",
+    });
+    res.end(JSON.stringify({ error: "request error" }));
+  });
+
+  return true;
+}
+
+// =============================================================================
+// IMP-56 (#90) u18 — POST /api/connect : cel astro dev mirror copy.
+//
+// Body: {"run_id": "<id>", "slug": "<mdx-stem>"}.
+//   • Copies <DESIGN_AGENT_ROOT>/data/runs/<run_id>/phase_z2/final.html →
+//     <CEL_PROJECT_ROOT>/public/slides/<slug>.html (overwrite).
+//   • If <run_dir>/phase_z2/assets/ exists, mirrors its contents into
+//     <CEL_PROJECT_ROOT>/public/slides/assets/ (overwrite copy, recursive).
+//   • run_id and slug are validated through the existing
+//     isValidUserOverridesKey gate so path-traversal payloads are rejected.
+// =============================================================================
+
+export function mirrorDirRecursive(srcDir: string, dstDir: string): number {
+  if (!fs.existsSync(srcDir) || !fs.statSync(srcDir).isDirectory()) return 0;
+  if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, { recursive: true });
+  let count = 0;
+  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    const srcPath = path.join(srcDir, entry.name);
+    const dstPath = path.join(dstDir, entry.name);
+    if (entry.isDirectory()) {
+      count += mirrorDirRecursive(srcPath, dstPath);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(srcPath, dstPath);
+      count += 1;
+    }
+  }
+  return count;
+}
+
+export function handleConnectMirror(
+  req: PutReqLike,
+  res: ResLike,
+  designAgentRoot: string,
+  celRoot: string,
+): boolean {
+  if (req.method !== "POST") return false;
+  let body = "";
+  req.on("data", (chunk: Buffer | string) => {
+    body += typeof chunk === "string" ? chunk : chunk.toString();
+  });
+  req.on("end", () => {
+    let parsed: unknown;
+    try {
+      parsed = body.length > 0 ? JSON.parse(body) : {};
+    } catch {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "invalid JSON" }));
+      return;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "body must be a JSON object" }));
+      return;
+    }
+    const { run_id, slug } = parsed as { run_id?: unknown; slug?: unknown };
+    if (typeof run_id !== "string" || typeof slug !== "string") {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "missing run_id or slug" }));
+      return;
+    }
+    if (!isValidUserOverridesKey(run_id) || !isValidUserOverridesKey(slug)) {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "invalid run_id or slug" }));
+      return;
+    }
+    const runDir = path.join(designAgentRoot, "data", "runs", run_id, "phase_z2");
+    const srcHtml = path.join(runDir, "final.html");
+    if (!fs.existsSync(srcHtml)) {
+      res.writeHead(404, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "final.html not found" }));
+      return;
+    }
+    const dstSlidesDir = path.join(celRoot, "public", "slides");
+    if (!fs.existsSync(dstSlidesDir)) fs.mkdirSync(dstSlidesDir, { recursive: true });
+    const dstHtml = path.join(dstSlidesDir, `${slug}.html`);
+    try {
+      fs.copyFileSync(srcHtml, dstHtml);
+    } catch (err) {
+      res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: `copy failed: ${String(err)}` }));
+      return;
+    }
+    const assetsCopied = mirrorDirRecursive(
+      path.join(runDir, "assets"),
+      path.join(dstSlidesDir, "assets"),
+    );
+    res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ success: true, run_id, slug, html_target: dstHtml, assets_copied: assetsCopied }));
+  });
+  req.on("error", () => {
+    res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ error: "request error" }));
+  });
+  return true;
+}
+
+// =============================================================================
+// IMP-56 (#90) u19 — POST /api/export : standalone HTML download.
+//
+// Body: {"run_id": "<id>"}.
+//   • Reads <DESIGN_AGENT_ROOT>/data/runs/<run_id>/phase_z2/final.html.
+//   • Inlines every `url(assets/<frame>/<file>)` reference (the only
+//     external dep emitted by the Phase Z2 render path — verified by grep
+//     against templates/phase_z2/slide_base.html and a representative run)
+//     as a base64 data URL so the emitted HTML is portable (file:// open
+//     or any external host, no co-located assets/ dir required). Mirrors
+//     u18 validation: isValidUserOverridesKey gate for path-traversal
+//     rejection; final.html missing → 404.
+//   • Response: 200 text/html with Content-Disposition: attachment so the
+//     browser triggers a download with `<run_id>.html` filename. Raw HTML
+//     body (NOT JSON-wrapped) — the BottomActions wiring (u20) will pipe
+//     the response body straight into a Blob → a[download] click chain
+//     mirroring the existing serializeSlidePlan JSON download flow.
+// =============================================================================
+
+export function inlineAssetsAsDataUrls(html: string, assetsRoot: string): string {
+  // Match `url(assets/<rel-path>)` (with optional single/double quotes,
+  // optional surrounding whitespace). The Phase Z2 render path emits
+  // `url(assets/<frame>/<file>.png)` verbatim into inline `style="..."`
+  // custom-property declarations (see slide_base.html `--card-frame-bg`
+  // etc.) — there is no `<link rel="stylesheet">` or `<img src>` external
+  // ref to handle. Keeping the matcher narrow avoids accidentally
+  // rewriting `data:` / `http(s):` / sibling-path URLs that the render
+  // path does not produce.
+  const URL_RE = /url\(\s*(['"]?)assets\/([^)'"]+)\1\s*\)/g;
+  return html.replace(URL_RE, (match, _quote: string, rel: string) => {
+    const filePath = path.join(assetsRoot, rel);
+    if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) return match;
+    const ext = path.extname(filePath).toLowerCase().slice(1);
+    const mime =
+      ext === "png" ? "image/png" :
+      ext === "jpg" || ext === "jpeg" ? "image/jpeg" :
+      ext === "svg" ? "image/svg+xml" :
+      ext === "webp" ? "image/webp" :
+      ext === "gif" ? "image/gif" :
+      "application/octet-stream";
+    const buf = fs.readFileSync(filePath);
+    return `url("data:${mime};base64,${buf.toString("base64")}")`;
+  });
+}
+
+export function handleExportStandalone(
+  req: PutReqLike,
+  res: ResLike,
+  designAgentRoot: string,
+): boolean {
+  if (req.method !== "POST") return false;
+  let body = "";
+  req.on("data", (chunk: Buffer | string) => {
+    body += typeof chunk === "string" ? chunk : chunk.toString();
+  });
+  req.on("end", () => {
+    let parsed: unknown;
+    try {
+      parsed = body.length > 0 ? JSON.parse(body) : {};
+    } catch {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "invalid JSON" }));
+      return;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "body must be a JSON object" }));
+      return;
+    }
+    const { run_id } = parsed as { run_id?: unknown };
+    if (typeof run_id !== "string") {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "missing run_id" }));
+      return;
+    }
+    if (!isValidUserOverridesKey(run_id)) {
+      res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "invalid run_id" }));
+      return;
+    }
+    const runDir = path.join(designAgentRoot, "data", "runs", run_id, "phase_z2");
+    const srcHtml = path.join(runDir, "final.html");
+    if (!fs.existsSync(srcHtml)) {
+      res.writeHead(404, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "final.html not found" }));
+      return;
+    }
+    let html: string;
+    try {
+      html = fs.readFileSync(srcHtml, "utf-8");
+    } catch (err) {
+      res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: `read failed: ${String(err)}` }));
+      return;
+    }
+    const inlined = inlineAssetsAsDataUrls(html, path.join(runDir, "assets"));
+    res.writeHead(200, {
+      "Content-Type": "text/html; charset=utf-8",
+      "Content-Disposition": `attachment; filename="${run_id}.html"`,
+    });
+    res.end(inlined);
+  });
+  req.on("error", () => {
+    res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ error: "request error" }));
+  });
+  return true;
+}
+
 // =============================================================================
 // Phase Z API Plugin — MDX 업로드 → 파이프라인 실행 → 결과 노출
 //
 // Endpoints (vite dev middleware) :
 //   POST /api/run         multipart/JSON body {filename, content} → run_id
 //   GET  /data/runs/{run_id}/{path}  →  {DESIGN_AGENT_ROOT}/data/runs/{run_id}/phase_z2/{path}
+//   GET  /api/user-overrides/{key}   →  data/user_overrides/{key}.json (IMP-52 u3)
+//   PUT  /api/user-overrides/{key}   →  partial-merge save (IMP-52 u4)
+//   POST /api/connect                →  cel mirror (IMP-56 #90 u18)
+//   POST /api/export                 →  standalone HTML download (IMP-56 #90 u19)
 //
 // 환경 변수 (선택) :
 //   DESIGN_AGENT_ROOT  python pipeline 실행 cwd. default = D:/ad-hoc/kei/design_agent
+//   CEL_PROJECT_ROOT   cel astro dev repo root. default = D:/ad-hoc/cel
 // =============================================================================
 
 function vitePluginPhaseZApi(): Plugin {
   const DESIGN_AGENT_ROOT =
     process.env.DESIGN_AGENT_ROOT || "D:\\ad-hoc\\kei\\design_agent";
+  const CEL_PROJECT_ROOT =
+    process.env.CEL_PROJECT_ROOT || "D:\\ad-hoc\\cel";
   const UPLOADS_DIR = path.join(DESIGN_AGENT_ROOT, "samples", "uploads");
   const RUNS_DIR = path.join(DESIGN_AGENT_ROOT, "data", "runs");
 
@@ -245,6 +770,16 @@ function vitePluginPhaseZApi(): Plugin {
               // (e.g., "top": ["03-1-sub-1"]). Forwarded as --override-section-assignment.
               zoneSections?: Record<string, string[]>;
             };
+            // IMP-43 (#72) u6 — optional PREV_RUN_ID to reuse Step 0/1/2/5/6
+            // artifacts from a prior run and resume execution at Step 7.
+            // Lives at the payload root (NOT under `overrides`) because the
+            // backend u1 post-merge guard rejects most override axes when
+            // --reuse-from is supplied. Absent / empty = full pipeline
+            // (byte-identical to pre-u6 spawn).
+            reuseFromRunId?: string;
+            // #98 Task 1 — clean generate / no-change regenerate must not
+            // resurrect stale data/user_overrides/<key>.json fallback axes.
+            ignoreUserOverrides?: boolean;
           };
           try {
             payload = JSON.parse(body);
@@ -256,7 +791,7 @@ function vitePluginPhaseZApi(): Plugin {
             return;
           }
 
-          const { filename, content, overrides } = payload;
+          const { filename, content, overrides, reuseFromRunId, ignoreUserOverrides } = payload;
           if (!filename || typeof content !== "string") {
             res.writeHead(400, { "Content-Type": "application/json" });
             res.end(
@@ -340,23 +875,37 @@ function vitePluginPhaseZApi(): Plugin {
               );
             }
           }
+          // IMP-43 (#72) u6 — --reuse-from <PREV_RUN_ID> forward. Backend
+          // (u1) parses this flag, validates the snapshot, copies Step
+          // 0/1/2/5/6 artifacts from data/runs/<PREV_RUN_ID>/phase_z2 into
+          // the new run_dir, and resumes execution at Step 7. The post-merge
+          // guard at the same site rejects --override-layout /
+          // --override-zone-geometry / --override-section-assignment /
+          // --override-image with axis-named fail-closed exit; only
+          // --override-frame (above) is preserved. Truthy check excludes
+          // empty string + undefined so an invalid argument never reaches
+          // argparse.
+          if (reuseFromRunId && typeof reuseFromRunId === "string") {
+            cliArgs.push("--reuse-from", reuseFromRunId);
+          }
+          if (ignoreUserOverrides === true) {
+            cliArgs.push("--ignore-user-overrides");
+          }
           console.log(
             `[phase-z-api] spawn pipeline: run_id=${runId}, mdx=${mdxPath}, args=${JSON.stringify(cliArgs.slice(2))}`
           );
           const pythonExe = process.platform === "win32" ? "python.exe" : "python";
-          // 2026-05-14 — env toggle forward (보고용 일회성).
+          // 2026-05-21 — IMP-38 retire PHASE_Z_MAX_RANK env (never read by backend).
-          //   PHASE_Z_ALLOW_RESTRUCTURE / PHASE_Z_ALLOW_REJECT : status 통과
+          //   v4 fallback chain max_rank 는 templates/phase_z2/catalog/v4_fallback_policy.yaml 의
-          //   PHASE_Z_MAX_RANK=32 : V4 fallback chain 의 max_rank 확대 (등록 frame 까지 검색)
+          //   정식 정책 (dynamic_usable_count_based) 으로 결정 — backend src/phase_z2_pipeline.py
-          // 04-1 (all reject) / 05-2 (rank 1~3 미등록) 등 자동 매칭 가능.
+          //   의 lookup_v4_match_with_fallback() 가 load_v4_fallback_policy() 로 적용.
+          // 2026-07-02 — issue #9 quick fix: PHASE_Z_ALLOW_REJECT / PHASE_Z_ALLOW_RESTRUCTURE
+          //   retire (dead env — src 에서 read 0곳. Emergency P2 가 reject 보존을 기본
+          //   정책으로 만들어 env toggle 불필요 — emergency.md §4 Quick fix 결정 B).
           const proc = spawn(pythonExe, cliArgs, {
             cwd: DESIGN_AGENT_ROOT,
             shell: false,
-            env: {
+            env: { ...process.env },
-              ...process.env,
-              PHASE_Z_ALLOW_RESTRUCTURE: "1",
-              PHASE_Z_ALLOW_REJECT: "1",
-              PHASE_Z_MAX_RANK: "32",
-            },
           });
 
           let stdout = "";
@@ -408,11 +957,13 @@ function vitePluginPhaseZApi(): Plugin {
         });
       });
 
-      // ── GET /api/sample-mdx → samples/mdx/{03|04|05} (데모) ──
+      // ── GET /api/sample-mdx → samples/mdx/{01|02|03|04|05} (데모) ──
       // 페이지 로드 시 frontend 가 자동 fetch — 상대방에게 mdx 파일 공유 안 해도 되게.
-      // 2026-05-14 — query param `?mdx=04` / `?mdx=05` 추가 (default = 03).
+      // 2026-05-14 — query param `?mdx=01`~`?mdx=05` 추가 (default = 03).
-      // 04 / 05 도 frontend simulation 가능하도록 frame/layout override 적용 path 유지.
+      // 01~05 모두 frontend simulation 가능하도록 frame/layout override 적용 path 유지.
       const SAMPLE_MDX_MAP: Record<string, string> = {
+        "01": "01. 건설산업 DX의 올바른 이해(0127).mdx",
+        "02": "02. DX의 시행 목표 및 기대효과.mdx",
         "03": "03. DX 시행을 위한 필수 요건 및 혁신 방안.mdx",
         "04": "04. DX 지연 요인.mdx",
         "05": "05. 설계 방식의 왜곡.mdx",
@@ -463,6 +1014,40 @@ function vitePluginPhaseZApi(): Plugin {
         fs.createReadStream(previewPath).pipe(res);
       });
 
+      // ── GET / PUT /api/user-overrides/{key} → data/user_overrides/{key}.json ──
+      // IMP-52 u3 (GET) + u4 (PUT) — MDX-stem keyed user overrides. Logic
+      // lives in the pure helpers (handleGetUserOverrides / handlePutUserOverrides)
+      // so vitest can exercise them without booting vite. Both handlers
+      // return false when the HTTP method does not match, so they chain
+      // cleanly: GET first, then PUT, then next() for everything else
+      // (e.g., OPTIONS / preflight handled by upstream middleware).
+      server.middlewares.use("/api/user-overrides", (req, res, next) => {
+        if (handleGetUserOverrides(req, res, DESIGN_AGENT_ROOT)) return;
+        if (handlePutUserOverrides(req, res, DESIGN_AGENT_ROOT)) return;
+        next();
+      });
+
+      // ── POST /api/connect → cel astro public/slides mirror ──
+      // IMP-56 (#90) u18 — see handleConnectMirror docblock for body shape +
+      // copy semantics. Logic lives in the pure helper so vitest can drive
+      // it without booting vite.
+      server.middlewares.use("/api/connect", (req, res, next) => {
+        if (handleConnectMirror(req, res, DESIGN_AGENT_ROOT, CEL_PROJECT_ROOT)) return;
+        next();
+      });
+
+      // ── POST /api/export → standalone HTML download ──
+      // IMP-56 (#90) u19 — see handleExportStandalone docblock for body
+      // shape + inline-asset semantics. Logic lives in the pure helper
+      // (handleExportStandalone + inlineAssetsAsDataUrls) so vitest can
+      // drive it without booting vite. The response is raw text/html
+      // (Content-Disposition: attachment); the u20 BottomActions wiring
+      // will turn the response body into a Blob → a[download] click.
+      server.middlewares.use("/api/export", (req, res, next) => {
+        if (handleExportStandalone(req, res, DESIGN_AGENT_ROOT)) return;
+        next();
+      });
+
       // ── GET /data/runs/{run_id}/{path} →  {RUNS_DIR}/{run_id}/phase_z2/{path} ──
       server.middlewares.use("/data/runs", (req, res, next) => {
         if (req.method !== "GET") return next();

ISSUE_DRAFTS_2026-07-02.md

@@ -0,0 +1,209 @@
+# 이슈 초안 — 2026-07-02 스냅샷(b836e79) 전수 검토 결과
+
+> 검토 범위: PLAN/PROGRESS/emergency.md 등 계획 문서, tests/matching 진단 리포트,
+> b836e79 커밋 코드 diff, figma_to_html_agent(미통합) 전체.
+> 목표: ① Figma→HTML 변환이 정확히 되고 ② 그 HTML에 콘텐츠 내용·의미가 반영되어 정리되는 상태.
+
+---
+
+## 그룹 A — Figma→HTML 변환 정확도
+
+### A-1. figma_to_html_agent를 메인 repo로 통합 (유실 위험 제거)
+
+**배경**
+- Figma→HTML 변환기 본체(MCP 추출 + 수학 변환 + 검증 프로세스 문서 PROCESS.md/MATH.md/RULES.md)가 `Front_test_v515/figma_to_html_agent/`에만 존재하며, 이 디렉토리는 gitignore 처리되어 **어디에도 백업이 없음**.
+- 메인 repo에는 사본 스크립트(`scripts/figma_to_html.py`)와 메타데이터만 있음.
+- 32개 frame 변환 산출물(blocks/{frame_id}/index.html, texts.md, flat.md)도 같은 위치에 미보존 상태.
+
+**작업**
+1. `figma_to_html_agent/`를 repo 최상위로 이동 (문서 + blocks + scripts).
+2. `scripts/figma_to_html.py` 중복 제거, gradient_math.py import 경로 정리.
+3. MCP(Figma Desktop Dev Mode) 의존성·.mcp.json 샘플 문서화.
+4. .gitignore에서 해당 경로 제외 확인 후 커밋.
+
+**완료 조건**: 변환기 전체가 origin/main에 push되어 로컬 디스크 유실 시에도 복구 가능.
+
+---
+
+### A-2. 잔여 Figma frame 프로모션 완료 (8/32 → 32/32)
+
+**배경**
+- Figma frame 32개 중 **promoted(본체 편입) 8개**, static(1:1 변환만) 6개+, 나머지는 staged 미작성.
+- placement_planner에 "contract-only 템플릿 skip" 로직(`b4_partial_missing_skip`, IMP-95 u6)이 있다는 것은 contract는 있으나 partial HTML이 없는 frame이 존재한다는 뜻 — 매칭이 맞아도 렌더링 불가.
+
+**작업**
+1. frame_contracts.yaml 기준 32개 frame의 상태 매트릭스 작성 (contract 유무 / partial HTML 유무 / promoted 여부).
+2. static 6개(process-products-2col, scene-with-numbered-list-4, framework-3section-label-body, bordered-3paragraphs, cards-3-category-bim-diagram, dx-banner-3perspective)부터 staged → promoted 진행.
+3. partial 없는 contract-only frame 목록을 문서화하고 순차 해소.
+
+**완료 조건**: V4가 선택한 어떤 frame도 "partial 없음"으로 skip되지 않음.
+
+---
+
+### A-3. Figma 원본 추적성(provenance) 강화
+
+**배경**
+- promoted 블록은 Jinja2 파라미터화 과정에서 Figma 원본 좌표·구조 추적성이 손실됨. 현재 provenance 테스트(test_imp49_partial_figma_provenance.py)는 **색상 literal만** 비교.
+- `get_screenshot` 결과(Figma 원본 PNG)가 캐시되지 않아 사후 육안 비교 기준이 없음.
+
+**작업**
+1. blocks/{frame_id}/에 Figma 원본 스크린샷 캐시 저장 (fetch_figma_screenshots.py 활용).
+2. promoted 블록마다 source frame_id를 frame_contracts.yaml에 정식 필드로 기록.
+3. provenance 테스트를 색상 외 구조(슬롯 수, 주요 영역 배치)까지 확장.
+
+**완료 조건**: 임의의 promoted 블록에서 "원본 Figma frame → HTML 요소" 대응을 문서·테스트로 확인 가능.
+
+---
+
+## 그룹 B — 콘텐츠 의미 → HTML 반영 (매칭 품질)
+
+### B-1. 02-2.2 매칭 실패 교정 — TARGET 4/4 달성
+
+**배경**
+- V4 종합 판정 TARGET 3/4 (75%). 실패 케이스 02-2.2: 정답 Frame 14가 V4 순위 7위, 모든 후보 reject.
+- 근본 원인: Frame 14의 anchor_sets 키워드가 MDX 02-2.2 본문과 거의 안 겹침 (tests/PIPELINE.md:230-232).
+- 문서상 예상 공수 1~2일 — 가장 빠르게 정확도를 올릴 수 있는 지점.
+
+**작업**
+1. Frame 14 anchor_sets 재라벨링 + 도메인 키워드 보강.
+2. holdout(02-2.1 등)으로 과적합 여부 교차 확인.
+
+**완료 조건**: TARGET 4/4, holdout 정확도 하락 없음.
+
+---
+
+### B-2. MDX 콘텐츠 성격·시각 의도 분류를 키워드 사전 → LLM 판정으로 대체
+
+**배경**
+- V3 구조 매칭의 "콘텐츠 성격(12 카테고리)·시각 의도(9 카테고리)"가 키워드 사전 매칭이라 오분류 발생 (예: 01-2가 policy_requirements로 오분류). tests/PROGRESS.md 약점 #2·#3, 예상 공수 3~5일.
+- 일반 표현을 못 잡는 구조적 한계 — 새 MDX가 들어올수록 사전 유지비 증가.
+
+**작업**
+1. 분류 프롬프트 설계 + 기존 4 TARGET/holdout으로 정확도 비교 (사전 vs LLM vs 하이브리드).
+2. 비용 고려해 "사전 1차 + 저신뢰 시 LLM" 하이브리드 우선 검토.
+3. 판정 근거를 pipeline_trace에 기록해 사후 검증 가능하게.
+
+**완료 조건**: 01-2 오분류 해소 + TARGET/holdout 분류 정확도 리포트 갱신.
+
+---
+
+### B-3. V4 스코어링 재조정 — ablation 결과 반영
+
+**배경**
+- ablation으로 확인된 사실: slot 축(가중 0.15)은 frame 선별에 무영향(Top-1 7/7 동일), cardinality는 axis(0.20)+slot.within(0.075)로 같은 신호가 중복 가중됨 (tests/PROGRESS.md 약점 #5·#6, V4_SLOT_ABLATION.md).
+
+**작업**
+1. slot 축을 frame 선별 가중에서 제거하고 label 게이트 역할로만 유지.
+2. cardinality 중복 가중 해소 후 가중치 재정규화.
+3. TARGET/holdout 재실행으로 회귀 없음 확인.
+
+**완료 조건**: 재조정된 가중치로 TARGET ≥ 기존, confidence 분포 문서화.
+
+---
+
+### B-4. 슬롯 의미 매핑 계약(T25) 실제 배선 + 컴포넌트 확장(T23) 커버리지
+
+**배경**
+- "BIM → col_a_label" 같은 편집 슬롯 의미 매핑 부재가 약점 #4로 기록됨.
+- 이번 스냅샷에서 node_slot_mapping.yaml(11 node × 9 slot 매트릭스)이 **정의됐으나 runtime에서 읽는 배선 미확인** (주석: "T25 will wire builders/mappers to validate").
+- component_expansion_registry.yaml은 DxEffect 1개 entry뿐이고 status: planned. persona role label도 "DxEffect" 하드코딩 (src/phase_z2_pipeline.py L281-284).
+- AI schema hints도 three_parallel_requirements 1개 frame만 정의 (L216-241).
+
+**작업**
+1. mapper/builder가 node_slot_mapping.yaml을 실제로 로드·검증하도록 배선 (T25).
+2. DxEffect expansion end-to-end 테스트 후 status: planned 해제.
+3. AI schema hints를 주요 frame(three_persona_benefits, quadrant 등)으로 확장.
+4. component_name 하드코딩 제거.
+
+**완료 조건**: node→slot 매핑 위반이 파이프라인에서 검출되고, DxEffect 외 컴포넌트 1개 이상 추가 등록.
+
+---
+
+### B-5. 표 전체 행 추출 + 이미지 frame 매칭 (약점 #7·#8)
+
+**배경**
+- 4행 표에서 첫 행만 본문으로 추출, 나머지 행 무시 (DECK 정직성 점검에서 발견).
+- 그림/이미지 frame은 본문 텍스트 패턴만 분석해 매칭이 약함.
+
+**작업**
+1. `_extract_markdown_table` 및 관련 파서가 전 행을 atom으로 보존하도록 수정, check_phase_z2_render_text_coverage.py로 검증.
+2. image_ref node type의 매칭 신호 설계 (alt 텍스트, 주변 문맥).
+
+**완료 조건**: 표 포함 MDX의 render_text_coverage에서 missing 행 0.
+
+---
+
+## 그룹 C — 파이프라인 신뢰성 (empty shell 제거·배선 완성)
+
+### C-1. Emergency P2~P5 완수 — empty shell 완전 제거
+
+**배경**
+- mdx 01~05 rescue 세션(emergency.md): root cause 3개(C1 catalog gap all-reject / C2 section key mismatch / C3 V4 source 누락) 식별 후 **P1 진단만 완료, P2~P5 미실행**.
+- 정책은 이미 확정됨: reject → `ai_adaptation_required` status, empty_shell terminal 제거, generic_fallback은 기존 catalog 활용.
+
+**작업** (emergency.md의 priority 순서 그대로)
+1. P2: V4 후보 보존 + 3-status 분류 (auto_renderable / ai_adaptation_required / blocked_runtime).
+2. P2.5: Section key alignment (child → parent pool merge universal policy).
+3. P3: empty_shell terminal 제거 + generic_fallback mandatory. — generic fallback frame(three_parallel_requirements, 1171281190 하드코딩)이 모든 MDX 타입을 커버하는지 검증 포함.
+4. P4: AI fallback 호출 trace 검증.
+5. P5: Frontend candidate panel status surface.
+
+**완료 조건**: mdx 01~05 전부 empty shell 없이 슬라이드 출력.
+
+---
+
+### C-2. V4 evidence 경로(PHASE_Z_B4_V4_EVIDENCE) end-to-end 배선
+
+**배경**
+- `_select_frame_v4_aware()`(placement_planner L180-285)와 selection_trace 필드까지 구현됐으나:
+  - env flag 기본 OFF에 call site에서 v4_candidates 전달 여부 미확인
+  - Step 11 trace 직렬화 wiring은 "u4 out of scope"로 명시적 미구현
+  - `partial_exists()` callback의 실제 호출처 없음
+
+**작업**
+1. plan_placement() 호출부에 v4_candidates 전달 + flag ON 경로 통합 테스트.
+2. Step 11에서 selection_trace JSON 직렬화·응답 포함.
+3. flag ON/OFF SHA parity 회귀 테스트(기존 test_b4_v4_evidence_off_sha_parity.py) 통과 유지.
+
+**완료 조건**: flag ON 실행에서 V4 rank 기반 frame 선택이 trace로 확인되고, OFF 시 기존 출력과 SHA 동일.
+
+---
+
+### C-3. pipeline_trace / ai_trace 백엔드-프론트 계약 검증
+
+**배경**
+- 프론트 PipelineTracePanel(신규 216줄)이 `RunMeta.pipeline_trace`, `ai_trace` 스키마(sections/units/zones, skip_reasons 등)를 기대하지만, **백엔드가 이 JSON을 실제 생성·응답에 포함하는지 미확인**.
+- `ignoreUserOverrides` 플래그, `coverage_state`, `rationale.ai_adaptation_required` 등 신규 필드도 동일.
+
+**작업**
+1. 백엔드 응답과 프론트 타입(designAgentApi.ts) 필드 대조표 작성.
+2. 누락 필드는 백엔드에서 생성 추가, 계약 테스트(스키마 검증) 1본 작성.
+
+**완료 조건**: 실제 run에서 PipelineTracePanel이 전 섹션 상태를 표시.
+
+---
+
+### C-4. SlideCanvas.tsx 한글 주석 인코딩 손상 복구 (소형)
+
+**배경**
+- Front/client/src/components/SlideCanvas.tsx L1~80 부근 한글 주석이 깨진 채 커밋됨 ("?ㅼ젣", "?쒖떆" — CP949↔UTF-8 오변환 패턴). 기능 코드는 정상.
+
+**작업**: 깨진 주석 복원(git 히스토리의 정상 버전 참조) 후 UTF-8로 재저장. 에디터/훅에 인코딩 고정 설정 검토.
+
+**완료 조건**: 파일 전체 UTF-8 정상, diff에 주석 복원만 포함.
+
+---
+
+## 제안 우선순위 (의존 관계 기준)
+
+| 순위 | 이슈 | 이유 |
+|---|---|---|
+| 1 | A-1 (변환기 통합) | 백업 없는 유실 위험 — 즉시 |
+| 2 | C-1 (Emergency P2~P5) | 진행 중 작업, 정책 확정 상태 |
+| 3 | B-1 (02-2.2 교정) | 1~2일로 TARGET 4/4 |
+| 4 | C-2 (V4 evidence 배선) | 이미 절반 구현된 코드 완성 |
+| 5 | C-3 (trace 계약) + C-4 (인코딩) | 프론트 검증 기반 확보 |
+| 6 | B-4 (슬롯 매핑 배선) | "의미 반영" 목표의 핵심 |
+| 7 | A-2 (frame 32개 완성) | 매칭 성공해도 렌더 불가인 갭 해소 |
+| 8 | B-2, B-3 (분류 LLM화, V4 재조정) | 정확도 상한 돌파 |
+| 9 | B-5 (표/이미지), A-3 (추적성) | 커버리지·품질 보강 |

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 (후순위) |

data/frame_cache/.gitkeep

@@ -0,0 +1,5 @@
+# IMP-46 u6 — persistent frame_cache root marker.
+#
+# Tracked so the directory exists on a fresh checkout; cached JSON payloads
+# under data/frame_cache/{frame_id}/{signature_hash}.json remain git-ignored
+# via the .gitignore exception block.

docs/architecture/DORMANT-TRIGGERS.yaml

@@ -0,0 +1,135 @@
+# Dormant trigger registry (L3 layer — machine-readable).
+#
+# Purpose :
+#   Closed-but-binding dormant backlog rows ("documented:dormant" /
+#   "documented (deferred)") carry implicit "trigger-on-X" contracts.
+#   L1 (human memory) + L2 (periodic INTEGRATION-AUDIT) are fragile / late.
+#   This file is the single source of truth that scripts/check_dormant_triggers.py
+#   reads to flag activation candidates on every orchestrator run.
+#
+# Schema (per entry) :
+#   - issue                       : int      # closed Gitea issue id (the dormant axis)
+#   - title                       : string
+#   - doc                         : string   # repo-relative path to the dormant reference doc
+#   - doc_evidence_lines          : string   # "start-end" line range citing the activation-gate text
+#   - status                      : enum     # documented:dormant | documented:deferred | documented:no-runtime | followup-linked
+#   - followup_issue              : int|null # set when an open issue already tracks the watch (then no checker watch needed)
+#   - trigger
+#       description               : string
+#       file_patterns             : [glob]   # working-tree paths checked against changed files
+#       content_patterns          : [regex]  # python re patterns matched against changed-file contents
+#       manual_evidence_required  : bool     # true → checker skips (human-only gate; e.g. User GO, sign-off, runtime regression analysis)
+#   - on_trigger
+#       action                    : enum     # create_runtime_issue | reactivate_dormant | manual_review | note_only
+#       template                  : string   # suggested follow-up issue title (if action ≠ note_only)
+#
+# Guardrails :
+#   - Checker is informational only (exit 0 always; orchestrator never blocks Stage 5 on alerts).
+#   - manual_evidence_required: true entries do NOT auto-fire — they are noted for human review.
+#   - followup_issue is set: the registry entry is note-only; no checker watch (the open issue tracks the axis).
+#   - Out of scope for this registry : IMP-07 (documented:no-runtime — policy decline, reactivation = policy reopen, not a code trigger).
+
+- issue: 16
+  title: "IMP-16 U2 wiring (Phase Q U1 → Phase Z runtime)"
+  doc: docs/architecture/IMP-16-U2-WIRING-DESIGN.md
+  doc_evidence_lines: "21-25"
+  status: documented:dormant
+  followup_issue: null
+  trigger:
+    description: >-
+      IMP-07 reverse-path actually lands runtime — a non-test module under src/
+      introduces the reverse-path adapter (html_to_slide_mdx / edited_html_to_mdx /
+      reverse_path). At that point IMP-16 U2 wiring (Step 1/2/14 surface use)
+      becomes a live integration axis, not a paper design.
+    file_patterns:
+      - "src/**/*.py"
+    content_patterns:
+      - "html_to_slide_mdx"
+      - "edited_html_to_mdx"
+      - "reverse_path"
+    manual_evidence_required: false
+  on_trigger:
+    action: create_runtime_issue
+    template: "[IMP-16][P5][WIRING] Activate U2 reverse-path wiring against new IMP-07 adapter"
+
+- issue: 17
+  title: "IMP-17 AI repair fallback carve-out"
+  doc: docs/architecture/IMP-17-CARVE-OUT.md
+  doc_evidence_lines: "25-31"
+  status: documented:dormant
+  followup_issue: null
+  trigger:
+    description: >-
+      3-condition AND gate: (1) explicit User GO for axis activation,
+      (2) B4 frame_selection evidence integration complete (Step 9 evidence trace
+      stabilised), (3) IMP-04 (catalog expansion to 32 frames) + IMP-05 (V4
+      rank-2/3 fallback) live. All three required before the carve-out exits
+      design-only state.
+    file_patterns: []
+    content_patterns: []
+    manual_evidence_required: true
+  on_trigger:
+    action: manual_review
+    template: "[IMP-17][P5][CARVE-OUT] Activate ai_adaptation_required fallback (3-cond gate cleared)"
+
+- issue: 18
+  title: "IMP-18 SVG coordinate pipeline gap report"
+  doc: docs/architecture/IMP-18-SVG-GAP-REPORT.md
+  doc_evidence_lines: "38-43"
+  status: documented:dormant
+  followup_issue: null
+  trigger:
+    description: >-
+      An SVG-bearing partial lands under templates/phase_z2/ (families or frames)
+      AND the partial declares slots consuming items[*].cx/cy/r + outer_r +
+      viewbox_* (the prepare_venn_data return contract). IMP-04 frame_partials
+      registration is the natural upstream.
+    file_patterns:
+      - "templates/phase_z2/families/*.html"
+      - "templates/phase_z2/frames/*.html"
+    content_patterns:
+      - "<svg"
+      - "viewBox"
+    manual_evidence_required: false
+  on_trigger:
+    action: create_runtime_issue
+    template: "[IMP-18][P5][SVG] Activate SVG coordinate pipeline for new partial"
+
+- issue: 19
+  title: "IMP-19 zone ratio reference (Phase O role-container pattern)"
+  doc: docs/architecture/IMP-19-ZONE-RATIO-REFERENCE.md
+  doc_evidence_lines: "83-90"
+  status: documented:dormant
+  followup_issue: null
+  trigger:
+    description: >-
+      Phase Z Step 8 solver (min_height_first + content_weight) produces a
+      verifiable regression that the Phase O role-container pattern would have
+      handled correctly, AND the IMP-09 owner confirms the case is not
+      addressable inside the Phase Z solver (visual_hints.min_height_px /
+      content_weight.score adjustments insufficient). Requires failing-case MDX
+      + frame_contract trace + observed vs expected geometry.
+    file_patterns: []
+    content_patterns: []
+    manual_evidence_required: true
+  on_trigger:
+    action: manual_review
+    template: "[IMP-19][P5][ZONE-RATIO] Re-activate Phase O role-container pattern (IMP-09 sign-off attached)"
+
+- issue: 20
+  title: "IMP-20 frame contract validation reference"
+  doc: docs/architecture/IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md
+  doc_evidence_lines: "85-91"
+  status: followup-linked
+  followup_issue: 55
+  trigger:
+    description: >-
+      §A5 3-cond AND gate (Step 10 partial frame-contract emit insufficient +
+      evidence + IMP-04 sign-off). Watch surface already owned by open issue
+      #55 — no checker watch installed here to avoid double-tracking.
+    file_patterns: []
+    content_patterns: []
+    manual_evidence_required: true
+  on_trigger:
+    action: note_only
+    template: "Tracked under open issue #55 — no new watch needed."

docs/architecture/IMP-16-U2-WIRING-DESIGN.md

@@ -0,0 +1,84 @@
+# IMP-16-U2 — Phase Z verification wiring design (design-only)
+> **⚠️ STATUS UPDATE (2026-05-20, INTEGRATION-AUDIT-02)** — IMP-16 is reclassified
+> as `documented:dormant` and IMP-07 as `documented:no-runtime`. The 3 "Open items
+> deferred until IMP-07 lands" below remain dormant until IMP-07 reverse-path
+> actually lands runtime (no current plan).
+>
+> Resolution evidence: see `INTEGRATION-AUDIT-02-REPORT.md` Sections 3, 4, and 7
+> (final decision: `NEEDS_DOC_SYNC_FOLLOWUP`).
+>
+> Do NOT treat this design contract as actionable in current Phase Z runtime.
+
+**Status**: design-only contract. **No runtime wiring lands in this issue.** All wiring is gated behind IMP-07 reverse-path activation (B-2 main). When IMP-07 lands, this doc becomes the binding contract for the Step 1 / 2 / 14 / 21 / 22 changes that consume the IMP-16-U1 surface in `src/phase_z2_verification_utils.py`.
+
+**Source anchors**
+- IMP-16 backlog row — [`docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md):67 (priority ↓ low, hard link IMP-07, source §3 H3 Reference Only).
+- IMP-07 backlog row — same doc line 51 (status `pending`).
+- 22-step pipeline anchor — [`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md) Steps 1 / 2 / 14 / 21 / 22.
+- U1 module — `src/phase_z2_verification_utils.py` (u1~u10 ports).
+- Phase Q reference H3 (Reference Only — do not import) — `src/content_verifier.py`.
+
+## Gate (hard block — do not merge wiring before this clears)
+
+- IMP-07 status MUST be `implemented` and `verified` before any code change listed below lands.
+- Repo grep `html_to_slide_mdx | edited_html_to_mdx | reverse_path` MUST return at least one runtime hit in a non-test module under `src/`.
+- The reverse-path entry point MUST emit (a) a normalized re-entry MDX string and (b) the upstream generated HTML string, both as deterministic outputs accessible to Step 2 and Step 14 callers.
+
+## Per-step wiring contract
+
+### Step 1 — MDX upload (re-entered MDX validation)
+- Caller : the reverse-path adapter introduced by IMP-07, immediately after it produces a re-entry MDX.
+- Surface used : u6 `split_into_sentences` (validate that the reverse-path MDX yields at least one sentence after meta-strip + bullet-marker strip).
+- Behavior : if `split_into_sentences(reentry_mdx)` returns an empty list, the reverse-path adapter MUST raise a deterministic input error before Step 2 starts. No silent fallback. No AI call. No content rewrite.
+- Trace : `debug.json["step01"]["reentry_sentence_count"]` (additive integer field).
+
+### Step 2 — MDX normalize (text preservation cross-check)
+- Caller : `parse_mdx` / `align_sections_to_v4_granularity` post-normalize hook (added only when the input came through the IMP-07 reverse path; original-upload path is unchanged).
+- Surface used : u8 `verify_text_preservation(reentry_mdx, upstream_generated_html, area_name="reentry_mdx_vs_upstream_html")`.
+- Threshold : the U1 module default (`_TEXT_PRESERVATION_DEFAULT_THRESHOLD = 0.70`, ported verbatim from Phase Q). Do not redesign in U2.
+- Behavior : `VerificationResult.passed == False` → adapter aborts the re-entry with the result's `errors` list surfaced; auto pipeline does NOT silently continue. Per `feedback_auto_pipeline_first`, no `review_required` / `review_queue` is inserted — adapter abort is the deterministic outcome.
+- Trace : `debug.json["step02"]["reentry_text_preservation"] = {passed, score, area_name, missing_count}` (additive; missing sentences themselves NOT serialised, per privacy-by-default).
+
+### Step 14 — Selenium visual runtime check (invented-text guard)
+- Caller : the `run_overflow_check` post-render path, ONLY when the run was triggered from the reverse-path re-entry. Original-upload path keeps current Step 14 behavior unchanged (this is NOT an enhancement of Step 14 image/table coverage — that axis belongs to IMP-15).
+- Surface used : u9 `detect_invented_text(reentry_mdx, final_html)` against the just-rendered `final.html`.
+- Behavior : the returned `list[str]` is purely *telemetry*. It does NOT change render outcome and does NOT change `compute_slide_status` (Step 20). The reverse-path may consult the list to decide whether to surface a warning at Step 22 — but auto pipeline does not gate on it (per `feedback_auto_pipeline_first` + AI-isolation contract).
+- Trace : `debug.json["step14"]["reentry_invented_text_fragments"] = list[str]` (additive; already truncated by u9's `_INVENTED_TEXT_TRUNCATE_LEN = 80`).
+
+### Step 21 — Debug / trace recording (additive only)
+- Surface used : none (Step 21 consumes the additive fields written by Step 1 / 2 / 14 above).
+- Behavior : `write_debug_json` MUST treat the new fields as additive — no rename, no removal, no schema regression of existing keys. Missing fields (original-upload path) MUST be absent rather than null, so downstream consumers can distinguish "original upload" from "reverse-path re-entry".
+- Trace contract : the three additive fields above + a single new flag `debug.json["pipeline"]["reverse_path_reentry"] = bool` (the only schema field that gates the existence of the other three).
+
+### Step 22 — User confirmation / export (surface, no AI)
+- Surface used : none directly (Step 22 is UI scope, currently CLI-only — see PHASE-Z-PIPELINE-OVERVIEW Step 22).
+- Behavior contract for whoever lands Step 22 UI : Step 22 MAY render the additive Step 2 / Step 14 fields read-only. No write-back. No AI call. No content rewrite.
+
+## Redesigned frame-contract pattern dict (reserved, NOT delivered in U2)
+
+- Phase Q `REQUIRED_PATTERNS` (Phase Q reference: `src/content_verifier.py:382`) is `body_bg / core / sidebar / footer` — these are Phase Q *area* names, not Phase Z entities. **Values are NOT reused.**
+- Phase Z replacement will be keyed on (frame_id, frame_slot_id) per the canonical hierarchy `Slide → Zone → Internal Region → Frame → Frame Slot → Content` ([`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md) §Operating Principles), and will be sourced from `templates/phase_z2/catalog/frame_contracts.yaml` (Step 0 / Step 10).
+- **Out of scope for IMP-16-U2.** This belongs to IMP-20 (H2 frame contract validation — same backlog doc line 71). U2 must not ship a pattern dict; U2 must not import or wrap Phase Q `verify_structure` / `verify_area` / `verify_all_areas`.
+
+## Guardrails (binding)
+
+- **AI isolation contract** — all wiring above is deterministic. No LLM / Kei / httpx / SSE call on any path. (per `feedback_ai_isolation_contract` + `PZ-1: AI=0 normal`.)
+- **No-hardcoding** — U2 ports the algorithm. The only literal values reused are the Phase Q H3 thresholds already lifted to named constants in u7 / u8 / u9. No sample-specific value (MDX 03 / 04 / 05) enters U2.
+- **No `src.content_verifier` import** — under any condition. The U1 module is the sole Phase Z surface.
+- **No FORBIDDEN_KEI_MEMOS / `generate_with_retry` port** — these are H4 / H5 archive markers and remain out of scope.
+- **Schema additive only** — debug.json keys listed above are new; no existing key is renamed, removed, or repurposed. (per `feedback_artifact_status_naming` — final.html is not the same axis as preservation / invented-text telemetry.)
+- **Spacing direction** — N/A for this axis (this is verification, not layout). No common CSS / padding / tolerance shrinking is introduced.
+- **Status semantics** — Step 20 `compute_slide_status` is NOT changed by U2. Preservation / invented-text fields are *telemetry*; they do not flip `PASS` → `RENDERED_WITH_VISUAL_REGRESSION` on their own.
+
+## Rollback
+
+- All changes are additive: the Step 1 input-error path, the Step 2 post-normalize hook, the Step 14 telemetry call, the four new `debug.json` keys.
+- Rollback = revert the IMP-07 reverse-path entry's call sites; no schema migration needed because the four debug.json keys are gated on `pipeline.reverse_path_reentry`.
+
+## Open items deferred until IMP-07 lands
+
+- Exact module path of the IMP-07 reverse-path adapter (TBD by IMP-07).
+- Whether Step 2's preservation cross-check needs a per-section variant or only a whole-MDX variant — depends on whether IMP-07 emits a single re-entry MDX or per-section MDX fragments.
+- Whether Step 14's invented-text telemetry should be emitted per `area_name` or only once globally — depends on whether IMP-07's reverse-path produces area-tagged HTML.
+
+These are NOT resolved here. They are resolved at IMP-07 land time, in a follow-up update to this doc.

docs/architecture/IMP-17-CARVE-OUT.md

@@ -0,0 +1,55 @@
+# IMP-17 — AI repair fallback infrastructure (carve-out)
+
+**Status**: carve-out infra **scaffolded under IMP-33** (issue #61, Stage 3 u1~u11). Normal-path AI calls = 0 (PZ-1) — `ai_fallback_enabled` flag default `False` in `src/config.py`. Runtime AI is reachable only via fallback path entry points; Step 12 entry is provisional-gated, Step 17 entry is structurally blocked behind IMP-34 + IMP-35.
+
+**Source anchors**
+- IMP-17 backlog row — [`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md):68 (carve-out — normal path 밖, soft link IMP-04 + IMP-05).
+- INSIGHT-MAP §3 — [`PHASE-Q-INSIGHT-TO-22STEP-MAP.md`](PHASE-Q-INSIGHT-TO-22STEP-MAP.md) (G3 AI repair fallback infra registry row, normal path = no).
+- 22-step pipeline — [`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md) Step 12 (lines 280-287), Step 16 (lines 318-325), Step 17 (lines 326-333).
+- Pattern shape reference (Phase Q Archive — link-only, do not port) — `src/content_editor.py:21,318` (httpx + retry shape, imports `sse_utils`) + `src/sse_utils.py:16-50` (SSE token parser).
+- Route hint surface (current anchors) — `src/phase_z2_pipeline.py:570` (conceptual comment), `:572` (`_IMP05_ROUTE_HINTS` table), `:575` (`restructure` → `ai_adaptation_required`), `:580` (`_imp05_route_hint`), `:664` (candidate_evidence emission). Deterministic emission today; AI consumer deferred to IMP-17 (this carve-out). Anchor pin: `tests/orchestrator_unit/test_imp17_comment_anchor.py`.
+
+## Carve-out boundary
+
+### Allowed (fallback path only)
+- **Step 12**: when V4 emits `restructure` (route hint `ai_adaptation_required`) AND deterministic mapping cannot satisfy the frame contract, an AI proposal MAY be invoked to map `content_object` → `Internal Region` / `Frame Slot`. Output = placement proposal at content-object granularity. Frame selection, layout selection, zone topology remain deterministic.
+- **Step 16 / 17**: when retry router exhausts deterministic actions (zone_ratio_retry / layout_adjust / frame_reselect / details_popup_escalation / image_fit_candidate / frame_internal_fit_candidate) AND user-approved fallback budget remains, an AI proposal MAY be invoked. Output scope identical to Step 12 — content-object placement only.
+
+### Forbidden (any path)
+- Normal-path AI calls (Step 12 deterministic mapper, all other steps).
+- MDX 원문 요약·삭제·재작성 (Phase Z spacing direction guardrail: never compress text).
+- HTML / CSS 직접 생성, frame contract 신설, layout / zone topology 결정 (Layer-A / Layer-B planning은 코드 영역).
+- 공통 padding / spacing / tolerance 축소 (PZ-4 — no silent shrink).
+- 신규 IMP ID 발급 (이 carve-out 은 IMP-17 슬롯에 영구 귀속).
+
+## Activation gate (3-condition AND — all three required)
+
+1. **User GO** — 명시적 axis activation 요청. carve-out 자체로는 코드 작성 트리거 안 됨.
+2. **B4 frame_selection evidence integration complete** — Step 9 frame_selection 의 evidence trace 가 안정화되어야 fallback proposal 이 어떤 frame contract 안에서 동작해야 하는지 식별 가능.
+3. **IMP-04 (catalog 확장) + IMP-05 (V4 fallback) live** — 카탈로그가 32 frame 으로 확장되고 V4 rank-2/3 fallback 이 활성화돼야 `ai_adaptation_required` 라우트가 실제 의미를 가짐 (현재는 dead-end route hint).
+
+세 조건 중 하나라도 미충족이면 본 carve-out 은 design-only 상태로 잠겨 있다.
+
+## Pattern shape reference (link-only, do not import)
+
+Phase Q `content_editor.py` 는 **Archive Candidate** ([`PHASE-Q-AUDIT.md`](PHASE-Q-AUDIT.md):660-673) — 포팅 대상 아님. 모양만 참조한다:
+- httpx async streaming + retry 구조 — `src/content_editor.py:21,318` 라인 부근 (import + `stream_sse_tokens` 호출 site).
+- SSE token 파서 분리 모듈 — `src/sse_utils.py:16-50` (`stream_sse_tokens` 본체).
+- `EDITOR_PROMPT` (Kei persona) 및 Kei-API endpoint 는 **영구 단절**. 재사용 금지.
+
+## AI 격리 + Kei persona 단절 contract
+
+- AI 호출은 normal path 에 없다 (Phase Z 원칙, [memory `feedback_ai_isolation_contract`](../../README.md)).
+- 출력 단위는 항상 content_object / Internal Region / Frame Slot 또는 restructuring proposal — HTML 구조 / 레이아웃 / 프리셋 결정 X.
+- Phase Q 자산 (Kei persona prompts, Kei-API endpoint, persona retry semantics) 과 단절. Phase Z 의 fallback runtime 은 별도 prompt / endpoint 설계로 출발한다 (본 carve-out 활성 시).
+
+## Runtime module surface (IMP-33 u1~u11 binding)
+
+| Axis | Binding |
+|---|---|
+| Module path | `src/phase_z2_ai_fallback/` (locked by [`IMP-31-GATE-AUDIT.md`](IMP-31-GATE-AUDIT.md):31,50,56). |
+| Step 12 entry | `src.phase_z2_ai_fallback.step12.gather_step12_ai_repair_proposals` — IMP-30 provisional gate (`not_provisional` skip) AND reject gate (`design_reference_only_no_ai` skip) AND non-AI route catch-all run BEFORE `route_ai_fallback`. |
+| Step 17 entry | `src.phase_z2_ai_fallback.step17.gather_step17_ai_repair_proposals` — STRUCTURALLY BLOCKED. Every unit returns `skip_reason="step17_ai_blocked_imp_34_35_prerequisites_missing"`. Module does NOT import `route_ai_fallback` / `AiFallbackClient` / `anthropic`. |
+| Cascade order | `src.phase_z2_ai_fallback.step17.OVERFLOW_CASCADE_ORDER = (DETERMINISTIC, POPUP, AI_REPAIR, USER_OVERRIDE)` — single source of truth for Step 17 consumers. Aligns with line 16 of this doc. |
+| IMP-46 cache gate | `src.phase_z2_ai_fallback.cache.save_proposal(..., visual_check_passed, user_approved, auto_cache=False)` raises `AiFallbackCacheGateError` unless `visual_check_passed=True` AND (`user_approved=True` OR `auto_cache=True`). Persistent JSON backend at `data/frame_cache/{frame_id}/{signature_hash}.json` (u2); cache key = structural signature over 8 axes (u1+u4); read-side fingerprint invalidation via `read_proposal(..., fingerprints=...)` strict equality (u3); `--auto-cache` CLI flag + `settings.ai_fallback_auto_cache` (default `False`) bypasses ONLY the `user_approved` gate (u5); repo root tracked via `data/frame_cache/.gitkeep` with cached payloads git-ignored (u6). `read_proposal` returns `None` on missing / corrupt / fingerprint-mismatched entries — cache is a hint, never a hard dependency. |
+| AST isolation | `tests/phase_z2_ai_fallback/test_ast_isolation.py` parses every `*.py` under `src/phase_z2_ai_fallback/` and forbids Phase Q runtime / Kei client / `src.phase_z2_*` (non-fallback) imports. Whitelist = `src.config` + intra-package + stdlib + `anthropic` + `pydantic`. |

docs/architecture/IMP-18-SVG-GAP-REPORT.md

@@ -0,0 +1,64 @@
+# IMP-18 — Phase Z SVG Coordinate Pre-compute Gap Report
+
+**Status**: documented (reference-only, dormant)
+**Scope**: doc-only. No runtime surface modified.
+**Related issue**: https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2/issues/18
+**Soft dependency**: IMP-04 (frame_partials registration) — IMP-18 activates only when a SVG-bearing partial lands under `templates/phase_z2/`.
+
+---
+
+## A1 — Phase R' source pattern (read-only reference)
+
+Phase R' implements SVG coordinate pre-compute as a renderer hook. References (do **not** modify):
+
+- `src/renderer.py:169-207` — `_preprocess_svg_data(block_type, block_data)` — mutates `block_data` with computed coordinates when `block_type` ∈ `SVG_BLOCKS`; warns and falls back on exception.
+- `src/renderer.py:175` — `SVG_BLOCKS = {"venn-diagram", "relationship"}` — exhaustive type allow-list.
+- `src/renderer.py:321` — call site inside `render_multi_page()` (`block_data = _preprocess_svg_data(block_type, block_data)`), right before `_resolve_template_path` lookup.
+- `src/svg_calculator.py:15-156` — five helpers:
+  - L15 `calc_circle_positions(n, center_x, center_y, radius)` — 12 o'clock clockwise N-element layout.
+  - L47 `calc_item_radius(n, base_radius=75.0)` — auto-shrink small-circle radius for crowding.
+  - L59 `calc_orbit_radius(n, base_orbit=120.0)` — auto-expand orbit for crowding.
+  - L70 `calc_outer_radius(n, orbit_radius, item_radius)` — outer enclosing circle, 40 px margin.
+  - L77 `prepare_venn_data(items, center_label, center_sub, description, viewbox_width=600.0, viewbox_height=550.0)` — top-level entry; mutates `items[*].cx/cy/r` and returns `outer_r`/`center_x`/`center_y`/`viewbox_width`/`viewbox_height`.
+
+## A2 — Phase Z partial SVG inventory (gap)
+
+Phase Z active partials surface:
+
+- `templates/phase_z2/families/*.html` — **11 contracted + 2 WIP untracked = 13 on disk** (contracted set = `templates/phase_z2/catalog/frame_contracts.yaml` top-level keys; WIP allowlist = [`templates/phase_z2/families/_WIP_FILES.md`](../../templates/phase_z2/families/_WIP_FILES.md), gated on Gitea #42 / #52 F-2 option (c)).
+- `templates/phase_z2/frames/*.html` — **2** files.
+- Total surface = **13 active partials (11 contracted families + 2 frames) + 2 WIP untracked families** (15 on disk; runtime matcher consumes the contracted set only).
+
+SVG usage scan (evidence): `rg "<svg|viewBox" templates/phase_z2/` → **0 matches** (exit 1).
+
+Closest geometric candidate is `templates/phase_z2/families/construction_goals_three_circle_intersection.html` (frame_id `1171281189`, "cycle-3way-intersection" intent), but it renders three intersecting circles via HTML/CSS — `border-radius:50%` + `linear-gradient` + `::before` outer ring — **not** SVG. The Figma source's six accent kanji circles, six side labels, three decorative rects, and three arcs are explicitly **NOT PROMOTED** at the partial header (compact MDX-mapped focus). No partial currently demands the pre-computed `items[*].cx/cy/r` contract.
+
+## A3 — IMP-04 activation gate (soft dependency)
+
+IMP-18 has no Phase Z runtime consumer today. Re-activation triggers:
+
+1. IMP-04 (frame_partials registration) lands an SVG-bearing partial under `templates/phase_z2/` (e.g., a venn-diagram or relationship frame promoted from Figma).
+2. The partial declares slots that consume `items[*].cx/cy/r` + `outer_r` + `viewbox_*` (the `prepare_venn_data` return contract).
+
+Until both conditions hold, IMP-18 stays dormant and this gap report is the sole deliverable.
+
+## A4 — Phase R' guardrail (read-only lock)
+
+Per `CLAUDE.md` Phase R' regression prevention rules and the Stage 1/2 exit reports:
+
+- `src/renderer.py` — read-only. No edit to `_preprocess_svg_data` body, `SVG_BLOCKS` set, or `render_multi_page` call site.
+- `src/svg_calculator.py` — read-only. No edit to the five helpers or their public signatures.
+- `templates/phase_z2/families/*.html` (11 contracted + 2 WIP untracked = 13 on disk; WIP set = [`_WIP_FILES.md`](../../templates/phase_z2/families/_WIP_FILES.md)) + `templates/phase_z2/frames/*.html` (2) — no `<svg>` / `viewBox` insertion in IMP-18 scope. SVG-bearing partial onboarding is owned by IMP-04. The 2 WIP family templates are gated on Gitea #42 (promote-or-remove) and remain outside the runtime matcher set per #52 F-2 option (c).
+- F12 `construction_goals_three_circle_intersection.html` HTML/CSS → SVG migration is **out of scope** (separate post-IMP-04 issue).
+- No hardcoded SVG coordinates in Phase Z templates — when IMP-18 re-activates, coordinates must be derived from `svg_calculator` helpers (or equivalent forward-port into `phase_z2_renderer`), not hand-copied.
+
+---
+
+## Re-activation checklist (future)
+
+When IMP-04 introduces the first SVG-bearing Phase Z partial:
+
+- [ ] Identify partial(s) consuming `items[*].cx/cy/r` + `outer_r` + `viewbox_*`.
+- [ ] Decide port target — extend `phase_z2_renderer` with a `_preprocess_svg_data` analog, or reuse `src/svg_calculator.py` directly.
+- [ ] Keep Phase R' references untouched.
+- [ ] Add anchor SHA bump only if runtime source surface changes.

docs/architecture/IMP-19-ZONE-RATIO-REFERENCE.md

@@ -0,0 +1,97 @@
+# IMP-19 — Phase O/Q Zone Ratio Container Pattern Reference
+
+**Status**: documented (reference-only, dormant)
+**Scope**: doc-only. No runtime surface modified.
+**Related issue**: https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2/issues/19
+**Soft dependency**: IMP-09 (Phase Z Step 8 zone-ratio solver) — IMP-19 stays dormant; activates only via the A5 gate.
+**Source axis**: INSIGHT-MAP §3 / §2.8 I4 — `renderer._group_blocks_by_area` pattern reference.
+
+---
+
+## A1 — Phase O/Q consumer pattern (read-only reference)
+
+Phase O/Q implements role-based block grouping inside body-side zones at the renderer layer. References (do **not** modify):
+
+- `src/renderer.py:210-295` — `_group_blocks_by_area(blocks, container_specs=None)` — `OrderedDict` grouping by `block["area"]`; when `container_specs` is supplied and `area ∈ {"body","left","right","hero","detail"}` enters the role-container branch (L230).
+- `src/renderer.py:234` — hardcoded `role_order = ["배경", "본심"]` — two-role role-loop axis (block-level container, **not** zone geometry).
+- `src/renderer.py:240-253` — topic_id-first match against `spec.topic_ids`, then fallback positional fill when topic_id match yields empty (L248-253).
+- `src/renderer.py:261-274` — inline-style injection: `height:{spec.height_px}px; overflow:visible; display:flex; flex-direction:column; gap:8px; font-size:{font_size}px; --spacing-inner:{padding}px; --font-body:{font_size/16}rem;`. `font_size` / `padding` are read at `:262-263` via `spec.block_constraints.get("font_size_px", 15.2)` / `.get("padding_px", 20)` — **renderer-side defaults**, not producer-emitted (see A2).
+- `src/renderer.py:277-279` — leftover (unassigned) blocks appended after role containers.
+- `src/renderer.py:283-291` — non-container branch: `len(block_list)==1` → single html, else `flex-direction:column` wrapper with `gap:var(--spacing-block); height:100%`.
+
+Call sites:
+
+- `src/renderer.py:352-353` — `render_multi_page()` — passes `layout_concept.get("_container_specs")` as `container_specs` argument (Phase O activation path).
+- `src/renderer.py:426` — `render_slide()` — invokes `_group_blocks_by_area(blocks_raw)` with **no** `container_specs` (legacy fallback / unit-test path).
+
+Classification: block/role-level container injection at render time. **Not** Phase Z zone geometry.
+
+## A2 — Phase O upstream producer (read-only reference)
+
+`ContainerSpec` payloads consumed by A1 are produced upstream. References (do **not** modify):
+
+- `src/space_allocator.py:445-586` — `build_containers_type_b(page_structure, slide_width=1280, slide_height=720, image_sizes=None)` — Phase X-B 유형 B container builder.
+- `src/space_allocator.py:462-468` — token load (`_load_design_tokens`) + `pad`, `header_h`, `gap_block`, `gap_small`, `inner_w` derivation.
+- `src/space_allocator.py:470-484` — role classification into `top_roles` / `bottom_roles` / `footer_role` by `info["zone"] ∈ {"top","bottom","bottom_left","bottom_right","footer"}`.
+- `src/space_allocator.py:486-503` — usable height calculation against `slide_body_top=65` + `slide_body_h=590` with optional `footer_role` carve-out.
+- `src/space_allocator.py:505-510` — `zone_overhead = zone_count * zone_title_h(28) + (zone_count-1) * zone_gap(16)`.
+- `src/space_allocator.py:512-520` — `top_h` / `bottom_h` split by `weight` ratio over `usable_h`.
+- `src/space_allocator.py:522-537` — image-aware top-zone width split (`img_w = min(top_h*ratio, inner_w*0.45)`).
+- `src/space_allocator.py:541-556` — top-role `ContainerSpec` emission: `block_constraints = {"img_width_px": img_w, "img_height_px": top_h if img_w>0 else 0, "has_image": img_w>0}` — image-aware keys only.
+- `src/space_allocator.py:562-574` — bottom-role `ContainerSpec` emission: `block_constraints = {}` (empty; no producer keys).
+- `src/space_allocator.py:577-588` — footer-role `ContainerSpec` emission: `block_constraints = {}` (empty; `max_height_cost="low"` literal).
+
+Producer classification: block-level role container with `height_px` + `width_px` + `block_constraints` containing **only** image-aware keys (`img_width_px`, `img_height_px`, `has_image`) on top role, **empty** on bottom/footer roles. **Not** zone-level ratio geometry. `font_size_px` / `padding_px` are **renderer-side defaults** (consumed via `.get(..., 15.2)` / `.get(..., 20)` at `src/renderer.py:262-263`), **not** producer output.
+
+## A3 — Phase Z Step 8 solver delta (IMP-09 owned)
+
+The active Phase Z zone-ratio solver lives in `src/phase_z2_pipeline.py` and is **IMP-09 owned**. IMP-19 does **not** absorb, replace, or amend this surface. References (do **not** modify):
+
+- `src/phase_z2_pipeline.py:794-853` — `compute_zone_layout(zones_data, total_height=SLIDE_BODY_HEIGHT, gap=GRID_GAP)` — row-axis solver. Algorithm = `min_height_first + content_weight_distribution`: Step 1 reserves per-zone `min_height_px` from frame_contract `visual_hints` (with proportional scale-down on overflow), Step 2 distributes the remaining vertical budget by `content_weight.score`, Step 3 absorbs rounding residual into the last zone. Returns `heights_px` + `ratios` + reasoning trace.
+- `src/phase_z2_pipeline.py:924-972` — `compute_zone_layout_cols(zones_data, total_width=SLIDE_BODY_WIDTH, gap=GRID_GAP)` — col-axis solver. Algorithm = `content_weight_distribution_cols` (weight-only; no `min_width_px` contract exists in `frame_contracts.yaml` per IMP-09 verification). Zero-weight guard splits evenly across `n` zones. Returns `widths_px` + `width_ratios`.
+- `src/phase_z2_pipeline.py:1125-1452` — topology dispatch surface:
+  - `:1125-1152` `_build_rows_dynamic` — `topology=="rows"` (horizontal-2): dynamic row heights via `compute_zone_layout`, static fr column widths via `_parse_fr_string`.
+  - `:1155+` `_build_grid_dynamic_2d` — `topology ∈ {T, inverted-T, side-T-left, side-T-right, 2x2}`: per-row + per-col virtual-zone aggregation → row solver + col solver → `2d_dynamic_aggregated` computation.
+  - `:1444-1452` dynamic-branch dispatcher: `rows` / `cols` / 2-D / default fr.
+  - `:1380-1434` user-override geometry branch (`computation == "user_override_geometry"`) — preserves raw override percentages without invoking the weight solver.
+
+Delta vs Phase O/Q (A1+A2):
+
+| Axis | Phase O/Q (`renderer._group_blocks_by_area`) | Phase Z Step 8 (`compute_zone_layout` + cols) |
+|---|---|---|
+| Geometry level | block/role inside one zone | zone-level row/col tracks across slide_body |
+| Width source | role x-anchor + `top_h` image carve-out | content_weight share (cols) / fr-string (rows) |
+| Height source | producer `ContainerSpec.height_px` injection | min_height_first + content_weight remainder |
+| Role axis | hardcoded `["배경","본심"]` (L234) | no role concept — zone position + frame contract |
+| Min-height source | none (producer-emitted absolute px) | frame_contract `visual_hints.min_height_px` |
+| Topology dispatch | none (single role-loop) | rows / cols / T / inverted-T / side-T-* / 2x2 / single |
+| Inline-style injection | yes (height + font_size + spacing-inner) | no (geometry-only; styling handled downstream) |
+
+Conclusion: Phase O role-container pattern and Phase Z zone-ratio solver operate at **different abstraction layers** (block-in-zone vs zone-in-slide). They are **not** drop-in interchangeable; IMP-19 surfaces this delta only for design-pattern comparison.
+
+## A4 — IMP-09 boundary statement (soft-link)
+
+IMP-19 is `soft link: IMP-09`. Ownership separation:
+
+- **IMP-09 owns**: every algorithmic change to `compute_zone_layout`, `compute_zone_layout_cols`, the topology dispatch surface (`_build_rows_dynamic` / `_build_cols_dynamic` / `_build_grid_dynamic_2d` / `_build_fr_default`), and the frame_contract `visual_hints.min_height_px` contract.
+- **IMP-19 owns**: reference-only documentation of the Phase O/Q `_group_blocks_by_area` + `build_containers_type_b` pattern (A1 + A2) and the Phase Z solver delta narrative (A3).
+- **No bidirectional code flow**: IMP-19 does not move Phase O code into Phase Z, and IMP-09 does not consume Phase O `ContainerSpec` payloads. The two solvers remain isolated.
+- **Reference direction is one-way**: this document points read-only at `src/renderer.py`, `src/space_allocator.py`, and `src/phase_z2_pipeline.py`. No reverse pointer is required in those source files.
+
+If IMP-09 alters the Phase Z solver signature, A3 must be re-verified (file:line refs); the boundary statement itself does not change.
+
+## A5 — Re-activation gate + guardrails
+
+IMP-19 is `documented` (dormant). Re-activation requires **all** of the following gate conditions:
+
+1. **Trigger**: Phase Z Step 8 produces a verifiable case where the active solver (`min_height_first + content_weight`) yields geometry that the Phase O role-container pattern would have handled correctly — i.e., a regression that maps cleanly to the block-level role abstraction, not the zone-level abstraction.
+2. **Evidence requirement**: failing-case MDX + frame_contract trace + observed geometry vs expected geometry, attached to a new issue or this issue's reopened state.
+3. **IMP-09 sign-off**: the IMP-09 owner confirms the failing case is **not** addressable inside the Phase Z solver (e.g., adding `visual_hints.min_height_px` or adjusting `content_weight.score` does not resolve it).
+4. **Scope re-lock**: the new axis is scope-locked under a fresh implementation issue (not silently reopened in IMP-19) so the soft-link contract is preserved.
+
+Guardrails (preserved from Stage 1 + Stage 2):
+
+- **GR1 — No runtime integration**: this document does not authorize merging Phase O role-container code into the Phase Z runtime. Any such integration requires a new scope-locked issue with its own Stage 1/2 review.
+- **GR2 — Phase O no-regression**: Phase O containers (`render_multi_page` path with `_container_specs`) must not re-enter the Phase Z render path; the `render_slide` legacy fallback at `src/renderer.py:426` (no `container_specs`) remains the unit-test entry.
+- **GR3 — Reference extract stays in `docs/architecture/`**: never under `src/`. No code body copying; file:line refs only.
+- **GR4 — Soft-link integrity**: IMP-19 status remains `documented` until the A5 gate fires. The IMP-09 backlog entry carries a back-reference (see u3); IMP-19 carries the forward reference here.

docs/architecture/IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md

@@ -0,0 +1,109 @@
+# IMP-20 — Phase Q `content_verifier` Frame Contract Validation Pattern Reference
+
+**Status**: documented (reference-only, dormant)
+**Scope**: doc-only. No runtime surface modified.
+**Related issue**: https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2/issues/20
+**Soft dependency**: IMP-04 (extended catalog application) — IMP-20 stays dormant; activates only via the A5 gate.
+**Source axis**: INSIGHT-MAP §3 / §2.7 H2 — `content_verifier.verify_structure` pattern reference.
+
+---
+
+## A1 — Phase Q consumer pattern (read-only reference)
+
+Phase Q implements area-level required-pattern validation at the content-verifier layer. References (do **not** modify):
+
+- `src/content_verifier.py:382-392` — `REQUIRED_PATTERNS: dict[str, list[str]]` — top-level pattern dictionary keyed by area name (`body_bg`, `body_core`, `sidebar`, `footer`). Values verified: `body_bg=[]`, `body_core=["key-msg"]`, `sidebar=["padding-left", "text-indent"]`, `footer=[]`. Phase T (`L379-381` comment) removed the `overflow:hidden` requirement to reconcile with the Phase T prompt's "overflow:hidden 금지" directive — that no-regression boundary is preserved.
+- `src/content_verifier.py:395-448` — `verify_structure(generated_html, area_name, has_image=False, font_hierarchy=None) → VerificationResult` — the substring-check + OR + tolerance core logic.
+  - `:405-412` — substring presence loop. Each pattern string is split on `|` (`pattern.split("|")` at L410) and treated as an OR alternation: any alternative present passes the pattern. Missing alternatives are appended to a `missing` list.
+  - `:414-416` — `has_image` branch. When `has_image=True` and `area_name == "body_core"`, an additional implicit requirement is enforced: `"slide-img-"` must appear in `generated_html`. Missing image marker is reported as `"slide-img-* (이미지 태그)"` in `missing`.
+  - `:418-436` — `font_hierarchy` branch. When supplied, area-name → max-font lookup uses a fixed `role_font_map = {"body_bg":bg/11, "body_core":core/12, "sidebar":sidebar/10, "footer":core/12}`. HTML `font-size:\s*(\d+(?:\.\d+)?)\s*px` matches are extracted via regex (L430); each measured size > `max_font + 1` (1px tolerance at L433) emits a `font_warnings` entry. Warnings do **not** flip `passed`.
+  - `:438-447` — result construction. `passed = (len(missing) == 0)`. `score = 1.0` on pass else `1.0 - len(missing) / max(1, len(patterns))` (continuous degradation; `max(1, …)` guards empty-pattern division by zero). Errors prefixed `"필수 패턴 누락: "`. Warnings carry font hierarchy violations only.
+- `src/content_verifier.py:455-487` — `verify_area(original_text, generated_html, area_name, has_image=False) → VerificationResult` — composes L1 (`verify_text_preservation`) + L2 (`verify_no_forbidden_content`) + L3 (`verify_structure`) at L462-466. `verify_structure` call at L465 passes `has_image` but **not** `font_hierarchy` (font_hierarchy is unused inside `verify_area`).
+- `src/content_verifier.py:490-529` — `verify_all_areas(generated, area_texts, has_image_areas=None)` — area dispatch fan-out. `body_html` is split into `body_bg` + `body_core` (L510-519); `body_core` is the **only** branch that propagates `has_image=("body_core" in has_image_areas)` to `verify_area` (L518). `sidebar_html` (L521-525) and `footer_html` (L527-531) call `verify_area` with default `has_image=False`.
+
+Classification: area-level (Phase Q HTML area axis) required-pattern validation at content-verifier time. **Not** Phase Z frame_id × sub_zone contract validation.
+
+## A2 — Phase Q `REQUIRED_PATTERNS` shape (read-only reference)
+
+The Phase Q pattern-dict shape — **values are Phase Q-specific and excluded from reuse; only the shape is Phase Z design input.**
+
+| Axis | Phase Q shape | Where observed |
+|---|---|---|
+| Key axis | area name (string) | `src/content_verifier.py:382` keys: `body_bg` / `body_core` / `sidebar` / `footer` |
+| Value type | `list[str]` of substring patterns | `src/content_verifier.py:383-391` |
+| Alternation semantics | `"a\|b"` → OR (any alt passes) via `pattern.split("|")` | `src/content_verifier.py:410` |
+| Image-conditional branch | `has_image=True` ∧ `area_name=="body_core"` → implicit `"slide-img-"` requirement | `src/content_verifier.py:414-416` |
+| Font hierarchy tolerance | 1px (`fs > max_font + 1`); area-name → max-font fixed lookup | `src/content_verifier.py:433`, `:421-426` |
+| Pass/score rule | `passed = (missing == [])`; score = continuous degradation `1.0 - len(missing)/max(1, len(patterns))` | `src/content_verifier.py:438`, `:445` |
+| Empty-pattern handling | `max(1, len(patterns))` guards divide-by-zero; empty pattern list always passes | `src/content_verifier.py:445`, `:382-383` (`body_bg=[]`) |
+
+Shape-only carry-over candidates for Phase Z design (see A3 in u2):
+
+- `dict[key]→list[pattern]` indirection.
+- OR via in-string `|` separator (low-ceremony alternation).
+- Conditional implicit requirement injected by external context flag (here `has_image`; in Phase Z potentially `accepted_content_types` per sub_zone).
+- Continuous score degradation rather than binary pass/fail (downstream consumers can threshold).
+- Separate `errors` (block) vs `warnings` (advisory) lanes — font hierarchy lives in warnings, not errors.
+
+Values that **must not** carry into Phase Z: the literal strings `"key-msg"`, `"padding-left"`, `"text-indent"`, `"slide-img-"`, and the area names `body_bg` / `body_core` / `sidebar` / `footer` themselves — these are Phase Q area-HTML idioms, not Phase Z frame/slot idioms.
+
+## A3 — Phase Z target pattern dict (design input, not yet active)
+
+The Phase Z-native target axis = **frame_id × sub_zone** pattern dict, aligned with `templates/phase_z2/catalog/frame_contracts.yaml`. References (do **not** modify):
+
+- `templates/phase_z2/catalog/frame_contracts.yaml:21` `three_parallel_requirements` (F13, 3 sub_zones), `:77` `process_product_two_way` (F29, 2 sub_zones × strict 3 cardinality), `:128` `bim_issues_quadrant_four` (F16, 4 sub_zones), `:189` `three_persona_benefits` (F14, 3 sub_zones), `:253` `construction_goals_three_circle_intersection` (F12, 3+1 sub_zones — `intersection` is `min:0,max:1`), `:323` `construction_bim_three_usage` (F11, 3 sub_zones), `:391` `bim_dx_comparison_table` (F18, 2 header + 1 `rows` with `min:1,max:12`), `:456` `dx_sw_necessity_three_perspectives` (F20, 3 sub_zones), `:520` `info_management_what_how_when` (F8, 3 sub_zones), `:580` `sw_reality_three_emphasis` (F28, 3 sub_zones), `:637` `bim_current_problems_paired` (F17, 8 sub_zones — row × side 2-axis).
+- All 11 contracts carry `accepted_content_types` + `sub_zones`; field `density_envelope` is absent across the catalog (verified `grep -c "density_envelope" templates/phase_z2/catalog/frame_contracts.yaml` = 0).
+- `src/phase_z2_mapper.py:49-57` `load_frame_contracts` / `get_contract` — direct dict lookup against the 11 entries above.
+- `src/phase_z2_pipeline.py:3776-3805` Step 10 emit — currently surfaces `frame_id` / `family` / `source_shape` / `cardinality` / `visual_hints` / `accepted_content_types` / `sub_zones` / `payload_builder` / `payload_builder_options` to `step10_frame_contract.json` with `step_status="partial"`. No pattern-dict assertion runs against this payload yet.
+
+Abstraction-mismatch table (Phase Q area-level vs Phase Z frame/slot-level):
+
+| Axis | Phase Q (A1+A2) | Phase Z target (A3) |
+|---|---|---|
+| Key | area name (`body_bg`/`body_core`/`sidebar`/`footer`) | `(frame_id, sub_zone_id)` tuple — e.g. `(1171281190, "pillar_1")` |
+| Cardinality of keys | 4 fixed area names | open over 11 contracts × N sub_zones (3+2+4+3+4+3+3+3+3+3+8 = 39 sub_zones in current catalog) |
+| Value semantics | substring presence (HTML-string match) | candidates: substring presence and/or contract-field assertion (`cardinality.strict` / `accepts` membership / `partial_target_path` resolution) |
+| Conditional branch input | `has_image` external flag | `accepted_content_types` per sub_zone (catalog-driven, not external flag) |
+| Tolerance | 1px on font-size (single axis) | candidates: font-size 1px tolerance carried over **or** replaced by `visual_hints.min_height_px` envelope check |
+| Validation timing | post-render HTML (`generated_html` string) | post Step 18 final.html (mirrors Phase Q timing) — Step 12 light_edit/restructure proposal is excluded (proposal is upstream of render) |
+| Result lanes | `errors` (block) + `warnings` (advisory) | preserved as-is from Phase Q shape (continuous score; separate font-hierarchy warnings) |
+
+Classification: Phase Q area axis ⇄ Phase Z frame/slot axis are **not** drop-in compatible. The shape (dict indirection + OR alternation + tolerance + conditional implicit-requirement + continuous score) is the only portable element; every value (key strings, area names, literal patterns) is Phase Q-local.
+
+## A4 — IMP-04 soft-link boundary (catalog vs validation ownership)
+
+IMP-20 is `soft link: IMP-04` per the backlog (`docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md:71`). Ownership separation:
+
+- **IMP-04 owns**: every `frame_contracts.yaml` entry — addition / removal / `accepted_content_types` change / `sub_zones` schema change / `cardinality` change / `visual_hints` change. `templates/phase_z2/catalog/frame_contracts.yaml` is the IMP-04 source of truth.
+- **IMP-20 owns**: reference-only documentation of the Phase Q pattern-dict shape (A1 + A2) and the Phase Z target axis design narrative (A3). No catalog edits, no Step 10 promotion.
+- **Coupling direction**: **one-way** read. A Phase Z pattern dict (if/when activated through the A5 gate) consumes `frame_contracts.yaml` as input. It does **not** publish back into the catalog. IMP-04 is unaware of IMP-20.
+- **No bidirectional code flow**: IMP-20 does not move Phase Q `content_verifier.py` code into Phase Z, and IMP-04 does not consume `REQUIRED_PATTERNS`. The two surfaces remain isolated.
+- **Reference direction is one-way**: this document points read-only at `src/content_verifier.py`, `src/phase_z2_mapper.py`, `src/phase_z2_pipeline.py`, and `templates/phase_z2/catalog/frame_contracts.yaml`. No reverse pointer is required in those source files.
+
+If IMP-04 alters the catalog schema (e.g. adds `density_envelope` or renames `sub_zones`), A3 must be re-verified (key axis and conditional-branch row in particular). The boundary statement itself does not change.
+
+## A5 — Re-activation gate + guardrails
+
+IMP-20 is `documented` (dormant). Re-activation requires **all** of the following gate conditions (3-cond AND):
+
+1. **Trigger**: Phase Z Step 10 produces a verifiable case where the partial frame-contract emit alone is insufficient — i.e., a final.html regression that a frame_id × sub_zone pattern dict would have caught (missing slot marker, contract field violation, font-hierarchy breach against a sub_zone-resolved max). The trigger must be a regression that maps cleanly to the frame/slot axis, **not** to a higher layer (composition planning, content adapter, render-time CSS).
+2. **Evidence requirement**: failing-case MDX + `step10_frame_contract.json` trace + final.html excerpt with the slot path that should have asserted, attached to a new issue or this issue's reopened state.
+3. **IMP-04 sign-off**: the IMP-04 owner confirms the failing case is **not** addressable inside the catalog (e.g. tightening `cardinality` or `accepted_content_types` does not resolve it) — only then is a Phase Z-native pattern dict justified.
+
+Design questions resolved in this document (revisit if the gate fires):
+
+- **Q1 — Key granularity**: `(frame_id, sub_zone_id)`. Frame-only granularity is insufficient because contracts with `sub_zones` of differing `accepts` (e.g. F29 `process_column` accepts `[text_block, transform_table]` vs `product_column` accepts `[text_block]`) require slot-level differentiation.
+- **Q2 — Value type**: hybrid — substring patterns (Phase Q parity) **plus** contract-field assertions (`cardinality.strict` / `accepts` membership / `partial_target_path` resolved in DOM) **plus** numeric tolerance (carried from font-hierarchy 1px). Three lanes preserved separately so each can fail/pass independently.
+- **Q3 — Validation timing**: post Step 18 final.html **only**. Step 12 light_edit/restructure proposal is upstream of render and exposes no HTML for substring assertion; running the dict there would either fire false negatives (no DOM yet) or duplicate Step 18 work.
+- **Q4 — Font-hierarchy carry-over**: replaced — Phase Q's `role_font_map` fixed dict (area → max-font) is Phase Q-local. The Phase Z equivalent reads from `frame_contracts.yaml` `visual_hints` (`min_height_px` already present; a future `max_font_px` field would live in `visual_hints` and is IMP-04-owned). 1px tolerance shape is portable; the lookup source is replaced.
+
+Guardrails (preserved from Stage 1 + Stage 2):
+
+- **GR1 — Shape-only reference**: no Phase Q `REQUIRED_PATTERNS` value (`"key-msg"`, `"padding-left"`, `"text-indent"`, `"slide-img-"`) or area name (`body_bg`/`body_core`/`sidebar`/`footer`) may appear in any Phase Z pattern dict activation.
+- **GR2 — Phase Q no-regression**: `src/content_verifier.py:382-392` `REQUIRED_PATTERNS` is no-touch. The Phase T `L379-381` comment (overflow:hidden removed) remains the no-regression boundary; any Phase Z dict design must not re-introduce removed patterns into Phase Q's surface.
+- **GR3 — Phase Z dict is Phase Z-owned**: no `import` of `content_verifier.REQUIRED_PATTERNS` from Phase Z code. The two pattern dicts coexist without symbol sharing.
+- **GR4 — IMP-04 soft-link one-way**: per § A4. Activating IMP-20 must not block on or modify IMP-04; the catalog is read-only input.
+- **PZ-1 — AI isolation contract**: pattern dict is code/spec, not AI-generated content. No Kei rewrite, no LLM proposal of pattern values (`feedback_ai_isolation_contract`).
+- **RULE 13 — Anchor sync**: any future activation must update backlog (`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`), status board (`PHASE-Z-PIPELINE-STATUS-BOARD.md`), and INSIGHT-MAP (`PHASE-Q-INSIGHT-TO-22STEP-MAP.md`) in the same commit.
+
+If IMP-04 alters the catalog schema or `src/content_verifier.py` is rewritten upstream, A1–A3 must be re-verified (file:line refs); the A5 gate itself does not change.

docs/architecture/IMP-31-GATE-AUDIT.md

@@ -0,0 +1,59 @@
+# IMP-31 — AI-assisted frame-aware adaptation activation gate audit
+
+**Status**: design-only audit. IMP-31 (#40) = IMP-17 carve-out activation tracking issue. No new design slot. No runtime AI code lands until the 3-condition AND gate clears.
+
+**Source**
+- Gitea issue [#40](https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2/issues/40) IMP-31 — AI-assisted frame-aware adaptation (restructure / reject routes).
+- Carve-out boundary spec: [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) (allowed / forbidden / activation gate).
+- Backlog row: [`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md):68 (IMP-17 — carve-out, normal path 밖, soft link IMP-04 + IMP-05).
+- Stage 1 / Stage 2 exit reports: `.orchestrator/issues/40_stage_problem-review_exit.md` (Stage 1 binding contract).
+
+## Issue-body anchor drift (axis C1)
+
+Issue body cites `src/phase_z2_pipeline.py:452` for IMP-05 L5 `_imp05_route_hint()`. Current anchor surface (commit `1efbf67`):
+
+- `:570` — conceptual comment ("restructure → AI-assisted frame-aware adaptation (deferred to IMP-17 …)").
+- `:572` — `_IMP05_ROUTE_HINTS: dict[str, str] = {` declaration.
+- `:575` — `"restructure": "ai_adaptation_required"` entry.
+- `:580` — `def _imp05_route_hint(label: Optional[str]) -> Optional[str]:`.
+- `:664` — `"route_hint": _imp05_route_hint(match.label)` candidate_evidence emission.
+
+Anchor pin: `tests/orchestrator_unit/test_imp17_comment_anchor.py`. Synced in [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md):10 (Stage 3 u1).
+
+## 3-condition AND gate state (this cycle)
+
+| # | Condition | State | Evidence |
+|---|---|---|---|
+| 1 | User GO — explicit activation request | **NOT CLEAR** | No axis activation directive in #40. Stage 1 root_cause: runtime consumer = 0. |
+| 2 | B4 frame_selection evidence integration complete | **NOT CLEAR** (⚠ partial) | [`PHASE-Z-PIPELINE-STATUS-BOARD.md`](PHASE-Z-PIPELINE-STATUS-BOARD.md):48 Step 9 ⚠ partial; :82 "B4 frame_selection 의 V4 evidence 미통합"; :126 (j) ❌ pending. |
+| 3 | IMP-04 catalog expansion + IMP-05 V4 fallback live | **AMBIGUOUS** | `templates/phase_z2/catalog/frame_contracts.yaml` = 11 `template_id:` entries vs 32 target. IMP-05 V4 rank-2/3 fallback selector logic live, but catalog coverage gates real semantics. |
+
+**Verdict**: gate **NOT CLEAR**. Runtime AI adaptation remains gated. `src/phase_z2_ai_fallback/` = **scaffolded under IMP-33** (#61, Stage 3 u1~u11); module created, but `settings.ai_fallback_enabled` defaults to `False` (u1) so normal-path AI call count remains 0 (PZ-1). Runtime engagement still requires the 3-condition AND gate above.
+
+## Issue-body axis verdict
+
+| Axis | Issue-body line | Verdict | Binding boundary |
+|---|---|---|---|
+| A1 | restructure → ai_adaptation_required actual adaptation route | **gate-blocked** | Allowed only inside [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) Step 12 fallback path; runtime AI consumer not added this cycle. |
+| A2 | reject → design_reference_only | **gate-blocked + frontend ownership** | Reject route = design reference only. Frontend zone-level override remains IMP-29 scope ([`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md) Step 12). |
+| A3 | AI call provider | **Anthropic API only** | Kei API / `EDITOR_PROMPT` / Kei-API endpoint forbidden (Phase Q Kei persona 영구 단절 — [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) §"AI 격리 + Kei persona 단절 contract"). |
+| A4 | candidate_evidence[].route_hint | **live (deterministic emission)** | Emission anchored at `src/phase_z2_pipeline.py:570/:572/:575/:580/:664`; AI consumer deferred. Anchor pin: `tests/orchestrator_unit/test_imp17_comment_anchor.py`. |
+| A5 | MDX content preservation = strict | **locked** | No invent / rewrite / compress / summarize ([`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) §Forbidden; memory `feedback_phase_z_spacing_direction`). |
+| A6 | AI prompt = frame-aware placement only, not "rewrite content" | **locked** | Output = content_object → Internal Region / Frame Slot placement proposal at content-object granularity ([`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) §Allowed). HTML / CSS / layout / zone topology / frame selection X. |
+| A7 | popup / details / zone-resize routing when content cannot fit | **deferred to Step 17 fallback** | Deterministic actions exhausted (zone_ratio_retry / layout_adjust / frame_reselect / details_popup_escalation / image_fit_candidate / frame_internal_fit_candidate) before AI proposal ([`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) §Allowed Step 16/17). |
+| A8 | no `calculate_fit` migration | **locked** | IMP-05 selector uses V4 labels + frame-contract presence + Phase Z capacity precheck only (`src/phase_z2_pipeline.py:587` `lookup_v4_match_with_fallback` declaration; :599 docstring "it does not call calculate_fit"; secondary anchors :3093 / :4871). |
+| C1 | Anchor drift `:452` → current | **synced** | Stage 3 u1 — [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md):10. |
+| C2 | Backlog + status-board cross-ref | **planned (u3)** | Cross-ref discoverability surfaces only; no verdict duplication. |
+
+## Out of scope (this cycle)
+
+Runtime AI consumer enablement (flag default OFF), `candidate_evidence` schema change, Phase Q file mutation, Kei API reuse, frontend zone override (IMP-29 scope), IMP-30 invariant change, `calculate_fit` migration. Note: `src/phase_z2_ai_fallback/` directory scaffold itself was created under IMP-33 (#61, Stage 3 u1~u11) — see [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md) §"Runtime module surface".
+
+## Future activation path
+
+When the 3-condition AND gate clears (User GO ∧ B4 V4 evidence integrated ∧ catalog 32/32 + IMP-05 V4 fallback live):
+
+- Runtime AI module path = `src/phase_z2_ai_fallback/` (scaffolded under IMP-33; flag default OFF until gate clears).
+- Provider = Anthropic API only. Prompt design starts fresh (no Phase Q `EDITOR_PROMPT` import).
+- Output granularity = content_object → Internal Region / Frame Slot placement proposal. Frame / layout / zone topology selection remains deterministic.
+- Activation tracker = this issue (#40, IMP-31). No new IMP ID issued.

docs/architecture/INTEGRATION-AUDIT-01-MATRIX.md

@@ -0,0 +1,162 @@
+# INTEGRATION-AUDIT-01 -- Axis 2 pipeline map (22 issues x 22 steps)
+
+**Anchor (Stage 1 lock)** :
+> This audit verifies pipeline contracts. It does not optimize any single MDX sample.
+
+**Companion file** : `docs/architecture/INTEGRATION-AUDIT-01-REPORT.md` -- this MATRIX is the spin-off body of REPORT Section 4 (Axis 2). Combined REPORT exceeded the 10 KB readability threshold (REPORT u1 size = 21,070 bytes) at u1 completion, so the grid is housed here per the Stage 2 split rule. REPORT Section 4 carries a back-pointer to this file.
+
+**Pipeline reference** : `docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md` (22-step master). Block A (Steps 0-12) = pre-render planning; Block B (Step 13) = render; Block C (Steps 14-22) = post-render telemetry / exception handling.
+
+**Closed issues under audit (22 total)** : `#2 #3 #4 #5 #6 #7 #8 #9 #10 #11 #12 #13 #14 #15 #16 #17 #18 #45 #46 #47 #48 #49`. `#15` = parent; `#45-#49` = execution children. Parent/child de-dup convention (Stage 1 lock) -- `#15` row records integration glue only, no `P` (primary) cells; real code attribution lives in `#45-#48` rows. `#49` = verification-only, no new SHA, re-uses `#48` evidence.
+
+---
+
+## Step 0 precondition NOTE (NOT an axis, recorded above the grid)
+
+Step 0 = `docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md` precondition block (catalog / contract / matching data / template / asset). Per Stage 2 plan, Step 0 is NOT a grid column; it is recorded here as a precondition note. Closed issues that touched Step 0 :
+
+| issue | Step 0 touch | scope summary | evidence path |
+|---|---|---|---|
+| `#4` | catalog + contract expansion (16 frame_partials + F17 paired_rows_4x2 + frame_contracts.yaml schema) | adds frame DB rows + contract schema fields | `templates/phase_z2/catalog/frame_contracts.yaml` ; `templates/phase_z2/families/*.html` |
+| `#11` | contract field `min_height_px` exposure | additive contract payload field | `templates/phase_z2/catalog/frame_contracts.yaml` ; `src/phase_z2_pipeline.py` (commit `a79bd8b`) |
+| `#13` | build-time frame preview generator (salvage of `capture_slide_screenshot`) | precondition asset only (lives in `scripts/`, NOT runtime pipeline) | `scripts/generate_frame_previews.py` (commit `7d5639a`) |
+| `#14` | slide-base template contract bit (embedded vs standalone) | precondition template surface | `templates/phase_z2/slide_base.html` (commit `7a52ceb`) |
+| `#18` | doc-only carve-out (no Step 0 code change) | SVG gap report + 1-line backlog status flip | `docs/architecture/IMP-18-SVG-GAP-REPORT.md` (commit `cbbc163`) |
+
+Step 0 touches above are precondition data / template / contract; they do not flow runtime decisions in Steps 1-22 directly, except via consumers already accounted for as Step 5 / 9 / 10 / 12 / 13 / 22 cells in the grid below.
+
+---
+
+## Cell legend
+
+- `P` = primary touch (the issue's own declared scope per body / closing commit)
+- `A` = adjacent contract (consumer / producer / cross-step dependency surface, not the primary scope)
+- `.` = not touched (blank-equivalent; dot used for column alignment in monospace renderers)
+
+Rule applied : if an issue's body or closing commit explicitly names a step or its code file, that is `P`. If the change shape forces the issue to read from or write into another step's contract without being the primary scope, that is `A`. Otherwise `.`.
+
+Parent `#15` row carries no `P` cells per the Stage 1 de-dup convention; its child rows (`#45-#48`) carry the actual `P` cells.
+
+---
+
+## 22 x 22 grid (Step 1 columns -> Step 22 columns)
+
+Column header shorthand : `S1 = MDX upload | S2 = MDX normalize | S3 = content_object | S4 = section internal composition planning | S5 = V4 evidence | S6 = composition planning | S7 = layout vocabulary | S8 = zone+region ratio | S9 = region-level frame/display | S10 = frame contract | S11 = region-to-slot mapping | S12 = slot payload | S13 = render | S14 = visual_check | S15 = fit_classification | S16 = router | S17 = action | S18 = failure_classify | S19 = next_action | S20 = slide_status | S21 = debug.json | S22 = user UI/export`.
+
+| issue | S1 | S2 | S3 | S4 | S5 | S6 | S7 | S8 | S9 | S10 | S11 | S12 | S13 | S14 | S15 | S16 | S17 | S18 | S19 | S20 | S21 | S22 | row total |
+|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+| `#2`  | . | P | A | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | A | . | 3 |
+| `#3`  | . | A | P | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | A | . | 3 |
+| `#4`  | . | . | . | . | A | . | . | . | A | P | . | A | A | . | . | . | . | . | . | . | . | . | 5 |
+| `#5`  | . | . | . | . | A | A | . | . | P | . | . | . | . | . | . | A | A | . | . | P | . | . | 6 |
+| `#6`  | A | . | . | . | . | P | A | A | A | . | . | . | A | . | . | . | . | . | . | . | . | A | 7 |
+| `#7`  | A | A | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | P | 3 |
+| `#8`  | . | . | P | . | A | A | . | . | A | . | . | . | A | . | . | . | . | . | . | . | . | A | 6 |
+| `#9`  | . | . | . | . | . | . | A | P | A | . | . | . | A | . | . | . | A | . | . | . | . | . | 5 |
+| `#10` | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | A | . | P | 2 |
+| `#11` | . | . | . | . | . | . | . | . | A | . | . | . | . | . | . | . | . | . | . | . | . | P | 2 |
+| `#12` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | . | P | P | P | A | A | . | . | 6 |
+| `#13` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | . | . | . | . | . | . | . | . | 1 |
+| `#14` | . | . | . | . | . | . | . | . | . | . | . | . | P | . | . | . | . | . | . | . | . | A | 2 |
+| `#15` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | A | . | . | . | . | . | A | . | 3 |
+| `#16` | A | A | . | . | . | . | . | . | . | . | . | . | . | A | . | . | . | . | . | . | A | A | 5 |
+| `#17` | . | . | . | . | . | . | . | . | . | . | . | P | . | . | . | A | A | . | . | . | . | . | 3 |
+| `#18` | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | . | 0 |
+| `#45` | . | . | . | . | . | . | . | . | . | . | . | . | . | P | A | . | . | . | . | . | A | . | 3 |
+| `#46` | . | . | . | . | . | . | . | . | . | . | . | . | . | P | A | . | . | . | . | . | A | . | 3 |
+| `#47` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | P | A | . | . | . | . | . | . | 3 |
+| `#48` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | A | . | . | . | . | . | P | . | 3 |
+| `#49` | . | . | . | . | . | . | . | . | . | . | . | . | . | A | A | . | . | . | . | . | A | . | 3 |
+| **col total** | 3 | 4 | 3 | 0 | 3 | 3 | 2 | 2 | 6 | 1 | 0 | 2 | 5 | 9 | 6 | 4 | 4 | 1 | 1 | 3 | 8 | 7 | -- |
+| **HOTSPOT (>= 4)** | . | H | . | . | . | . | . | . | H | . | . | . | H | H | H | H | H | . | . | . | H | H | -- |
+
+Cell-count totals : sum of row totals = 77 ; sum of column totals = 77 (cross-check matches; 22 rows x 22 cols = 484 grid positions, of which 77 are non-blank).
+
+---
+
+## HOTSPOT enumeration (column total >= 4)
+
+9 of the 22 steps are HOTSPOT (touched by 4 or more closed issues). Listed in pipeline order :
+
+| step | col total | touching issues | hotspot meaning |
+|---|---|---|---|
+| `S2 MDX normalize` | 4 | `#2 P`, `#3 A`, `#7 A`, `#16 A` | Step 2 is the entry surface for both the Stage 0 chained adapter (`#2`) and downstream content-object trace (`#3`), with reverse-path (`#7`) and verification utility (`#16`) as adjacent consumers. Cross-issue contract = `parse_mdx` output shape stays compatible with `extract_*` semantics. |
+| `S9 region-level frame/display` | 6 | `#4 A`, `#5 P`, `#6 A`, `#8 A`, `#9 A`, `#11 A` | Step 9 is the heaviest pre-render hotspot. `#5` is primary (V4 fallback / application_plan). `#4 #8 #11` extend the contract / schema feeding Step 9. `#6 #9` exercise the consumer of zone-region geometry. Cross-issue invariant : V4 candidates list + min_height contract + sub_section alias + region ratio must all agree at the Step 9 application_plan boundary. |
+| `S13 render` | 5 | `#4 A`, `#6 A`, `#8 A`, `#9 A`, `#14 P` | Step 13 is the Jinja2 render surface. `#14` (slide-base iframe mode) is primary. `#4 #6 #8 #9` flow new payload / layout css into the same renderer. Cross-issue invariant : `build_layout_css` + frame_partial + slide_base remain deterministic with no AI in path. |
+| `S14 visual_check` | 9 | `#12 A`, `#13 A`, `#15 A`, `#16 A`, `#45 P`, `#46 P`, `#47 A`, `#48 A`, `#49 A` | Highest column total. `#15` parent + 5 children (`#45-#49`) all converge here. `#12 #13 #16` are adjacent. Cross-issue invariant : detector producers (`#45 #46`) emit canonical event shape; classifier consumer (`#47`) reads the same shape; debug.json surfaces (`#48`) match -- to be re-verified by Axis 3 (REPORT Section 5). |
+| `S15 fit_classification` | 6 | `#15 A`, `#45 A`, `#46 A`, `#47 P`, `#48 A`, `#49 A` | `#47` primary (classifier consumes image + table events). All `#15` family is adjacent. Cross-issue invariant : Step 14 producer event keys agree with Step 15 `CONTENT_TYPE_PATTERNS`. |
+| `S16 router` | 4 | `#5 A`, `#12 P`, `#17 A`, `#47 A` | `#12` primary (3-stage salvage cascade). `#5` bridge fallback adjacent. `#17` gated carve-out adjacent. `#47` classifier output flows into router. Cross-issue invariant : router action map remains deterministic / no AI in normal path. |
+| `S17 action` | 4 | `#5 A`, `#9 A`, `#12 P`, `#17 A` | `#12` primary (zone_ratio_retry expansion + cross-zone donor + 3-stage cascade). `#9` zone-geometry feeds the same retry surface. `#5` V4 fallback shares `PASS_WITH_FALLBACK` status enum. `#17` is gated. Cross-issue invariant : no common-CSS shrink (per `feedback_phase_z_spacing_direction`). |
+| `S21 debug.json` | 8 | `#2 A`, `#3 A`, `#15 A`, `#16 A`, `#45 A`, `#46 A`, `#48 P`, `#49 A` | Second-highest column total. `#48` primary (debug.json event surfacing). 7 issues adjacent. Cross-issue invariant : debug.json schema additive only; no key type / semantic conflict (Axis 3 re-verifies this category). |
+| `S22 user UI/export` | 7 | `#6 A`, `#7 P`, `#8 A`, `#10 P`, `#11 P`, `#14 A`, `#16 A` | Frontend / CLI exit surface. 3 primary (`#7 #10 #11`). 4 adjacent. Cross-issue invariant : `Front/` consumes backend artifacts as read-only payload; backend never reads from frontend except via the reverse path (`#7`). |
+
+`S2 S9 S13 S14 S15 S16 S17 S21 S22` = 9 distinct hotspot steps (col total >= 4). The col-total HOTSPOT row in the grid carries 9 `H` marks ; counting check matches.
+
+---
+
+## Row total HOTSPOT (issues touching the most steps)
+
+For information only -- this dimension is not an issue-body requirement, but is useful for scope-myopia cross-check with REPORT Section 3 :
+
+| issue | row total | finding (per REPORT Section 3) |
+|---|---|---|
+| `#6`  | 7 | Warning -- wide override blast radius (4 commits + Stage 4 blocker-fix `52ccb7f`) -- matrix row total agrees |
+| `#5`  | 6 | OK -- pre-render bridge ; rank-1 path unchanged |
+| `#8`  | 6 | OK -- additive schema with explicit backward-compat alias resolver |
+| `#12` | 6 | Warning -- large blast radius (4 src + 5 test modules in `56619a0`) -- matrix row total agrees |
+| `#4`  | 5 | OK -- pre-render planning only ; catalog read-only for V4 |
+| `#9`  | 5 | OK -- 8-vocabulary build_layout_css with fixtures |
+| `#16` | 5 | OK -- utility + design doc only ; gated by `#7` activation |
+
+The two `Warning` rows in Section 3 (`#6` row total 7 and `#12` row total 6) sit at the top of the row-total ranking -- this is consistent with "wide blast radius" findings in Section 3. The other high-row-total issues (`#5 #8 #4 #9 #16`) are all `OK` per Section 3 because each ships with explicit backward-compat guards / fixtures / gating.
+
+---
+
+## Cross-check vs REPORT Section 3 adjacency list
+
+REPORT Section 3 flagged 9 adjacent-contract pairs for Axis 3 re-verification. Each pair maps onto cells in this grid :
+
+| Section 3 adjacency pair | matrix evidence |
+|---|---|
+| `#2` Step 2 normalize -> `#3` Step 3 content_object | `#2` S2 `P` + `#3` S2 `A` (producer/consumer same column) |
+| `#3` content_object -> `#8` sub_sections | `#3` S3 `P` + `#8` S3 `P` (both primary on same step -- schema extension) |
+| `#4` catalog -> `#5` V4 fallback | `#4` S5 `A` + `#5` S5 `A` (both adjacent on same step -- candidate pool dedup) |
+| `#4` catalog -> `#10 #11` min_height | `#11` S0 (NOTE) ; `#11` S9 `A` (Step 9 consumer of min_height) -- direct adjacency |
+| `#9` layout vocabulary -> `#12` retry zone-ratio | `#9` S17 `A` + `#12` S17 `P` (consumer/producer same step) |
+| `#9` -> `#11` Step 9 min_height test | `#9` S9 `A` + `#11` S9 `A` (both adjacent on same step) |
+| `#45 + #46` Step 14 -> `#47` Step 15 | `#45 #46` S14 `P` + `#47` S15 `P` ; `#47` S14 `A` (cross-step producer/consumer) |
+| `#48` debug.json -> open `#21` consumer | `#48` S21 `P` ; `#21` is out-of-scope (open) -- no grid row |
+| `#17` AI carve-out -> `#5 + #4` activation gate | `#17` S12 `P` ; `#17` S16 `A` ; `#17` S17 `A` (gated cells) |
+
+All 9 adjacency pairs map onto provable cells. Axis 3 (REPORT Section 5) will verify each pair's producer-line / consumer-line on live code.
+
+---
+
+## Empty columns (col total = 0)
+
+- `S4 section internal composition planning` -- 0 touches. Consistent with PHASE-Z-PIPELINE-OVERVIEW Step 4 status `missing` (no closed issue implemented Step 4 yet; it remains in the open backlog).
+- `S11 content unit / child group -> internal region -> frame slot mapping` -- 0 touches. Consistent with PHASE-Z-PIPELINE-OVERVIEW Step 11 status `missing` (Layer A / Layer B 2-stage placement algorithm not implemented).
+
+Step 4 and Step 11 are the two `missing` steps in Block A that no closed issue in the audit window addressed. This is expected per the master pipeline status; the audit records absence without claiming a gap (an implementation gap would require an OPEN issue to claim it, which is out of audit scope).
+
+---
+
+## Low-touch columns (col total = 1)
+
+- `S10 frame contract` (1) -- `#4` only ; consistent with `#4` being the catalog/contract owner.
+- `S18 failure_classify` (1) -- `#12` only ; consistent with `#12` being the retry cascade owner.
+- `S19 next_action` (1) -- `#12` only ; same.
+
+---
+
+## Notes on parent / child row separation
+
+- `#15` row carries 3 adjacencies (S14 / S15 / S21) and zero `P` cells per the Stage 1 de-dup convention.
+- `#45 #46 #47 #48` carry the corresponding `P` cells (S14 for `#45 #46` ; S15 for `#47` ; S21 for `#48`).
+- `#49` (verification-only, no new SHA) mirrors the `#48` adjacency pattern with all-`A` cells -- this is intentional and consistent with the Stage 1 lock that `#49` re-uses `#48` evidence (commit `614c533`). No double-count.
+
+Sum cross-check : `#15` 3 + `#45` 3 + `#46` 3 + `#47` 3 + `#48` 3 + `#49` 3 = 18 row-total cells across the `#15` family. None of these duplicate code attribution -- only `#45 #46 #47 #48` carry the four `P` cells (one each), totaling 4 primary cells for the family. `#15 #49` carry zero primaries.
+
+---
+
+*End of MATRIX. Back to REPORT Section 4 for narrative integration.*

docs/architecture/INTEGRATION-AUDIT-01-REPORT.md

@@ -0,0 +1,547 @@
+# INTEGRATION-AUDIT-01 -- Phase Z closed-issue cumulative consistency review
+
+## Section 1. Audit anchor
+
+**Anchor (cited verbatim per Stage 1 exit report)** :
+> This audit verifies pipeline contracts. It does not optimize any single MDX sample.
+
+**Scope** : 22 closed Gitea issues `#2-#18 + #45-#49` on `Kyeongmin/C.E.L_Slide_test2` against the 22-step Phase Z pipeline (`docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md`, Steps 1-22 plus Step 0 precondition).
+
+**Mode** : audit-only -- no source code changes. Report-only file changes under `docs/architecture/INTEGRATION-AUDIT-*.md` and one row in `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` (u7).
+
+**Parent / child relationship** : Gitea `#15` = parent (IMP-15 Step 14 visual_check reinforcement). Execution children = `#45 / #46 / #47 / #48 / #49`. Locked child SHAs (Stage 1 exit report) :
+- `#45` -> `e9b3d2e` (execution-1, image_aspect_mismatch detection)
+- `#46` -> `2827622` (execution-2, table_self_overflow detection; commit message label says `IMP-16` but the closed Gitea issue is `#46`; flagged in Section 3)
+- `#47` -> `535c484` (execution-3, classifier consumes image+table events)
+- `#48` -> `614c533` (execution-4, debug.json event surfacing + spec taxonomy)
+- `#49` -> no new SHA (verification-only per `#15` body; re-uses `614c533` evidence)
+
+**Close timestamp anomaly** (Stage 1 lock, recorded; NOT reopened) :
+- `#15` closed `2026-05-19T02:35:05+09:00`
+- `#45 / #46 / #47 / #48` all closed BEFORE `#15` (correct ordering)
+- `#49` closed `2026-05-19T02:49:56+09:00` -- about 15 minutes AFTER `#15` close (anomaly)
+- Disposition : record-only in Section 3 / Section 6 finding column; no remediation row in backlog beyond the existing audit completion row (u7).
+
+**Excluded (open / not in audit)** : `#1, #19, #20, #21, #22, #23, #24, #25, #26, #27, #28, #38, #39, #40, #41, #42, #43, #44`.
+
+**Sample budget** : `samples/mdx_batch/03.mdx` (smoke) plus `samples/mdx_batch/04.mdx` (details + images). Pipeline runs captured in Section 7.
+
+---
+
+## Section 2. Baseline pytest
+
+**Method** : `pytest -q tests` is the project regression suite. The audit captures it twice -- once before any u5 / u6 / u7 edits, once after Section 7 / 8 grep + render evidence is collected. Equality of both runs proves the audit-only work surface (`docs/architecture/INTEGRATION-AUDIT-*.md` + backlog row in u7) did not perturb production code.
+
+**Command** : `pytest -q tests` (working dir = repo root `D:\ad-hoc\kei\design_agent\`).
+
+**Pytest BEFORE audit u5 edits (audit date 2026-05-19)** :
+- Result : `303 passed in 40.80s`
+- Last 5 progress dots aggregated to `[100%]` then `Running teardown with pytest sessionfinish...` -- expected suite teardown banner.
+
+**Pytest AFTER audit u5 edits (post §7 / §8 evidence collection, same audit date)** :
+- Result : `303 passed in 40.54s`
+- 303 == 303 ; 0 new failures, 0 skipped, 0 errored. Test count parity proves no test discovery side-effect from new audit docs.
+
+**Verdict** : OK. Audit-only edits under `docs/architecture/INTEGRATION-AUDIT-*.md` introduce no regression. Baseline stable across u5 assembly.
+
+---
+
+## Section 3. Axis 1 -- Scope myopia (22 issues x adjacent-contract cross-reference)
+
+**Method** : per closed issue, list (a) its own scope as declared in body / backlog row / closing commits, (b) adjacent pipeline contracts the change could have leaked into, (c) downstream consumers of its outputs, (d) finding label `OK` / `Warning` / `Blocker`. Each row cites `src/`, `tests/`, `docs/`, or `templates/` paths.
+
+**De-dup convention** : `#15` is treated as the *integration parent*; the actual code/test changes are owned by execution children `#45-#49`. `#15` row records integration glue only (parent close evidence + cross-child reconciliation). No change is double-counted across parent + child.
+
+**Pipeline step shorthand (per `PHASE-Z-PIPELINE-OVERVIEW.md`, full 22-step list)** :
+- Step 0 precondition / 1 MDX upload / 2 normalize / 3 content_object / 4 internal composition planning / 5 V4 evidence / 6 composition planning / 7 layout vocabulary / 8 zone+region ratio / 9 region-level frame/display / 10 frame contract / 11 region-to-slot mapping / 12 slot payload / 13 render / 14 visual_check / 15 fit_classification / 16 router / 17 action / 18 failure_classify / 19 next_action / 20 slide_status / 21 debug.json / 22 user UI.
+
+### Section 3 table -- 22 rows
+
+| # | issue (title) | declared own_scope | adjacent contracts (potential leak surface) | downstream consumers | finding | evidence path |
+|---|---|---|---|---|---|---|
+| 1 | `#2` IMP-02 A-1 Stage 0 normalize chained adapter | Step 2 -- chained `normalize_mdx_content` + `extract_major_sections` + `extract_conclusion_text` with dual-write, preserve raw MDX | Step 3 content_object input shape (raw chunk handoff); Step 21 debug.json schema (`step02_*` keys) | Step 3 (IMP-03 ContentObject extractor); Step 21 trace writer; Step 7/8 layout planner (consumes normalized section list) | OK -- additive; preserves prior `extract_*` semantics via dual-write; no AI in path | `src/phase_z2_pipeline.py` (commit `bac13c0`, +165/-3) |
+| 2 | `#3` IMP-03 A-1 popup/image/table trace | Step 3 -- normalize popups/images/tables into ContentObject (B1 v0 extension); slide-level rich ContentObject trace | Step 2 normalize output shape (consumer); Step 4 internal composition planning (Step 4 itself still not implemented, so this row only emits trace); Step 21 debug.json schema | Step 4 (not yet implemented; receives data only via trace); Step 21 debug.json (`content_objects` field) | OK -- emits trace without coupling to downstream Step 4 (Step 4 still pending); raw content preserved (no AI summarization; satisfies `feedback_ai_isolation_contract`) | `src/phase_z2_content_extractor.py` + `src/phase_z2_pipeline.py` (commit `fc3f7d8`) |
+| 3 | `#4` IMP-04 A-2 catalog expansion | Step 0 + Step 9 -- register/expand 16 frame_partials + `frame_contracts.yaml` schema; F17 paired_rows_4x2 + pill alternation + theme | Step 5 V4 evidence (catalog size affects evidence pool); Step 10 frame contract validator (consumes new contracts); Step 12 mapper PAYLOAD_BUILDERS (consumes new schema); Step 13 render template surface (16 new `templates/phase_z2/families/*.html`) | Step 5/9/10/12/13; smoke tests `scripts/smoke_frame_render.py` | OK -- pre-render planning only; catalog is read-only data for V4; frame DB extension matches Step 0 contract; commit `73a98b8` corrected F17 schema after first land (factual_verification path active) | `templates/phase_z2/catalog/frame_contracts.yaml`; `templates/phase_z2/families/*.html`; `src/phase_z2_mapper.py`; `docs/architecture/IMP-04-FRAME-SUITABILITY-MATRIX.md` |
+| 4 | `#5` IMP-05 A-5 V4 fallback | Step 9 + Step 16/17 -- deterministic V4 candidate bridge (pre-render rank-2/3 fallback); trace schema; dedup invariant test; new `PASS_WITH_FALLBACK` status semantics in Step 20 | Step 5 evidence (candidate dedup must agree with rank-1 path); Step 6 composition (candidates[0] backward-compat); Step 9 application_plan; Step 20 status enum; debug.json trace | Step 9/16/17/20; `tests/test_phase_z2_v4_fallback.py`; `tests/test_catalog_invariant.py` | OK -- pre-render bridge (Block A); deterministic (no AI); rank-1 path unchanged (backward compat per backlog guardrail); dedup invariant test guards collision with `#4` catalog expansion | `src/phase_z2_pipeline.py` + `src/phase_z2_composition.py` + `src/phase_z2_router.py` (commits `15c5b9a`, `21476ae`, `23d1b25`) |
+| 5 | `#6` IMP-06 B-1 zone-section override | Step 6 + Step 1/22 input -- CLI arg + composition planner override (`replaced_auto_unit`, `render_records`, plan-aware traces, units rebuild, empty zone) | Step 1 CLI surface; Step 6 `plan_composition` schema (CompositionUnit); Step 7/8/9 downstream (units rebuild forces re-planning); Step 13 render (Catch K render-path) | Step 7/8/9/13; debug.json render_records; `Front/` (later wired via `#8` U3) | Warning -- wide blast radius (4 commits + Stage 4 blocker-fix `52ccb7f`); units-rebuild touches Step 7/8/9 implicitly; verified by `tests/test_phase_z2_section_assignment_override.py` (285 + 42 + 228 lines). No AI; deterministic. Risk = override path widens Step 6 surface where Step 4 is still pending | `src/phase_z2_pipeline.py` (commits `d596fab` `b81e564` `1f15495` `52ccb7f`) |
+| 6 | `#7` IMP-07 B-2 edited HTML to MDX reverse path | Step 22 + Step 1/2 input -- Vite/React `Front/` plus reverse path glue; pipeline re-entry | Step 1 MDX upload; Step 2 normalize (must accept reverse-path MDX); CLI plus service API; `feedback_ai_isolation_contract` (reverse must not invoke AI rewrite) | Step 2 (reverse-path consumer); `Front/client/src/services/designAgentApi.ts`; pipeline CLI | OK -- frontend-shipped (`0f0d3fa`); reverse path schema aligned with `#2` Stage 0 normalize via hard-link declared in backlog. AI isolation preserved (no normal-path LLM in reverse). | `Front/`; `src/phase_z2_pipeline.py`; backlog row IMP-07 |
+| 7 | `#8` IMP-08 B-3 sub-section drag-drop | Step 3 schema -- sub_sections schema + V4 alias resolver + aligner canonical sub-id + decimal alias guard (N-R5) + frontend wire | Step 3 ContentObject schema (extends `#3`); Step 5 V4 alias surface; Step 6 composition planner (consumer); Step 9 application_plan; `Front/` zoneSections override (U3) | Step 5/6/9/13; `tests/test_phase_z2_subsection_schema.py` (82+100+61 lines) | OK -- additive schema with explicit backward-compat guard (alias resolver at 4 lookup sites); Stage 5 R2 blocker-fix `8f6cffc` force-drills aligner only on override targets (scope contained) | `src/phase_z2_pipeline.py` + `src/phase_z2_composition.py` (commits `a422d72` `5191aca` `ab2764c` `8f6cffc`) |
+| 8 | `#9` IMP-09 B-4 non-default layout zone-geometry | Step 8 -- col-axis solver + per-zone geometry mapper + retry gate; 2-D dynamic dispatch for 5 preset families (single + horizontal-2 + vertical-2 + top-1-bottom-2 + top-2-bottom-1 + left-1-right-2 + left-2-right-1 + grid-2x2) | Step 7 layout vocabulary (consumer); Step 9 region-level (zone geometry feeds region ratios; Step 9 region-level still warning); Step 17 zone_ratio_retry (`#12` IMP-12 retry path); Step 13 render `build_layout_css` | Step 9/13/17; `tests/phase_z2/fixtures/build_layout_css/*.yaml` (16 fixtures); `tests/phase_z2/fixtures/retry_gate/*.yaml` | OK -- all 8 vocabulary entries enabled in build_layout_css; fixtures supply provable diff per preset; no Kei/Phase R' regression (existing `build_containers_type_b` untouched) | `src/phase_z2_pipeline.py` (commits `201099e` PR1, `1fb9732` PR2) |
+| 9 | `#10` IMP-10 D-1 filtered_section_reasons UI | Step 20/22 -- frontend read-only display of `filtered_section_reasons` artifact | Step 20 slide_status enum (read-only consumer); `Front/` service API; no backend mutation | `Front/client/src/pages/Home.tsx`; `Front/client/src/services/designAgentApi.ts` | OK -- frontend-only; backend artifact strictly read-only per backlog guardrail | `Front/` (commit `0fb168b`, +45 lines) |
+| 10 | `#11` IMP-11 D-2 Frame min_height display | Step 22 -- `min_height_px` hint exposed backend to UI; resize hint read-only; Step 9 v4 all-judgments min_height test | Step 0 frame contract (`min_height_px` field); Step 9 region-level (consumer); `Front/` SlideCanvas | Step 9; `Front/client/src/components/SlideCanvas.tsx`; `tests/test_phase_z2_step9_v4_all_judgments_min_height.py` | OK -- contract read-only; backend exposure is additive payload field (`src/phase_z2_pipeline.py` +32/-12 in `a79bd8b`) | `src/phase_z2_pipeline.py` + `Front/client/src/components/SlideCanvas.tsx`; `tests/test_phase_z2_step9_v4_all_judgments_min_height.py` |
+| 11 | `#12` IMP-12 Step 16/17 retry refinement | Step 16 + Step 17 -- multi-donor + 3-stage salvage cascade; `redistribute` + glue + font compression; new router action; new failure_router taxonomy | Step 14 visual_check (donor selection consumes overflow events); Step 18 failure_classify (cascade adds new failure types); Step 19 next_action (downstream router consumer); Step 20 status semantics; `feedback_phase_z_spacing_direction` (cross-zone redistribute is grant-changing, not common-shrink) | Step 18/19/20; `tests/phase_z2/test_phase_z2_*` (cross_zone, font_step, glue, multi_donor, step17_salvage_chain -- 5 new test modules) | Warning -- large blast radius (4 src files + 5 test modules in `56619a0`); multi-donor introduces cross-zone state in Step 17; verified by 5 dedicated test modules. Risk = cascade may interact with `#5` V4 fallback path in Step 20 status enum (mitigated by separate status enums per `#5` exit report) | `src/phase_z2_failure_router.py` + `src/phase_z2_pipeline.py` + `src/phase_z2_retry.py` + `src/phase_z2_router.py` (commit `56619a0`) |
+| 12 | `#13` IMP-13 A-3 frame preview consistency | Step 0 + Step 14/21 -- build-time frame preview generator (salvage of `capture_slide_screenshot`) | Step 0 catalog frame_partials (consumer for snapshot); Step 14 visual_check (uses preview for sanity, read-only); no Phase R' regression | `scripts/generate_frame_previews.py`; `tests/test_generate_frame_previews.py` | OK -- build-time only (not in runtime pipeline); deterministic; no Phase R' coupling (script lives in `scripts/`) | `scripts/generate_frame_previews.py` (commit `7d5639a`, 239 LOC + 50 LOC test) |
+| 13 | `#14` IMP-14 A-4 slide-base iframe mode | Step 13 render -- `slide-base.html` conditional CSS (embedded vs standalone); Step 0 contract bit | Step 0 slide_base template; Step 13 Jinja2 deterministic render; `Front/` SlideCanvas (consumer) | Step 13; `Front/client/src/components/SlideCanvas.tsx`; `tests/phase_z2/test_slide_base_embedded_mode.py` | OK -- render-time contract only; Jinja2 deterministic; embedded mode reduces SlideCanvas friction (34 LOC simplified) | `templates/phase_z2/slide_base.html` + `src/phase_z2_pipeline.py` (commit `7a52ceb`) |
+| 14 | `#15` IMP-15 Step 14 visual_check reinforcement (PARENT -- execution children `#45-#49`) | Integration glue only -- *no direct code* under #15; closure depends on `#45-#49` SHAs. De-duped against children (real change attribution = #45-#49 rows below) | Step 14 (parent contract); Step 15 fit_classification consumer; Step 21 debug.json trace; `PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md` (taxonomy row added by `#48`) | Step 15/21; spec doc | Warning -- close-timestamp anomaly only : `#49` closed at `2026-05-19T02:49:56+09:00`, about 15 minutes AFTER `#15` close `02:35:05+09:00`. All other children (#45-#48) close BEFORE #15. `#49` body declares verification-only path (no new SHA; re-uses `614c533`), so post-close `#49` close does not leak code into `#15`. Disposition : record-only, no reopen. | `docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md` Step 14/15; child rows below |
+| 15 | `#16` IMP-16 B-2 verification helper axis | Step 1/2/14/21/22 -- `phase_z2_verification_utils.py` port + 8 verification test modules + U2 wiring design doc | Step 22 reverse path verification (consumer is `#7` IMP-07 once activated); no normal-path coupling | Step 14/21 trace consumers (utility); future `#7` reverse-path verification | OK -- utility module plus design doc only; no normal-path coupling (gated by `#7` activation); commit `23ba8b6` is design + utility port (335 LOC utility + 8 test modules + wiring doc) | `src/phase_z2_verification_utils.py`; `docs/architecture/IMP-16-U2-WIRING-DESIGN.md` (commit `23ba8b6`) |
+| 16 | `#17` IMP-17 AI repair fallback infra (carve-out -- outside normal path) | Design-only boundary + 3-cond AND gate (User GO AND B4 frame_selection evidence AND IMP-04/05 live); `httpx` + SSE + retry + JSON parse pattern reference | Step 12 (AI position contract; carve-out body asserts normal path AI = 0); Step 16/17 fallback path (gated activation); `feedback_ai_isolation_contract` (foundational rule); backlog row + INSIGHT-MAP cross-ref | Step 12 (design boundary); future activation gated by 3-cond AND | OK -- design-only carve-out; `src/phase_z2_pipeline.py` change = 1 line (comment anchor for orchestrator test); no runtime AI added | `docs/architecture/IMP-17-CARVE-OUT.md` + `tests/orchestrator_unit/test_imp17_comment_anchor.py` (commit `e10ec36`) |
+| 17 | `#18` IMP-18 I3 SVG coordinate reinforcement | Doc-only carve-out -- SVG gap report; `renderer._preprocess_svg_data` pattern reference | Step 0 frame_partials SVG geometry (reference); Phase R' (renderer.py) read-only | doc consumers; backlog row | OK -- doc-only (`docs/architecture/IMP-18-SVG-GAP-REPORT.md` + 1-line backlog status flip from `pending` to `documented`); no code touched | `docs/architecture/IMP-18-SVG-GAP-REPORT.md` (commit `cbbc163`) |
+| 18 | `#45` (`#15` execution-1) image_aspect_mismatch detection + runtime test | Step 14 -- `image_aspect_mismatch` detection in visual_check; runtime test `test_phase_z2_step14_image_check.py` | Step 15 fit_classification consumer; Step 21 debug.json event surfacing (delegated to `#48`); `#15` parent close evidence | Step 15 (consumer via classifier event); `#47` (classifier integration) | OK -- Step 14 detection only (no Step 15 wiring yet; delegated to `#47`). Test scope local. | `src/phase_z2_pipeline.py` + `tests/phase_z2/test_phase_z2_step14_image_check.py` (commit `e9b3d2e`) |
+| 19 | `#46` (`#15` execution-2) table overflow + element-identity dedup + Selenium test | Step 14 -- `table_self_overflow` detection; element-identity dedup; Selenium integration test | Step 14 dedup logic (must agree with image events from `#45`); Step 15 consumer (delegated to `#47`); `#15` parent | Step 15 (consumer); `#47` | Warning -- commit-message label drift only (Step 14 scope-discipline pattern itself matches `#45`). Commit `2827622` message reads `feat(IMP-16): ...`, which mis-labels the closing Gitea issue (actually closes `#46` = `#15` execution-2; IMP-16 backlog row is the verification utility carved out separately). Audit attribution corrected here; SHA `2827622` is the authoritative anchor. No code/contract leak; risk is record-keeping only. | `src/phase_z2_pipeline.py` + `tests/phase_z2/test_phase_z2_step14_table_check.py` (commit `2827622`) |
+| 20 | `#47` (`#15` execution-3) classifier consumer (image + table) + pure-dict test | Step 15 -- classifier consumes image+table events from Step 14; pure-dict test (no Selenium) | Step 14 producers (`#45` + `#46`); Step 15 `CONTENT_TYPE_PATTERNS` taxonomy; Step 16 router (consumer) | Step 16; `tests/phase_z2/test_phase_z2_visual_classifier.py` | OK -- classifier wiring with pure-dict tests isolates Step 15 from Selenium dependency; aligns Step 14 producer to Step 15 consumer (Axis 3 invariant -- to be re-verified in Section 5) | `src/phase_z2_classifier.py` (commit `535c484`) |
+| 21 | `#48` (`#15` execution-4) debug.json event surfacing + spec doc trace + regression | Step 21 debug.json event surfacing + `PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md` taxonomy row + regression test | Step 21 trace schema (additive); spec doc; regression guard | spec doc consumers; debug.json consumers (Front/, audit tooling) | OK -- 3-line pipeline change + 2 test modules + 1-line spec doc row; smallest blast radius of #15 children | `src/phase_z2_pipeline.py` + `docs/architecture/PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md` (commit `614c533`) |
+| 22 | `#49` (`#15` execution-5) final integration + parent close | Verification-only -- re-uses `#48` `614c533` evidence; no new SHA per `#15` body | `#15` parent close; integration-only | `#15` parent | Warning -- close-timestamp anomaly (closed `2026-05-19T02:49:56+09:00`, about 15 minutes AFTER `#15` close `02:35:05+09:00`). Verification-only path has no code change, so anomaly is administrative only; no contract leak. | `#15` body + `614c533` (re-used) |
+
+### Section 3 finding summary
+
+- **OK** rows : `#2 #3 #4 #5 #7 #8 #9 #10 #11 #13 #14 #16 #17 #18 #45 #47 #48` (17)
+- **Warning** rows : `#6` (wide override blast radius, contained by tests); `#12` (multi-donor + cascade, contained by 5 test modules); `#15` (close-timestamp anomaly via `#49`); `#46` (commit-message label drift only, SHA correct); `#49` (close-timestamp anomaly, verification-only) -- 5 rows
+- **Blocker** rows : 0
+- **Total** : 17 OK + 5 Warning + 0 Blocker = 22 rows (matches 22 closed issues under audit).
+- **De-dup audit** : `#15` row carries no code attribution; all code/test work attributed to `#45-#48` (and `#49` = verification-only). No double-count.
+
+### Section 3 cross-issue scope-myopia adjacency check
+
+Adjacent-contract pairs flagged for Section 5 Axis 3 re-verification (producer to consumer continuity) :
+- `#2` Step 2 normalize output -> `#3` Step 3 content_object input
+- `#3` content_object schema -> `#8` sub_sections schema extension
+- `#4` catalog expansion -> `#5` V4 fallback candidate pool dedup
+- `#4` catalog expansion -> `#10`-`#11` `min_height_px` exposure
+- `#9` layout vocabulary -> `#12` retry zone-ratio donor selection
+- `#9` layout vocabulary -> `#11` Step 9 min_height v4-all-judgments test
+- `#45 + #46` Step 14 events -> `#47` Step 15 classifier -> Step 16 router
+- `#48` debug.json event surfacing -> `#21` (Step 21 debug consumer; open, excluded)
+- `#17` AI carve-out -> `#5 + #4` activation 3-cond AND gate (gated, not active)
+
+Axis 3 (Section 5) will verify each pair has agreeing producer-line / consumer-line on the live code.
+
+---
+
+## Section 4. Axis 2 -- 22 issues x 22 steps pipeline matrix
+
+**Split rationale** : at u1 completion the combined REPORT was 21,070 bytes / 136 lines -- over the 10 KB readability threshold defined in the Stage 2 plan. Per the split rule (`combined REPORT >= 10 KB grid moves to MATRIX.md + back-pointer`), the 22 x 22 grid lives in the companion file :
+
+- `docs/architecture/INTEGRATION-AUDIT-01-MATRIX.md`
+
+**What MATRIX.md contains** :
+- Step 0 precondition NOTE (NOT a grid column) -- 5 issues (`#4 #11 #13 #14 #18`) recorded with scope summary + evidence path.
+- 22 x 22 grid (Step 1 through Step 22 columns x 22 issue rows). Cell legend : `P` = primary touch, `A` = adjacent contract, `.` = no touch. ASCII-only.
+- Row footer (touched-step count) and column footer (touching-issue count + `H` HOTSPOT marker for col total >= 4).
+- HOTSPOT enumeration (9 steps : `S2 S9 S13 S14 S15 S16 S17 S21 S22`).
+- Cross-check against the 9 adjacent-contract pairs flagged in Section 3.
+- Empty / low-touch column notes (Step 4 and Step 11 are `missing` per PHASE-Z-PIPELINE-OVERVIEW -- 0 touches expected).
+- Parent/child de-dup sum check : `#15` row carries 3 adjacencies and zero `P` cells ; only `#45 #46 #47 #48` carry the 4 primary cells for the `#15` family ; `#49` is verification-only with all-`A`.
+
+**Section 4 summary (for readers staying in REPORT)** :
+- 9 hotspot steps (col total >= 4) : Step 2 (4), Step 9 (6), Step 13 (5), Step 14 (9 highest), Step 15 (6), Step 16 (4), Step 17 (4), Step 21 (8), Step 22 (7).
+- 2 empty columns : Step 4 + Step 11. Consistent with master pipeline `missing` status -- no audit gap.
+- Total grid cells filled = 77 (row sum = col sum, cross-checked).
+- Top row-total issues : `#6` (7), `#5` (6), `#8` (6), `#12` (6) -- the 2 `Warning` rows (`#6 #12`) sit at the top, consistent with Section 3 wide-blast-radius finding.
+
+---
+
+## Section 5. Axis 3 -- Cross-issue conflict per invariant category
+
+**Method** : 6 invariant categories listed in the issue body. Per category, identify producer file:line, consumer file:line, the named state key / contract, the closed issues that touch it, agree-or-conflict verdict, plus grep evidence path. Categories are evaluated against the live tracked code at audit time, not against historical snapshots.
+
+### 5.1 Invariant category roster (from issue body)
+
+| # | category | issue-body wording |
+|---|---|---|
+| C1 | `debug.json` schema | phase_z2 debug payload paths; no conflicting key type / semantics |
+| C2 | `visual_check_passed` | `src/phase_z2_pipeline.py` Step 14 / 17; set-site <-> read-site agree |
+| C3 | `fit_classification` / router | `src/phase_z2_mapper.py` + consumers; labels consistent producer -> consumer (charter mis-cite; live producer = `src/phase_z2_classifier.py` -- see §10 F-1) |
+| C4 | Step 14 / 17 / 21 interactions | expected state values stay aligned across the trio |
+| C5 | Phase R vs Phase Z boundary | no R regression, Z additions don't leak into R |
+| C6 | template / catalog / frame count | all docs / code use same numbers (family = 13) |
+
+### 5.2 Producer / consumer / agreement table
+
+| C# | invariant key | producer (file : line) | consumer(s) (file : line) | touching closed issues | verdict | grep evidence |
+|---|---|---|---|---|---|---|
+| C1 | per-step JSON schema = `step_num`, `step_name`, `step_status`, `pipeline_path_connected`, `input`, `output`, `note`, `data` (locked) | `src/phase_z2_pipeline.py:2593` `_write_step_artifact` definition; locked schema docstring at `2605-2611` (Locked schema lines `2607-2610`) | every step writer in `src/phase_z2_pipeline.py` -- 24 call sites at lines `2782, 2812, 2857, 2934, 3184, 3619, 3652, 3674, 3793, 3804, 3826, 3881, 4056, 4308, 4481, 4507, 4527, 4549, 4658, 4677, 4688, 4706, 4761, 4780`; `Front/` reads `data/runs/.../steps/*.json`; audit tooling | `#2 step02_*`; `#3 content_objects`; `#5 v4_fallback_summary` + `selection_paths` + `fallback_selection_count`; `#6 render_records`; `#11 min_height_px` payload; `#48 image_events` / `table_events` event surfacing | AGREE -- all step writers go through the single `_write_step_artifact` site with the locked field set; additive `data` payload only; no conflicting key types observed | `Grep _write_step_artifact src/phase_z2_pipeline.py` = 1 definition (line 2593) + 24 call sites = 25 total occurrences (all 24 call sites enumerated in consumer column); all share the same `_write_step_artifact(run_dir, step_num, name, data, *, step_status, pipeline_path_connected, inputs, outputs, note)` kwargs surface |
+| C2 | `visual_check_passed: bool` set at Step 14 / read at Step 17 | `src/phase_z2_classifier.py:495` `visual_check_passed = bool(overflow.get("passed", False)) and not classifications` returned at `497` | `src/phase_z2_router.py:128` `if fit_classification.get("visual_check_passed", True): ... router_active = False`; `src/phase_z2_pipeline.py:2560` sets `slide_status["visual_check_passed"] = visual_passed`; pipeline summary reads at `4800`, `4804`, `4830` | `#15` parent; `#45` (image_events flip the flag); `#46` (table_events flip the flag); `#47` (classifier widens semantic to `passed AND no classifications`) | AGREE -- single set-site (classifier.py:495) + slide_status mirror (pipeline.py:2560); router.py:128 + pipeline.py:4800/4804/4830 read the same key. Default `.get(..., True)` at router.py:128 is safe because absent key = no classification = pass | `Grep visual_check_passed src` = 14 hits across `classifier.py` + `router.py` + `pipeline.py` -- producer / consumer line set matches |
+| C3 | `fit_classification` dict keys = `visual_check_passed`, `classifications`, `summary`, `categories_seen`, `unclassified_signals`, `placement_diagnostics`; classifier <-> router consumer | `src/phase_z2_classifier.py:496-506` `classify_visual_runtime_check` return dict | `src/phase_z2_router.py:109` `route_fit_classification(fit_classification)`; `src/phase_z2_pipeline.py:4524` `fit_classification = classify_visual_runtime_check(overflow, debug_zones)`; pipeline re-classify after retry at `4582 / 4643`; router decision call at `4540 / 4583 / 4644`; retry consumer `src/phase_z2_retry.py:47` reads `fit_classification` | `#5` (V4 fallback PASS_WITH_FALLBACK semantics); `#12` (retry router multi-donor + cascade); `#15` parent; `#47` (classifier feed); `#48` (debug surfacing) | AGREE -- producer key set is the exact set consumed downstream. NOTE : the issue body says `src/phase_z2_mapper.py` for invariant C3, but the live producer is `src/phase_z2_classifier.py` (`mapper.py` owns slot payload, not fit classification). This is a record-keeping mismatch in the issue body, not a code conflict. Recorded as Section 10 follow-up candidate F-1 | `Grep fit_classification src` = 30 total occurrences across 4 files (`classifier.py` 3 hits incl. docstring/comments; `pipeline.py` 20 hits; `router.py` 5 hits; `retry.py` 2 hits). Active code use sites = producer at `classifier.py:497`; consumers at `router.py:128 / 139` + `pipeline.py 2732 / 4524 / 4540 / 4571 / 4582 / 4583 / 4643 / 4644 / 4754 / 4804 / 4805` + `retry.py:47 / 67`. Remaining occurrences are imports / function-parameter declarations / docstring references |
+| C4 | Step 14 visual_check overflow events (`image_events`, `table_events`, `passed`) -> Step 15/16 (fit + router) -> Step 17 retry action -> Step 21 debug surface | Step 14 emit sites `src/phase_z2_pipeline.py:2236` (`image_events`), `2282` (`table_events`), `2367 / 2386` (aggregation); Step 15 classifier consumes both event lists at `src/phase_z2_classifier.py:429 / 453`; Step 16 router at `src/phase_z2_router.py:142`; Step 17 retry orchestration at `src/phase_z2_pipeline.py:4571 / 4583 / 4644`; Step 21 trace producer at `src/phase_z2_pipeline.py:4762-4777` (`step21_debug_index.json` + `debug.json` outputs) | Step 21 `debug.json` index reader (`Front/` + audit tooling); pipeline summary 4791-4841 | `#12` (retry cascade Step 17 multi-donor + glue + font compression); `#15 / #45 / #46 / #47 / #48` (Step 14 producer / Step 15 classifier consumer / Step 21 surface); `#10` filtered_section_reasons (Step 22 read-only, Step 21 source) | AGREE with one DOCUMENTED PARTIAL -- Step 21 writer at `pipeline.py:4772` is `step_status="partial"` with note `region marker partial 미주입 -- Step 21 ⚠ partial`. This is an *acknowledged* partial state recorded in trace, not a contract conflict between issues. Recorded as Section 6 status row | `Grep step_num.*=.*21\|outputs.*debug\.json src/phase_z2_pipeline.py` = single producer at line 4762-4777 |
+| C5 | Phase R' (`src/renderer.py`, `src/content_editor.py`, `src/html_validator.py`, `src/block_selector.py`) <-> Phase Z (`src/phase_z2_*.py`) module boundary; no cross-import | `src/phase_z2_pipeline.py` (Phase Z entry) has zero imports of Phase R' modules; verified via `Grep "from renderer\|import renderer\|from phase_q\|from src\.renderer" src/phase_z2_pipeline.py` = `No matches found` | inverse direction `src/renderer.py` and `src/block_selector.py` have zero references to `phase_z2`; verified via `Grep phase_z2 src/renderer.py` = 0 and `Grep phase_z2 src/block_selector.py` = 0 | `#13` (build-time frame preview generator, scripts/ only); `#14` (slide-base iframe mode -- Phase Z only); `#16` (verification utility for Phase Z, no Phase R coupling); `#17` (AI carve-out, design-only no R coupling); `#18` (SVG gap report doc-only) | AGREE -- boundary clean both directions for the closed-issue scope. No Phase R' regression observed; Phase Z additions stay in `phase_z2_*.py` modules | `Grep` results above |
+| C6 | family templates count vs frame_contracts.yaml count (= 11 in tracked baseline); docs cite "family = 13" including 2 in-progress untracked files | `templates/phase_z2/families/*.html` tracked = 11 (`git ls-files templates/phase_z2/families/` produces 11 entries); `templates/phase_z2/catalog/frame_contracts.yaml` top-level entries = 11 (`grep -cE "^[a-z_]+:$"` = 11) | `src/phase_z2_mapper.py` PAYLOAD_BUILDERS / ITEM_PARSERS / COLUMN_BODY_PARSERS registries (mapper.py:10-16 docstring + 262 / 306 / 332 / 369 / 414 / 424 / 471 registry sites); render surface `templates/phase_z2/families/*.html` | `#4` (16 frame_partials + F17 paired_rows_4x2 schema + theme); `#5` (V4 fallback candidate pool dedup); `#13` (frame preview generator); `#18` (SVG gap report cites `families/*.html (13)`) | AGREE FOR TRACKED BASELINE -- 11 tracked family templates <-> 11 frame_contracts entries. SURFACE NOTE : 2 untracked WIP family templates (`app_sw_package_vs_solution.html`, `pre_construction_model_info_stacked.html`) exist on disk but are NOT in any closed issue and NOT yet contracted. IMP-18 doc "families/*.html (13)" is forward-looking, includes the 2 WIP files. No closed-issue contract is broken; documentation drift is recorded as Section 10 follow-up candidate F-2 | `git ls-files templates/phase_z2/families/` = 11; `ls templates/phase_z2/families/*.html` = 13 (2 untracked); `grep -cE "^[a-z_]+:$" frame_contracts.yaml` = 11 |
+
+### 5.3 Cross-issue adjacency continuity (Section 3 pairs re-verified)
+
+| Section 3 adjacent pair | invariant carrying the contract | live continuity verdict |
+|---|---|---|
+| `#2` Step 2 normalize -> `#3` Step 3 content_object input | C1 (debug.json `step02_*` + content_objects) | OK -- additive payload, schema preserved via `_write_step_artifact` |
+| `#3` content_object schema -> `#8` sub_sections schema | C1 + C4 (alias resolver state) | OK -- alias resolver covers 4 lookup sites (REPORT Section 3 row #8 evidence) |
+| `#4` catalog -> `#5` V4 fallback dedup | C3 + C6 (frame count + classifier consumer) | OK -- candidates[0] backward-compat verified by `tests/test_catalog_invariant.py` (REPORT Section 3 row #5) |
+| `#4` catalog -> `#10 / #11` `min_height_px` exposure | C1 + C6 | OK -- `min_height_px` is additive read-only field |
+| `#9` layout vocabulary -> `#12` retry donor selection | C3 + C4 (Step 17 cascade) | OK -- multi-donor cross-zone state lives inside Step 17 retry; spacing direction matches `feedback_phase_z_spacing_direction` (no common-shrink) |
+| `#9` layout vocabulary -> `#11` Step 9 min_height v4-all-judgments | C6 | OK -- guarded by `tests/test_phase_z2_step9_v4_all_judgments_min_height.py` |
+| `#45 + #46` Step 14 events -> `#47` Step 15 classifier -> Step 16 router | C2 + C3 + C4 | OK -- live trace `image_events` / `table_events` enter classifier at `classifier.py:429 / 453`, flow into router at `router.py:142` |
+| `#48` debug.json event surfacing -> `#21` (open, excluded) | C1 | OK for closed scope -- open consumer `#21` is outside audit window |
+| `#17` AI carve-out -> `#5 / #4` activation 3-cond AND gate | C5 (boundary not yet crossed) | OK -- gate is *closed* (`User GO AND B4 frame_selection evidence AND IMP-04/05 live`); no normal-path AI active |
+
+### 5.4 Axis 3 summary
+
+- 6 invariant categories evaluated. All AGREE for the closed-issue audit scope.
+- 2 surface notes recorded as Section 10 follow-up candidates :
+  - **F-1** : issue body cites `src/phase_z2_mapper.py` for invariant C3 (`fit_classification`), but the live producer is `src/phase_z2_classifier.py`. Record-keeping correction needed in any future audit charter, not a code conflict. RESOLVED via IMP-53 (2026-05-19)
+  - **F-2** : 2 untracked family templates exist on disk without `frame_contracts.yaml` entries; IMP-18 doc cites "families/*.html (13)" forward-looking. Tracked baseline (11 / 11) is consistent. Contract drift is *not* present for any closed issue; the WIP delta belongs to open work. RESOLVED via #52 option (c) (2026-05-19) -- WIP allowlist captured in `templates/phase_z2/families/_WIP_FILES.md`; tracked + contracted baseline unchanged at 11/11; promote / remove gated on #42.
+- 1 documented partial recorded :
+  - Step 21 `_write_step_artifact` at `pipeline.py:4772` carries `step_status="partial"` with note `region marker partial 미주입 -- Step 21 ⚠ partial`. This is *self-honest acknowledged* per `feedback_artifact_status_naming`; no cross-issue conflict.
+- Phase R' <-> Phase Z boundary clean both directions for the 22 closed issues.
+- 0 Blocker findings in Axis 3.
+
+### 5.5 Live-grep re-verification stamp (audit date 2026-05-19)
+
+All numerical claims in Section 5.2 re-verified against live source on the audit date. Commands and results :
+
+| Claim | Command | Live result | Status |
+|---|---|---|---|
+| C1 producer + consumer count | `Grep _write_step_artifact src/phase_z2_pipeline.py -n` | 1 definition (`pipeline.py:2593`) + 24 call sites at lines `2782, 2812, 2857, 2934, 3184, 3619, 3652, 3674, 3793, 3804, 3826, 3881, 4056, 4308, 4481, 4507, 4527, 4549, 4658, 4677, 4688, 4706, 4761, 4780` = 25 total occurrences | MATCH (Section 5.2 C1 row already lists all 24 call sites) |
+| C2 consumer scan | `Grep visual_check_passed src` | 14 hits across 3 files (`classifier.py:5`, `pipeline.py:6`, `router.py:3`) | MATCH (Section 5.2 C2 row says "14 hits across `classifier.py` + `router.py` + `pipeline.py`") |
+| C3 consumer scan | `Grep fit_classification src` | 30 hits across 4 files (`classifier.py:3`, `pipeline.py:20`, `retry.py:2`, `router.py:5`) | MATCH (Section 5.2 C3 row says "30 total occurrences across 4 files") |
+| C6 family templates -- tracked | `git ls-files templates/phase_z2/families/` | 11 entries | MATCH (Section 5.2 C6 row says "tracked = 11") |
+| C6 family templates -- on disk | `ls templates/phase_z2/families/*.html | wc -l` | 13 files (11 tracked + 2 WIP untracked : `app_sw_package_vs_solution.html`, `pre_construction_model_info_stacked.html`) | MATCH (Section 5.2 C6 row + F-2 follow-up candidate) |
+| C6 frame_contracts entries | `grep -cE "^[a-z_]+:$" templates/phase_z2/catalog/frame_contracts.yaml` | 11 | MATCH (Section 5.2 C6 row says "= 11") |
+
+No discrepancy between Section 5.2 grep evidence and live code. Re-verification re-confirms u3 Axis 3 conclusion : 6 invariant categories all AGREE; 2 record-keeping follow-up candidates (F-1, F-2); 1 documented partial (Step 21); 0 Blocker findings.
+
+---
+
+## Section 6. Axis 4 -- Backlog vs code reality status matrix
+
+**Method** : per closed issue, compare (a) `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` status column at audit time (live read 2026-05-19), (b) live src/ + templates/ + tests/ + docs/ evidence (grep hits + file existence), (c) the audit-allowed status enum `implemented | documented (deferred) | pending`, (d) mismatch flag.
+
+**Per issue-body rule set** :
+- `implemented` -> live grep on `src/**` MUST show wired call site(s); not just a single declaration with no consumer.
+- `documented (deferred)` -> live grep on `src/**` MUST NOT show a production code path that assumes the feature is active (carve-out only).
+- `pending` -> live grep on `src/**` MUST NOT show wired implementation (or evidence shows incomplete).
+- `pending -> documented` flip -> reason cited in backlog row must match what `src/**` actually contains.
+
+### 6.1 Backlog status legend (live read on audit date)
+
+| backlog status | IMP rows under audit | meaning |
+|---|---|---|
+| `documented` | `IMP-18` (1 row) | doc-only carve-out, no production path |
+| `pending` | `IMP-02` through `IMP-17` (16 rows) | backlog status column has NOT been flipped, despite Gitea issue being closed |
+| (no backlog row) | `#45 / #46 / #47 / #48 / #49` (5 rows) | execution children of `#15`; backlog tracks the parent `IMP-15` only -- and `IMP-15` is itself still marked `pending` in §2 row |
+
+**Headline Axis 4 finding** : `PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` status column is **stale across the entire closed-issue audit scope** -- 16 of 22 audited issues are flagged `BACKLOG_STALE` (backlog `pending` vs Gitea closed + live code wired); additionally 5 of 22 carry `NO_BACKLOG_ROW` for the `#15` execution children (`#45-#49`), and only 1 of 22 (`#18`) is `AGREE`. Reconciliation: 16 `BACKLOG_STALE` + 5 `NO_BACKLOG_ROW` + 1 `AGREE` = 22 (matches Section 6.3 summary and the 15+1=16 flip plan in §6.3 follow-up reference). This is documentation drift, not a code-side contract conflict; recorded as Section 10 follow-up candidate `F-3`.
+
+### 6.2 Axis 4 -- 22 row backlog vs code reality matrix
+
+Status meaning (audit verdict column) :
+- `implemented_live` = backlog should be flipped to `implemented`; live src/ wiring proves it (grep evidence below).
+- `documented_live` = backlog `documented` matches code reality (doc-only carve-out; no prod path).
+- `child_of_parent` = no backlog row by design (execution child of parent IMP-15); status tracked via parent row.
+
+Mismatch flag :
+- `BACKLOG_STALE` = backlog says `pending` but code is wired live. Documentation drift only; no code conflict.
+- `AGREE` = backlog status matches live code reality.
+- `NO_BACKLOG_ROW` = execution child, child not represented in backlog; not an error, but parent `IMP-15` row is itself stale.
+
+| # | issue (title) | backlog status (live read) | audit verdict | mismatch flag | live grep evidence |
+|---|---|---|---|---|---|
+| 1 | `#2` IMP-02 A-1 Stage 0 normalize chained adapter | `pending` (§1 row 2) | `implemented_live` | BACKLOG_STALE | `Grep "normalize_mdx_content\|extract_major_sections\|extract_conclusion_text" src/` = 24 hits across 6 files (`mdx_normalizer.py`, `phase_z2_content_extractor.py`, `phase_z2_pipeline.py` 9 hits, `pipeline.py`, `pipeline_v2.py`, `section_parser.py`); commit `bac13c0` +165/-3 |
+| 2 | `#3` IMP-03 A-1 popup/image/table trace | `pending` (§1 row 3) | `implemented_live` | BACKLOG_STALE | `src/phase_z2_content_extractor.py` file exists (Glob hit); commit `fc3f7d8` |
+| 3 | `#4` IMP-04 A-2 catalog expansion | `pending` (§1 row 4) | `implemented_live` | BACKLOG_STALE | `git ls-files templates/phase_z2/families/` = 11 tracked; `frame_contracts.yaml` top-level entries = 11; commit `73a98b8` corrects F17 schema; matches Axis 3 C6 |
+| 4 | `#5` IMP-05 A-5 V4 fallback | `pending` (§1 row 5) | `implemented_live` | BACKLOG_STALE | `Grep "PASS_WITH_FALLBACK\|v4_fallback\|fallback_selection" src/` = 28 hits in `phase_z2_pipeline.py`; commits `15c5b9a`, `21476ae`, `23d1b25` |
+| 5 | `#6` IMP-06 B-1 Zone-section override | `pending` (§1 row 6) | `implemented_live` | BACKLOG_STALE | `Grep "replaced_auto_unit\|render_records\|zone_section_override" src/` = 33 hits in `phase_z2_pipeline.py`; commits `d596fab` / `b81e564` / `1f15495` / `52ccb7f` |
+| 6 | `#7` IMP-07 B-2 edited HTML to MDX reverse path | `pending` (§1 row 7) | `implemented_live` | BACKLOG_STALE | `Front/client/src/services/designAgentApi.ts` file exists (Glob hit); commit `0f0d3fa` |
+| 7 | `#8` IMP-08 B-3 sub-section drag-drop | `pending` (§1 row 8) | `implemented_live` | BACKLOG_STALE | `Grep "sub_sections\|sub_section_id\|subsection_alias" src/` = 14 hits across `block_assembler.py` (12) + `phase_z2_pipeline.py` (2); commits `a422d72` / `5191aca` / `ab2764c` / `8f6cffc` |
+| 8 | `#9` IMP-09 B-4 non-default layout zone-geometry | `pending` (§1 row 9) | `implemented_live` | BACKLOG_STALE | `Grep "build_layout_css\|preset_layout\|zone_geometry" src/` = 11 hits in `phase_z2_pipeline.py`; commits `201099e` / `1fb9732` |
+| 9 | `#10` IMP-10 D-1 filtered_section_reasons UI | `pending` (§1 row 10) | `implemented_live` | BACKLOG_STALE | `Grep "filtered_section_reasons" Front/` = 4 hits (`Home.tsx`, `designAgentApi.ts`); + `src/phase_z2_pipeline.py` 6 hits (read-only consumer); commit `0fb168b` +45 lines |
+| 10 | `#11` IMP-11 D-2 Frame min_height display | `pending` (§1 row 11) | `implemented_live` | BACKLOG_STALE | `Grep "min_height_px" src/` = 50 hits across 6 files (`block_reference.py`, `block_selector.py`, `fit_verifier.py`, `phase_z2_pipeline.py` 21 hits, `phase_z2_retry.py`, `space_allocator.py`); + Front/ 21 hits across 7 files including `SlideCanvas.tsx` (8); commit `a79bd8b` |
+| 11 | `#12` IMP-12 Step 16/17 retry refinement | `pending` (§2 row 12 IMP-12) | `implemented_live` | BACKLOG_STALE | `Grep "phase_z2_failure_router\|phase_z2_retry\|redistribute\|font_compression" src/` = 63 hits across 7 files (incl. `phase_z2_failure_router.py` 17, `phase_z2_retry.py` 16, `phase_z2_router.py` 6, `phase_z2_pipeline.py` 17); commit `56619a0` |
+| 12 | `#13` IMP-13 A-3 frame preview consistency | `pending` (§2 row 13) | `implemented_live` | BACKLOG_STALE | `scripts/generate_frame_previews.py` file exists (Glob hit); build-time only (scripts/, not runtime src/) -- matches `documented (deferred)` semantics for *runtime* path but verdict here = implemented_live because the script is the deliverable per issue body; commit `7d5639a` |
+| 13 | `#14` IMP-14 A-4 slide-base iframe mode | `pending` (§2 row 14) | `implemented_live` | BACKLOG_STALE | `templates/phase_z2/slide_base.html` file exists (Glob hit); `Grep "slide_base\|embedded_mode\|standalone_mode" src/` = 25 hits across 5 files (incl. `block_assembler.py` 8, `phase_z2_pipeline.py` 11); commit `7a52ceb` |
+| 14 | `#15` IMP-15 Step 14 visual_check reinforcement (PARENT) | `pending` (§2 row 15) | `implemented_live` (via children `#45-#49`) | BACKLOG_STALE | parent integration only; live code attribution belongs to child rows below (Stage 1 de-dup rule). All 4 child SHAs present in repo (`e9b3d2e` / `2827622` / `535c484` / `614c533`) |
+| 15 | `#16` IMP-16 B-2 verification helper axis | `pending` (§2 row 16) | `implemented_live` | BACKLOG_STALE | `src/phase_z2_verification_utils.py` file exists (Glob hit); `docs/architecture/IMP-16-U2-WIRING-DESIGN.md` exists; commit `23ba8b6` |
+| 16 | `#17` IMP-17 AI repair fallback infra (carve-out) | `pending` (§2 row 17) | `documented_live` | BACKLOG_STALE (status semantics) | `docs/architecture/IMP-17-CARVE-OUT.md` file exists (Glob hit); src/ runtime AI = 0 (verified Axis 3 C5 boundary); 3-cond AND gate closed; commit `e10ec36` -- 1 line in `src/phase_z2_pipeline.py` is comment anchor only, not a runtime path. Mismatch FLAG semantics : backlog says `pending`, but reality = `documented (deferred)`. The flag is BACKLOG_STALE *with status-class shift*, distinguished from rows above. |
+| 17 | `#18` IMP-18 I3 SVG coordinate reinforcement | `documented` (§2 row 18) | `documented_live` | AGREE | `docs/architecture/IMP-18-SVG-GAP-REPORT.md` file exists (Glob hit); pure doc carve-out; no `src/**` touched; commit `cbbc163` -- the ONLY closed audited issue whose backlog status already reflects code reality |
+| 18 | `#45` (`#15` execution-1) image_aspect_mismatch detection | no backlog row | `child_of_parent` | NO_BACKLOG_ROW | `tests/phase_z2/test_phase_z2_step14_image_check.py` file exists (Glob hit); `Grep "image_aspect_mismatch" src/` = 6 hits across `phase_z2_classifier.py` (2 : lines 426, 435) + `phase_z2_pipeline.py` (4 : lines 131, 2236, 2367, 4517); commit `e9b3d2e` |
+| 19 | `#46` (`#15` execution-2) table_self_overflow detection | no backlog row | `child_of_parent` | NO_BACKLOG_ROW | `tests/phase_z2/test_phase_z2_step14_table_check.py` file exists (Glob hit); `Grep "table_self_overflow" src/` = 3 hits all in `phase_z2_pipeline.py` (lines 136, 2282, 2386); commit `2827622` (commit-message label drift `feat(IMP-16)` flagged in Section 3 row 19) |
+| 20 | `#47` (`#15` execution-3) classifier consumer (image + table) | no backlog row | `child_of_parent` | NO_BACKLOG_ROW | `tests/phase_z2/test_phase_z2_visual_classifier.py` file exists (Glob hit); `Grep "classify_visual_runtime_check\|CONTENT_TYPE_PATTERNS" src/` = 8 hits across `phase_z2_classifier.py` (4) + `phase_z2_pipeline.py` (4); commit `535c484` |
+| 21 | `#48` (`#15` execution-4) debug.json event surfacing + spec doc + regression | no backlog row | `child_of_parent` | NO_BACKLOG_ROW | `Grep "step21_debug_index\|step21_debug" src/` = 1 hit (`phase_z2_pipeline.py`); `docs/architecture/PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md` has taxonomy row (Section 3 row 21 evidence); commit `614c533`; Axis 3 C4 confirms `image_events` / `table_events` end-to-end |
+| 22 | `#49` (`#15` execution-5) final integration + parent close | no backlog row | `child_of_parent` (verification-only) | NO_BACKLOG_ROW + close-timestamp anomaly (recorded Section 3 row 22) | verification-only per `#15` body; no new SHA; re-uses `614c533` evidence; no fresh grep needed |
+
+### 6.3 Axis 4 summary
+
+- **BACKLOG_STALE** rows : `#2 #3 #4 #5 #6 #7 #8 #9 #10 #11 #12 #13 #14 #15 #16 #17` = 16 rows (status column reads `pending` but live code is wired; for `#17` the right target status is `documented (deferred)` while for the other 15 it is `implemented`).
+- **AGREE** rows : `#18` = 1 row (the only issue whose backlog status truthfully reflects code reality).
+- **NO_BACKLOG_ROW** rows : `#45 #46 #47 #48 #49` = 5 rows (execution children, by-design no backlog row; parent `IMP-15` row exists but is itself BACKLOG_STALE).
+- **Total** : 16 + 1 + 5 = 22 rows (matches 22 closed issues under audit).
+- **Implementation-vs-documented split** (audit verdict, ignoring backlog wording) :
+  - `implemented_live` (runtime path wired) : `#2 #3 #4 #5 #6 #7 #8 #9 #10 #11 #12 #13 #14 #15(via children) #16` = 15 rows
+  - `documented_live` (doc-only / design-only carve-out, no runtime path) : `#17 #18` = 2 rows
+  - `child_of_parent` (no backlog row, attribution via parent) : `#45-#49` = 5 rows
+- **0 Blocker findings in Axis 4.** No closed issue is `pending` *and* unimplemented; the only mismatches are documentation drift in the backlog status column.
+- **Cross-axis consistency** :
+  - Axis 3 C6 frame count `11 tracked / 11 contract entries / 13 on disk (2 WIP)` matches the IMP-04 evidence in Axis 4 row 3 (BACKLOG_STALE but live code present).
+  - Axis 3 C5 boundary (Phase R' <-> Phase Z) clean both ways re-confirms `#17 #18` as documented_live (no R' leak).
+  - Axis 1 (Section 3) `Warning` rows `#6 #12 #15 #46 #49` are all still `implemented_live` in Axis 4 -- the warnings are about *blast radius* and *administrative drift*, not implementation absence.
+- **Follow-up candidate F-3** (Section 10) : `PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` status column needs a sweep to flip 15 rows `pending` -> `implemented`, 1 row `pending` -> `documented (deferred)` for `IMP-17`, and either add child-row stubs for `#45-#49` or add a footnote on the `IMP-15` row pointing at the 5 execution children. This is a single-file documentation-only edit; orthogonal to source-code Stage 3 work; safe under audit-only scope (deferred to a separate follow-up issue, NOT this audit's u7 backlog row).
+
+---
+
+## Section 7. Representative pipeline runs
+
+**Method** : run the Phase Z runtime entry (`python -m src.phase_z2_pipeline <mdx_path> <run_id>`) on the two locked samples (`samples/mdx_batch/03.mdx` smoke + `samples/mdx_batch/04.mdx` details+images). Per run capture (from `data/runs/<run_id>/phase_z2/debug.json`) : top-level keys, `slide_status.visual_check_passed`, `slide_status.overall`, zone count, per-zone frame template + slot keys + slot key count, `slide_status.visual_fail_reasons`, `slide_status.filtered_section_reasons`, `selection_paths`, `image_events` / `table_events` count. Compare invariants across both runs.
+
+**Audit date** : 2026-05-19. Both runs are fresh on this audit pass (run_ids `audit50_run_03_smoke` + `audit50_run_04_details`).
+
+### 7.1 Run #1 -- `samples/mdx_batch/03.mdx` (smoke baseline)
+
+| field | value |
+|---|---|
+| `run_id` | `audit50_run_03_smoke` |
+| MDX title parsed | `DX 실행 체계 구축 방안` |
+| sections parsed | 2 (`03-1`, `03-2`) |
+| layout preset | `horizontal-2` (composition v0 count-based) |
+| mode | `composition_v0_layout_8preset` |
+| debug.json top-level keys | `composition_planner_debug`, `fit_classification`, `image_events`, `layout_css`, `layout_preset`, `mode`, `mode_note`, `mvp1_allowed_statuses`, `retry_trace`, `router_decision`, `slide_status`, `table_events`, `v4_label_to_phase_z_status`, `v4_source`, `visual_runtime_check`, `zone_geometries_px`, `zones` (17 keys) |
+| `slide_status.visual_check_passed` | `True` |
+| `slide_status.full_mdx_coverage` | `True` |
+| `slide_status.rendered` | `True` |
+| `slide_status.overall` | `PASS` |
+| `slide_status.visual_fail_reasons` | `[]` (empty) |
+| `slide_status.filtered_section_reasons` | `[]` (empty) |
+| `slide_status.fallback_selection_count` | `0` |
+| `fit_classification.visual_check_passed` | `True` (mirrors slide_status) |
+| `fit_classification.classifications` | `[]` |
+| `fit_classification.categories_seen` | `[]` |
+| `router_decision.action` | `None` (no retry path triggered) |
+| `image_events` count | `0` |
+| `table_events` count | `0` |
+| zone count | `2` |
+| zone[0] (top) | template `three_parallel_requirements` (frame 13), contract `three_parallel_requirements`, label `use_as_is`, slot keys `['pillars', 'title']` (2), sections `['03-1']`, `height_px=228`, `width_px=1180` |
+| zone[1] (bottom) | template `process_product_two_way` (frame 29), contract `process_product_two_way`, label `use_as_is`, slot keys `['banner_left', 'banner_right', 'process', 'product', 'title']` (5), sections `['03-2']`, `height_px=343`, `width_px=1180` |
+| `selection_paths` | both `rank_1` (no fallback) |
+| fail / overflow events | none |
+
+### 7.2 Run #2 -- `samples/mdx_batch/04.mdx` (details + images)
+
+| field | value |
+|---|---|
+| `run_id` | `audit50_run_04_details` |
+| MDX title parsed | `DX 지연 요인` |
+| sections parsed | 2 (`04-1`, `04-2`) |
+| sections aligned | 3 (`04-1`, `04-2-sub-1`, `04-2-sub-2`) -- IMP-08 sub_section schema active |
+| layout preset | `single` (composition v0 count-based; only 1 unit survived filtering) |
+| mode | `composition_v0_layout_8preset` |
+| debug.json top-level keys | identical 17 keys as Run #1 (`composition_planner_debug`, `fit_classification`, `image_events`, `layout_css`, `layout_preset`, `mode`, `mode_note`, `mvp1_allowed_statuses`, `retry_trace`, `router_decision`, `slide_status`, `table_events`, `v4_label_to_phase_z_status`, `v4_source`, `visual_runtime_check`, `zone_geometries_px`, `zones`) |
+| `slide_status.visual_check_passed` | `True` |
+| `slide_status.full_mdx_coverage` | `False` |
+| `slide_status.rendered` | `True` (partial artifact -- viable units only) |
+| `slide_status.overall` | `PARTIAL_COVERAGE` |
+| `slide_status.visual_fail_reasons` | `[]` (visual side OK; coverage failure is upstream of visual_check) |
+| `slide_status.filtered_section_reasons` | `[]` (filtering recorded via `selection_paths` chain_exhausted / no_v4_candidate, not via `filtered_section_reasons`) |
+| `slide_status.fallback_selection_count` | `0` |
+| `fit_classification.visual_check_passed` | `True` |
+| `fit_classification.classifications` | `[]` |
+| `fit_classification.categories_seen` | `[]` |
+| `router_decision.action` | `None` |
+| `image_events` count | `0` |
+| `table_events` count | `0` |
+| zone count | `1` (single preset) |
+| zone[0] (primary) | template `bim_issues_quadrant_four` (frame 16), contract `bim_issues_quadrant_four`, label `light_edit`, slot keys `['quadrant_1_body', 'quadrant_1_label', 'quadrant_2_body', 'quadrant_2_label', 'quadrant_3_body', 'quadrant_3_label', 'quadrant_4_body', 'quadrant_4_label', 'title']` (9), sections `['04-2-sub-2']`, `height_px=585`, `width_px=1180` |
+| `selection_paths` | `04-1=chain_exhausted`, `04-2-sub-1=chain_exhausted`, `04-2-sub-2=rank_1`, `04-2=no_v4_candidate` |
+| fail / overflow events | none |
+
+### 7.3 Cross-run invariants
+
+| invariant | run #1 (03.mdx) | run #2 (04.mdx) | verdict |
+|---|---|---|---|
+| debug.json top-level key set | 17 keys (above) | identical 17 keys | AGREE -- Step 21 schema stable across both runs (Axis 3 C1) |
+| `slide_status` schema keys | 19 keys (`visual_check_passed`, `full_mdx_coverage`, `rendered`, `overall`, `visual_fail_reasons`, `filtered_section_ids`, `filtered_section_reasons`, `aligned_section_ids`, `covered_section_ids`, `adapter_needed_count`, `adapter_needed_units`, `content_truncated_count`, `content_truncated_units`, `fallback_selection_count`, `fallback_selections`, `fallback_used`, `selection_path`, `selection_paths`, `note`) | identical 19 keys | AGREE -- slide_status surface stable (Axis 3 C2 + C4) |
+| `fit_classification` shape | `{visual_check_passed, classifications, summary, categories_seen, ...}` -- matches Axis 3 C3 row | identical shape | AGREE -- classifier output schema invariant |
+| `visual_check_passed` semantic | `True` AND `classifications=[]` -> overall `PASS` | `True` AND `classifications=[]` AND `full_mdx_coverage=False` -> overall `PARTIAL_COVERAGE` | AGREE -- visual side passing under both runs; `PARTIAL_COVERAGE` is composition-planner side (upstream of Step 14), so visual_check_passed does NOT contradict overall status (Axis 3 C2 verdict re-confirmed) |
+| zone count vs layout preset | `horizontal-2` -> 2 zones (top + bottom) | `single` -> 1 zone (primary) | AGREE -- preset-to-zone arity matches IMP-09 B-4 vocabulary (Axis 1 row 8) |
+| frame contract resolution | both zones resolved to a contract id (rank_1 path) | only 1 of 4 selection paths resolved (3 `chain_exhausted` / `no_v4_candidate`) | DIFF EXPECTED -- 04.mdx exhibits v4 candidate gap; this is the composition-planner maturity gap (not in any closed-issue scope). Not a contract conflict. |
+| `image_events` / `table_events` arity | both = 0 | both = 0 | AGREE -- neither sample triggers Step 14 image/table self-overflow; `#45` `image_aspect_mismatch` and `#46` `table_self_overflow` event-arrays exist in the schema and are *correctly empty* when no overflow is detected |
+| router action triggered | `None` | `None` | AGREE -- Step 16 router is dormant when classifications=[] (Axis 3 C3 verdict re-confirmed; `#12` retry cascade not exercised by these samples) |
+| pipeline final banner | `PASS` (full MDX coverage + visual OK) | `PARTIAL_COVERAGE` (visual OK + composition-planner filter) | self-honest status naming per [[feedback_artifact_status_naming]] |
+
+### 7.4 Run-level findings
+
+- Both runs pass the visual_check axis (Axis 3 C2 contract). `visual_check_passed=True` agrees between `fit_classification` and `slide_status` mirror in both runs.
+- 04.mdx `PARTIAL_COVERAGE` is a composition-planner side filter (3 sections drop to `chain_exhausted` / `no_v4_candidate` before reaching Step 14). This is NOT an audit Blocker because (a) no closed issue under audit targets composition-planner coverage, (b) the status field is self-honestly named `PARTIAL_COVERAGE` rather than misnamed `PASS` (matches [[feedback_artifact_status_naming]]).
+- Step 21 `debug.json` writer surfaces a stable 17-key top-level surface across both runs; Axis 3 C1 invariant re-confirmed at runtime.
+- Zero Blocker findings in Section 7.
+
+---
+
+## Section 8. Anti-hardcoding grep checklist
+
+**Method** : run the 6 anti-hardcoding patterns enumerated in the Issue #50 body. For each, capture the live hit set, classify hits (Phase Z scope vs. legacy Phase R'/Q out-of-scope vs. docstring/comment vs. test fixture), then return a verdict. Raw output preserved at `D:\ad-hoc\kei\design_agent\.orchestrator\tmp\50_grep_checklist_raw.txt` (evidence-only, not staged for commit per Stage 3 directive).
+
+**Audit date** : 2026-05-19. Searched against tracked source on this date.
+
+### 8.1 Checklist
+
+| # | pattern (issue body) | expected | live hit count (src/) | hit classification | verdict |
+|---|---|---|---|---|---|
+| G1 | `grep -E 'if .* == ["'\\''].*\.mdx' src/` | 0 hits | 0 | none | PASS |
+| G2 | `grep -E 'OVERRIDES\s*=\s*\{' src/` | each match sample-agnostic | 0 | none | PASS (vacuously sample-agnostic) |
+| G3 | `grep -E '재구성\|건설산업 DX\|BIM' src/` -- sample text leak | 0 hits | 31 source hits across 14 `.py` files (binary `.pyc` matches ignored) | (a) 20 hits in legacy Phase R'/Q files (`block_assembler_b2.py` 1, `block_matcher_tfidf.py` 1, `block_reference.py` 3, `content_editor.py` 3, `design_director.py` 2, `design_tokens.py` 1, `fit_verifier.py` 1, `frame_extractor.py` 1, `kei_client.py` 4, `pipeline.py` 3) -- pre-Phase-Z; not in audit window; (b) 11 hits in Phase Z files (`phase_z2_content_extractor.py` 7 -- all inside `if __name__ == "__main__"` self-test data blocks at lines 466/493/511/556/565/573/591; `phase_z2_failure_router.py:123` 1 -- internal taxonomy string `"topology 부터 재구성. frame_reselect 는 그 다음 단계"`; `phase_z2_mapper.py:519/529` 2 -- docstring examples; `phase_z2_retry.py:59` 1 -- docstring). Per-file count sum = 20 + 11 = 31, matching the live total. | PASS for the audit scope -- **0 closed-issue (#2-#18 + #45-#49)** introduces new sample-specific hardcoded BIM/재구성/건설산업 string literals into runtime code paths. All 11 Phase Z hits are docstring/taxonomy/self-test fixtures, none injected into runtime contracts. Legacy 20 hits are out of audit window. Recorded as Section 10 follow-up candidate `F-4` for future cleanup (doc-only, optional). |
+| G4 | `grep -E 'height\s*=\s*720\|aspect\s*=\s*0\.5' src/` -- magic literal pinning | 0 hits | 0 | none | PASS |
+| G5 | sample paths come from CLI args / config, not hardcoded | sample-agnostic | 4 occurrences across 2 files (`src/block_assembler.py:1390/1393` + `src/image_utils.py:62/65`) | all 4 hits use `samples/mdx_batch` as one of several **generic asset search directories** alongside `samples/images` (image asset discovery fallback). The directory is treated as a discovery namespace, not as a path to a specific MDX file. CLI entry (`src/phase_z2_pipeline.py:4861`) takes `mdx_path` as positional arg -- no hardcoded MDX path on the runtime entry. | PASS -- sample-agnostic asset discovery default; not a per-sample pin. |
+| G6 | `tests/` : sample-specific fixtures only under `tests/fixtures/`, not in production pipeline | fixtures isolated | `tests/fixtures/` directory does not exist; closest hits = `tests/phase_z2/test_pz2_vu_integration.py:6, 82` referencing `samples/mdx_batch/02.mdx` as smoke-coverage MDX | the references in `test_pz2_vu_integration.py` are inside a verification-utility integration test (`#16` IMP-16 scope). The test file is named with the test prefix and lives in `tests/phase_z2/`, so pytest discovery treats it as a test, not as a production module. No production pipeline file imports a sample MDX path literal. | PASS WITH NOTE -- no `tests/fixtures/` directory exists today; the existing integration tests already keep sample references inside `tests/phase_z2/test_*.py`, which discharges the spirit of the rule. Optional follow-up: formalize a `tests/fixtures/` directory if sample inventory grows. Recorded as Section 10 follow-up candidate `F-5` (low priority, doc-only). |
+
+### 8.2 Anti-hardcoding verdict
+
+- 4 patterns PASS cleanly with 0 hits (G1, G2, G4) and 1 PASS with sample-agnostic hits (G5).
+- 1 pattern PASS-for-audit-scope with classification (G3) : 11 Phase Z hits are all docstrings/taxonomy/self-test fixtures; 20 legacy hits are out of the 22-closed-issue audit window. Per-file counts sum to 31, matching the live grep total. No closed issue introduces new hardcoded sample text into a runtime code path.
+- 1 pattern PASS WITH NOTE (G6) : `tests/fixtures/` directory not yet established; existing integration test references stay inside `tests/phase_z2/`. Already aligned with the spirit of the rule.
+- **0 Blocker findings in Section 8.**
+- Cross-axis : the F-4 / F-5 follow-up candidates are doc-only optional cleanup; they do not alter any closed-issue contract.
+
+---
+
+## Section 9. Final decision
+
+**Decision** : **CONDITIONAL GO for #19**.
+
+### 9.1 Summary across all 4 audit axes + supporting sections
+
+| section | axis | Blocker | Warning | OK | follow-up candidates |
+|---|---|---|---|---|---|
+| §3 | Axis 1 -- scope myopia | 0 | 5 (`#6 #12 #15 #46 #49`) | 17 | none Blocker; warnings are blast-radius + administrative drift |
+| §4 + MATRIX.md | Axis 2 -- 22 x 22 pipeline matrix | 0 | (9 hotspot steps, 2 expected-empty cols) | 22 issues mapped | none Blocker; hotspots match expected Step 14 / 21 attention |
+| §5 | Axis 3 -- cross-issue conflict (6 invariants) | 0 | 0 | 6 categories AGREE | F-1 (body cites mapper.py; live producer is classifier.py for `fit_classification`); F-2 (13 family templates on disk vs. 11 tracked / contracted -- 2 WIP outside any closed issue) |
+| §6 | Axis 4 -- backlog vs code reality | 0 | -- | 1 AGREE, 16 BACKLOG_STALE (doc drift), 5 NO_BACKLOG_ROW (by design for `#45-#49`) | F-3 (backlog status sweep : flip 15 rows `pending` -> `implemented`, 1 row `pending` -> `documented (deferred)` for IMP-17, footnote `IMP-15` row with 5 children) |
+| §7 | representative runs (03.mdx + 04.mdx) | 0 | -- | both runs visual_check_passed = True; debug.json schema stable; 04.mdx PARTIAL_COVERAGE is composition-planner side (no audit-window contract conflict) | none new |
+| §8 | grep checklist (6 patterns from issue body) | 0 | -- | G1/G2/G4/G5 PASS; G3/G6 PASS WITH NOTE | F-4 (legacy Phase R'/Q BIM literals -- optional cleanup); F-5 (formalize `tests/fixtures/` -- optional) |
+| §2 | baseline pytest | -- | -- | 303 passed BEFORE + 303 passed AFTER audit | none |
+
+### 9.2 Blocker tally
+
+- **0 Blocker** findings across all four axes and all supporting sections.
+- 5 Warning rows in §3 are about blast radius (`#6 #12`), administrative commit-label drift (`#46`), and parent/child close-timestamp anomaly (`#15 #49`). None of them indicate broken code contracts.
+- All BACKLOG_STALE rows in §6 are documentation drift, not implementation absence. Live grep on `src/**` confirms each closed issue is wired (or carved-out as designed for `#17 #18`).
+- 5 follow-up candidates (F-1 .. F-5) are all doc-only. None require source code changes.
+
+### 9.3 Why CONDITIONAL GO, not unconditional GO
+
+Audit found zero Blocker, but the conditions for upgrading to unconditional GO are not met because:
+
+1. **F-3 (backlog sweep)** is the largest doc-drift surface (16 of 22 audited rows mislabeled). Issue #19 will read the backlog when scoping next-step coverage; running #19 against a stale backlog risks a planner who treats already-implemented features as still pending. The F-3 follow-up should be filed and merged before -- or at minimum in parallel with -- #19 Stage 2 planning.
+2. **F-2 (family template count drift)** matters if #19 touches the catalog / `frame_contracts.yaml` (likely). The audit confirms 11 tracked entries are consistent today, but #19 should reconcile the 2 WIP files (`app_sw_package_vs_solution.html`, `pre_construction_model_info_stacked.html`) before adding any new family templates.
+3. **F-1 (record-keeping for invariant C3 producer file path)** -- a small but real mismatch between the issue body wording (`src/phase_z2_mapper.py`) and the live producer (`src/phase_z2_classifier.py`). Should be fixed in the audit charter / spec doc before the next integration audit so future audits do not repeat the same drift check.
+
+F-4 / F-5 are optional and do not gate #19.
+
+### 9.4 Conditions to satisfy for #19 progression
+
+- File F-1 / F-2 / F-3 as Section 10 follow-up issues (text-only drafts produced in u6).
+- F-3 backlog sweep should land before #19 Stage 2 (so #19 plans against accurate status).
+- F-2 family template reconciliation should land before #19 introduces new family templates (whichever comes first).
+- F-1 is a one-line spec-doc edit, can land any time before the next INTEGRATION-AUDIT issue is opened.
+
+### 9.5 Decision sentence
+
+> **Issue #19 is approved for entry under CONDITIONAL GO**, with the explicit dependency that follow-up F-3 (backlog status sweep) must land before #19 Stage 2 planning consumes the backlog, and F-2 (family template reconciliation) must land before any #19 work that extends the catalog. No production source code change is required from this audit. Pytest baseline stable (303 passed BEFORE + AFTER).
+
+---
+
+## Section 10. Follow-up issue drafts (text-only, not auto-posted)
+
+**Scope rule (Stage 2 u6 contract)** : per-draft fields = `title` + `source_axis` (1-4) + `scope` (what files / what change) + `evidence_link` (REPORT section that produced the finding). **No Gitea post.** Final disposition of each candidate is the orchestrator / human triage decision after #50 closes; this REPORT only records the audit-side text.
+
+Five candidates were produced by Axes 1-4. F-3 + F-2 + F-1 are blocking conditions for upgrading §9 CONDITIONAL GO -> unconditional GO for #19; F-4 + F-5 are optional housekeeping. None require source-code changes inside this audit.
+
+### 10.1 F-1 -- audit charter record-keeping : invariant C3 producer file path -- RESOLVED via IMP-53 (2026-05-19)
+
+- **title** : `[AUDIT-CHARTER-FIX] invariant C3 (fit_classification) producer cited as src/phase_z2_mapper.py; live producer is src/phase_z2_classifier.py`
+- **source_axis** : Axis 3 (cross-issue conflict, invariant category C3) -- recorded in §5.2 C3 row + §5.4 follow-up bullet F-1.
+- **scope** :
+  - one-line fix in any future INTEGRATION-AUDIT-* issue body or in `docs/architecture/PHASE-Z-PIPELINE-OVERVIEW.md` if it cites the wrong file for `fit_classification` producer.
+  - replace text `src/phase_z2_mapper.py` -> `src/phase_z2_classifier.py` *only in the context of `fit_classification` invariant* (mapper.py legitimately owns slot payload and registries, so do not blanket-rename).
+  - update audit charter template (if one exists) so the next integration audit does not repeat the drift check.
+- **scope-lock** : **doc-only**, zero `src/**` / `templates/**` / `tests/**` edits.
+- **evidence_link** :
+  - REPORT §5.2 row C3 (issue body wording vs. live producer).
+  - REPORT §5.4 follow-up bullet F-1.
+  - Live producer site : `src/phase_z2_classifier.py:495-497` (return dict with `visual_check_passed`, `classifications`, `summary`, `categories_seen`, `unclassified_signals`, `placement_diagnostics`).
+- **priority / gating** : low priority on its own; required for charter cleanliness; **not** a blocker for #19 Stage 2.
+
+### 10.2 F-2 -- family template count reconciliation : 11 tracked / 11 contracted / 13 on disk -- RESOLVED via #52 (option c, 2026-05-19)
+
+- **title** : `[FAMILY-TEMPLATE-RECONCILE] templates/phase_z2/families/ has 13 .html files on disk but 11 tracked + 11 frame_contracts entries; 2 WIP files (app_sw_package_vs_solution.html, pre_construction_model_info_stacked.html) untracked`
+- **source_axis** : Axis 3 (invariant category C6 template / catalog / frame count) -- recorded in §5.2 C6 row + §5.4 follow-up bullet F-2 + §6.3 Axis 4 cross-axis consistency bullet.
+- **scope** :
+  - decide whether the 2 untracked WIP family templates (`app_sw_package_vs_solution.html`, `pre_construction_model_info_stacked.html`) should be (a) tracked + contracted (add to `frame_contracts.yaml`, add to `git ls-files`), (b) removed if abandoned, or (c) explicitly noted as in-progress with a parent issue.
+  - reconcile the IMP-18 SVG-gap report doc citation `families/*.html (13)` against whichever decision is chosen (so the doc count matches code reality).
+- **scope-lock** : touches `templates/phase_z2/families/*.html`, `templates/phase_z2/catalog/frame_contracts.yaml`, `docs/architecture/IMP-18-SVG-GAP-REPORT.md`. **Must NOT be folded into #19 silently**: any catalog growth needs a dedicated issue per [[feedback_workflow_atomicity_rules]] (one commit = one decision).
+- **evidence_link** :
+  - REPORT §5.2 row C6 ("AGREE FOR TRACKED BASELINE -- 11 tracked family templates <-> 11 frame_contracts entries").
+  - REPORT §5.5 row "C6 family templates -- on disk" (`ls templates/phase_z2/families/*.html` = 13).
+  - REPORT §6.3 Axis 4 cross-axis consistency bullet (matches IMP-04 evidence).
+- **priority / gating** : **must land before #19 introduces any new family template** (per §9.3 condition 2). Until #19's catalog touch surface is known, this can be filed independently.
+- **resolution** : option (c) -- 2 WIP family templates explicitly noted as in-progress and tracked outside `frame_contracts.yaml` (RESOLVED via Gitea #52, 2026-05-19) :
+  - WIP allowlist : `templates/phase_z2/families/_WIP_FILES.md` (added by #52 u1) -- names both files with Figma frame IDs (`app_sw_package_vs_solution.html` -> frame 23 / `1171281203`; `pre_construction_model_info_stacked.html` -> frame 9 / `1171281180`) and explicit "not in `frame_contracts.yaml`, not in runtime matcher set" status; promote / remove gated on Gitea #42.
+  - IMP-18 doc reconciled : `docs/architecture/IMP-18-SVG-GAP-REPORT.md` L28 + L30 + L51 corrected from disk-only "13 files" / "15 partials" wording to "11 contracted + 2 WIP untracked = 13 on disk" (#52 u2) -- runtime matcher consumes the contracted set only; doc / tracked / contracted surfaces agree at 11 active.
+  - baseline guard (planned by #52 u4) : `tests/test_family_contract_baseline.py` will enforce tracked families <-> `frame_contracts.yaml` 1:1 set-equality modulo WIP allowlist parsed from `_WIP_FILES.md`; future drift (#42 or otherwise) fails CI.
+  - tracked baseline (11 contracted families <-> 11 `frame_contracts.yaml` entries) unchanged; no contract entries added or removed; no runtime matcher mutation; **C6 invariant remains AGREE** for the closed-issue audit scope.
+  - **F-2 closed-by-#52** under [[feedback_workflow_atomicity_rules]] (one commit = one decision unit), without re-opening any §5 C-invariant or §6.3 Axis 4 conclusion. #19 catalog-touch gate (per §9.3 condition 2) is now satisfied for the current 11/11 baseline; any #19 / #42 catalog growth must reconcile the WIP allowlist before merge.
+
+### 10.3 F-3 -- backlog status sweep : 15 rows pending->implemented + 1 row pending->documented(deferred) + IMP-15 children footnote
+
+- **title** : `[BACKLOG-STATUS-SWEEP] PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md has 16 of 22 audited rows mislabeled as pending; flip 15 to implemented, 1 (IMP-17) to documented (deferred), footnote IMP-15 with 5 execution children`
+- **source_axis** : Axis 4 (backlog vs code reality) -- recorded in §6.1 headline finding + §6.2 22-row matrix + §6.3 follow-up candidate F-3 + §9.1 §6 row + §9.3 condition 1.
+- **scope** :
+  - **15 rows** to flip `pending` -> `implemented` : IMP-02, IMP-03, IMP-04, IMP-05, IMP-06, IMP-07, IMP-08, IMP-09, IMP-10, IMP-11, IMP-12, IMP-13, IMP-14, IMP-15 (parent), IMP-16.
+  - **1 row** to flip `pending` -> `documented (deferred)` : IMP-17 (status-class shift; runtime AI = 0, 3-cond AND gate closed; matches §6.2 row 16).
+  - **IMP-15 row** : add inline footnote citing the 5 execution children commits `#45 (e9b3d2e)`, `#46 (2827622)`, `#47 (535c484)`, `#48 (614c533)`, `#49 (verification-only, re-uses 614c533)`. Either as a footnote on the IMP-15 row or as 5 child stub rows -- pick one and apply consistently.
+  - **IMP-18 row** : leave as `documented` (already AGREE per §6.2 row 17).
+- **scope-lock** : single-file edit to `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`. **Doc-only**, zero `src/**` / `templates/**` / `tests/**` edits. Must be filed as a separate Gitea issue with its own Stage 5 commit (not merged into #19 or any other improvement issue).
+- **evidence_link** :
+  - REPORT §6.1 headline finding (16 BACKLOG_STALE + 5 NO_BACKLOG_ROW + 1 AGREE = 22).
+  - REPORT §6.2 22-row matrix (per-row grep evidence + commit SHAs).
+  - REPORT §6.3 follow-up reference.
+  - REPORT §9.1 / §9.3 condition 1 ("F-3 backlog sweep should land before #19 Stage 2 planning consumes the backlog").
+- **priority / gating** : **highest of the 5 candidates**. **Must land before #19 Stage 2 planning** (per §9.3 condition 1) so that #19's planner reads accurate `implemented` / `documented (deferred)` status and does not treat already-wired features as still pending.
+
+### 10.4 F-4 -- legacy Phase R' / Q sample-literal cleanup (OPTIONAL)
+
+- **title** : `[LEGACY-LITERAL-CLEANUP] 20 hits of 재구성 / 건설산업 DX / BIM across 10 legacy Phase R'/Q files (block_assembler_b2.py, block_matcher_tfidf.py, block_reference.py, content_editor.py, design_director.py, design_tokens.py, fit_verifier.py, frame_extractor.py, kei_client.py, pipeline.py)`
+- **source_axis** : Axis-supporting Section 8 (anti-hardcoding grep checklist) -- recorded in §8.1 row G3 + §8.2 third bullet + §9.1 §8 row.
+- **scope** :
+  - per-file review of the 20 legacy hits to determine which are docstrings / comments (keep), legacy taxonomy (keep with annotation), or true sample-literal pins (remove or generalize).
+  - per-file counts to triage : `block_assembler_b2.py` 1, `block_matcher_tfidf.py` 1, `block_reference.py` 3, `content_editor.py` 3, `design_director.py` 2, `design_tokens.py` 1, `fit_verifier.py` 1, `frame_extractor.py` 1, `kei_client.py` 4, `pipeline.py` 3.
+  - **NOT** touching the 11 Phase Z hits (`phase_z2_content_extractor.py` 7 self-test data, `phase_z2_failure_router.py:123` taxonomy, `phase_z2_mapper.py:519/529` docstring examples, `phase_z2_retry.py:59` docstring) -- those passed audit verdict G3.
+- **scope-lock** : potentially touches legacy `src/**` files NOT in the Phase Z 22-step pipeline. Must be filed as a deliberate cleanup issue with its own scope-lock. If any file flagged here turns out to be on a live Phase Z code path on review, demote the candidate or split it.
+- **evidence_link** :
+  - REPORT §8.1 row G3 (per-file count breakdown, audit date 2026-05-19).
+  - REPORT §8.2 third bullet (20 legacy + 11 Phase Z = 31, reconciliation).
+  - Raw grep output : `D:\ad-hoc\kei\design_agent\.orchestrator\tmp\50_grep_checklist_raw.txt`.
+- **priority / gating** : **optional, low priority, doc-only follow-up note**. Does NOT gate #19; §8 verdict already PASS for audit scope. Recorded for completeness so future audits do not re-discover the same 20-hit baseline.
+
+### 10.5 F-5 -- formalize tests/fixtures/ directory (OPTIONAL)
+
+- **title** : `[TESTS-FIXTURES-FORMALIZE] tests/fixtures/ directory does not exist; sample MDX references currently live in tests/phase_z2/test_pz2_vu_integration.py`
+- **source_axis** : Axis-supporting Section 8 (anti-hardcoding grep checklist G6) -- recorded in §8.1 row G6 + §8.2 fourth bullet.
+- **scope** :
+  - if-and-only-if sample inventory grows beyond what fits inside `tests/phase_z2/test_*.py` files, formalize a `tests/fixtures/` directory holding sample-specific fixtures.
+  - migrate existing `samples/mdx_batch/02.mdx` references in `tests/phase_z2/test_pz2_vu_integration.py:6, 82` only if migration is part of a broader test-fixture refactor (otherwise leave them as integration smoke).
+  - update the issue-body rule wording to acknowledge that `tests/phase_z2/test_*.py` already discharges the spirit of "no sample-specific fixtures in production pipeline".
+- **scope-lock** : touches `tests/fixtures/` (new directory if filed) + the cited test files. Must NOT be folded into any unrelated test refactor.
+- **evidence_link** :
+  - REPORT §8.1 row G6 verdict "PASS WITH NOTE".
+  - REPORT §8.2 fourth bullet (`tests/fixtures/` not yet established).
+- **priority / gating** : **optional, very low priority**. Filing is only justified when sample inventory grows; the current state is already aligned with the spirit of the rule.
+
+#### 10.5.1 F-5 docs-only resolution addendum (#54 Stage 3 u5, 2026-05-19)
+
+Per issue #54 Stage 2 plan, F-5 is closed as **docs-only**; no root `tests/fixtures/` directory is created in this work. The current fixture inventory does not justify migration, and the existing convention is sufficient. The convention is recorded here so future anti-hardcoding audits can distinguish fixture / test-only paths from production paths without re-discovering the §8 G6 PASS-WITH-NOTE baseline.
+
+- **Existing convention (DO NOT CHANGE)** : `tests/phase_z2/fixtures/` exists as a YAML regression fixture root (loaded by `tests/phase_z2/test_fixtures_loader.py`). Subdirectories present at audit time : `tests/phase_z2/fixtures/build_layout_css/`, `tests/phase_z2/fixtures/retry_gate/`. This is the canonical home for Phase Z regression fixtures.
+- **Root `tests/fixtures/` (ABSENT)** : not created in #54. If a future change requires a non-Phase-Z, non-YAML fixture corpus (for example, multi-file MDX golden inputs that grow beyond what `tests/phase_z2/test_*.py` can hold inline), the migration must be filed as its own Gitea issue with its own scope-lock per §10.5.
+- **Allowed sample references** : `samples/mdx_batch/**` and `samples/mdx/**` may be referenced from `tests/**` (test-only paths) for integration smoke -- e.g. the existing `samples/mdx_batch/02.mdx` references in `tests/phase_z2/test_pz2_vu_integration.py`. These do not violate the §8 anti-hardcoding rule because the spirit of the rule targets production pipeline code, not test runners.
+- **Forbidden sample references** : production pipeline code (`src/**` runtime path) must NOT hardcode sample-specific MDX filenames or content (e.g. `02.mdx`, `03.mdx`, frame-specific labels keyed to a sample). The 20 legacy Phase R'/Q hits annotated under F-4 (#54 Stage 3 u1-u4) are intentional documented examples in docstrings / comments / glossary regex / sample-data dicts, not runtime input pins; they are out of scope for this rule by §10.4 verdict.
+- **AI-isolation contract** : this addendum is text-only. No production behavior change, no runtime sample-path mutation, no new fixture file. Compatible with PZ-1 (AI = 0 on normal path) and [[feedback_ai_isolation_contract]].
+- **Cross-reference** : `tests/CLAUDE.md` fixture convention note (#54 Stage 3 u5) mirrors the test-only / production rule split documented here.
+
+### 10.6 Follow-up summary
+
+| candidate | source axis | doc-only? | gates #19? | priority |
+|---|---|---|---|---|
+| F-1 audit-charter producer file path | Axis 3 (§5) | YES | NO | low (charter cleanup) |
+| F-2 family template count reconcile | Axis 3 (§5) | NO -- touches templates / catalog / docs | gate IF #19 extends catalog | medium |
+| F-3 backlog status sweep | Axis 4 (§6) | YES | YES -- must land before #19 Stage 2 plan | **highest** |
+| F-4 legacy R'/Q literal cleanup | §8 (anti-hardcoding) | NO -- legacy src/ touch surface | NO | low (optional) |
+| F-5 tests/fixtures/ formalize | §8 (anti-hardcoding) | NO -- tests/ migration | NO | very low (optional) |
+
+- **Counts** : 5 candidates total. 3 are blocking conditions for upgrading §9 CONDITIONAL GO to unconditional GO for #19 (F-3 hard-gates, F-2 conditional-gates on catalog touch, F-1 nice-to-have before next audit). 2 are optional housekeeping (F-4, F-5).
+- **Compliance with Stage 2 u6 contract** : per-draft fields (title / source_axis / scope / evidence_link) populated for each of F-1 .. F-5. **Zero auto-posts** -- this section is text-only. Filing decisions = orchestrator / human after #50 closes.
+- **AI-isolation contract** : none of the 5 follow-up candidates require AI on a normal path. F-2 / F-4 / F-5 are scope decisions to be made by a human reviewer. Compatible with [[feedback_ai_isolation_contract]] and PZ-1 (AI = 0 on normal path).

docs/architecture/INTEGRATION-AUDIT-02-REPORT.md

@@ -0,0 +1,197 @@
+# INTEGRATION-AUDIT-02 — IMP-07 reverse-path ↔ backlog ↔ IMP-16-U2 deferred items
+
+**Issue**: Gitea #56 ([`Kyeongmin/C.E.L_Slide_test2/issues/56`](https://gitea.hmac.kr/Kyeongmin/C.E.L_Slide_test2/issues/56))
+**Mode**: audit-only (orchestrator P4/P4a) — no runtime code; reverse-path NOT implemented in this audit.
+**HEAD at audit**: `47f072e` (`docs: PROJECT-INTENT-AND-GOVERNANCE master doc`)
+**Binding evidence artifact**: `.orchestrator/tmp/issue7_comments_r3.json` (102144 B, mtime_utc `2026-05-19T17:11:58Z`, 13 comments)
+**Live Gitea API calls during audit**: 0 (artifact is binding per Stage 1)
+**Fallback exit-report check**: `ls .orchestrator/issues/ | grep '^7_stage' | wc -l = 0` (no local stage-exit fallback)
+
+**Scope-lock (u1 binding)**
+- Forbidden writes (4 surfaces): `src/**`, `templates/**`, `tests/**`, `docs/architecture/IMP-16-U2-WIRING-DESIGN.md`.
+- Allowed writes (2 surfaces): CREATE this report; line-scoped EDIT to `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` L51 + L67 status cells only.
+
+**Cross-links**
+- Project governance: [`PROJECT-INTENT-AND-GOVERNANCE.md`](PROJECT-INTENT-AND-GOVERNANCE.md)
+- Pipeline anchors: [`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md), [`PHASE-Z-PIPELINE-STATUS-BOARD.md`](PHASE-Z-PIPELINE-STATUS-BOARD.md)
+- Backlog: [`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md)
+- Wiring-design (read-only, not edited here): [`IMP-16-U2-WIRING-DESIGN.md`](IMP-16-U2-WIRING-DESIGN.md)
+- Prior audit: [`INTEGRATION-AUDIT-01-REPORT.md`](INTEGRATION-AUDIT-01-REPORT.md)
+
+---
+
+## 1. Executive decision
+
+| Q | question | verdict | evidence anchor |
+|---|---|---|---|
+| Q1 | IMP-07 actual implementation status | **closed-as-no-runtime** (policy close; no backend adapter; no FE trigger) | u2 close-trio c.17970 / c.19226 / c.19240; u3 BE grep 1 hit (docstring) + FE grep 0 hits |
+| Q2 | Backlog accuracy for IMP-07 (and dependent IMP-16) | **divergent — correct to `documented:no-runtime` (IMP-07) + `documented:dormant` (IMP-16)** | Backlog L51 / L67 currently both `implemented`; status-vocabulary precedent at L68–L71 (`documented`, `documented (deferred)`) |
+| Q3 | IMP-16-U2 3 deferred items resolution | **all three DORMANT pending reverse-path reactivation** (no runtime substrate to resolve any of the three) | u4 §3 (a/b/c each cite u2 + u3 + IMP-16-U2-WIRING-DESIGN.md L14–16 gate clauses, all NOT CLEARED) |
+| Q4 | Follow-up needs | **1 backlog correction (applied in u7) + 1 doc-sync follow-up (drafted in §6, NOT posted)**; no runtime follow-up needed under current policy | §5 (backlog patch) + §6 (doc-sync banner draft) |
+
+**Final decision**: see §7 below.
+
+---
+
+## 2. Evidence table (4-axis convergence)
+
+| axis | claim | observed state | source / anchor |
+|---|---|---|---|
+| Gitea #7 close text | reverse-path closed-as-no-runtime (policy) | c.17970 `<< 해당 기능 필요 없음 >>`; c.19226 §5 `"코드 변경 없이 close … '구현 완료'가 아니라 '기능 불필요 / 현 정책상 reverse path 미진행'"`; c.19240 `"이 이슈는 코드 변경 없이 정책 판단으로 close했다."` | `.orchestrator/tmp/issue7_comments_r3.json` (binding artifact); cited verbatim in `.orchestrator/drafts/56_close_evidence.md` §3 / §4 / §5 |
+| Live BE code grep (`src/`) | no reverse-path adapter exists | pattern P `html_to_slide_mdx\|edited_html_to_mdx\|reverse_path\|reverse-path\|reversePath\|html-to-mdx` → 1 hit at `src/phase_z2_verification_utils.py:68`, classified **docstring-only** inside `extract_text_from_html()` (docstring says `Deterministic, pure: no I/O, no LLM, no network.`) | `src/phase_z2_verification_utils.py:64-73`; `.orchestrator/drafts/56_code_grep.md` §3 |
+| Live FE code grep (`Front/client/src/`) | no reverse-path payload trigger exists | same pattern P → **0 hits** across populated tree (`App.tsx`, `components/`, `contexts/`, `data/`, `hooks/`, `lib/`, `pages/`, `services/`, `types/`, `utils/`); 0-hit is true absence, not missing-dir false negative | `.orchestrator/drafts/56_code_grep.md` §4 |
+| Backlog status (`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` L51) | currently labels IMP-07 `implemented` — divergent from #7 close text + grep | L51 final cell = `implemented`; row preserves hard link to IMP-02 (normalize schema). Correct token under audit verdict = `documented:no-runtime`. | `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md:51`; proposed diff in `.orchestrator/drafts/56_backlog_diff.md` §2 |
+| Backlog status (L67) | currently labels IMP-16 `implemented` — gated to closed IMP-07, so dormant | L67 final cell = `implemented`; row carries `hard link: IMP-07 (B-2 main 활성 시점 의미)`. Correct token under audit verdict = `documented:dormant`. | `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md:67`; proposed diff in `.orchestrator/drafts/56_backlog_diff.md` §3 |
+| IMP-16-U2 deferred items (`IMP-16-U2-WIRING-DESIGN.md` L71–L73) | three items deferred "until IMP-07 lands" | (a) adapter module path TBD, (b) Step 2 per-section vs whole-MDX undecided, (c) Step 14 telemetry granularity undecided. None can be resolved while IMP-07 remains closed-as-no-runtime. | `docs/architecture/IMP-16-U2-WIRING-DESIGN.md:69-75`; gate at L14–L16 (all 3 clauses NOT CLEARED — `.orchestrator/drafts/56_imp16_deferred.md` §2) |
+| Fallback orchestrator exit report | absent — binding artifact is sole source | `ls .orchestrator/issues/ \| grep '^7_stage' \| wc -l = 0` | `.orchestrator/drafts/56_close_evidence.md` §1 |
+| Convergence | zero contradicting evidence across 37 independent passes (Stage 1 → Stage 3) | all 4 evidence axes (close-text / BE grep / FE grep / dependent doc gate) point to **policy-closed, no runtime, dependent doc dormant** | Stage 1 + Stage 2 exit reports; u2–u5 drafts; u4 §4 cross-axis check |
+
+**Commit SHA at audit time**: `47f072e` (HEAD before u7's backlog patch).
+
+---
+
+## 3. IMP-07 verdict (with evidence)
+
+**Verdict**: `documented:no-runtime` — reverse-path (B-2 Edited HTML → MDX) was closed by user policy decision on 2026-05-15 (c.17970) and re-affirmed by structured close-audit on 2026-05-18 (c.19226 + c.19240). **No backend adapter, no frontend trigger, no `html_to_slide_mdx` port exists in this repository.**
+
+### Evidence chain (compact form — full verbatim in drafts)
+
+1. **Initial close decision** — c.17970 (2026-05-15T18:28:22+09:00):
+   > `<< 해당 기능 필요 없음 >>`
+   > `(*) mdx → html 변환 이후 html 수기 수정된 것은 html에서만 적용.`
+2. **Structured close-audit (v1)** — c.19226 (2026-05-18T08:31:05+09:00). Section 3 enumerates the *absence* of every required runtime surface: SlideCanvas outerHTML capture absent; backend POST absent; `/api/edit | /api/html_to_mdx | /api/save` endpoints absent; glubeot `html_to_slide_mdx` not ported. Section 5 verdict: `"코드 변경 없이 close … '구현 완료'가 아니라 '기능 불필요 / 현 정책상 reverse path 미진행'"`.
+3. **Structured close-audit (v2 restatement)** — c.19240 (2026-05-18T08:41:19+09:00):
+   > `"이 이슈는 코드 변경 없이 정책 판단으로 close했다."`
+4. **Live BE grep** (`src/`, pattern P): 1 hit at `src/phase_z2_verification_utils.py:68` inside the docstring of `extract_text_from_html()`. Function body is a deterministic, pure text extractor (`no I/O, no LLM, no network`) — **not** a reverse-path adapter, **not** an HTML→MDX converter, **not** a pipeline re-entry call site.
+5. **Live FE grep** (`Front/client/src/`, pattern P): 0 hits across populated React/TS tree — true absence, not missing-dir false negative.
+
+### Why not `implemented:partial`
+
+c.19226 §3 enumerates the absence of **every** required runtime surface (frontend, backend, converter, endpoint). `implemented:partial` would imply at least one runtime substrate is present; none is.
+
+### Why not plain `documented` / `documented (deferred)`
+
+IMP-17/18/19/20 use `documented` / `documented (deferred)` to mean "design captured, runtime deferred pending an explicit activation gate (IMP-17 carve-out, IMP-18 gap report, etc.)". IMP-07 is a stronger statement — **closed by explicit policy decision, no runtime, reactivation requires reopening the policy in a separate issue**. The `:no-runtime` suffix encodes that distinction so future readers can tell IMP-07 apart from the IMP-17/18/19/20 `documented` family.
+
+### Reactivation contract (informational, NOT a doc edit)
+
+Per c.19226 §5 and c.19240 closing line, reverse-path reactivation requires reopening IMP-07 policy in a **separate** issue covering: endpoint design, marker coverage, re-entry validation. This audit does NOT reopen that policy.
+
+---
+
+## 4. IMP-16-U2 deferred items resolution (with evidence)
+
+**Source**: `docs/architecture/IMP-16-U2-WIRING-DESIGN.md` lines 69–75 (read-only; this doc is FORBIDDEN to edit in this audit per u1).
+
+**Governing gate** (doc L12–L16): three clauses MUST be cleared before any IMP-16-U2 wiring lands.
+
+| gate clause | required state | observed | gate status |
+|---|---|---|---|
+| `IMP-07 implemented + verified` | runtime adapter in `src/`, verified | Gitea #7 closed as policy / no-runtime (c.17970 / c.19226 §5 / c.19240) | **NOT CLEARED** |
+| Repo grep returns runtime hit in non-test `src/` module | ≥1 non-docstring runtime hit for pattern P | u3 hits=1, **docstring only** at `src/phase_z2_verification_utils.py:68` (pure text extractor) | **NOT CLEARED** |
+| Reverse-path entry emits (a) re-entry MDX + (b) upstream HTML | both as deterministic outputs | c.19226 §3 enumerates absence of every required surface; u3 FE grep hits=0 | **NOT CLEARED** |
+
+All three gate clauses NOT CLEARED → resolution policy from issue body Q3 branches: "If Q1 confirms no-runtime / dormant → reclassify item as dormant pending reverse-path reactivation."
+
+### Per-item resolution
+
+| item | text (verbatim, doc L71–L73) | classification | reason | evidence anchor |
+|---|---|---|---|---|
+| (a) | Exact module path of the IMP-07 reverse-path adapter (TBD by IMP-07). | **DORMANT** | No reverse-path adapter exists in `src/`. The TBD slot stays TBD — not answered with a placeholder path. | u3 §3 (single docstring hit at `src/phase_z2_verification_utils.py:68`); c.19226 §3 absent-surface enumeration |
+| (b) | Step 2 preservation cross-check: per-section variant vs whole-MDX variant. | **DORMANT (gate closed)** | Step 2 surface = `verify_text_preservation(reentry_mdx, upstream_generated_html, area_name=...)` (doc L29). With no emitter producing `reentry_mdx`, the per-section vs whole-MDX choice is unanswerable from runtime evidence. | doc L29; u3 §3; c.19226 §3 (`html_to_slide_mdx` not in repo); c.19226 §5 |
+| (c) | Step 14 invented-text telemetry: per `area_name` vs global. | **DORMANT (gate closed)** | Step 14 surface = `detect_invented_text(reentry_mdx, final_html)` (doc L35). With no FE producer of area-tagged HTML (u3 FE grep hits=0), the granularity question has no runtime substrate. The current Step 14 `run_overflow_check` path is unchanged because no reverse-path re-entry sets `debug.json["pipeline"]["reverse_path_reentry"] = True` (doc L42 schema gate). | doc L35; doc L42; u3 §4 (FE 0-hits); c.19240 closing line |
+
+### Axis disambiguation (why DORMANT, not no-runtime)
+
+IMP-07 is **policy-closed** (active decline). IMP-16's verification helpers are **code-present** in `src/phase_z2_verification_utils.py` (u6 `split_into_sentences`, u8 `verify_text_preservation`, u9 `detect_invented_text` ports). The wiring they would land is **gated by IMP-07** (doc L12–L16). Because the gate is closed, the helpers are runtime-inert — they have no upstream caller. `:dormant` captures "code-shape present, runtime entry-point absent"; `:no-runtime` would imply the helpers themselves are absent (they are not).
+
+---
+
+## 5. Backlog status correction proposal
+
+Target file: `docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` — line-scoped edit to L51 and L67 status cells only. **Exactly 2 line changes**; surrounding cells (id / title / step / source / priority / scope / guardrail / dependency) byte-for-byte unchanged on both rows. Adjacent rows (L50 IMP-06, L52 IMP-08, L66 IMP-15, L68 IMP-17) untouched.
+
+### L51 — IMP-07: `implemented` → `documented:no-runtime`
+
+```diff
+-| ... | hard link: IMP-02 (A-1 normalize schema 와 reverse path schema 정합 필요) | implemented |
++| ... | hard link: IMP-02 (A-1 normalize schema 와 reverse path schema 정합 필요) | documented:no-runtime |
+```
+
+Justification: §3 verdict + close-trio (c.17970 / c.19226 / c.19240) + BE grep (docstring only) + FE grep (0 hits).
+
+### L67 — IMP-16: `implemented` → `documented:dormant`
+
+```diff
+-| ... | hard link: IMP-07 (B-2 main 활성 시점 의미) | implemented |
++| ... | hard link: IMP-07 (B-2 main 활성 시점 의미) | documented:dormant |
+```
+
+Justification: §4 — all three deferred items DORMANT under the IMP-07 no-runtime gate. The row's own `hard link: IMP-07` declares its meaning is conditioned on IMP-07 activation.
+
+### Status-vocabulary precedent
+
+Existing tokens in the file: `pending` (L45), `implemented` (L46–L66 majority), `documented (deferred)` (L68 IMP-17), `documented` (L69 IMP-18 / L70 IMP-19 / L71 IMP-20). The proposed `documented:<qualifier>` form is a minimal suffix extension of an already-present family — and is **explicitly enumerated by the issue body's Q2**: "propose corrected status (`implemented` / `implemented:partial` / `documented:dormant` / `documented:no-runtime` / etc.)".
+
+---
+
+## 6. Follow-up issue recommendations (drafts, NOT posted)
+
+Auto-posting follow-ups is out-of-scope per u1. The drafts below are recommended text only; this audit does **not** post them.
+
+### Recommended follow-up #1 — doc-sync banner for `IMP-16-U2-WIRING-DESIGN.md`
+
+- **Draft title**: `[DOC-SYNC] IMP-16-U2-WIRING-DESIGN.md — add cross-reference banner to INTEGRATION-AUDIT-02-REPORT.md (IMP-07 closed-as-no-runtime context)`
+- **Scope sketch**:
+  - Add a one-paragraph banner near the top of `IMP-16-U2-WIRING-DESIGN.md` (post-§1 "Status" paragraph) cross-referencing this audit report.
+  - Banner content: IMP-07 was closed-as-no-runtime per Gitea #7 (c.17970 / c.19226 / c.19240). The L12–L16 gate clauses remain unchanged but are currently NOT CLEARED; the 3 deferred items (L71–L73) are DORMANT pending a future reverse-path reactivation issue.
+  - **Do NOT** modify the gate clauses, the per-step wiring contract, or the deferred items themselves — preserve them verbatim as the binding contract for any future IMP-07 reactivation.
+- **Allowed file changes**: `docs/architecture/IMP-16-U2-WIRING-DESIGN.md` (banner add only); optionally a one-line back-link in `INTEGRATION-AUDIT-02-REPORT.md`.
+- **Forbidden**: any change to the doc's gate clauses, per-step contract, or deferred items list; any change to `src/**`, `templates/**`, `tests/**`.
+- **Acceptance**: banner contains explicit cross-link to `INTEGRATION-AUDIT-02-REPORT.md`, cites c.17970 / c.19226 / c.19240, and states the 3 deferred items are DORMANT (not resolved, not closed).
+- **Rationale for separating from this audit**: per u1 scope-lock, `IMP-16-U2-WIRING-DESIGN.md` is a forbidden write surface in INTEGRATION-AUDIT-02 (issue #56). The banner addition is a separate doc-sync axis.
+
+### No runtime follow-up needed under current policy
+
+Reverse-path runtime activation is **out-of-scope under current user policy** (c.17970 / c.19226 §5 / c.19240). A runtime follow-up would require reopening IMP-07 policy in a separate issue — that decision lies with the user, not with this audit. This audit does NOT recommend a runtime follow-up at this time.
+
+### Pre-existing follow-up linkage (informational)
+
+Per the issue body's "Sequence note", the next planned issue #57 ([P5][DORMANT-TRIGGER-GUARD]) will register IMP-17 / IMP-18 / IMP-19 + (per #56 outcome) IMP-16 / IMP-07 + IMP-20 as followup-linked to #55. This audit's verdict feeds #57's dormant-trigger registry input: IMP-07 enters as `documented:no-runtime`; IMP-16 enters as `documented:dormant`.
+
+---
+
+## 7. Final decision
+
+**`NEEDS_DOC_SYNC_FOLLOWUP`**
+
+Rationale: the in-scope reconciliation (backlog L51 + L67 status corrections) is performed in u7. However, `IMP-16-U2-WIRING-DESIGN.md` opens with `**Status**: design-only contract. **No runtime wiring lands in this issue.** All wiring is gated behind IMP-07 reverse-path activation (B-2 main). When IMP-07 lands, this doc becomes the binding contract …` (L3) — written under the original assumption that IMP-07 would eventually land as runtime. With IMP-07 now classified `documented:no-runtime` (policy decline, not deferred-pending-future), this framing is stale without a cross-reference banner pointing readers to the present audit. Because u1 forbids direct edits to that doc, the banner addition must be a separate follow-up issue (drafted in §6, NOT posted by this audit).
+
+Why not `BACKLOG_PATCH_ONLY`: the backlog patch alone leaves `IMP-16-U2-WIRING-DESIGN.md` reading as a future-binding contract without acknowledging the IMP-07 close. A reader landing on that doc would not know to consult this audit.
+
+Why not `NEEDS_RUNTIME_FOLLOWUP`: reverse-path runtime is out-of-scope under current user policy (c.17970 / c.19226 §5 / c.19240); recommending a runtime follow-up would contradict the binding close-decision.
+
+---
+
+## Acceptance Criteria checklist (issue body)
+
+| AC | requirement | status |
+|---|---|---|
+| 1 | No production source code (`src/**`, `templates/**`, `tests/**`) changes | ✅ — u1 forbids; u2–u6 verified empty tracked diff on these surfaces; u7 scoped to BACKLOG.md only |
+| 2 | No direct modification of `IMP-16-U2-WIRING-DESIGN.md` | ✅ — u1 forbids; banner addition deferred to follow-up #1 in §6 |
+| 3 | Each of Q1~Q4 has evidence-backed answer | ✅ — §1 table cites u2/u3/u4 drafts; §3, §4, §5, §6 expand each answer |
+| 4 | Evidence table includes concrete `file:line`, comment IDs, commit SHAs | ✅ — §2 cites `src/phase_z2_verification_utils.py:68`, c.17970 / c.19226 / c.19240, SHA `47f072e`, `BACKLOG.md:51` / `:67`, `IMP-16-U2-WIRING-DESIGN.md:69-75` / `:12-16` |
+| 5 | Final decision ∈ {BACKLOG_PATCH_ONLY, NEEDS_DOC_SYNC_FOLLOWUP, NEEDS_RUNTIME_FOLLOWUP} | ✅ — §7 = `NEEDS_DOC_SYNC_FOLLOWUP` |
+| 6 | Body size budget: each Gitea comment ≤ 8000 chars | ✅ — Stage 3 comments split large evidence into `.orchestrator/drafts/56_*.md` + this report; report body itself is not a comment |
+
+---
+
+## Evidence drafts (RULE-6 evidence-only; NOT staged for commit)
+
+- u1: `.orchestrator/drafts/56_scope_lock.md` — scope binding + forbidden / allowed writes.
+- u2: `.orchestrator/drafts/56_close_evidence.md` — c.17970 / c.19226 / c.19240 verbatim.
+- u3: `.orchestrator/drafts/56_code_grep.md` — `src/` 1 hit (docstring) + `Front/client/src/` 0 hits.
+- u4: `.orchestrator/drafts/56_imp16_deferred.md` — 3 deferred items DORMANT (per-item table).
+- u5: `.orchestrator/drafts/56_backlog_diff.md` — L51 + L67 status-cell diff proposal.
+
+These drafts are evidence-only per RULE 6 and remain untracked. The committed deliverables of INTEGRATION-AUDIT-02 are: (i) this report (`INTEGRATION-AUDIT-02-REPORT.md`), and (ii) the 2 line-scoped status-cell edits applied in u7 (`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md` L51 + L67).

docs/architecture/PHASE-Q-AUDIT.md

@@ -96,13 +96,13 @@ Phase Z 는 본체이고, Phase Q 는 부품 창고 / 참고 자산이다. Phase
 | id | 보완 항목 | 목적 | input | output | Phase Q 후보 파일 | 우선순위 |
 |---|---|---|---|---|---|---|
 | **A-1** | Stage 0 normalize 통합 | HTML-heavy / 비정형 raw MDX 를 Phase Z canonical input 으로 변환 | raw MDX text | `{clean_text, title, images, popups, tables, sections}` (frontmatter / 코드블록 보호 / list/table HTML 변환 / AST 구조 추출) | `mdx_normalizer.py`, `section_parser.py` | 높음 |
-| **A-2** | Catalog 확장 (frame_contracts + frame_partials) | V4 32 후보 중 backend 적용 가능한 frame 수 증가 (현재 3 → 32 목표) | `figma_to_html_agent/blocks/{frame_id}/` 의 index.html / assets / analysis.md | `templates/phase_z2/catalog/frame_contracts.yaml` entry + `templates/phase_z2/frames/{template_id}.html` partial | `block_reference.py`, `block_selector.py` | 높음 |
+| **A-2** | Catalog 확장 (frame_contracts + frame_partials) | V4 32 후보 중 backend 적용 가능한 frame 수 증가 (현재 3 → 32 목표) | `figma_to_html_agent/blocks/{frame_id}/` 의 index.html / assets / analysis.md | `templates/phase_z2/catalog/frame_contracts.yaml` entry + `templates/phase_z2/frames/{template_id}.html` partial | `block_reference.py`, `block_selector.py` (간접 — catalog 로딩 / block 검색 패턴 reference; A-2 main = frame_contracts.yaml + frame_partials 신규 구축, Phase Q catalog schema ≠ Phase Z) | 높음 |
-| **A-3** | Frame preview png 일관성 | 모든 catalog frame 의 일관된 preview.png 자동 생성 (현재 figma_previews 우회) | frame partial HTML + assets | `figma_to_html_agent/blocks/{frame_id}/preview.png` | `renderer.py`, `html_generator.py` (selenium 캡처 흔적 추정) | 중 |
+| **A-3** | Frame preview png 일관성 | 모든 catalog frame 의 일관된 preview.png 자동 생성 (현재 figma_previews 우회) | frame partial HTML + assets | `figma_to_html_agent/blocks/{frame_id}/preview.png` | `slide_measurer.capture_slide_screenshot` (main), `renderer.py` (간접 — render-path 자료) | 중 |
-| **A-4** | slide-base.html iframe-friendly mode | iframe embed 시 body padding / centering / min-height 미적용 (frontend CSS injection 제거) | slide-base.html template + query string `?embedded=1` 같은 시그널 | conditional CSS (standalone vs embedded) | `html_generator.py` | 중 |
+| **A-4** | slide-base.html iframe-friendly mode | iframe embed 시 body padding / centering / min-height 미적용 (frontend CSS injection 제거) | slide-base.html template + query string `?embedded=1` 같은 시그널 | conditional CSS (standalone vs embedded) | `renderer.py` (legacy `slide-base.html` 호출 지점 보유, embedded/standalone CSS 분기 미구현) | 중 |
 | **A-5** | V4 후보 자동 fallback | rank-1 capacity / cardinality / structure mismatch 시 자동 rank-2/3 시도 | V4 후보 list + 각 frame contract 의 cardinality + 추출된 content items | 통과한 frame template_id (모두 fail 시 filtered_capacity) | `fit_verifier.py` | 높음 |
 | **A-6** | Zone DOM 좌표 export | backend 가 zone 절대 px 좌표를 step08 / 별도 step 에 export (frontend 측정 우회) | layout_css + slide-base 좌표 | `zone_geometries_px: [{position, x, y, w, h}]` | `slide_measurer.py` | 중 |
-| **B-1** | Zone-section assignment override | 사용자 drag drop 결과를 backend 가 받아 composition planner 의 자동 결정 강제 변경 | `--override-section-assignment ZONE_ID=section_id,section_id` (CLI multi) | units 배치가 사용자 매핑 따름 | `pipeline.py`, `content_editor.py` | 중 |
+| **B-1** | Zone-section assignment override | 사용자 drag drop 결과를 backend 가 받아 composition planner 의 자동 결정 강제 변경 | `--override-section-assignment ZONE_ID=section_id,section_id` (CLI multi) | units 배치가 사용자 매핑 따름 | `pipeline.py` (간접 — orchestration entry, Stage Y page_structure 생성 흐름 보유) | 중 |
-| **B-2** | Edited HTML → MDX 역변환 | frontend 편집 모드의 텍스트 변경이 새 final.html 에 반영 | edited HTML (iframe contentDocument outerHTML) | 새 MDX text 또는 patched mapper input | 글벗 `fmt_slide.py html_to_slide_mdx`, `content_editor.py` | 중 |
+| **B-2** | Edited HTML → MDX 역변환 | frontend 편집 모드의 텍스트 변경이 새 final.html 에 반영 | edited HTML (iframe contentDocument outerHTML) | 새 MDX text 또는 patched mapper input | 글벗 `fmt_slide.py html_to_slide_mdx` | 중 |
 | **B-3** | Sub-section (### 단위) drag drop backend 처리 | backend 가 sub-section id 를 인식해서 zone 에 sub-section 단위로 매핑 | sub-section id (e.g., "03-1-sub-2") + zone_id | 그 sub-content 단위로 unit 분할 | `section_parser.py` | 낮 |
 | **B-4** | 다른 layout 의 zone-geometry override 확장 | top-1-bottom-2 / top-2-bottom-1 / left-1-right-2 / left-2-right-1 / grid-2x2 도 사용자 ratio override 적용 (현재 horizontal-2 / vertical-2 만) | `--override-zone-geometry` 인자 + 새 layout_preset 분기 | build_layout_css 의 grid 표현 (areas / cols / rows) | `space_allocator.py` | 낮 |
 | **D-1** | filtered_section_reasons 노출 UI | 사용자가 어떤 섹션이 왜 빠졌는지 즉시 인지 (Step 8 coverage UI) | `step20_slide_status.json.data.filtered_section_reasons` | frontend header / 패널 UI | N/A (frontend 만) — Phase Q audit 외 | 중 |
@@ -122,7 +122,7 @@ Phase Z 는 본체이고, Phase Q 는 부품 창고 / 참고 자산이다. Phase
 3. `slide_measurer.py` (A-6)
 4. `fit_verifier.py` (A-5, D-2 간접)
 5. `space_allocator.py` (B-4)
-6. `content_editor.py` (B-1, B-2)
+6. `content_editor.py`
 7. `content_verifier.py` (검증 — B-2 후속)
 8. `renderer.py` (A-3, A-4)
 9. `html_generator.py` (A-3, A-4)

docs/architecture/PHASE-Q-INSIGHT-TO-22STEP-MAP.md

@@ -120,10 +120,10 @@
 | A-4 slide-base iframe mode | Step 13 | §2.8 I2 (renderer.py slide-base 사용 호출 지점) | pending | yes (UI/backend) |
 | Step 14 visual_check 보강 | Step 14, 21 | §2.7 H1 (`content_verifier` utilities Reference Only) | pending | yes (deterministic) |
 | B-2 verification 보조 | Step 1, 2, 14, 21, 22 | §2.7 H3 (text 추출 / 정규화 / 비교 utility) | pending | yes (UI/backend) |
-| AI repair fallback infra | Step 12, 16, 17 | §2.6 G3 (`httpx` + SSE streaming + retry + JSON parse pattern) | pending | no (AI fallback only) |
+| IMP-17 AI repair fallback infra (carve-out — see [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md)) | Step 12, 16, 17 | §2.6 G3 (`httpx` + SSE streaming + retry + JSON parse pattern) | pending | no (AI fallback only) |
 | I3 SVG 좌표 보강 | Step 0, 9 | §2.8 I3 (`renderer._preprocess_svg_data`) | pending | yes (deterministic) |
-| I4 zone 비중 분배 | Step 8 | §2.8 I4 (`renderer._group_blocks_by_area`) | pending | yes (deterministic) |
+| IMP-19 I4 zone 비중 분배 (reference — see [`IMP-19-ZONE-RATIO-REFERENCE.md`](IMP-19-ZONE-RATIO-REFERENCE.md)) | Step 8 | §2.8 I4 (`renderer._group_blocks_by_area`) | pending | yes (deterministic) |
-| H2 frame contract validation | Step 10 | §2.7 H2 (`content_verifier.verify_structure` pattern) | pending | yes (deterministic) |
+| IMP-20 H2 frame contract validation (reference — see [`IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md`](IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md)) | Step 10 | §2.7 H2 (`content_verifier.verify_structure` pattern) | pending | yes (deterministic) |
 
 ---
 
@@ -147,7 +147,7 @@
 
 | candidate ID | 출처 | cleanup 대상 | trigger axis |
 |---|---|---|---|
-| J3 | §2.9 `html_generator` | utility 중복 — `normalize_mdx` / `_slice_mdx_sections` / `_get_definitions` / `_get_conclusion` (vs §2.1 / §2.2 SoT) | Phase R' cleanup axis 활성 시 |
+| J3 | §2.9 `html_generator` | utility 중복 — `normalize_mdx` / `_slice_mdx_sections` / `_get_definitions` / `_get_conclusion` (vs §2.1 / §2.2 SoT) | Phase R' archive trigger AND §2.1/§2.2 SoT signature unification (both preconditions required to keep guardrail = code-removal-only) |
 | K5 | §2.10 `block_reference` + `block_selector` + §2.8 `renderer` | catalog 로드 + `_get_block_by_id` 중복 (3 module) | Phase R' cleanup 또는 Phase Z catalog 확장 axis 활성 시 |
 | L4 | §2.11 `pipeline` + §2.6 `content_editor` + §2.9 `html_generator` | `_parse_json` 중복 (3 module) | Phase R' cleanup 또는 Phase Z utility 통합 axis 활성 시 |
 

docs/architecture/PHASE-Z-FIT-CLASSIFIER-ROUTER-SPEC.md

@@ -93,6 +93,7 @@ action :
 | `moderate_overflow` | content_type ∈ {`text_flow`, `frame_label`} AND `line_equivalent` ∈ (1.5, 4] |
 | `minor_overflow` | content_type ∈ {`text_flow`, `frame_label`} AND `line_equivalent` ≤ 1.5 |
 | `hard_visual_fail` | 위 어디에도 매핑 안 됨 OR retry budget 소진 |
+| `image_aspect_mismatch` | Post-render `fail_reasons` signal — Step 14 visual_runtime_check 가 이미지 frame slot 의 rendered aspect ratio 와 declared aspect ratio 불일치를 감지 (router-routed fit_classifier 출력 아님; 별도 image_events stream 으로 표면화) |
 
 ### 3.2 분류 우선순위 (위에서 아래로)
 

docs/architecture/PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md

@@ -43,16 +43,16 @@
 | ID | title | related step | source | priority | scope | guardrail / validation | dependency | status |
 |---|---|---|---|---|---|---|---|---|
 | IMP-01 | A-6 Zone DOM 좌표 export | Step 14, 21 | §2 A-6 Salvage | ↑ high (small) | `_MEASURE_SCRIPT` JS extension `getBoundingClientRect()` + artifact field 추가 | AI/Kei/V4/frame 선택 변경 X / DOM bbox trace / 기존 debug.json schema 보존 (additive) | none | pending |
-| IMP-02 | A-1 Stage 0 normalize chained adapter | Step 2 | §2 A-1 Salvage chained | ↑ high (medium) | `normalize_mdx_content` + `extract_major_sections` + `extract_conclusion_text` chained adapter + dual-write | AI/Kei normalize 회귀 X / step02 sections / sub_sections trace 설명 가능 | none | pending |
+| IMP-02 | A-1 Stage 0 normalize chained adapter | Step 2 | §2 A-1 Salvage chained | ↑ high (medium) | `normalize_mdx_content` + `extract_major_sections` + `extract_conclusion_text` chained adapter + dual-write | AI/Kei normalize 회귀 X / step02 sections / sub_sections trace 설명 가능 | none | implemented |
-| IMP-03 | A-1 popup/image/table trace | Step 3 | §2 A-1 chained 보강 | medium | normalized popups / images / tables → ContentObject 변환 (B1 v0 보강) | AI/Kei content extraction 회귀 X / popup/image/table 추출 trace 설명 가능 | hard link: IMP-02 (Stage 0 normalize output 의 popup/image/table list 의존) | pending |
+| IMP-03 | A-1 popup/image/table trace | Step 3 | §2 A-1 chained 보강 | medium | normalized popups / images / tables → ContentObject 변환 (B1 v0 보강) | AI/Kei content extraction 회귀 X / popup/image/table 추출 trace 설명 가능 | hard link: IMP-02 (Stage 0 normalize output 의 popup/image/table list 의존) | implemented |
-| IMP-04 | A-2 Catalog 확장 | Step 0, 9 | §2 A-2 새로 만들기 (핵심 unblocker) | medium (large) | `frame_contracts.yaml` + frame_partials 32 frame 등록/확장 | Phase R' frame catalog 회귀 X / V4 logic 변경 X / catalog 확장 후 PASS/FAIL 변화와 frame 선택 trace 설명 가능 | none | pending |
+| IMP-04 | A-2 Catalog 확장 | Step 0, 9 | §2 A-2 새로 만들기 (핵심 unblocker) | medium (large) | `frame_contracts.yaml` + frame_partials 32 frame 등록/확장 | Phase R' frame catalog 회귀 X / V4 logic 변경 X / catalog 확장 후 PASS/FAIL 변화와 frame 선택 trace 설명 가능 | none | implemented |
-| IMP-05 | A-5 V4 fallback | Step 9, 16, 17, 20 | §2 A-5 새로 만들기 | medium | Step 9 / Step 16 router 확장 (rank-1 fail 시 rank-2/3 fallback) + step20 status semantics | `calculate_fit` 통째 Migrate X (dual path 위험) / 신설 status (`PASS_WITH_FALLBACK` 등) 일관성 / frame 변경 허용 trace 설명 | hard link: IMP-04 (catalog 확장 후 fallback path 의미 있음) | pending |
+| IMP-05 | A-5 V4 fallback | Step 9, 16, 17, 20 | §2 A-5 새로 만들기 | medium | Step 9 / Step 16 router 확장 (rank-1 fail 시 rank-2/3 fallback) + step20 status semantics | `calculate_fit` 통째 Migrate X (dual path 위험) / 신설 status (`PASS_WITH_FALLBACK` 등) 일관성 / frame 변경 허용 trace 설명 | hard link: IMP-04 (catalog 확장 후 fallback path 의미 있음) | implemented |
-| IMP-06 | B-1 Zone-section override | Step 6 + input Step 1, 22 | §2 B-1 새로 만들기 (backend path) | medium | CLI 인자 + composition planner override path 신설 | Kei composition / Phase R' frame 보조 회귀 X / override 적용 시 composition_unit schema 정합 + trace | soft link: IMP-04 (frame 후보 ↑ 시 override 의미 ↑) | pending |
+| IMP-06 | B-1 Zone-section override | Step 6 + input Step 1, 22 | §2 B-1 새로 만들기 (backend path) | medium | CLI 인자 + composition planner override path 신설 | Kei composition / Phase R' frame 보조 회귀 X / override 적용 시 composition_unit schema 정합 + trace | soft link: IMP-04 (frame 후보 ↑ 시 override 의미 ↑) | implemented |
-| IMP-07 | B-2 Edited HTML → MDX reverse path | Step 22 + Step 1, 2 | §2 B-2 새로 만들기 (backend path) | medium | frontend edited HTML → backend → MDX 변환 → pipeline 재진입 (글벗 `html_to_slide_mdx` 참조) | AI/Kei reverse 회귀 X / 재진입 후 step02 정합 + visual_check 통과 | hard link: IMP-02 (A-1 normalize schema 와 reverse path schema 정합 필요) | pending |
+| IMP-07 | B-2 Edited HTML → MDX reverse path | Step 22 + Step 1, 2 | §2 B-2 새로 만들기 (backend path) | medium | frontend edited HTML → backend → MDX 변환 → pipeline 재진입 (글벗 `html_to_slide_mdx` 참조) | AI/Kei reverse 회귀 X / 재진입 후 step02 정합 + visual_check 통과 | hard link: IMP-02 (A-1 normalize schema 와 reverse path schema 정합 필요) | documented:no-runtime |
-| IMP-08 | B-3 Sub-section drag drop | Step 3 | §2 B-3 새로 만들기 (backend schema) | ↓ low | Phase Z `section_id` schema 확장 (sub_sections 단위 매핑) | AI/Kei schema 회귀 X / backward compatible / step03 trace | hard link: IMP-02 (A-1 normalize sub_sections schema 의존) | pending |
+| IMP-08 | B-3 Sub-section drag drop | Step 3 | §2 B-3 새로 만들기 (backend schema) | ↓ low | Phase Z `section_id` schema 확장 (sub_sections 단위 매핑) | AI/Kei schema 회귀 X / backward compatible / step03 trace | hard link: IMP-02 (A-1 normalize sub_sections schema 의존) | implemented |
-| IMP-09 | B-4 다른 layout zone-geometry | Step 8 | §2 B-4 새로 만들기 (backend layout) | ↓ low | `build_layout_css` 분기 확장 (top-1-bottom-2 / left-1-right-2 / grid-2x2 등) | Kei `build_containers_type_b` 회귀 X / step08 trace | none | pending |
+| IMP-09 | B-4 다른 layout zone-geometry | Step 8 | §2 B-4 새로 만들기 (backend layout) | ↓ low | `build_layout_css` 분기 확장 (top-1-bottom-2 / left-1-right-2 / grid-2x2 등) | Kei `build_containers_type_b` 회귀 X / step08 trace | soft back-link: IMP-19 ([reference doc](IMP-19-ZONE-RATIO-REFERENCE.md) — Phase O block-level pattern reference, no runtime integration) | implemented |
-| IMP-10 | D-1 filtered_section_reasons UI | Step 20, 22 | §2 D-1 frontend 신규 | ↓ low | frontend UI — backend artifact read-only 표시 | AI/Kei UI 회귀 X / backend artifact read-only | none | pending |
+| IMP-10 | D-1 filtered_section_reasons UI | Step 20, 22 | §2 D-1 frontend 신규 | ↓ low | frontend UI — backend artifact read-only 표시 | AI/Kei UI 회귀 X / backend artifact read-only | none | implemented |
-| IMP-11 | D-2 Frame min_height 표시 | Step 22 | §2 D-2 새로 만들기 (frontend hint + catalog 참조) | ↓ low | frontend UI — frame contract `min_height_px` read-only + resize hint | AI/Kei UI 회귀 X / catalog 참조 + resize limit | none | pending |
+| IMP-11 | D-2 Frame min_height 표시 | Step 22 | §2 D-2 새로 만들기 (frontend hint + catalog 참조) | ↓ low | frontend UI — frame contract `min_height_px` read-only + resize hint | AI/Kei UI 회귀 X / catalog 참조 + resize limit | none | implemented |
 
 ---
 
@@ -60,15 +60,17 @@
 
 | ID | title | related step | source | priority | scope | guardrail / validation | dependency | status |
 |---|---|---|---|---|---|---|---|---|
-| IMP-12 | Step 16/17 retry 정밀화 | Step 16, 17 | §3 group B (Salvage deterministic) | medium | `redistribute` + glue + font compression — Step 16 router action 신설 + Step 17 action 실행 | AI fallback X / Kei retry loop (H5) 회귀 X / status semantics 일관 | soft link: IMP-05 (Step 16 router 영역 공유, 병렬 가능) | pending |
+| IMP-12 | Step 16/17 retry 정밀화 | Step 16, 17 | §3 group B (Salvage deterministic) | medium | `redistribute` + glue + font compression — Step 16 router action 신설 + Step 17 action 실행 | AI fallback X / Kei retry loop (H5) 회귀 X / status semantics 일관 | soft link: IMP-05 (Step 16 router 영역 공유, 병렬 가능) | implemented |
-| IMP-13 | A-3 frame preview 일관성 | Step 0, 14, 21 | §3 Salvage 후보 | ↓ low | `capture_slide_screenshot` Salvage — preview.png 자동 생성 path | Phase R' reference path 회귀 X / preview artifact trace | soft link: IMP-04 (catalog frame_partial 확장 시 의미 ↑) | pending |
+| IMP-13 | A-3 frame preview 일관성 | Step 0, 14, 21 | §3 Salvage 후보 | ↓ low | `capture_slide_screenshot` Salvage — preview.png 자동 생성 path | Phase R' reference path 회귀 X / preview artifact trace | soft link: IMP-04 (catalog frame_partial 확장 시 의미 ↑) | implemented |
-| IMP-14 | A-4 slide-base iframe mode | Step 13 | §3 새로 만들기 | ↓ low | `slide-base.html` conditional CSS (embedded vs standalone) | Claude / Phase R' HTML generation 회귀 X / Jinja2 deterministic | none | pending |
+| IMP-14 | A-4 slide-base iframe mode | Step 13 | §3 새로 만들기 | ↓ low | `slide-base.html` conditional CSS (embedded vs standalone) | Claude / Phase R' HTML generation 회귀 X / Jinja2 deterministic | none | implemented |
-| IMP-15 | Step 14 visual_check 보강 | Step 14, 21 | §3 H1 Reference Only | medium | image_aspect_mismatch / tabular_overflow 검사 추가 | AI/Kei classification 회귀 X / deterministic 검사 + trace | soft link: IMP-01 (Step 14 측정/trace layer 공유) | pending |
+| IMP-15 | Step 14 visual_check 보강 | Step 14, 21 | §3 H1 Reference Only | medium | image_aspect_mismatch / tabular_overflow 검사 추가 | AI/Kei classification 회귀 X / deterministic 검사 + trace | soft link: IMP-01 (Step 14 측정/trace layer 공유) | implemented |
-| IMP-16 | B-2 verification 보조 axis | Step 1, 2, 14, 21, 22 | §3 H3 Reference Only | ↓ low | B-2 reverse path 의 verification 보조. main reverse path 는 IMP-07, 본 issue 는 text/visual/trace 검증 layer | AI/Kei verification 회귀 X / utility deterministic | hard link: IMP-07 (B-2 main 활성 시점 의미) | pending |
+| IMP-16 | B-2 verification 보조 axis | Step 1, 2, 14, 21, 22 | §3 H3 Reference Only | ↓ low | B-2 reverse path 의 verification 보조. main reverse path 는 IMP-07, 본 issue 는 text/visual/trace 검증 layer | AI/Kei verification 회귀 X / utility deterministic | hard link: IMP-07 (B-2 main 활성 시점 의미) | documented:dormant |
-| **IMP-17** | **AI repair fallback infra** (**carve-out — normal path 밖**) | Step 12, 16, 17 | §3 G3 | (별 axis priority — pending) | `httpx` + SSE streaming + retry + JSON parse pattern reference — light_edit / restructure proposal | **normal path AI 호출 0 — 본 axis = fallback only, normal path 와 분리 설계** / Kei persona 단절 (Phase Q 자산과 단절) | soft link: IMP-04 + IMP-05 (catalog 확장 + V4 fallback 활성 시 의미) | pending |
+| **IMP-17** | **AI repair fallback infra** (**carve-out — normal path 밖**) | Step 12, 16, 17 | §3 G3 | (별 axis priority — pending) | [carve-out boundary + activation gate](IMP-17-CARVE-OUT.md) (3-cond AND: User GO ∧ B4 frame_selection evidence ∧ IMP-04/05 live — full def in u2 doc) — `httpx` + SSE streaming + retry + JSON parse pattern reference — light_edit / restructure proposal. Activation tracker = IMP-31 (#40); current gate state in [`IMP-31-GATE-AUDIT.md`](IMP-31-GATE-AUDIT.md) | **normal path AI 호출 0 — 본 axis = fallback only, normal path 와 분리 설계** / Kei persona 단절 (Phase Q 자산과 단절) | soft link: IMP-04 + IMP-05 (catalog 확장 + V4 fallback 활성 시 의미) | documented (deferred) |
-| IMP-18 | I3 SVG 좌표 보강 | Step 0, 9 | §3 Reference Only | ↓ low | `renderer._preprocess_svg_data` 패턴 reference — frame_partials SVG 좌표 사전 박힘 | Phase R' (renderer.py) 회귀 X | soft link: IMP-04 (frame_partials 등록 후 의미 ↑) | pending |
+| IMP-18 | I3 SVG 좌표 보강 | Step 0, 9 | §3 Reference Only | ↓ low | `renderer._preprocess_svg_data` 패턴 reference — frame_partials SVG 좌표 사전 박힘 — [gap report](IMP-18-SVG-GAP-REPORT.md) | Phase R' (renderer.py) 회귀 X | soft link: IMP-04 (frame_partials 등록 후 의미 ↑) | documented |
-| IMP-19 | I4 zone 비중 분배 | Step 8 | §3 Reference Only | ↓ low | `renderer._group_blocks_by_area` 패턴 reference — zone-level ratio 분배 | Phase O 컨테이너 회귀 X / 직접 통합 X | soft link: IMP-09 (zone 비중 분배 영역 공유) | pending |
+| IMP-19 | I4 zone 비중 분배 | Step 8 | §3 Reference Only | ↓ low | `renderer._group_blocks_by_area` 패턴 reference — zone-level ratio 분배 — [reference doc](IMP-19-ZONE-RATIO-REFERENCE.md) | Phase O 컨테이너 회귀 X / 직접 통합 X | soft link: IMP-09 (zone 비중 분배 영역 공유) | documented |
-| IMP-20 | H2 frame contract validation | Step 10 | §3 Reference Only | ↓ low | `content_verifier.verify_structure` pattern reference — Phase Z frame contract 검증 pattern | Phase Q `REQUIRED_PATTERNS` 값 회귀 X / Phase Z 자체 pattern dict 설계 | soft link: IMP-04 (확장 catalog 적용 시 검증 범위 확대) | pending |
+| IMP-20 | H2 frame contract validation | Step 10 | §3 Reference Only | ↓ low | `content_verifier.verify_structure` pattern reference — Phase Z frame contract 검증 pattern — [reference doc](IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md) | Phase Q `REQUIRED_PATTERNS` 값 회귀 X / Phase Z 자체 pattern dict 설계 | soft link: IMP-04 (확장 catalog 적용 시 검증 범위 확대) | documented |
+
+> **IMP-15 child issues note (#45–#49)** — IMP-15 (Step 14 visual_check 보강) is the parent row; child sub-axes were tracked as separate Gitea issues and are not given standalone backlog rows. Children: #45 (e9b3d2e), #46 (2827622), #47 (535c484), #48 (614c533), #49 (verification-only). Per INTEGRATION-AUDIT-01 §10.3 footnote option to avoid double-counting under IMP-15.
 
 ---
 
@@ -88,7 +90,7 @@
 
 | ID | title | related module | source | priority | scope | guardrail / validation | trigger axis | status |
 |---|---|---|---|---|---|---|---|---|
-| IMP-26 | J3 — html_generator utility 중복 cleanup | §2.9 html_generator | §5 J3 | ↓ low (future) | `normalize_mdx` / `_slice_mdx_sections` / `_get_definitions` / `_get_conclusion` 중복 제거 (vs §2.1/§2.2 SoT) | Phase R' 영역 — 코드 제거만 | Phase R' cleanup axis 활성 시 | pending |
+| IMP-26 | J3 — html_generator utility 중복 cleanup | §2.9 html_generator | §5 J3 | ↓ low (future) | `normalize_mdx` / `_slice_mdx_sections` / `_get_definitions` / `_get_conclusion` 중복 제거 (vs §2.1/§2.2 SoT) | Phase R' 영역 — 코드 제거만 | Phase R' archive trigger AND §2.1/§2.2 SoT signature unification (both preconditions required to keep guardrail = code-removal-only) | deferred |
 | IMP-27 | K5 — catalog 로드 + `_get_block_by_id` 중복 cleanup | §2.10 + §2.8 (3 module) | §5 K5 | ↓ low (future) | block_reference / block_selector / renderer 의 catalog 로드 중복 제거 | Phase R' 영역 또는 Phase Z catalog 확장 axis | Phase Z catalog 확장 axis 활성 시 (soft link: IMP-04) | pending |
 | IMP-28 | L4 — `_parse_json` 중복 cleanup | §2.11 + §2.6 + §2.9 (3 module) | §5 L4 | ↓ low (future) | pipeline / content_editor / html_generator 의 `_parse_json` 중복 제거 | Phase R' 영역 또는 Phase Z utility 통합 axis | Phase R' cleanup 또는 Phase Z utility 통합 axis 활성 시 | pending |
 
@@ -132,3 +134,5 @@ Gitea Issues 활성 sanity check 별 GO ─┐
                               (Codex 1차 → Claude 재검토 → Codex 재검증
                                → 100% 합의 → 구현 → 검증 → close)
 ```
+
+- **IMP-50 audit (2026-05-19)** — [INTEGRATION-AUDIT-01-REPORT.md](INTEGRATION-AUDIT-01-REPORT.md) — Decision: **CONDITIONAL GO for #19** (F-3 backlog status sweep + F-2 family template reconciliation required before #19 Stage 2) — Stage 5 commit SHA: 8c7d693

docs/architecture/PHASE-Z-PIPELINE-STATUS-BOARD.md

@@ -46,7 +46,7 @@ Step 0 은 본체가 아닌 *준비 조건*. Step 1 (MDX 업로드) 부터가 ru
 | A | 7 | Slide-Level Layout Planning | ⚠ partial (count-based / 7-A catalog + 7-B candidate fn 추가, runtime 호출처 X) |
 | A | 8 | Zone + Internal Region Ratio Planning | ⚠ partial (zone-level horizontal-2 만 dynamic / 8-A region+display catalog + 8-B-1/2 candidate fn 추가, runtime 호출처 X / region-level 은 B2 안 partial) |
 | A | 9 | Region-Level Frame / Display Selection | ⚠ partial (B4 가 catalog cover + declaration order 로 frame 선택 분담 / V4 evidence 미통합 / Step 5 와 conflate 잔존) |
-| A | 10 | Frame Contract 확인 | ⚠ partial (B3 의 accepted_content_types + sub_zones 선언 추가 — B4 만 읽음, mapper 미읽음 / density envelope 별 axis) |
+| A | 10 | Frame Contract 확인 | ⚠ partial (B3 의 accepted_content_types + sub_zones 선언 추가 — B4 만 읽음, mapper 미읽음 / density envelope 별 axis) — IMP-20 ref: [reference doc](IMP-20-FRAME-CONTRACT-VALIDATION-REFERENCE.md) |
 | A | 11 | Content Unit / Child Group → Internal Region → Frame Slot Mapping | ⚠ partial (B4 v0 dormant 2-stage + region 1:1 sub_zone + narrowest first + trace-only runtime 호출, render path 미연결) |
 | A | 12 | Slot Payload 생성 | ✅ (deterministic) |
 | B | 13 | Render | ✅ |
@@ -157,6 +157,8 @@ Step 0 (사전 준비) 의 Figma → HTML 변환은 *precondition phase 의 작
 
 다른 step 에서의 AI 호출은 본 도면 안에 *없음*.
 
+> **Activation status reference** : runtime AI fallback (Step 12 light_edit / restructure) 는 IMP-17 carve-out infra + IMP-31 activation tracker (#40) 로 관리. carve-out boundary = [`IMP-17-CARVE-OUT.md`](IMP-17-CARVE-OUT.md). current 3-condition AND gate state + issue-body axis verdict = [`IMP-31-GATE-AUDIT.md`](IMP-31-GATE-AUDIT.md). 본 board 는 verdict 중복 X — gate / axis 판정은 audit doc 따름.
+
 ---
 
 ## 6. 현재 병목 (한 줄)
@@ -165,6 +167,66 @@ Step 0 (사전 준비) 의 Figma → HTML 변환은 *precondition phase 의 작
 
 ---
 
+## 7. Multi-MDX regression markers (IMP-91)
+
+> CI workflow `.github/workflows/multi-mdx-regression.yml` rewrites these via `scripts/update_status_board.py` after each push / PR. Initial value `?` = not yet observed. `PASS` / `FAIL` / `ERR` / `SKIP` = last CI run outcome per axis × mdx. Untouched markers remain `?` so collection failures are loud, not silent.
+
+| axis | mdx 01 | mdx 02 | mdx 03 | mdx 04 | mdx 05 |
+|---|---|---|---|---|---|
+| F0 normalize           | <!-- IMP-91:F0:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F0:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F0:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F0:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F0:05 -->?<!-- /IMP-91 --> |
+| F1 V4 ranking          | <!-- IMP-91:F1:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F1:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F1:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F1:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F1:05 -->?<!-- /IMP-91 --> |
+| F2 slot_payload        | <!-- IMP-91:F2:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F2:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F2:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F2:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F2:05 -->?<!-- /IMP-91 --> |
+| F3 classifier-only AI  | <!-- IMP-91:F3:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F3:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F3:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F3:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F3:05 -->?<!-- /IMP-91 --> |
+| F4 layout              | <!-- IMP-91:F4:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F4:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F4:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F4:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F4:05 -->?<!-- /IMP-91 --> |
+| F5 final.html          | <!-- IMP-91:F5:01 -->?<!-- /IMP-91 --> | <!-- IMP-91:F5:02 -->?<!-- /IMP-91 --> | <!-- IMP-91:F5:03 -->?<!-- /IMP-91 --> | <!-- IMP-91:F5:04 -->?<!-- /IMP-91 --> | <!-- IMP-91:F5:05 -->?<!-- /IMP-91 --> |
+
+---
+
+## 8. IMP-43 (#72) `--reuse-from` measured savings
+
+> Stage 2 §u8 binding contract: the issue-body 50–70% / 10–20s → 3–8s claim is **unverified** and is **not** mirrored here. Numbers below come from `scripts/measure_reuse_savings.py` on the project reference host; until that script is run and the values committed, every cell stays `TBD`.
+
+| axis | value |
+|---|---|
+| measurement script | `scripts/measure_reuse_savings.py` |
+| reuse boundary (Stage 1 lock) | Step 0 / 1 / 2 / 5 / 6 only; Step 7+ re-executes |
+| full rerun seconds (p50) | TBD |
+| full rerun seconds (p95) | TBD |
+| reuse seconds (p50) | TBD |
+| reuse seconds (p95) | TBD |
+| reuse / full ratio (p50) | TBD |
+| last measured | TBD (date / host / mdx / iterations) |
+
+Run protocol (per iteration): `(A)` seed → `(B)` full rerun with one self-discovered `--override-frame` pin → `(C)` `--reuse-from <seed>` with the same pin. The `(A)` seed time is reported separately and **not** included in the B-vs-C comparison — the reuse path's whole point is that the seed already exists from a prior interactive run.
+
+Invocation: `python -m scripts.measure_reuse_savings samples/mdx_batch/02.mdx --iterations 5` (mdx is argv-driven; the script does not pin a sample internally).
+
+---
+
+## 9. IMP-95 (V4 evidence → B4 `_select_frame` integration) sub-axis markers
+
+> Sub-axis carve-out of section 3 item (j) for IMP-95. Pair-comment markers
+> `<!-- IMP-95:<axis> -->VALUE<!-- /IMP-95 -->`. Closing tag `<!-- /IMP-95 -->`
+> is intentionally distinct from IMP-91's `<!-- /IMP-91 -->` so the IMP-91
+> updater (`scripts/update_status_board.py`) cannot rewrite IMP-95 cells.
+> Allowed values: `pending` (not implemented), `trace-only` (default-OFF flag
+> `PHASE_Z_B4_V4_EVIDENCE`, additive telemetry only — no render-path change),
+> `guarded` (default-OFF regression harness landed and runs locally), `active`
+> (default-ON — not the current IMP-95 target).
+
+| sub-axis | status |
+|---|---|
+| j1 V4-aware selector under `accepted_content_types ⊇` (u2)        | <!-- IMP-95:j1 -->trace-only<!-- /IMP-95 --> |
+| j2 `plan_placement` v4_candidates kwarg + selection_trace (u3)    | <!-- IMP-95:j2 -->trace-only<!-- /IMP-95 --> |
+| j3 Step 11 `placement_trace` hoist (u4)                           | <!-- IMP-95:j3 -->trace-only<!-- /IMP-95 --> |
+| j4 Gatekeeper `v4_short_circuit` telemetry (u5)                   | <!-- IMP-95:j4 -->trace-only<!-- /IMP-95 --> |
+| j5 `partial_exists` precheck (u6)                                 | <!-- IMP-95:j5 -->trace-only<!-- /IMP-95 --> |
+| j6 Flag-OFF SHA parity regression on mdx 01/02/04/05 (u8)         | <!-- IMP-95:j6 -->guarded<!-- /IMP-95 --> |
+| j7 Flag-ON adapter_needed monotone regression (u9)                | <!-- IMP-95:j7 -->guarded<!-- /IMP-95 --> |
+| j8 Flag-ON `placement_trace` field presence regression (u10)      | <!-- IMP-95:j8 -->guarded<!-- /IMP-95 --> |
+
+---
+
 ## 사용 방법
 
 - 새 작업 들어오면 → 본 board 의 *어느 step* 의 status 를 바꾸는 작업인지 식별

docs/architecture/PROJECT-INTENT-AND-GOVERNANCE.md

@@ -0,0 +1,182 @@
+# 프로젝트의 목적과 거버넌스
+
+> 이 문서는 **왜** 이 프로젝트를 하는지, **무엇을 위해** 이슈와 audit 을 도는지, 그리고 **그 구조가 어떻게 짜여있는지** 기록한다. 매번 처음부터 설명하지 않기 위함.
+>
+> 작성: 2026-05-20.
+
+---
+
+## 1. Destination (도착점)
+
+**Phase Z 가 다음 두 가지까지 작동하면 프로젝트 목표 달성**:
+
+1. **22-step pipeline** end-to-end 작동
+   - 참조: [`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md)
+   - 현재 status: [`PHASE-Z-PIPELINE-STATUS-BOARD.md`](PHASE-Z-PIPELINE-STATUS-BOARD.md)
+2. **AI 가 zone fit 평가 → 안 맞는 frame reject → zone 에 맞는 frame 생성**
+   - frame 이 zone 안에 들어가지 않으면 AI 가 reject
+   - reject 후 zone 에 맞춰 frame 을 생성하는 것까지가 destination
+
+이 두 가지가 작동하면 끝. 그 이상은 별도 결정.
+
+---
+
+## 2. Q~Y 검토 = 이미 끝났음 (과거형)
+
+Phase Z 구현 갭을 메우기 위해 Phase Q~Y 의 코드/기능을 **이미 다 검토했고**, 참고할 만한 것들을 22-step 에 매칭해서 **이슈로 다 정리해놓은 상태**.
+
+- Q~Y 새로 다시 보지 않음 — 작업은 끝남
+- 결과물 = INSIGHT-MAP 문서 + 28 개 초기 IMP 이슈 (#1~#28)
+- 회귀 금지선 4 항목 (Q/R'/T 의 폐기된 path 로 돌아가지 않음) 도 [`PHASE-Q-INSIGHT-TO-22STEP-MAP.md §0`](PHASE-Q-INSIGHT-TO-22STEP-MAP.md) 에 같이 박혀있음
+
+이제 남은 일 = **정리된 이슈를 orchestrator 로 처리해서 Phase Z 에 반영하는 것**.
+
+---
+
+## 3. 그 검토 결과 = INSIGHT-MAP 문서
+
+**문서**: [`PHASE-Q-INSIGHT-TO-22STEP-MAP.md`](PHASE-Q-INSIGHT-TO-22STEP-MAP.md)
+
+Q~Y 검토 결과를 22-step 의 어느 step 에 어떤 부품을 가져올지 매핑해서 정리한 catalog. 섹션 구성:
+
+- §0: 목적 + 회귀 금지 4 항목 + Archive marker inventory (9 개)
+- §1: SoT read result + 22 Step status snapshot
+- §2: Salvage chained + new-make backend axes
+- §3: Reference / carve-out
+- §4: audit §1 lens column 정정
+- §5: Module duplication cleanup
+
+각 § cell 이 IMP 이슈로 1-to-1 분해됨.
+
+---
+
+## 4. IMP 이슈 = INSIGHT-MAP § cell 의 execution unit
+
+**초기 28 개 (2026-05-12 한 번에 생성, #1~#28)**:
+
+| INSIGHT-MAP § | 이슈 |
+|---|---|
+| §2 (Salvage chained + new-make backend) | #1~#11 (IMP-01~11: A-1~A-6, B-1~B-4, D-1, D-2) |
+| §3 (Reference / carve-out) | #12~#20 (IMP-12~20: A-3/A-4, B-2, AI fallback, frame contract 등) |
+| §4 (audit §1 lens column 정정) | #21~#25 (IMP-21~25: G2, I6, J5, K6, L5) |
+| §5 (Module duplication cleanup) | #26~#28 (IMP-26~28: J3, K5, L4) |
+
+**모든 IMP 이슈 본문에 표준 anchor**:
+```
+**관련 step**: Phase Z 22-step 좌표
+**source**: INSIGHT-MAP §X (Q~Y 부품 출처)
+**priority**: ↑ high / medium / ↓ low
+**scope**: 구체 작업
+**guardrails**: 깨면 안 되는 contract
+```
+
+**이후 추가된 이슈** (모두 source 명시):
+
+| 이슈 | source | 의미 |
+|---|---|---|
+| #38~#41 (IMP-29~32) | IMP-05 §5 defer + Codex 분석 | V4 fallback 후 frontend bridge / AI adaptation 등 |
+| #42 (IMP-04b) | IMP-04 milestone close 후 잔여 | Catalog 32 frames 확장 |
+| #43, #44 | MDX 03/04/05 작업 중 발견 | 프론트 작업에서 발견된 새 axis |
+| #45~#49 | #15 (Step 14 visual_check) decomposition | parent → 5 execution children |
+| #50 | governance audit | 초반 28 다수 close 후 INTEGRATION-AUDIT-01 |
+| #51~#54 | #50 audit 의 발견 (F-1~F-5) | follow-up 분리 처리 |
+| #55 | #20 closed 후 runtime defer | doc-axis closed, runtime 별도 |
+
+→ 추가 이슈도 모두 (관련 step, source, priority) 좌표로 anchor.
+
+---
+
+## 5. orchestrator 의 역할
+
+이슈 처리의 **disciplined executor**.
+
+**파일**: [`orchestrator.py`](../../orchestrator.py) (현재 line 수: ~1500)
+**테스트**: [`tests/orchestrator_unit/`](../../tests/orchestrator_unit/) (현재 94 케이스)
+
+**6 stage workflow**:
+1. problem-review — 문제 검토
+2. simulation-plan — 시뮬 기반 계획 수립 (IMPLEMENTATION_UNITS YAML 강제)
+3. code-edit — 코드 수정 / 이슈 분기
+4. test-verify — 테스트 및 검증
+5. commit-push — 커밋 및 푸쉬
+6. final-close — 최종 확인 / close
+
+**원칙**:
+- Claude (executor) + Codex (verifier) 양쪽 합의 + evidence required
+- 단일 LLM 의견 X
+- 매 stage 마다 dual-write (local draft + Gitea comment)
+- exit report = stage 완료의 binding contract
+
+**audit-only mode (P4/P4a)**:
+- 제목에 `[INTEGRATION-AUDIT-*]`/`[AUDIT-ONLY]` 또는 `--audit-only` CLI flag
+- Stage 3 에서 `src/`, `templates/`, `tests/` 변경 자동 reject (deterministic git diff guard)
+- Stage 5 commit 범위 = `docs/architecture/INTEGRATION-AUDIT-*.md` + `BACKLOG.md` 만 허용
+- audit 이슈는 fix 안 함 → follow-up 이슈로 분리
+
+---
+
+## 6. Audit cycle (meta-governance)
+
+이슈 진행으로 인한 누적 drift / 충돌 / 하드코딩 / 매핑 누락을 주기적으로 검증.
+
+**audit 자체는 코드 안 만짐**. 발견 사항은 별도 이슈로 분리해서 일반 workflow 로 처리.
+
+**현재까지**:
+- #50 INTEGRATION-AUDIT-01 (closed 2026-05-19)
+  - 산출: [`INTEGRATION-AUDIT-01-REPORT.md`](INTEGRATION-AUDIT-01-REPORT.md) + [`INTEGRATION-AUDIT-01-MATRIX.md`](INTEGRATION-AUDIT-01-MATRIX.md)
+  - 발견 F-1~F-5 → #51~#54 로 분리 (모두 closed)
+
+**다음 audit 시점 trigger**:
+- 닫힌 IMP 이슈가 일정 수 누적될 때 (5+ 연속)
+- debug.json schema / layout / frame contract / router / visual_check_passed 의미가 바뀔 때
+- 새 parent axis 진입 직전 (예: #19 → #20 → ...)
+- 큰 feature 축 (#42 catalog 확장 / #38~#41 frontend bridge) 완료 후
+
+---
+
+## 7. 도착점 도달 기준
+
+다음이 모두 작동해야 destination 도달:
+
+- [ ] 22-step pipeline end-to-end (Step 0~22 모두 contract 준수, 회귀 0)
+- [ ] AI 가 frame 을 zone fit 기준으로 평가 → 안 맞으면 reject
+- [ ] reject 후 AI 가 zone 에 맞춰 frame 생성
+- [ ] 하드코딩 0 (sample-specific 코드 없음 — anti-hardcoding mechanical check 통과)
+- [ ] 모든 IMP 이슈 backlog 의 closed / documented (deferred) / pending 분류가 [`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md) 와 code reality 일치
+
+---
+
+## 8. 자주 헷갈리는 것들 (anti-patterns — 하지 말 것)
+
+| 잘못된 framing | 옳은 framing |
+|---|---|
+| "Phase Q~Y heritage 를 보존한다" | Q~Y 는 부품 창고. 갭에 필요한 것만 선택적 참조 |
+| "MDX 03 잘 만들면 끝" | 재사용 가능한 pipeline contract 가 목표. 특정 샘플 최적화 X |
+| "audit 가 발견하면 그 자리에서 고친다" | follow-up 이슈로 분리. audit 자체는 코드 안 만짐 |
+| "Claude 가 좋다고 하면 OK" | Claude + Codex 합의 + evidence 필수 |
+| "이슈 본문은 참고일뿐" | 본문의 (관련 step, source, scope, guardrails) 가 binding anchor |
+| "Phase R / R' / Q 의 path 로 돌아가도 됨" | 회귀 금지선 4 항목 (INSIGHT-MAP §0) 절대 위반 X |
+| "destination 외 추가 기능도 욕심내자" | 22-step + AI frame generation 까지가 목표. 그 이상은 별도 결정 |
+| "문서에 박힌 dormant 항목은 자동 실행 안 됨" | L3 registry [`DORMANT-TRIGGERS.yaml`](DORMANT-TRIGGERS.yaml) + `scripts/check_dormant_triggers.py` 가 orchestrator Stage 4→5 transition 에서 informational alert 로 발화 (closed 이슈 #16/#17/#18/#19/#20 의 trigger-on-X contract) |
+
+---
+
+## 9. 핵심 참조 문서 한 곳에
+
+| 문서 | 역할 |
+|---|---|
+| [`PROJECT-INTENT-AND-GOVERNANCE.md`](PROJECT-INTENT-AND-GOVERNANCE.md) | **이 문서** — 왜/무엇을 |
+| [`PHASE-Q-INSIGHT-TO-22STEP-MAP.md`](PHASE-Q-INSIGHT-TO-22STEP-MAP.md) | INSIGHT-MAP — Q~Y → Z 매핑 catalog |
+| [`PHASE-Z-PIPELINE-OVERVIEW.md`](PHASE-Z-PIPELINE-OVERVIEW.md) | 22-step pipeline 정의 |
+| [`PHASE-Z-PIPELINE-STATUS-BOARD.md`](PHASE-Z-PIPELINE-STATUS-BOARD.md) | 22-step 현재 status |
+| [`PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md`](PHASE-Z-IMPLEMENTATION-ISSUE-BACKLOG.md) | IMP 이슈 backlog (closed/documented/pending) |
+| [`PHASE-Z-ROADMAP.md`](PHASE-Z-ROADMAP.md) | 진행 로드맵 |
+| [`INTEGRATION-AUDIT-01-REPORT.md`](INTEGRATION-AUDIT-01-REPORT.md) | 첫 audit 사이클 결과 |
+| [`../../orchestrator.py`](../../orchestrator.py) | disciplined executor (Claude + Codex 합의 workflow) |
+| [`../../CLAUDE.md`](../../CLAUDE.md) | AI 가 코드 작업할 때 따를 규칙 |
+
+---
+
+## 10. 한 줄 요약
+
+> **Phase Z 가 "22-step pipeline + AI zone-fit frame generation" 까지 작동하는 것이 destination. Z 구현의 갭은 Phase Q~Y 를 부품 창고로 보고 선택적으로 참조해서 메움. INSIGHT-MAP 이 그 catalog, IMP 이슈가 execution unit. orchestrator 가 Claude + Codex 합의 + evidence 로 disciplined 하게 처리. INTEGRATION-AUDIT 가 주기적으로 누적 정합성 검증, 발견은 follow-up 이슈로 분리. 도착점은 22-step + AI frame generation 까지이고 그 이상은 별도 결정.**

docs/reference/architecture/5_MDX_STRUCTURE_INVENTORY.md

@@ -0,0 +1,119 @@
+# Five-MDX Structure Inventory
+
+Issue: #98
+
+Purpose: establish the empirical ground truth for T22-T30 before changing
+the parser, matcher, layout planner, slot mapper, frontend override path, or
+AI adaptation path.
+
+This inventory intentionally compares three layers:
+
+| Column | Meaning | Gap type exposed |
+|---|---|---|
+| A. Original MDX contains | What the source file actually expresses | Source structure |
+| B. Current pipeline sees | What the current `task21d_*` runs expose in Step 02 / Step 06 / Step 20 | Parser, normalizer, component, and planner behavior |
+| C. Expected result | What the slide pipeline should preserve and render | Layout, matching, slot mapping, override, and adaptation behavior |
+
+Source files inspected:
+
+- `samples/mdx/01. ... .mdx`
+- `samples/mdx/02. ... .mdx`
+- `samples/mdx/03. ... .mdx`
+- `samples/mdx/04. ... .mdx`
+- `samples/mdx/05. ... .mdx`
+
+Observed pipeline runs:
+
+- `data/runs/task21d_01`
+- `data/runs/task21d_02`
+- `data/runs/task21d_03`
+- `data/runs/task21d_04`
+- `data/runs/task21d_05`
+
+## MDX 01
+
+| A. Original MDX contains | B. Current pipeline sees | C. Expected result | Gap owner |
+|---|---|---|---|
+| A pre-intro block before the first numbered `##` heading. It includes a details/popup block and is user-visible content. | Step 02 only emits `01-1` and `01-2`. The pre-intro has no unit id. Existing `data/user_overrides/01.json` references `01-3`, but that id is orphaned. | Promote the pre-intro into a first-class unit such as `01-intro`, or define a documented alias/migration path for the existing `01-3` override. | T22 parser/normalizer and override migration |
+| `## 1` and `## 2` numbered sections. | Step 06 selects two units: `01-1 -> construction_bim_three_usage`, `01-2 -> bim_dx_comparison_table`. | Body zones should be based on the normalized section tree after the pre-intro policy is decided. | T24 layout policy |
+| An image reference in section 2 and details/popup content. | Recent asset handling removes broken image icons, but popup/details semantics remain only partially represented. | Image and popup/details nodes must be explicit node types, not raw markdown leftovers. | T22 node taxonomy and T25 slot mapping |
+
+## MDX 02
+
+| A. Original MDX contains | B. Current pipeline sees | C. Expected result | Gap owner |
+|---|---|---|---|
+| `## 1` with goal content and one image. | Step 02 emits `02-1`. Step 06 selects `construction_goals_three_circle_intersection`. A user override exists for `02-1`, but frontend/runtime override behavior is not proven end-to-end. | Section `02-1` must remain independently addressable, and selected/overridden frames must render without stale preview or silent fallback. | T28 frontend override E2E |
+| `## 2`, with `### 2.1` and `### 2.2`. | Step 02 emits only parent `02-2`; child headings are raw content inside the section. | `2.1` and `2.2` should become frame-internal groups under the `02-2` unit, not separate slide zones unless a layout policy explicitly asks for that. | T22/T25 |
+| `<DxEffect />`, which represents the stakeholder/persona effect table in `samples/src/components/dx.astro`. | The pipeline sees an opaque component tag; persona columns are not expanded into semantic nodes. | Register `DxEffect` in a component expansion registry and expand it into persona/table nodes before matching and slot mapping. | T23 component expansion |
+
+## MDX 03
+
+| A. Original MDX contains | B. Current pipeline sees | C. Expected result | Gap owner |
+|---|---|---|---|
+| `## 1` with three conceptual groups: technology, people, and environment/nature. | Step 06 selects `three_parallel_requirements` for `03-1`. Technical text coverage is currently PASS. | Child groups should populate the internal pillar labels and body slots of the selected frame. They must not become external slide titles. | T25 slot mapping |
+| `## 2` with `### 2.1` process and `### 2.2` product, including table-like content. | Step 06 selects `process_product_two_way` for `03-2`. | Process/product child groups should map to the selected two-way frame with all source atoms preserved. | T25/T27 |
+| Dense content in two zones. | Presentation can still become visually dense even when technical coverage is PASS. | Fit must be solved through zone sizing, frame expansion, or layout choice, not font shrinking or text truncation. | T27 and T30 |
+
+## MDX 04
+
+| A. Original MDX contains | B. Current pipeline sees | C. Expected result | Gap owner |
+|---|---|---|---|
+| `## 1` with several perception/problem groups. | Step 06 selects `pre_construction_model_info_stacked` with a reject/provisional path. Step 20 marks design readiness as `needs_review`. | Reject/provisional candidates must remain visible as candidates, but the slide should surface that adaptation is required. | T26 candidate policy |
+| `## 2` with `### 2.1` and `### 2.2`, plus details blocks. | Step 06 keeps parent `04-2` and selects `bim_issues_quadrant_four`; earlier runs showed child handling instability. | Child groups under `04-2` should become internal quadrant/list items in source order. | T25 slot mapping |
+| Content is larger than the currently chosen zones in some layouts. | Technical PASS does not guarantee presentation readiness. | The system should resize/replan zones or expand frame structure. It must not shrink font size to hide overflow. | T24/T27/T30 |
+
+## MDX 05
+
+| A. Original MDX contains | B. Current pipeline sees | C. Expected result | Gap owner |
+|---|---|---|---|
+| Two top-level numbered sections, `05-1` and `05-2`. | Step 06 now emits two units, but both use `three_parallel_requirements` through `generic_fallback`. Step 20 marks design readiness as `not_ready`. | Sections must stay separated, and fallback/generic frames must be visible as not ready unless a real matching/adaptation path is used. | T24/T26 |
+| `05-2` uses numeric `### 1` and `### 2` headings, not decimal `### 2.1` style headings. | These child headings are raw section content. | The contract must decide whether numeric child headings are allowed input or require MDX standardization. | T21.6/T22 |
+| User-selected alternative frames can work through CLI override, but UI selection has not been proven. | `data/user_overrides/05.json` contains zone assignment but no `frames` override. | Frontend frame selection must persist `frames` and backend must apply the selected frame without stale preview or silent no-op. | T28 frontend override E2E |
+
+## Aggregate Node Inventory
+
+| Node type | Found in | Current state | Contract decision needed |
+|---|---|---|---|
+| `pre_intro` | MDX 01 | Not promoted to a unit | Allow as first-class unit or require source standardization |
+| `numbered_section` | MDX 01-05 | Parsed as top-level units | Keep as the main slide-zone unit type |
+| `subsection_decimal` | MDX 02, 03, 04 | Usually raw content under parent | Map to frame-internal groups unless explicitly split |
+| `subsection_numeric` | MDX 05 | Raw content under parent | Decide whether allowed or normalized to decimal form |
+| `component_ref` | MDX 02 `<DxEffect />` | Opaque tag | Registry-based component expansion |
+| `image_ref` | MDX 01, MDX 02 | Asset copy now works for known frame images; content images still need typed handling | Explicit image node and image slot policy |
+| `details_popup` | MDX 01, MDX 04 | Raw markdown/html-like content | Explicit popup/details node and presentation policy |
+| `table_like_content` | MDX 01 details, MDX 02 component, MDX 03 table | Partly raw content | Explicit table/comparison nodes |
+| `summary_footer` | All five MDX samples conceptually | Must stay outside body frame zones | Fixed base-slide region, not a body layout zone |
+
+## Aggregate Gap List
+
+| Gap | Evidence | Next task |
+|---|---|---|
+| Pre-intro content lacks stable unit identity | MDX 01 source has visible content before the first `##`; Step 02 emits only `01-1` and `01-2`; override references orphan `01-3` | T22 |
+| Registered component expansion does not exist | MDX 02 uses `<DxEffect />`; current parser sees only the component tag | T23 |
+| Child headings need frame-internal mapping | MDX 02/03/04/05 child headings remain raw content or map inconsistently | T25 |
+| Generic fallback can be technically PASS but design-not-ready | MDX 05 uses `generic_fallback` for both units | T26/T30 |
+| Frontend override persistence is not proven | MDX 05 override JSON has no `frames`; CLI override works separately | T28 |
+| Fit is still a structure/layout problem, not a font problem | MDX 03/04 can be dense; policy forbids font shrinking | T24/T27/T30 |
+
+## Immediate Contract Decisions For T21.6
+
+1. Unit identity policy:
+   - Prefer stable explicit ids such as `01-intro`, not implicit renumbering.
+   - Existing user override aliases such as `01-3` need a tested migration or compatibility rule.
+2. Component registry:
+   - Start with `DxEffect`.
+   - New components must be added through registry entries, not one-off parser branches.
+3. Child-section policy:
+   - Top-level `## n.` sections map to body zones.
+   - Child headings map to internal frame slots by default.
+4. Allowed input policy:
+   - `## n. Title` is allowed.
+   - Registered component tags are allowed.
+   - Unregistered component tags are unsupported.
+   - Raw JSX/style blobs are disallowed in rendered text and must be sanitized or rejected.
+5. Coverage-state policy:
+   - `covered_native`: current frame and builder can render source atoms verbatim.
+   - `covered_via_expand`: current frame can render after deterministic repeat/expand.
+   - `requires_adaptation`: visual motif is usable, but an adapted schema is needed.
+   - `unsupported`: no current contract path; must be surfaced honestly.
+

docs/reference/architecture/MDX_TO_FRAME_STRUCTURE_CONTRACT.md

@@ -0,0 +1,189 @@
+# MDX-to-Frame Structure Contract
+
+Issue: #98
+
+Status: draft contract for T22-T30.
+
+This document converts `5_MDX_STRUCTURE_INVENTORY.md` into a shared
+contract for parser normalization, component expansion, layout selection,
+frame candidate ranking, slot mapping, frontend override behavior, and AI
+adaptation.
+
+The contract is deliberately process-first. It must not introduce MDX-id
+special cases, generated text, font shrinking, or silent fallback.
+
+## 1. Non-Negotiable Policies
+
+| Policy | Rule |
+|---|---|
+| Source text preservation | MDX source atoms are copied verbatim into rendered slots. No omission, summary, inference, or rewriting. |
+| AI isolation | AI may propose adapted frame structure only. AI must not output new or modified MDX text. |
+| Unit separation | Top-level content units must not be silently merged. |
+| Child mapping | Child headings and groups usually map to frame-internal labels/body slots, not independent slide titles. |
+| Summary/footer | Summary/footer content belongs to the fixed base-slide region, not body layout zones. |
+| Fit policy | Do not reduce font size to force fit. Use layout, zone sizing, frame expansion, or needs-review state. |
+| Candidate honesty | Reject/provisional candidates remain visible with status. They are not deleted and not treated as ready. |
+| No silent swap | If selected frame and rendered frame differ, record a failure or explicit adaptation state. |
+| No debug leakage | Internal ids, counters, and pipeline labels must not appear in presentation output. |
+
+## 2. Node Taxonomy
+
+| Node type | Definition | Unit role | Examples from inventory |
+|---|---|---|---|
+| `pre_intro` | Visible content before the first numbered `##` heading | Optional top-level unit | MDX 01 intro/details before `## 1` |
+| `numbered_section` | `## n. Title` top-level section | Default slide body unit | MDX 01-05 |
+| `subsection_decimal` | `### n.m Title` child section | Frame-internal group by default | MDX 02, 03, 04 |
+| `subsection_numeric` | `### n Title` child section without parent decimal prefix | Allowed only if normalized to parent-scoped child id | MDX 05 |
+| `bullet_group` | Consecutive bullet lines under a unit or child heading | Slot body group | MDX 01-05 |
+| `table_like_content` | Markdown table, component-expanded table, or details table | Table/comparison slot group | MDX 01 details, MDX 02 `DxEffect`, MDX 03 |
+| `image_ref` | Markdown image reference with alt text and src | Image slot | MDX 01, MDX 02 |
+| `component_ref` | Registered MDX/Astro component tag | Expanded node tree | MDX 02 `<DxEffect />` |
+| `details_popup` | `<details>` block or equivalent collapsible detail source | Popup/detail body slot or auxiliary note | MDX 01, MDX 04 |
+| `summary_footer` | Closing summary or key message outside body frame zones | Fixed footer/base-slide region | All five samples conceptually |
+
+## 3. Unit Identity Rules
+
+| Input pattern | Unit id policy | Notes |
+|---|---|---|
+| `pre_intro` before first numbered section | `<mdx_id>-intro` | Existing orphan overrides such as `01-3` need alias migration to this id. |
+| `## n. Title` | `<mdx_id>-<n>` | This remains the stable primary unit id. |
+| `### n.m Title` under parent `n` | `<mdx_id>-<n>-sub-<m>` if materialized, otherwise child node under parent | Materialization must be explicit; default is internal child node. |
+| `### k Title` under parent `n` | `<mdx_id>-<n>-sub-<k>` after parent-scoped normalization | This covers MDX 05 numeric child headings. |
+| Registered component | Stays under containing unit unless registry declares child units | `DxEffect` should expand under `02-2`. |
+
+Override compatibility:
+
+- Existing overrides that reference missing ids must not be silently ignored.
+- A compatibility alias table must be emitted during T22 when a prior id can be
+  mapped safely, such as `01-3 -> 01-intro` if that is confirmed as user
+  intent.
+- If an override id cannot be resolved, the frontend and pipeline trace must
+  show `override_unresolved`.
+
+## 4. Slot Taxonomy
+
+| Slot type | Meaning | Text source |
+|---|---|---|
+| `title` | Top-level frame title | Unit title only |
+| `label` | Short internal group label | Child heading or source label atom only |
+| `body_text_lines` | Paragraph or bullet text | Source atoms only |
+| `pillar` | Generic repeated vertical group with label/body | Child heading plus child body |
+| `persona_column` | Stakeholder/persona column | Component-expanded table/persona node |
+| `comparison_cell` | Cell in two-column or multi-column comparison | Source table cell or bullet group |
+| `table_row` | Repeated row in a table-like frame | Source row or key/value atom |
+| `image_target` | Frame image slot | Source image_ref, never decorative generated image |
+| `popup_body` | Detail/popup auxiliary content | Source details content |
+| `footer_summary` | Fixed summary/footer region | Summary source only |
+
+`pillar` is a generic repeated group concept. `three_parallel_requirements`
+uses it as one concrete family implementation, but the slot type itself is not
+limited to that frame.
+
+## 5. Node-to-Slot Mapping Matrix
+
+| Node type | Allowed target slots | Default behavior | Disallowed behavior |
+|---|---|---|---|
+| `pre_intro` | `title`, `label`, `body_text_lines`, `popup_body` | Treat as a top-level unit when visible and substantial | Dropping it because it precedes `## 1` |
+| `numbered_section` | `title`, `body_text_lines`, `image_target`, `table_row` | One body zone unit by default | Merging with another top-level section without explicit user action |
+| `subsection_decimal` | `label`, `body_text_lines`, `pillar`, `comparison_cell`, `table_row` | Internal frame group | Using child title as the whole slide title when parent is the unit |
+| `subsection_numeric` | `label`, `body_text_lines`, `pillar` | Normalize under current parent | Treating it as a new top-level section |
+| `bullet_group` | `body_text_lines`, `comparison_cell`, `table_row` | Preserve bullet text verbatim | Rewriting or summarizing |
+| `table_like_content` | `table_row`, `comparison_cell`, `persona_column` | Preserve cells verbatim | Flattening into prose without trace |
+| `image_ref` | `image_target` | Resolve source image path and alt text | Broken image icon or decorative replacement |
+| `component_ref` | Registry-defined expanded nodes | Expand before matching | Passing opaque tag into rendered text |
+| `details_popup` | `popup_body`, optional note slot | Preserve hidden/detail text in trace and supported frames | Leaking raw `<details>` markup as prose |
+| `summary_footer` | `footer_summary` | Fixed base-slide region | Consuming a body layout zone |
+
+## 6. Component Expansion Registry Contract
+
+Registry file:
+
+- `templates/phase_z2/catalog/component_expansion_registry.yaml`
+
+Initial required entry:
+
+- `DxEffect`
+
+Rules:
+
+- Registered components expand into typed nodes before matching.
+- Unregistered component tags are `unsupported`, not silently rendered as text.
+- Component expansion is data-driven through the registry, not a one-off parser
+  branch.
+- Expanded text still follows source preservation: copied from component source,
+  not generated.
+
+## 7. Coverage-State Taxonomy
+
+The same state labels must be used by Step 05/06/20, frontend candidate panel,
+and AI adaptation routing.
+
+| State | Meaning | User-facing behavior | AI behavior |
+|---|---|---|---|
+| `covered_native` | Existing frame and builder can render all required source atoms verbatim | Candidate is selectable and renderable | No AI |
+| `covered_via_expand` | Existing frame can render after deterministic repeat/expand | Candidate is selectable with expansion note | No AI |
+| `requires_adaptation` | Visual motif is usable, but slot schema/repeat structure must be adapted | Candidate is selectable with AI-adaptation badge | AI may propose adapted schema only |
+| `unsupported` | No current contract path | Show unsupported / needs design asset | No automatic AI text or hidden fallback |
+
+Reject/provisional V4 labels are not deleted. They map to
+`requires_adaptation` or `unsupported` depending on whether the frame motif can
+be structurally reused.
+
+## 8. Allowed And Disallowed Input Rules
+
+| Input | Contract status | Action |
+|---|---|---|
+| `## n. Title` | Allowed | Parse as `numbered_section`. |
+| Visible content before first `##` | Allowed if non-empty | Parse as `pre_intro`. |
+| `### n.m Title` under current parent | Allowed | Parse as `subsection_decimal`. |
+| `### k Title` under current parent | Allowed with normalization | Parse as `subsection_numeric`; emit normalized id. |
+| Registered component tag | Allowed | Expand through registry. |
+| Unregistered component tag | Unsupported | Surface unsupported with trace. |
+| Raw JSX style object or event handler in source text | Disallowed in rendered text | Sanitize or fail coverage gate. |
+| Raw HTML details block | Allowed with typed handling | Parse as `details_popup`. |
+
+## 9. Frame Coverage Priority
+
+T27 must not attempt to migrate all 32 contracts at once. The priority is:
+
+1. Frames actually selected or requested by the five MDX samples.
+2. Frames with existing family partials under `templates/phase_z2/families`.
+3. Remaining catalog-only frames, tracked separately as a family/variant mapping
+   axis. This remains separate from the #98 immediate readiness work.
+
+Initial frame families in scope:
+
+- `construction_bim_three_usage`
+- `bim_dx_comparison_table`
+- `construction_goals_three_circle_intersection`
+- `three_persona_benefits`
+- `three_parallel_requirements`
+- `process_product_two_way`
+- `pre_construction_model_info_stacked`
+- `bim_issues_quadrant_four`
+
+## 10. Task Mapping
+
+| Task | Contract responsibility |
+|---|---|
+| T22 | Implement node taxonomy and unit identity rules. |
+| T23 | Implement component expansion registry, starting with `DxEffect`. |
+| T24 | Select layout from normalized top-level units and fixed summary/footer policy. |
+| T25 | Implement node-to-slot mapping and builder coverage checks. |
+| T26 | Carry candidate pools and coverage states through backend and frontend. |
+| T27 | Add deterministic repeat/expand rules without font shrinking. |
+| T28 | Verify frontend override persistence, stale-preview prevention, and backend application. |
+| T29 | Implement AI structure-plan path only for `requires_adaptation`. |
+| T30 | Run five-MDX technical, design-readiness, and presentation-readiness gates. |
+
+## 11. Acceptance Checks For This Contract
+
+- The contract defines node taxonomy, slot taxonomy, node-to-slot mapping,
+  coverage states, allowed/disallowed input rules, and task mapping.
+- The contract explicitly covers all five MDX samples from the inventory.
+- The contract does not permit AI text generation or font shrinking.
+- The contract defines how reject/provisional candidates are surfaced without
+  silent deletion.
+- The contract identifies registry files that later implementation tasks can
+  read.
+

emergency.md

@@ -0,0 +1,319 @@
+# Emergency Session — mdx 01~05 visible-result rescue
+
+**시작**: 2026-05-26
+**목표 시간**: ~1 시간
+**모드**: 로컬 코드 개선 (no Gitea push, no orchestrator, no issue 생성)
+
+---
+
+## 1. 목표
+
+프론트에서 mdx 01~05 **5 개 모두 반드시 슬라이드 출력** (empty shell 금지) + 사용자가 frame 선택/변경 가능 + 선택된 frame 으로 AI 가 원문 보존하며 재배치.
+
+### 정책 lock (한 줄)
+
+> **empty shell 금지. 어떤 경우든 원문 텍스트 보존 + 선택 가능 frame 또는 fallback frame 에 AI 가 재배치.**
+
+**현재 상태**:
+| mdx | 결과 |
+|---|---|
+| 03 | ✅ direct path — 정상 |
+| 04 | ❌ 04-1 reject → provisional, 04-2 plan 에서 누락. 1 slide 만 |
+| 05 | ❌ 05-1 + 05-2 empty_shell. 빈 placeholder |
+| 01, 02 | unknown (이번 세션 sanity check 필요) |
+
+**기대 (정책 적용 후)**: 모든 mdx 의 모든 section 이 슬라이드로 렌더 — reject-only 여도 AI 재배치 path 로 surface.
+
+---
+
+## 2. 운영 원칙 (lock)
+
+- ❌ git push 금지
+- ❌ Gitea issue 생성 / orchestrator 실행 금지
+- ❌ 결과물 하드코딩 금지 (mdx 별 특수 처리 X)
+- ❌ MDX 원문 텍스트 변경 금지
+- ❌ 후보 수 강제 floor (3~6 padding) 금지
+- ❌ **empty_shell 종결 금지** — 후보 reject-only 라도 AI adaptation route 필수
+- ❌ **reject 후보 자동 렌더 금지** — 항상 ai_adaptation_required 로 status 부여
+- ✅ 코드 path / 정책 / fallback 수정
+- ✅ 각 edit 후 로컬 run 으로 검증
+- ✅ Codex + 사용자 + Claude consensus 매 step
+
+---
+
+## 3. Root cause 진단 (확정)
+
+3-layer contradiction:
+
+```
+Layer 1: vite.config.ts spawn env
+   PHASE_Z_ALLOW_REJECT="1"       ← 의도: reject 허용
+                                  ← 실제: src/ 에서 read 안 됨 (dead env var)
+
+Layer 2: src/phase_z2_pipeline.py:1481-1520
+   lookup_v4_non_reject_candidates()
+       if j.get("label") == "reject": continue   ← reject 강제 drop (May 8 lock)
+
+Layer 3: composition + IMP-30 u4
+   selection_path = "empty_shell"
+   imp30_u4 = "terminal_first_render_empty_shell"   ← AI fallback 도달 차단
+```
+
+**결과**: reject 후보가 있어도 → filter 에서 drop → empty_shell → terminal → AI fallback 미호출.
+
+**Cross-reference**:
+- `.env: AI_FALLBACK_ENABLED=true` ✅ 활성
+- 사용자 정책 ([feedback_ai_isolation_contract]): "reject = AI 재구성 대상 (frame 유지 + AI 재배치)"
+- IMP-47B (#76): reject 후보 surface = override path 만 (자동 path 미포함)
+
+### Resolution — 통합 정책
+
+3-layer contradiction 의 해소 = **§1 의 정책 lock ("empty shell 금지")** 적용 :
+
+1. Layer 2 의 reject filter → **status 분류로 대체** (제거 X, 모두 보존 + status 부여)
+2. Layer 3 의 empty_shell terminal → **제거** (어떤 후보 상태든 AI adaptation route 로 흐름)
+3. Layer 1 의 dead env → wire-up 또는 retire (§4 Quick fix)
+
+### P1 결과 (2026-05-26) — 3 종류 root cause 동시 존재 (단순 reject filter X)
+
+P1 검증으로 처음 가정 ("주로 reject filter 문제") 와 실제 가 다름 발견 :
+
+| 분류 | 영향 section | 처리 priority |
+|---|---|---|
+| **C1. All-reject (catalog gap)** | `02-2.1`, `04-1` (raw 32 모두 reject) | **P2** — reject = `ai_adaptation_required` (status 분류) |
+| **C2. Section key mismatch** | `02-2` ↔ `02-2.1/02-2.2`, `04-2` ↔ `04-2.1/04-2.2` (V4 source 가 split) | **P2.5** — parent ↔ child key alignment policy (universal) |
+| **C3. V4 source 자체 누락** | `mdx 05 전체` (entry 0) | **P3** — generic fallback frame mandatory (raw 후보 0 일반 정책) |
+
+**fixture 주의** : `tests/matching/v4_full32_result.yaml` = 2026-04-29 stale snapshot. 이번 세션 = fallback policy 강화로 fixture 의존 약화. runtime V4 evaluator migrate = 별 axis (이번 세션 후).
+
+### Candidate status 3 분류 (정책 기반)
+
+| status | 후보 label | 처리 |
+|---|---|---|
+| `auto_renderable` | use_as_is / light_edit / restructure (일부) | 즉시 직접 렌더 가능 |
+| `ai_adaptation_required` | needs_adaptation / reject / fallback_candidate | 자동 렌더 X, AI 재배치 필요 |
+| `blocked_runtime` | visual_pending / catalog scaffolding 등 | 현재 시스템상 렌더 불가 (별 axis 로 추적) |
+
+**규칙**:
+- `auto_renderable` 1+ → 그 중 rank-1 으로 직접 렌더
+- `auto_renderable` 0 + `ai_adaptation_required` 1+ → top 후보 AI adaptation route
+- 둘 다 0 → generic_fallback frame + AI adaptation (별 axis — 이번 세션 후순위, §4 결정 보류 참조)
+- **어떤 경우든 empty_shell 종결 X**
+
+---
+
+## 4. 작업 순서 (5 priority + 1 quick fix)
+
+### Priority 1 — Raw 후보 분포 확인 (5~10분, read-only)
+
+**목적**: catalog gap (후보 없음) vs matching gap (후보 있지만 reject) 구분.
+
+**파일**:
+- `tests/matching/v4_full32_result.yaml` (raw 32 candidates source)
+- `data/runs/mdx04_clean_check_v2/phase_z2/steps/step05_v4_evidence.json`
+- `data/runs/mdx05_clean_check_v2/phase_z2/steps/step05_v4_evidence.json`
+
+**검증 질문**:
+- 04-1, 04-2, 05-1, 05-2 각각의 raw 32 candidates 중 reject 수 / non-reject 수?
+- 어떤 frame_template_id 들이 reject 됐나? (catalog 의 가능성)
+- candidate_status="no_non_reject_v4_candidate" 가 정말 모든 4 섹션?
+
+### Priority 2 — V4 후보 보존 + status 분류 (15~20분, edit)
+
+**목적**: reject 후보 삭제 X, 모두 보존 + `candidate_status` 부여 (auto_renderable / ai_adaptation_required / blocked_runtime).
+
+**파일 + 함수**:
+- `src/phase_z2_pipeline.py:1481-1520` `lookup_v4_non_reject_candidates`
+  - rename → `lookup_v4_candidates(v4, section_id, max_n=6, include_reject=True, alias_keys=None)`
+  - **default = `include_reject=True`** (정책 lock 반영)
+  - 모든 후보 반환 + 각 V4Match 에 `candidate_status` field 추가
+  - reject filter 제거 — visual_pending 만 `blocked_runtime` 로 표시 (drop X)
+
+**V4Match dataclass / dict 확장**:
+- `candidate_status: str` field 추가
+- 분류 규칙 (단일 source of truth):
+  - label ∈ {use_as_is, light_edit} → `auto_renderable`
+  - label = restructure → `auto_renderable` (단, capacity_fit 통과 시) / `ai_adaptation_required` (mismatch 시)
+  - label ∈ {needs_adaptation, reject, fallback_candidate} → `ai_adaptation_required`
+  - visual_pending = True → `blocked_runtime`
+
+**호출처 검색 필요**:
+- `grep -n lookup_v4_non_reject_candidates src/`
+- 호출처 마다 status field 사용 여부 확인 + 필요 시 분기 추가
+
+**composition 변경**:
+- `src/phase_z2_composition.py` (line ~681 부근)
+- 후보 retrieve → status 별 분류:
+  - `auto_renderable` 1+ → rank-1 으로 직접 렌더
+  - 그 외 → `ai_adaptation_required` route (P3 의 empty_shell 우회 와 연결)
+
+### Priority 2.5 — Section key alignment policy (10~15분, edit) [NEW — C2 처리]
+
+**목적**: pipeline normalize 의 section_id (예: `04-2`) 와 V4 source 의 split child keys (예: `04-2.1`, `04-2.2`) 매칭. **universal policy** — 02-2 / 04-2 모두 cover, mdx 별 dispatch X.
+
+**접근 — "child → parent pool merge" (Codex 안)** :
+parent 를 child 로 split 하는 방식 (composition planner 변경) 보다 빠르고 안전 :
+
+```
+section_id = X (e.g., "04-2")
+lookup_v4_candidates(X) → V4 에 X 직접 매칭 시도
+  hit → return as-is
+  miss → fallback: child keys 검색 (X.1, X.2, X.3, ...)
+    hit → 모든 child candidates 를 X 의 candidate pool 로 merge
+           (origin: child_id 보존 — debug)
+    miss → return [] (P3 의 generic fallback 으로 흐름)
+```
+
+**파일**:
+- `src/phase_z2_pipeline.py:1505` `_resolve_v4_section_key` — alias 기능 이미 일부 있음 (alias_keys param). 확장 필요.
+- `lookup_v4_candidates` (P2 에서 신설) — alias miss 시 child key scan 추가
+
+**검증 sample**:
+- `04-2` lookup → V4 miss → `04-2.1` + `04-2.2` 찾음 → 5 candidates pool 로 merge (04-2.1=2, 04-2.2=3)
+- `02-2` lookup → V4 miss → `02-2.1` + `02-2.2` 찾음 → 5 candidates pool
+
+### Priority 3 — empty_shell terminal 제거 + AI adaptation + generic fallback mandatory (15~20분, edit)
+
+**목적**: `terminal_first_render_empty_shell` (IMP-30 u4) **제거** — 어떤 후보 상태든 AI adaptation 으로 분기. **empty_shell 종결 = 0 보장**. mdx 05 같은 raw 후보 0 케이스도 cover (C3).
+
+**파일**:
+- `src/phase_z2_composition.py` 또는 `src/phase_z2_pipeline.py` 의 IMP-30 u4 분기점
+- 검색: `terminal_first_render_empty_shell`, `empty_shell`, `__empty__` literal
+
+**정책 결정 (lock — universal, mdx 별 X)**:
+
+| condition | route |
+|---|---|
+| `auto_renderable` 1+ | rank-1 으로 직접 렌더 |
+| `auto_renderable` 0 + `ai_adaptation_required` 1+ | top 후보 AI adaptation route. selection_path = `"ai_adaptation_required"`, frame_template_id = 실제 frame |
+| `auto_renderable` 0 + `ai_adaptation_required` 0 (raw 후보 0 — C3) | **generic_fallback frame + AI adaptation** (mandatory, no longer deferred) |
+
+**generic_fallback frame 정책**:
+- catalog 의 가장 universal frame 1 개 지정 (예: simple bullet + title 형)
+- **신설 frame X — 기존 catalog 활용**
+- hardcode mdx 별 dispatch X — "raw 후보 0 일 때" 통일 트리거
+- selection_path = `"generic_fallback"`, candidate_status = `"ai_adaptation_required"` (AI 가 원문 재배치)
+- catalog_gap metric 기록 (운영 시그널 — terminal X)
+
+**무엇이 더 이상 존재하지 않는가**:
+- `merge_type: "empty_shell"`
+- `selection_path: "empty_shell"`
+- `frame_template_id: "__empty__"`
+- `imp30_u4: "terminal_first_render_empty_shell"` (이게 terminal 이라는 의미)
+
+**기록은 유지** (운영 시그널):
+- `candidate_status_summary` 같은 metric 으로 catalog_gap 비율 추적 — 단 terminal 아님
+
+### Priority 4 — AI fallback 호출 trace (5~10분, read + verify)
+
+**목적**: .env 가 `AI_FALLBACK_ENABLED=true` 인데 실제 호출되는지 확인. empty_shell 전에 끊기는지.
+
+**파일**:
+- `src/phase_z2_ai_fallback/router.py:67` (`if not settings.ai_fallback_enabled:` gate)
+- `src/phase_z2_pipeline.py:4914` (`if not _settings.ai_fallback_enabled:`)
+
+**검증**:
+- mdx 04/05 로컬 run 후 `step12_ai_repair.json` 확인 — AI 호출 attempt 있나?
+- 없으면 Priority 3 fix 후 다시 확인
+
+### Priority 5 — Frontend candidate panel 검증 (5~10분, read + edit)
+
+**목적**: backend 후보 살아도 frontend 숨기면 사용자 못 씀. reject / restructure / needs_adaptation 후보가 우측 panel 에 나와야.
+
+**파일**:
+- `Front/client/src/components/FramePanel.tsx` (candidate rendering 로직)
+- `Front/client/src/components/SlideCanvas.tsx` (candidate selection 흐름)
+- API: `/api/run` response 의 candidate 필드 확인
+
+**검증**:
+- mdx 04/05 로컬 run 결과 → frontend 가 reject 후보를 표시 / 선택 가능한지
+
+### Quick fix (5분) — PHASE_Z_ALLOW_REJECT wire-up 또는 retire
+
+**파일**:
+- `Front/vite.config.ts:903-904` — `PHASE_Z_ALLOW_REJECT: "1"` / `PHASE_Z_ALLOW_RESTRUCTURE: "1"`
+- `src/` — 현재 read 0 매치
+
+**결정 안**:
+- **A. Wire-up**: `lookup_v4_candidates` 의 `include_reject` 가 이 env 도 source 로 read
+- **B. Retire**: vite spawn env 에서 제거 (dead var 제거)
+
+선택은 작업 진행 중 결정.
+
+---
+
+## 5. 검증 — Acceptance criteria
+
+### 각 priority 완료 후 sanity
+
+| priority | local run | 기대 |
+|---|---|---|
+| 1 | (read-only) | ✅ done — 04/05 raw 후보 분포 + C1/C2/C3 root cause 식별 |
+| 2 | mdx04/05 local pipeline | step05_v4_evidence 의 각 candidate 에 `candidate_status` field 존재 (auto / ai_adaptation / blocked), reject 후보 surface — **C1 처리** |
+| 2.5 | mdx02/04 local pipeline | `04-2` lookup → child `04-2.1` + `04-2.2` 후보 5 개 merge 됨 (debug log 에 origin child_id 보존), `02-2` 도 동일 — **C2 처리** |
+| 3 | mdx04/05 local pipeline | step06_composition_plan 의 `selection_path` ∈ {`auto_renderable_rank_1`, `ai_adaptation_required`, `generic_fallback`}, **`"empty_shell"` 0 회**, `frame_template_id != "__empty__"`, mdx 05 도 generic_fallback 으로 슬라이드 — **C1/C3 처리** |
+| 4 | mdx04/05 local pipeline | step12_ai_repair.json 에 AI 호출 trace 존재 (ai_adaptation route 도달) |
+| 5 | frontend 새로고침 | mdx 04/05 의 우측 panel 에 후보 surface + status 별 시각 구분 (예: 배지) |
+
+### 최종 demo readiness
+
+- [ ] mdx 01: 의미 있는 슬라이드 나옴
+- [ ] mdx 02: 의미 있는 슬라이드 나옴 (02-2 = C2 alignment 검증)
+- [ ] mdx 03: 정상 (회귀 X 검증)
+- [ ] mdx 04: 04-1 (C1 reject→AI), 04-2 (C2 alignment) 모두 슬라이드 나옴
+- [ ] mdx 05: 05-1 + 05-2 generic_fallback 으로 슬라이드 나옴 (C3 처리)
+- [ ] **5 mdx 통합: empty_shell 결과 = 0** (어떤 mdx 도 empty 안 됨 — 정책 lock 검증)
+- [ ] **C2 검증**: 04-2 가 04-2.1/04-2.2 child candidates 받아옴 (parent ↔ child alignment universal)
+- [ ] **C3 검증**: mdx 05 가 V4 source 없음에도 generic_fallback frame + AI adaptation 으로 슬라이드 (raw 후보 0 일반 정책)
+- [ ] 각 슬라이드 frame 변경 가능 (panel UI, status 분류 surface)
+- [ ] AI 적용/재배치 동작 (mdx 텍스트 보존)
+- [ ] reject-only mdx (mdx 04-1, mdx 02-2.1) 가 AI adaptation 으로 슬라이드 생성 — 정책 lock end-to-end 검증
+
+---
+
+## 6. 수정 대상 파일 — 최종 inventory
+
+**Edit 대상**:
+- `src/phase_z2_pipeline.py` — lookup_v4 함수 + Step 5/9 caller + empty_shell 분기
+- `src/phase_z2_composition.py` — empty_shell terminal disposition 우회 + reject 후보 routing
+- (조건부) `src/phase_z2_ai_fallback/router.py` — gate 확인 후 필요 시
+- (조건부) `Front/vite.config.ts` — `PHASE_Z_ALLOW_REJECT` wire-up 또는 retire
+- (조건부) `Front/client/src/components/FramePanel.tsx` — reject 후보 surface 검증/추가
+
+**Read-only 진단**:
+- `tests/matching/v4_full32_result.yaml`
+- `data/runs/mdx04_clean_check_v2/phase_z2/steps/step05_v4_evidence.json`
+- `data/runs/mdx04_clean_check_v2/phase_z2/steps/step06_composition_plan.json`
+- `data/runs/mdx05_clean_check_v2/phase_z2/steps/step05_v4_evidence.json`
+- `data/runs/mdx05_clean_check_v2/phase_z2/steps/step06_composition_plan.json`
+- `data/runs/mdx05_clean_check_v2/phase_z2/steps/step12_ai_repair.json`
+- (priority 4 진행 후) 새 run 의 동일 step files
+
+**MDX 원문 (절대 변경 X)**:
+- `samples/mdx_batch/01.mdx` ~ `05.mdx`
+
+---
+
+## 7. 진행 추적
+
+각 priority 완료 후 이 섹션에 결과 한 줄 추가 — 작업 끝나면 정리해서 후속 Gitea issue / commit 본문 reference.
+
+- [x] P1: Raw 후보 분포 확인 — C1 (02-2.1, 04-1 all-reject) / C2 (04-2 ↔ 04-2.1/04-2.2 split) / C3 (mdx 05 source 누락) 식별
+- [x] P2: V4 후보 보존 + 3-status 분류 (C1 처리 — reject = ai_adaptation_required) — 2026-07-02 실측 검증: mdx04 04-1 reject 후보 `ai_adaptation_required` 로 보존 (GitHub issue #9)
+- [x] P2.5: Section key alignment policy (C2 처리 — child → parent pool merge, universal) — 2026-07-02 실측: 02-2 가 parent merge 로 frame 14 획득
+- [x] P3: empty_shell terminal 제거 + AI adaptation + generic_fallback frame mandatory (C1/C3 처리) — 2026-07-02 실측: mdx05 GENERIC_FALLBACK 렌더, 5/5 mdx empty shell 0
+- [x] P4: AI fallback 호출 trace — 2026-07-02: 호출은 됐으나 proposal envelope 불일치로 전량 ValidationError 유실 발견 → 수정 (커밋 9717898: 프롬프트 envelope 명시 + client 코어싱). 잔여: design_adaptation_plan apply 계층 미구현 (unsupported_kind — issue #7 axis)
+- [x] P5: Frontend candidate panel 검증 (status surface) — FramePanel candidate_status 툴팁 + route 배지 구현 확인
+- [ ] Quick fix: PHASE_Z_ALLOW_REJECT wire-up 또는 retire (미확인 — dead env var 여부 재점검 필요)
+
+---
+
+## 8. 후속 정리 (이 세션 후)
+
+작업 안정화 되면 별도 task 로:
+- 새 Gitea issue 생성 (P1~P5 결과 evidence 기반)
+- 분리된 commits 으로 push
+- 23 suspect pool deep-dive (별 axis)
+- queue tracker #97 update
+
+이 단계는 **이번 세션 scope 외**. 데모 우선.

figma_to_html_agent/README.md

@@ -163,3 +163,28 @@ STEP 10 인덱스 업데이트       — blocks_index.md 1줄 추가
 ### 고정 슬라이드 배경
 
 `templates/blocks/slide-base.html` — 16:9 (1280×720), 상단 제목 + 구분선 + 본문 영역 + 하단 결론 pill.
+
+---
+
+## MCP 의존성 (통합 시 추가 — 2026-07-02)
+
+이 에이전트는 **Figma Desktop Dev Mode MCP 서버**가 필요하다.
+
+1. Figma Desktop 앱 실행 → Dev Mode MCP 서버 활성화 (기본: `http://127.0.0.1:3845/mcp`)
+2. 프로젝트 루트 또는 이 디렉토리의 `mcp.sample.json`을 `.mcp.json`으로 복사:
+
+```json
+{
+  "mcpServers": {
+    "figma-desktop": {
+      "type": "http",
+      "url": "http://127.0.0.1:3845/mcp"
+    }
+  }
+}
+```
+
+3. Python 도구: Selenium(headless Chrome), Pillow — 렌더 검증용 (선택)
+
+> 참고: `Front_test_v515/figma_to_html_agent/`(gitignore)에 동일 내용의 작업 사본이 존재한다.
+> 2026-07-02 점검 결과 본 디렉토리는 이미 main에 추적·push되어 있음을 확인 (issue #1).

figma_to_html_agent/mcp.sample.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "figma-desktop": {
+      "type": "http",
+      "url": "http://127.0.0.1:3845/mcp"
+    }
+  }
+}

pyproject.toml

@@ -22,6 +22,7 @@ dependencies = [
 dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.24",
+    "pytest-json-report>=1.5",
     "ruff>=0.8",
 ]
 
@@ -33,4 +34,5 @@ target-version = "py310"
 asyncio_mode = "auto"
 markers = [
     "integration: end-to-end pipeline integration tests (heavy; invoke Selenium)",
+    "sweep: opt-in heavyweight sweep tests (IMP-43 u7b: 3 layouts × 3 mdx × frame-pin coverage). Invoke explicitly via `pytest -m sweep`; default CI must use `-m 'not sweep'`.",
 ]

samples/mdx/01. 건설산업 DX의 올바른 이해(0127)(원본).mdx

@@ -0,0 +1,120 @@
+---
+title: 건설산업 DX의 올바른 이해
+sidebar:
+  order: 00
+---
+
+* **용어의 혼용**
+
+  * 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명확히 정립되지 않은채 혼용되어 사용되고 있음  
+  * 이로인해 BIM기술의 도입을 DX의 완성으로 오인하거나, DX를 BIM 기술 도입 수준으로 한정하는 인식 확산    
+  <details>
+    <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>혼용 대표 사례</summary>
+      
+    <div style={{marginTop: '10px', paddingLeft: '15px', borderLeft: '3px solid #ddd', fontSize: '0.9rem', color: '#666'}}>
+    * **[스마트 건설 활성화 방안(2022.07)]**
+      * 추진과제 : 건설산업 디지털화   
+      * 실행과제 : BIM 전면 도입, BIM 전문인력 양성
+    * **[제7차 건설기술진흥 기본계획(2023.12)]**
+      * 추진방향 : 디지털 전환을 통한 스마트 건설 확산  
+      * 추진과제 : BIM 도입으로 건설산업 디지털화
+    </div>
+  </details>
+
+
+  * 건설산업의 DX를 올바르게 이해하기 위해 각 용어의 정의, 역할, 상호관계에 대한 체계적 정립 필요
+
+<br/>
+---
+
+
+## 1. 용어 정의
+
+<br/>
+
+* **건설산업**
+  * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업
+  * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편리하고 안전하며 우수한 성능의 시설물 완성을 목표로 함
+
+<br/>
+
+* **BIM(Building Information Modeling) : 디지털 전환을 위한 핵심 기술**
+  * 시설물의 생애주기동안 발생한 모든 정보를 3차원 모델 기반으로 통합·관리하는 정보 관리 도구
+  * 건설 정보와 절차를 표준화된 방식으로 연계하고 디지털 협업이 가능하도록 하는 핵심 인프라 기술
+      <div style={{ 
+    fontSize: '0.8rem', 
+    color: '#999', 
+    marginTop: '5px', 
+    lineHeight: '1.4',
+    paddingLeft: '0px' }}>
+    *건설산업 BIM 기본지침, 국토교통부, 2020*
+    </div>
+
+<br/>
+
+* **DX(Digital Transformation) : 산업 패러다임의 변화**
+  * 디지털 기술을 기반으로 산업 전반의 업무방식과 가치 창출 구조를 전환하는 과정 및 결과   
+  * 단순한 기술 도입이 아닌, 고객 가치와 의사결정 방식의 근본적인 변화로 산업의 새로운 방향을 정립하는 것을 의미함
+  <div style={{ 
+    fontSize: '0.8rem', 
+    color: '#999', 
+    marginTop: '5px', 
+    lineHeight: '1.4',
+    paddingLeft: '0px' }}>
+    *Digital Transformation, IBM Institute for Business Value, 2011 / What is Digital Transformation?, Agile Elephant, 2015*
+    </div>
+
+
+---
+<br/>
+
+## 2. 용어간 상호관계
+
+* DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념
+* 건설산업의 DX는 GIS(공간정보), BIM, 디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능  
+  * GIS의 역할 : 지리적 데이터를 공간 분석하여 시각적으로 표현, 위치기반 정보 제공
+  * BIM의 역할 : 형상정보와 내용정보가 포함된 3D모델로, 건설 정보 기반의 Process와 Product를 제공  
+![DX와 핵심기술간 상호관계](/assets/images/DX1.png)
+    <div style={{ 
+      fontSize: '0.8rem', 
+      color: '#999', 
+      marginTop: '5px', 
+      lineHeight: '1.4',
+      paddingLeft: '0px' }}>
+      *[그림 1] DX와 핵심기술간 상호관계*
+      </div>
+
+<br/>
+<br/>
+
+
+
+  <details>
+    <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>DX와 BIM의 구분</summary>
+      
+    <div style={{marginTop: '10px', paddingLeft: '15px', borderLeft: '3px solid #ddd', fontSize: '0.9rem', color: '#666'}}>
+    | DX | 구분 | BIM |
+    | :--- | :---: | ---: |
+    | **BIM &lt;&lt; DX**<br/>(Engineering + Management 통합) | **범위** | **Only 3D**<br/>(형상 구현 중심) |
+    | **제작 및 운영**(상용 + 전용 40~80개)<br/>[Rhino, Sketchup, Blender..] + [EG-BIM 등] | **S/W** | **모델 제작용 상용 SW**<br/>[Revit, Civil 3D, Navisworks, Autocad] |
+    | **근본적 문제의식을 통한 개선** | **프로세스** | **기존 2D 설계 방식 유지** |
+    | **공학 정보 및 콘텐츠 연계에 집중**<br/>**도면, 수량, 시공계획 등 일식** | **성과품** | **3D 모델 중심**<br/>**기존 성과품 유지** |
+    | **설계/시공 생산성 혁신**(개념의 재정립) | **활용** | **3D 모델에 의한 일반적 이해 향상** |
+    | **전 생애주기 활용 시스템** | **확장성** | **(설계/시공/운영) 분야별 단절** |
+    | **구체화(복잡) - 적극적/구체적 실현 방안** | **수행 개념** | **단순화(오류) - 수동적/집단적 동질화** |
+    | **적극적, 주체적인 기술 접목/융합** | **CIVIL + IT** | **소극적, 상용 기술에 의존** |
+    | **자체 수행 능력 - 지속가능성 확보** | **주체** | **S/W 제작사 판매 정책에 의존** |
+    | **차별화 및 경쟁력 확보, 해외 진출** | **발주처** | **평준화, 국내 중심** |
+    | **IT + CIVIL ENG 220명 운영 + 기술 개발** | **설계사** | **소규모 BIM팀 운영 + 단순교육에 집중** |
+    | **분야 확장 모델 및 시스템** | **시공사** | **국내 토목 소극적/해외 토목증가** |
+    </div>
+  </details>
+
+<br/>
+
+---
+
+:::note[핵심 요약]
+* BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다
+:::
+

samples/mdx/02. DX의 시행 목표 및 기대효과(원본).mdx

@@ -0,0 +1,42 @@
+---
+title: DX의 시행 목표 및 기대효과
+sidebar:
+  order: 1
+---
+
+import DxEffect from '../../../../components/dx.astro';
+
+
+## 1. DX의 궁극적 목표
+
+- **안전과 품질** 
+  - 시설물의 요구 성능을 설계-시공-운영 전 과정에서 **디지털로 검증**하여 **안전성 확보**
+  - Copy & Paste로 하향 평준화된 성과물의 **하자 최소화**로 **고품질 성과물 제공**
+<br/>
+- **생산성 향상**
+  - Analogue 기반 업무를 Digital 기반 프로세스로 전환하여 **업무 속도·정확성·일관성 향상**
+  - 건설 비용 및 유지관리비 절감, 건설 기간 단축, 인력투입 최소화를 통해 **부가가치 제고**
+<br/>
+- **소통과 신뢰**
+  - 성과품과 Solution을 통한 협업 강화로 **의사소통 효율 및 운영·유지관리**의 **편리성 증진**
+  - 3D 모델 및 데이터 기반 검증을 통한 **오류 최소화 및 Claim 예방**으로 **신뢰성 확보**
+![DX의 궁극적 목표](/assets/images/궁극적목표.png) 
+<br/>
+
+## 2. DX 기반 Process 혁신에 따른 주체별 기대효과
+<br/>
+### 2.1 업무 수행 과정(Process)의 변화
+  - **생산 방식**: 수작업 의존의 반복 업무에서 벗어나, **SW를 활용한 체계화된 방식**으로 전환
+  - **인지·검토**: 2D 도면 해석 중심에서 **3D 모델 기반의 직관적 인지·검토 체계**로 전환
+  - **협업 구조**: 개별 문서 중심 협업에서 **데이터 통합 기반의 정보 공유·관리 협업 환경**으로 전환
+  - **검증·대응**: 사후 대응 중심의 문제 처리에서 **사전 검증 중심의 예방적 업무 방식**으로 전환
+<br/>
+### 2.2 DX 시행 주체별 기대효과
+
+<DxEffect />
+<br/>
+<br/>
+:::note[핵심 요약]
+* 고품질의 성과품, 비용 절감, 시간 단축, 의사소통에 도움이 안 되면 DX가 아니다.
+:::
+<br/>

samples/mdx/04. DX 지연 요인(원본).mdx

@@ -0,0 +1,262 @@
+---
+title: DX 지연 요인
+sidebar:
+  order: 03
+---
+
+## 1. DX에 대한 인식
+<br/>
+<div style={{ display: 'flex', flexWrap: 'wrap', gap: '20px', justifycontent: 'center' }}>
+
+  <div style={{
+    width: '100%',
+    minWidth: '300px',
+    background: '#fff',
+    border: '1px solid #e1e4e8',
+    borderRadius: '12px',
+    padding: '20px',
+    boxShadow: '0 4px 6px rgba(0,0,0,0.05)',
+    position: 'relative',
+    transition: 'transform 0.2s, box-shadow 0.2s',
+    cursor: 'default'
+  }}
+  onMouseOver={(e) => {
+    e.currentTarget.style.transform = 'translateY(-3px)';
+    e.currentTarget.style.boxShadow = '0 6px 12px rgba(0,0,0,0.1)';
+  }}
+  onMouseOut={(e) => {
+    e.currentTarget.style.transform = 'translateY(0)';
+    e.currentTarget.style.boxShadow = '0 4px 6px rgba(0,0,0,0.05)';
+  }}
+  >
+    <div style={{ display: 'flex', alignitems: 'center', marginBottom: '15px' }}>
+    <h3 style={{ margin: 0, fontSize: '1.25rem'}}>기술 및 소프트웨어 이해도</h3>
+    </div>
+    <p style={{
+      background: '#f8f9fa',
+      borderLeft: '4px solid #1a73e8',
+      padding: '10px 15px',
+      margin: '0 0 15px 0',
+      fontSize: '1rem',
+      fontWeight: 'bold',
+      color: '#333'
+    }}>"무슨 말인지 잘 모르겠다, 어디까지 어떻게 해야 하는지 모르겠다"</p>
+    <ul style={{ margin: 0, paddingLeft: '20px', color: '#555', fontSize: '1.0rem', lineHeight: '1.8' }}>
+      <li>기본지침, 시행지침 등 새롭게 알아야 할 게 너무 많다.</li>
+      <li>3D 모델과 별 차이점을 모르겠다. S/W마다 사용법이 다르다.</li>
+      <li>필요한 것은 쉽고 간단한 건데, 왜 이렇게 복잡하게 만들까?</li>
+    </ul>
+  </div>
+
+  <div style={{
+    width: '100%',
+    minWidth: '300px',
+    background: '#fff',
+    border: '1px solid #e1e4e8',
+    borderRadius: '12px',
+    padding: '20px',
+    boxShadow: '0 4px 6px rgba(0,0,0,0.05)',
+    transition: 'transform 0.2s, box-shadow 0.2s',
+    cursor: 'default'
+  }}
+  onMouseOver={(e) => {
+    e.currentTarget.style.transform = 'translateY(-3px)';
+    e.currentTarget.style.boxShadow = '0 6px 12px rgba(0,0,0,0.1)';
+  }}
+  onMouseOut={(e) => {
+    e.currentTarget.style.transform = 'translateY(0)';
+    e.currentTarget.style.boxShadow = '0 4px 6px rgba(0,0,0,0.05)';
+  }}
+  >
+    <div style={{ display: 'flex', alignitems: 'center', marginBottom: '15px' }}>
+    <h3 style={{ margin: 0, fontSize: '1.25rem'}}>효과와 효율성</h3>
+    </div>
+    <p style={{
+      background: '#f8f9fa',
+      borderLeft: '4px solid #d93025',
+      padding: '10px 15px',
+      margin: '0 0 15px 0',
+      fontSize: '1rem',
+      fontWeight: 'bold',
+      color: '#333'
+    }}>"2D 설계 후 전환설계를 수행하는데 효과는 모르겠고, 효율은 낮다"</p>
+    <ul style={{ margin: 0, paddingLeft: '20px', color: '#555', fontSize: '1.0rem', lineHeight: '1.8' }}>
+      <li>성과품 작성은 기존과 같게 하고, 추가 업무만 발생해 효율이 낮다.</li>
+      <li>BIM으로 인해 가중되는 업무 대비 효과가 거의 없어 보인다.</li>
+      <li>결과적으로 큰 차이를 못 느끼겠고, 이런 노력이 정말 가치 있는 일이야?</li>
+    </ul>
+  </div>
+
+  <div style={{
+    width: '100%',
+    minWidth: '300px',
+    background: '#fff',
+    border: '1px solid #e1e4e8',
+    borderRadius: '12px',
+    padding: '20px',
+    boxShadow: '0 4px 6px rgba(0,0,0,0.05)',
+    transition: 'transform 0.2s, box-shadow 0.2s',
+    cursor: 'default'
+  }}
+  onMouseOver={(e) => {
+    e.currentTarget.style.transform = 'translateY(-3px)';
+    e.currentTarget.style.boxShadow = '0 6px 12px rgba(0,0,0,0.1)';
+  }}
+  onMouseOut={(e) => {
+    e.currentTarget.style.transform = 'translateY(0)';
+    e.currentTarget.style.boxShadow = '0 4px 6px rgba(0,0,0,0.05)';
+  }}
+  >
+    <div style={{ display: 'flex', alignitems: 'center', marginBottom: '15px' }}>
+    <h3 style={{ margin: 0, fontSize: '1.25rem'}}>인력 및 교육</h3>
+    </div>
+    <p style={{
+      background: '#f8f9fa',
+      borderLeft: '4px solid #f9ab00',
+      padding: '10px 15px',
+      margin: '0 0 15px 0',
+      fontSize: '1rem',
+      fontWeight: 'bold',
+      color: '#333'
+    }}>"수행 인력이 부족하고, 기존 직원들은 어떻게 교육해야 하나"</p>
+    <ul style={{ margin: 0, paddingLeft: '20px', color: '#555', fontSize: '1.0rem', lineHeight: '1.8' }}>
+      <li>교육시간 손실로 일손이 더 필요해지고, 적응하는데도 시간이 걸린다.</li>
+      <li>신입사원은 없고 BIM 수행을 할 수 있는 기술자가 부족하다.</li>
+      <li>여러 회사의 S/W별 사용법이 달라 새로운 S/W에 적용에 시간이 필요하다.</li>
+    </ul>
+  </div>
+
+  <div style={{
+    width: '100%',
+    minWidth: '300px',
+    background: '#fff',
+    border: '1px solid #e1e4e8',
+    borderRadius: '12px',
+    padding: '20px',
+    boxShadow: '0 4px 6px rgba(0,0,0,0.05)',
+    transition: 'transform 0.2s, box-shadow 0.2s',
+    cursor: 'default'
+  }}
+  onMouseOver={(e) => {
+    e.currentTarget.style.transform = 'translateY(-3px)';
+    e.currentTarget.style.boxShadow = '0 6px 12px rgba(0,0,0,0.1)';
+  }}
+  onMouseOut={(e) => {
+    e.currentTarget.style.transform = 'translateY(0)';
+    e.currentTarget.style.boxShadow = '0 4px 6px rgba(0,0,0,0.05)';
+  }}
+  >
+    <div style={{ display: 'flex', alignitems: 'center', marginBottom: '15px' }}>
+    <h3 style={{ margin: 0, fontSize: '1.25rem'}}>경제적 부담</h3>
+    </div>
+    <p style={{
+      background: '#f8f9fa',
+      borderLeft: '4px solid #34a853',
+      padding: '10px 15px',
+      margin: '0 0 15px 0',
+      fontSize: '1rem',
+      fontWeight: 'bold',
+      color: '#333'
+    }}>"S/W 구독료만 크게 발생되고, 비용 보전은 안 된다"</p>
+    <ul style={{ margin: 0, paddingLeft: '20px', color: '#555', fontSize: '1.0rem', lineHeight: '1.8' }}>
+      <li>사용해야 할 S/W의 종류가 너무 많고 복잡한데 모두 필요한가?</li>
+      <li>모든 Project에 적용되는 것도 아닌데, 다수의 S/W 구독료를 내야 한다.</li>
+      <li>디지털전환 하기 위해 이 비용을 쓰는게 정말 경제적인 이득이 있는 거야?</li>
+    </ul>
+  </div>
+
+  <div style={{
+    width: '100%',
+    background: '#fff',
+    border: '1px solid #e1e4e8',
+    borderRadius: '12px',
+    padding: '20px',
+    boxShadow: '0 4px 6px rgba(0,0,0,0.05)',
+    transition: 'transform 0.2s, box-shadow 0.2s',
+    cursor: 'default',
+    marginTop: '10px'
+  }}
+  onMouseOver={(e) => {
+    e.currentTarget.style.transform = 'translateY(-3px)';
+    e.currentTarget.style.boxShadow = '0 6px 12px rgba(0,0,0,0.1)';
+  }}
+  onMouseOut={(e) => {
+    e.currentTarget.style.transform = 'translateY(0)';
+    e.currentTarget.style.boxShadow = '0 4px 6px rgba(0,0,0,0.05)';
+  }}
+  >
+    <div style={{ display: 'flex', alignitems: 'center', marginBottom: '15px' }}>
+    <h3 style={{ margin: 0, fontSize: '1.25rem'}}>실무 및 적용성</h3>
+    </div>
+    <p style={{
+      background: '#f8f9fa',
+      borderLeft: '4px solid #8e24aa',
+      padding: '10px 15px',
+      margin: '0 0 15px 0',
+      fontSize: '1rem',
+      fontWeight: 'bold',
+      color: '#333'
+    }}>"실무적 사용에 의한 효율성 증진보다는 홍보, PQ용으로 사용한다"</p>
+    <ul style={{ margin: 0, paddingLeft: '20px', color: '#555', fontSize: '1.0rem', lineHeight: '1.8' }}>
+      <li>구체적 적용에 의한 비용, 시간, 품질 등의 효과 사례가 없다.</li>
+      <li>지형, 선형, 도로, 교량 Model을 만드는 S/W가 모두 달라 적용이 어렵다.</li>
+      <li>속성정보를 반영하지 않은 형상 위주의 3D 모델 제작에만 초점이 맞춰져 있다.</li>
+    </ul>
+  </div>
+</div>
+<br/>
+---
+<br/>
+## 2. DX 추진의 실태
+
+<br/>
+
+### 2.1 정책 및 발주 체계
+- **실질적 기술 경쟁을 저해하는 정책 집행** 
+  - 모든 설계사가 수행 능력을 갖추었다는 전제하에 정책 시행
+  - 수행 능력이 없는 업체 선정 후 성과품의 수준을 낮추어 시행 
+<br/>
+- **적용 효과가 있는 사례도 없이 방침부터 도입** 
+  - DX/BIM 적용에 따른 실무적 이득이 있다고 판단된 사례 부족
+  - BIM 지침/방침 등을 시행 경험과 효과 검증도 없이 남발
+<br/>
+- **엔지니어링 S/W에 대한 개념 부재** 
+  - 다양한 엔지니어링 S/W의 특성에 대한 깊은 이해 없이 범용 S/W 선택
+  - 대형 Global S/W 회사에 과도한 의존과 이에 예속되는 방침 남발로 전용 S/W 소멸
+<br/>
+- **기술투자(R&D) 없는 성과 창출 기대** 
+  - 단순 BIM S/W만 구입하면 될 것이라는 안일한 생각
+  - 실질적 기술 개발 투자 노력 없이 남들이 하는 대로 하면 된다는 착각
+<br/>
+<details>
+  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>발주처 반응</summary>
+  <img src="/assets/images/발주처반응.png" />
+</details>
+
+### 2.2 조직 및 수행 역량
+- **공학적 개념 정립 부재** 
+  - DX와 BIM의 차이점을 명확히 구분하지 못하고 접근 방식과 기술적 도구 사이의 혼란만 가중
+  - 단순히 기술적 도구의 사용에 초점을 맞추느라 3D모델 제작 S/W에 과도하게 의존
+<br/>
+- **‘본업 기술력 확보’ 우선의 개념 부재** 
+  - 고도의 전문지식과 현장 경험이 축적된 Manual의 중요성과 필요성에 대한 이해 부족
+  - 국가·발주처의 지침·방침에만 의존한 업체의 기술력 
+<br/>
+- **DX/BIM의 근본 취지와 목표의 이해 부족** 
+  - DX에 의한 과정의 혁신과 결과물의 변화에 대한 고민 부재
+  - 기술자가 직접 3D모델을 만들고 수정하며 설계를 수행하지 않고, 별도로 외주 처리하여 본질 회피
+<br/>
+- **과거의 타성에 머무르고 있는 기술자 집단** 
+  - 설계/감리/시공 임직원들의 Digital 무지와 전략적 무지
+  - 교육과 학습을 통한 인재 양성보다 당장 실무 활용이 가능한 타사 인력 빼오기에 집중
+<br/>
+<details>
+  <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>설계·시공업계 반응</summary>
+  <img src="/assets/images/설계시공업계반응.png" />
+</details>
+<br/>
+---
+
+:::note[핵심 요약]
+* 검증 없는 정책의 일방적 추진과 조직의 회피, 이해 부족은 DX 지연을 반복시키고 있다. 
+:::

samples/mdx/05. 설계 방식의 왜곡(원본).mdx

@@ -0,0 +1,48 @@
+---
+title: 설계 방식의 왜곡
+sidebar:
+  order: 0
+---
+
+## 1. 설계의 자동화
+
+- **설계의 개념** 
+  - **개념설계**: 건설사업의 타당성 조사, 환경영향평가 등을 수행하는 목적물과 방향성을 수립하는 단계 
+  - **실시설계**: 공학적 지식을 바탕으로 건설에 필요한 목적물의 형상과 규격, 공사비를 결정하는 단계
+  - **시공상세설계**: 시공에 필요한 정보를 반영하여 목적물과 공정을 단계별로 구체화하는 단계
+
+<br/>
+
+- **설계의 특성** 
+  - 계획 단계부터 엔지니어의 경험과 공학적 판단에 기반한 의사결정이 필수적인 과정
+  - 사업마다 고유한 환경 및 지역 조건이 다르므로 매번 일회성 작업으로 수행
+  - 평면 및 종단 등 선형의 일부 변경만으로도 시설물 전체의 구조적 해석이 변화
+
+<br/>
+
+
+- **'설계 자동화'라는 용어의 오용과 모순**
+  - **기능적 대체의 오류**: '설계 자동화' S/W는 설계 전체 프로세스가 아닌, 단순 반복적인 제도(Drafting)나 수량 산출 등 단순 기능만을 대체하는 수준
+  - **인식의 왜곡**: '자동화'라는 용어의 남용으로 엔지니어의 업무가 단순 반복 작업인 것으로 저평가되고 있으며, 가장 중요한 전문 지식과 경험 기반의 의사결정 단계가 경시
+  - **완전 자동화의 불가능**: 설계는 각 단계가 유기적으로 연결된 지식 집약적 활동이므로, 엔지니어의 판단을 배제한 전체 프로세스의 완전 자동화는 불가능
+
+<br/>
+---
+<br/>
+## 2. S/W 중심 설계 방식
+
+### 1 기능·구조적 한계
+- 시간 단축과 오류 감소 등 '도구적 효율성'에만 집중하여, 설계 품질 향상이나 고부가가치를 창출하는 핵심 기술로 발전하지 못함
+- 대부분의 S/W가 2D 기반의 설계에 머물러 있어, 엔지니어의 입체적인 아이디어와 복잡한 현장 <br/>특수성을 충분히 표현하지 못함
+
+### 2 기술 역량의 왜곡
+- S/W 개발사: 기술 혁신보다 기존 방식의 반복과 성과물 생산에만 치중하며, 수익성 중심의 개발 지속
+- 기업 및 기술자: 기존 방식의 한계를 분석하고 새로운 부가가치를 찾기보다는, 단순 S/W 활용 능력을 엔지니어의 핵심 역량으로 오인
+- 종속성 심화: 시간이 흐를수록 기술자는 S/W에 예속된 기능인으로 전락하고, 산업 전체는 저부가가치의 굴레를 벗어나지 못함
+
+<br/>
+---
+
+:::note[핵심 요약]
+* 잘못된 자동화 인식과 도구 중심의 설계는 기술자를 S/W에 의존하는 기능인으로 전락시키며, <br/>설계의 본질과 경쟁력을 동시에 훼손한다. 
+:::

samples/mdx/05. 설계 방식의 왜곡.mdx

@@ -0,0 +1,48 @@
+---
+title: 설계 방식의 왜곡
+sidebar:
+  order: 0
+---
+
+## 1. 설계의 자동화
+
+- **설계의 개념** 
+  - **개념설계**: 건설사업의 타당성 조사, 환경영향평가 등을 수행하는 목적물과 방향성을 수립하는 단계 
+  - **실시설계**: 공학적 지식을 바탕으로 건설에 필요한 목적물의 형상과 규격, 공사비를 결정하는 단계
+  - **시공상세설계**: 시공에 필요한 정보를 반영하여 목적물과 공정을 단계별로 구체화하는 단계
+
+<br/>
+
+- **설계의 특성** 
+  - 계획 단계부터 엔지니어의 경험과 공학적 판단에 기반한 의사결정이 필수적인 과정
+  - 사업마다 고유한 환경 및 지역 조건이 다르므로 매번 일회성 작업으로 수행
+  - 평면 및 종단 등 선형의 일부 변경만으로도 시설물 전체의 구조적 해석이 변화
+
+<br/>
+
+
+- **'설계 자동화'라는 용어의 오용과 모순**
+  - **기능적 대체의 오류**: '설계 자동화' S/W는 설계 전체 프로세스가 아닌, 단순 반복적인 제도(Drafting)나 수량 산출 등 단순 기능만을 대체하는 수준
+  - **인식의 왜곡**: '자동화'라는 용어의 남용으로 엔지니어의 업무가 단순 반복 작업인 것으로 저평가되고 있으며, 가장 중요한 전문 지식과 경험 기반의 의사결정 단계가 경시
+  - **완전 자동화의 불가능**: 설계는 각 단계가 유기적으로 연결된 지식 집약적 활동이므로, 엔지니어의 판단을 배제한 전체 프로세스의 완전 자동화는 불가능
+
+<br/>
+---
+<br/>
+## 2. S/W 중심 설계 방식
+
+### 1 기능·구조적 한계
+- 시간 단축과 오류 감소 등 '도구적 효율성'에만 집중하여, 설계 품질 향상이나 고부가가치를 창출하는 핵심 기술로 발전하지 못함
+- 대부분의 S/W가 2D 기반의 설계에 머물러 있어, 엔지니어의 입체적인 아이디어와 복잡한 현장 <br/>특수성을 충분히 표현하지 못함
+
+### 2 기술 역량의 왜곡
+- S/W 개발사: 기술 혁신보다 기존 방식의 반복과 성과물 생산에만 치중하며, 수익성 중심의 개발 지속
+- 기업 및 기술자: 기존 방식의 한계를 분석하고 새로운 부가가치를 찾기보다는, 단순 S/W 활용 능력을 엔지니어의 핵심 역량으로 오인
+- 종속성 심화: 시간이 흐를수록 기술자는 S/W에 예속된 기능인으로 전락하고, 산업 전체는 저부가가치의 굴레를 벗어나지 못함
+
+<br/>
+---
+
+:::note[핵심 요약]
+* 잘못된 자동화 인식과 도구 중심의 설계는 기술자를 S/W에 의존하는 기능인으로 전락시키며, <br/>설계의 본질과 경쟁력을 동시에 훼손한다. 
+:::

samples/mdx_batch/04.mdx

@@ -2,6 +2,17 @@
 title: DX 지연 요인
 sidebar:
   order: 03
+slide_overrides:
+  css: |
+    .slide-body {
+      grid-template-rows: 0.38fr 0.60fr !important;
+      gap: 1.5% !important;
+    }
+    .f29b__cell .text-line + .text-line { margin-top: 1px !important; }
+    .f29b__cell:nth-child(n+3) {
+      padding-top: 3px !important;
+      margin-top: 2px !important;
+    }
 ---
 
 ## 1. DX에 대한 인식

samples/mdx_batch/05.mdx

@@ -0,0 +1,48 @@
+---
+title: 설계 방식의 왜곡
+sidebar:
+  order: 0
+---
+
+## 1. 설계의 자동화
+
+- **설계의 개념** 
+  - **개념설계**: 건설사업의 타당성 조사, 환경영향평가 등을 수행하는 목적물과 방향성을 수립하는 단계 
+  - **실시설계**: 공학적 지식을 바탕으로 건설에 필요한 목적물의 형상과 규격, 공사비를 결정하는 단계
+  - **시공상세설계**: 시공에 필요한 정보를 반영하여 목적물과 공정을 단계별로 구체화하는 단계
+
+<br/>
+
+- **설계의 특성** 
+  - 계획 단계부터 엔지니어의 경험과 공학적 판단에 기반한 의사결정이 필수적인 과정
+  - 사업마다 고유한 환경 및 지역 조건이 다르므로 매번 일회성 작업으로 수행
+  - 평면 및 종단 등 선형의 일부 변경만으로도 시설물 전체의 구조적 해석이 변화
+
+<br/>
+
+
+- **'설계 자동화'라는 용어의 오용과 모순**
+  - **기능적 대체의 오류**: '설계 자동화' S/W는 설계 전체 프로세스가 아닌, 단순 반복적인 제도(Drafting)나 수량 산출 등 단순 기능만을 대체하는 수준
+  - **인식의 왜곡**: '자동화'라는 용어의 남용으로 엔지니어의 업무가 단순 반복 작업인 것으로 저평가되고 있으며, 가장 중요한 전문 지식과 경험 기반의 의사결정 단계가 경시
+  - **완전 자동화의 불가능**: 설계는 각 단계가 유기적으로 연결된 지식 집약적 활동이므로, 엔지니어의 판단을 배제한 전체 프로세스의 완전 자동화는 불가능
+
+<br/>
+---
+<br/>
+## 2. S/W 중심 설계 방식
+
+### 1 기능·구조적 한계
+- 시간 단축과 오류 감소 등 '도구적 효율성'에만 집중하여, 설계 품질 향상이나 고부가가치를 창출하는 핵심 기술로 발전하지 못함
+- 대부분의 S/W가 2D 기반의 설계에 머물러 있어, 엔지니어의 입체적인 아이디어와 복잡한 현장 <br/>특수성을 충분히 표현하지 못함
+
+### 2 기술 역량의 왜곡
+- S/W 개발사: 기술 혁신보다 기존 방식의 반복과 성과물 생산에만 치중하며, 수익성 중심의 개발 지속
+- 기업 및 기술자: 기존 방식의 한계를 분석하고 새로운 부가가치를 찾기보다는, 단순 S/W 활용 능력을 엔지니어의 핵심 역량으로 오인
+- 종속성 심화: 시간이 흐를수록 기술자는 S/W에 예속된 기능인으로 전락하고, 산업 전체는 저부가가치의 굴레를 벗어나지 못함
+
+<br/>
+---
+
+:::note[핵심 요약]
+* 잘못된 자동화 인식과 도구 중심의 설계는 기술자를 S/W에 의존하는 기능인으로 전락시키며, <br/>설계의 본질과 경쟁력을 동시에 훼손한다. 
+:::

samples/uploads/01. 건설산업 DX의 올바른 이해(0127).mdx

@@ -0,0 +1,120 @@
+---
+title: 건설산업 DX의 올바른 이해
+sidebar:
+  order: 00
+---
+
+* **용어의 혼용**
+
+  * 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명확히 정립되지 않은채 혼용되어 사용되고 있음  
+  * 이로인해 BIM기술의 도입을 DX의 완성으로 오인하거나, DX를 BIM 기술 도입 수준으로 한정하는 인식 확산    
+  <details>
+    <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>혼용 대표 사례</summary>
+      
+    <div style={{marginTop: '10px', paddingLeft: '15px', borderLeft: '3px solid #ddd', fontSize: '0.9rem', color: '#666'}}>
+    * **[스마트 건설 활성화 방안(2022.07)]**
+      * 추진과제 : 건설산업 디지털화   
+      * 실행과제 : BIM 전면 도입, BIM 전문인력 양성
+    * **[제7차 건설기술진흥 기본계획(2023.12)]**
+      * 추진방향 : 디지털 전환을 통한 스마트 건설 확산  
+      * 추진과제 : BIM 도입으로 건설산업 디지털화
+    </div>
+  </details>
+
+
+  * 건설산업의 DX를 올바르게 이해하기 위해 각 용어의 정의, 역할, 상호관계에 대한 체계적 정립 필요
+
+<br/>
+---
+
+
+## 1. 용어 정의
+
+<br/>
+
+* **건설산업**
+  * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업
+  * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편리하고 안전하며 우수한 성능의 시설물 완성을 목표로 함
+
+<br/>
+
+* **BIM(Building Information Modeling) : 디지털 전환을 위한 핵심 기술**
+  * 시설물의 생애주기동안 발생한 모든 정보를 3차원 모델 기반으로 통합·관리하는 정보 관리 도구
+  * 건설 정보와 절차를 표준화된 방식으로 연계하고 디지털 협업이 가능하도록 하는 핵심 인프라 기술
+      <div style={{ 
+    fontSize: '0.8rem', 
+    color: '#999', 
+    marginTop: '5px', 
+    lineHeight: '1.4',
+    paddingLeft: '0px' }}>
+    *건설산업 BIM 기본지침, 국토교통부, 2020*
+    </div>
+
+<br/>
+
+* **DX(Digital Transformation) : 산업 패러다임의 변화**
+  * 디지털 기술을 기반으로 산업 전반의 업무방식과 가치 창출 구조를 전환하는 과정 및 결과   
+  * 단순한 기술 도입이 아닌, 고객 가치와 의사결정 방식의 근본적인 변화로 산업의 새로운 방향을 정립하는 것을 의미함
+  <div style={{ 
+    fontSize: '0.8rem', 
+    color: '#999', 
+    marginTop: '5px', 
+    lineHeight: '1.4',
+    paddingLeft: '0px' }}>
+    *Digital Transformation, IBM Institute for Business Value, 2011 / What is Digital Transformation?, Agile Elephant, 2015*
+    </div>
+
+
+---
+<br/>
+
+## 2. 용어간 상호관계
+
+* DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념
+* 건설산업의 DX는 GIS(공간정보), BIM, 디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능  
+  * GIS의 역할 : 지리적 데이터를 공간 분석하여 시각적으로 표현, 위치기반 정보 제공
+  * BIM의 역할 : 형상정보와 내용정보가 포함된 3D모델로, 건설 정보 기반의 Process와 Product를 제공  
+![DX와 핵심기술간 상호관계](/assets/images/DX1.png)
+    <div style={{ 
+      fontSize: '0.8rem', 
+      color: '#999', 
+      marginTop: '5px', 
+      lineHeight: '1.4',
+      paddingLeft: '0px' }}>
+      *[그림 1] DX와 핵심기술간 상호관계*
+      </div>
+
+<br/>
+<br/>
+
+
+
+  <details>
+    <summary style={{cursor: 'pointer', fontWeight: 'bold', color: '#555'}}>DX와 BIM의 구분</summary>
+      
+    <div style={{marginTop: '10px', paddingLeft: '15px', borderLeft: '3px solid #ddd', fontSize: '0.9rem', color: '#666'}}>
+    | DX | 구분 | BIM |
+    | :--- | :---: | ---: |
+    | **BIM &lt;&lt; DX**<br/>(Engineering + Management 통합) | **범위** | **Only 3D**<br/>(형상 구현 중심) |
+    | **제작 및 운영**(상용 + 전용 40~80개)<br/>[Rhino, Sketchup, Blender..] + [EG-BIM 등] | **S/W** | **모델 제작용 상용 SW**<br/>[Revit, Civil 3D, Navisworks, Autocad] |
+    | **근본적 문제의식을 통한 개선** | **프로세스** | **기존 2D 설계 방식 유지** |
+    | **공학 정보 및 콘텐츠 연계에 집중**<br/>**도면, 수량, 시공계획 등 일식** | **성과품** | **3D 모델 중심**<br/>**기존 성과품 유지** |
+    | **설계/시공 생산성 혁신**(개념의 재정립) | **활용** | **3D 모델에 의한 일반적 이해 향상** |
+    | **전 생애주기 활용 시스템** | **확장성** | **(설계/시공/운영) 분야별 단절** |
+    | **구체화(복잡) - 적극적/구체적 실현 방안** | **수행 개념** | **단순화(오류) - 수동적/집단적 동질화** |
+    | **적극적, 주체적인 기술 접목/융합** | **CIVIL + IT** | **소극적, 상용 기술에 의존** |
+    | **자체 수행 능력 - 지속가능성 확보** | **주체** | **S/W 제작사 판매 정책에 의존** |
+    | **차별화 및 경쟁력 확보, 해외 진출** | **발주처** | **평준화, 국내 중심** |
+    | **IT + CIVIL ENG 220명 운영 + 기술 개발** | **설계사** | **소규모 BIM팀 운영 + 단순교육에 집중** |
+    | **분야 확장 모델 및 시스템** | **시공사** | **국내 토목 소극적/해외 토목증가** |
+    </div>
+  </details>
+
+<br/>
+
+---
+
+:::note[핵심 요약]
+* BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다
+:::
+

samples/uploads/02. DX의 시행 목표 및 기대효과.mdx

@@ -0,0 +1,42 @@
+---
+title: DX의 시행 목표 및 기대효과
+sidebar:
+  order: 1
+---
+
+import DxEffect from '../../../../components/dx.astro';
+
+
+## 1. DX의 궁극적 목표
+
+- **안전과 품질** 
+  - 시설물의 요구 성능을 설계-시공-운영 전 과정에서 **디지털로 검증**하여 **안전성 확보**
+  - Copy & Paste로 하향 평준화된 성과물의 **하자 최소화**로 **고품질 성과물 제공**
+<br/>
+- **생산성 향상**
+  - Analogue 기반 업무를 Digital 기반 프로세스로 전환하여 **업무 속도·정확성·일관성 향상**
+  - 건설 비용 및 유지관리비 절감, 건설 기간 단축, 인력투입 최소화를 통해 **부가가치 제고**
+<br/>
+- **소통과 신뢰**
+  - 성과품과 Solution을 통한 협업 강화로 **의사소통 효율 및 운영·유지관리**의 **편리성 증진**
+  - 3D 모델 및 데이터 기반 검증을 통한 **오류 최소화 및 Claim 예방**으로 **신뢰성 확보**
+![DX의 궁극적 목표](/assets/images/궁극적목표.png) 
+<br/>
+
+## 2. DX 기반 Process 혁신에 따른 주체별 기대효과
+<br/>
+### 2.1 업무 수행 과정(Process)의 변화
+  - **생산 방식**: 수작업 의존의 반복 업무에서 벗어나, **SW를 활용한 체계화된 방식**으로 전환
+  - **인지·검토**: 2D 도면 해석 중심에서 **3D 모델 기반의 직관적 인지·검토 체계**로 전환
+  - **협업 구조**: 개별 문서 중심 협업에서 **데이터 통합 기반의 정보 공유·관리 협업 환경**으로 전환
+  - **검증·대응**: 사후 대응 중심의 문제 처리에서 **사전 검증 중심의 예방적 업무 방식**으로 전환
+<br/>
+### 2.2 DX 시행 주체별 기대효과
+
+<DxEffect />
+<br/>
+<br/>
+:::note[핵심 요약]
+* 고품질의 성과품, 비용 절감, 시간 단축, 의사소통에 도움이 안 되면 DX가 아니다.
+:::
+<br/>

samples/uploads/03. DX 시행을 위한 필수 요건 및 혁신 방안.mdx

@@ -0,0 +1,89 @@
+---
+title: DX 실행 체계 구축 방안
+sidebar:
+  order: 02
+---
+
+## 1. DX 시행을 위한 필수 요건
+
+<br/>
+
+* **기술(디지털)**
+  * **Digital 기술(S/W, H/W)과 업무 Process의 통합**
+    * 기존 업무 프로세스에 다양한 디지털 기술을 접목하여 업무 수행
+    * 프로젝트 전반에 걸친 업무 프로세스의 연결 및 조율
+  * **분야별 전문 지식(설계, 시공, 유지관리 등) 보유**
+    * 건설 전 단계에 대한 근본적인 이해와 지식 및 경험
+    * 최신 토목 기술 트랜드 및 표준 기준 등에 대한 높은 지식
+
+<br/>
+
+* **사람(역량)**
+  * **혁신적 사고방식과 창의적 문제 해결 능력**
+    * 기존 수행 방식과 관습적 사고 등에 의한 접근 방식 탈피
+    * 디지털 기술을 활용한 창의적, 혁신적인 솔루션 제시
+  * **사용자 중심 사고와 DX 수행 경험**
+    * 사용자의 요구와 기대를 충족시키는 설계 및 구현
+    * 시행착오를 포함한 수행 경험과 사용자 경험(UX)을 반영한 해결 방안 제시
+
+<br/>
+
+* **자연(여건)**
+  * **지속적인 투자 및 실행 의지**
+    * 기술 도입 초기 단계에 필요한 인력·기간·비용 등의 대규모 투자
+    * 기술 고도화를 위한 지속적인 개선 및 투자 체계 구축
+    * 변화와 혁신을 통해 부가가치를 창출하려는 실행 의지와 추진력
+
+<br/>
+---
+
+## 2. Process의 혁신과 Product의 변화
+
+<br/>
+
+### 2.1 과정(Process)의 혁신
+
+* **Analogue 기반 업무의 Digital화**
+
+  | As-is [Analogue] | 구분 | To-be [Digital] |
+  | :--- | :---: | :--- |
+  | **개념·문서·행정 절차 중심** | ➠ | **시각화된 목적물, 소통, 투명성 중심** |
+  | **2D 도면, 전문가, 규정** | ➠ | **3D 모델, 참여자, 실체** |
+  | **업무 구분(단절), 책임** | ➠ | **협업(융·복합), 창의성** |
+
+<br/>
+
+* **GIS + BIM의 연계**
+  * 지리·지형·지반 등 위치정보(GIS)와 3D모델(형상, 속성정보) 기반의 건설 정보를 포함하는 BIM의 연계를 통한 업무 프로세스의 혁신
+
+<br/>
+
+* **사용자 중심의 Solution 제공**
+  * 서로 다른 S/W로 작성되어 분절화된 Analogue 방식의 성과물과 정보물을 연계할 수 있는 설계·시공 Solution 제공
+
+<br/>
+<br/>
+
+### 2.2 결과(Product)의 변화
+
+* **Copy & Paste로 인해 하향 평준화된 기존 성과물의 품질 향상**
+  * 과거 수작업으로 시행하면서 발생하던 오류 등의 최소화
+  * 정확한 Data에 기반한 계획으로 고품질 성과물 도출
+
+<br/>
+
+* **Analogue 기반 도서 외 Digital 기반 정보물 추가**
+  * 기존 성과물(도면, 수량, 계산서, 시방서 등)에 3D 모델, Simulation 등의 Digital 기반 정보물 추가
+
+<br/>
+
+* **Solution을 활용한 업무 효율화**
+  * Engn. Solution을 통해 성과물에 관한 이슈를 함께 검토·논의하는 협업 환경 조성
+  * 건설 단계별 정보를 디지털 데이터로 축적하여, 건설 전 과정을 통합관리
+
+<br/>
+---
+
+:::note[핵심 요약]
+* **DX는 필요한 요건과 체계를 갖춘 후 시행해야만 그 효과를 기대할 수 있다.**
+:::