From 684425693700ae4bc964542d054e6d312d9da580 Mon Sep 17 00:00:00 2001
From: omigamedev <omarator@gmail.com>
Date: Mon, 15 Jun 2026 22:45:26 +0200
Subject: [PATCH] Record open project history closeout

---
 docs/modernization/debt.md    |  5 +++++
 docs/modernization/roadmap.md |  3 +++
 docs/modernization/tasks.md   | 37 +++++++++++++++++++++++++++++++++++
 3 files changed, 45 insertions(+)

diff --git a/docs/modernization/debt.md b/docs/modernization/debt.md
index 2564c065..96113364 100644
--- a/docs/modernization/debt.md
+++ b/docs/modernization/debt.md
@@ -82,6 +82,11 @@ agent or engineer to remove them without reconstructing context from chat.
   `src/legacy_document_open_services.cpp` instead of living inline in the
   retained document-open helper; the remaining document-open bridge debt stays
   concentrated in retained history services.
+- 2026-06-15: `DEBT-0039` was narrowed again. The retained project-open
+  history-planning call in `open_legacy_project()` now routes through a focused
+  helper in `src/legacy_document_open_services.cpp` instead of living inline in
+  the retained document-open helper; the remaining document-open bridge debt
+  stays concentrated in retained history services.
 - 2026-06-15: `DEBT-0038` was narrowed again. The retained cloud downloaded-
   project open camera reset and layer-clear setup in
   `execute_legacy_downloaded_project_open()` now routes through a focused
diff --git a/docs/modernization/roadmap.md b/docs/modernization/roadmap.md
index 3c5735e4..086dcc1d 100644
--- a/docs/modernization/roadmap.md
+++ b/docs/modernization/roadmap.md
@@ -1408,6 +1408,9 @@ The retained project-open layer/title update work and failure-path error
 dialog in `handle_open_legacy_project_result()` now also route through focused
 helpers, so the remaining document-open bridge debt is further concentrated on
 retained history services.
+The retained project-open history-planning call in `open_legacy_project()`
+now also routes through a focused helper, so the remaining document-open
+bridge debt is further concentrated on retained history services.
 `App::request_close`, `App::save_document`, and
 `App::continue_document_workflow_after_optional_save` now route through
 app-core document-session executors and `src/legacy_document_session_services.*`,
diff --git a/docs/modernization/tasks.md b/docs/modernization/tasks.md
index dcc6894b..1b56af3d 100644
--- a/docs/modernization/tasks.md
+++ b/docs/modernization/tasks.md
@@ -1778,6 +1778,43 @@ Completed Task Log:
 | --- | --- | ---: | --- | --- |
 | 2026-06-15 | ADP-047 | no score movement | `powershell -ExecutionPolicy Bypass -File scripts\\automation\\quiet-validate.ps1 -BuildTargets pano_cli -TestRegex "pp_app_core_document_route|pp_app_core_document_session"` | `2f2b9621` |
 
+### ADP-048 - Extract Document-Open History Helper
+
+Status: Done
+Score: no score movement
+Debt: `DEBT-0039`
+Scope: `src/legacy_document_open_services.cpp` only
+
+Closeout: `c2083565`
+
+Goal:
+
+Reduce the inline retained project-open history-planning surface by
+extracting the `plan_document_open_history(route)` call and failure logging
+from `open_legacy_project()` into a focused helper while preserving current
+behavior.
+
+Done Checks:
+
+- The retained project-open history-planning call no longer lives inline in
+  `open_legacy_project()`.
+- The retained project-open history path now routes through a focused helper in
+  `src/legacy_document_open_services.cpp`.
+- `DEBT-0039` and the roadmap note the reduced remaining document-open bridge
+  surface.
+
+Validation:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts\\automation\\quiet-validate.ps1 -BuildTargets pano_cli -TestRegex "pp_app_core_document_route|pp_app_core_document_session"
+```
+
+Completed Task Log:
+
+| Date | Task | Score | Validation | Commit |
+| --- | --- | ---: | --- | --- |
+| 2026-06-15 | ADP-048 | no score movement | `powershell -ExecutionPolicy Bypass -File scripts\\automation\\quiet-validate.ps1 -BuildTargets pano_cli -TestRegex "pp_app_core_document_route|pp_app_core_document_session"` | `c2083565` |
+
 ### RND-001 - Make Pure Equirectangular Export The Primary Success Path
 
 Status: Done