Extract image import route planning

docs/modernization/debt.md

@@ -46,6 +46,7 @@ agent or engineer to remove them without reconstructing context from chat.
 | DEBT-0026 | Open | Modernization | Toolbar and canvas history command planning now consumes pure `pp_app_core` through `App::init_toolbar_main`, `NodeCanvas`, and `pano_cli plan-history-operation`, but live execution still mutates legacy `ActionManager` stacks and `Canvas::I` unsaved state directly | Preserve undo/redo/clear behavior while moving action history toward document/app command services | `pp_app_core_history_ui_tests`; `pano_cli plan-history-operation --kind undo --undo-count 2`; `pano_cli plan-history-operation --kind clear --undo-count 2 --redo-count 1 --memory-bytes 4096`; `ctest --preset desktop-fast --build-config Debug` | Undo/redo/clear execution is owned by document/app history services with toolbar and canvas input acting only as adapters |
 | DEBT-0027 | Open | Modernization | Canvas draw-tool toolbar command, canvas input mode switching, and active-state planning now consume pure `pp_app_core` through `App::init_toolbar_draw`, `App::update`, `NodeCanvas`, `pano_cli plan-canvas-tool`, and `pano_cli plan-canvas-tool-state`, but live execution/state storage still mutates or reads legacy `Canvas` mode state, pen picking state, touch-lock state, and transform copy/cut action objects directly | Preserve current toolbar, stylus eraser, and keyboard draw/erase behavior while canvas input/tools move toward an app/document command boundary | `pp_app_core_canvas_tool_ui_tests`; `pano_cli plan-canvas-tool --kind copy`; `pano_cli plan-canvas-tool-state --mode draw --picking --touch-lock`; `ctest --preset desktop-fast --build-config Debug` | Canvas tool selection, toolbar state refresh, picking, touch lock, stylus eraser/key mode switching, and transform action execution are owned by app/document/canvas services with toolbar/canvas callbacks acting only as adapters |
 | DEBT-0028 | Open | Modernization | Canvas clear command planning now consumes pure `pp_app_core` through `App::init_toolbar_main` and `pano_cli plan-canvas-clear`, but live execution still calls legacy `Canvas::clear`, which records `ActionLayerClear`, clears the current layer/frame, and marks legacy `Canvas::I` unsaved directly | Preserve clear-current-layer behavior while canvas/document commands move toward document/app command services | `pp_app_core_document_canvas_tests`; `pano_cli plan-canvas-clear --r 0 --g 0.1 --b 0.2 --a 0.3`; `pano_cli plan-canvas-clear --no-canvas`; `ctest --preset desktop-fast --build-config Debug` | Canvas clear execution, undo recording, dirty-state updates, and clear color handling are owned by document/app services with toolbar callbacks acting only as adapters |
+| DEBT-0029 | Open | Modernization | Image import route planning now consumes pure `pp_app_core` through the File menu and `pano_cli plan-image-import`, but live execution still calls legacy `Canvas::import_equirectangular` or legacy import transform mode setup directly after image loading | Preserve current File > Import behavior while image import moves toward document/app/asset command services | `pp_app_core_document_import_tests`; `pano_cli plan-image-import --width 4096 --height 2048`; `pano_cli plan-image-import --width 1024 --height 1024`; `ctest --preset desktop-fast --build-config Debug` | Image loading, equirectangular import, transform-placement import, and failure reporting are owned by document/app/asset services with File-menu callbacks acting only as adapters |
 
 ## Closed Debt
 

docs/modernization/roadmap.md

@@ -511,6 +511,11 @@ legacy canvas mode execution continues.
 clear-current-layer command, including clear color validation, no-canvas
 handling, undo recording intent, and dirty-state intent before legacy
 `Canvas::clear` execution continues.
+`pano_cli plan-image-import` exposes app-core planning for File > Import image
+route decisions, including wide equirectangular images, legacy vertical cube
+strips, regular transform-placement images, and invalid image dimensions before
+legacy `Canvas::import_equirectangular` or import transform-mode execution
+continues.
 `pano_cli plan-grid-operation` exposes app-core planning for grid heightmap
 pick/load/reload/clear, lightmap render capability/limit checks, and heightmap
 commit used by the live grid panel before legacy image loading, OpenGL texture
@@ -1191,6 +1196,13 @@ Results:
   `pano_cli_plan_canvas_clear_no_canvas_smoke`, and
   `pano_cli_plan_canvas_clear_rejects_bad_color` passed and expose toolbar
   canvas clear planning as JSON automation.
+- `pp_app_core_document_import_tests` passed, covering wide equirectangular,
+  legacy vertical cube strip, regular transform-placement, and invalid-dimension
+  import route decisions.
+- `pano_cli_plan_image_import_wide_equirect_smoke`,
+  `pano_cli_plan_image_import_transform_smoke`, and
+  `pano_cli_plan_image_import_rejects_invalid_dimensions` passed and expose File
+  > Import route planning as JSON automation.
 - `pp_app_core_history_ui_tests` passed, covering undo/redo availability,
   no-op history commands, clear-history stack/memory state, memory-only clear,
   and negative metric rejection.