Tuned Image Sorter v69.6 — portable package troubleshooting
========================================================

Use this guide when the user does not know what to do after an error.

1. The app does not start
   Check:
   - The ZIP was fully extracted.
   - The user runs TunedImageSorter.exe, not a file inside the archive.
   - The _internal folder is next to TunedImageSorter.exe.
   - Windows SmartScreen: More info -> Run anyway.

2. CPU or GPU package
   CPU package:
   - most compatible option;
   - CUDAExecutionProvider is not needed;
   - onnxruntime-gpu is not needed.

   GPU package:
   - needs an NVIDIA GPU and a current NVIDIA driver;
   - CUDA Toolkit and cuDNN installer are not required separately;
   - _internal\nvidia can be large — this is normal.

3. Environment check
   CPU:
     TunedImageSorter_CLI.exe --runtime-preflight
   GPU:
     TunedImageSorter_CLI.exe --runtime-preflight --gpu

   If CUDAExecutionProvider is missing in the GPU package, use the CPU package or check the NVIDIA driver.

4. Input/output errors
   Rule:
     input  = source photo folder;
     output = separate result folder outside input.

   Bad:
     D:\Photos\result, if input = D:\Photos

   Better:
     input  = D:\Photos
     output = D:\result

5. No faces found
   This can be a valid result if faces are small, blurry, occluded or the photos contain no people.
   Test with 5–20 clear portrait photos.

6. Some files were skipped
   Open:
     reports\problem_files.csv
   This lists problematic/unreadable/suspicious files. Processing of the remaining photos should continue.

7. Check an existing result folder
   Use:
     TunedImageSorter_CLI.exe --result-health --output <result_dir>

   Reports will be written to:
     <result_dir>\reports\result_health_check.json
     <result_dir>\reports\result_health_check.txt

8. Send diagnostics to the developer
   Use:
     TunedImageSorter_CLI.exe --support-bundle --output <result_dir>

   Do not add source photos to the ZIP. Support-bundle collects diagnostics, reports, package identity and result_health_check.

9. Where to look in the GUI
   - Run / settings — main run path.
   - Progress — job progress.
   - Status / errors — Meaning and Action.
   - Run result — completion summary.
   - Diagnostics / Support — result-health and support-bundle.

10. What did not change in v69.6
   ML/recognition unchanged.
   clustering unchanged.
   pipeline stages unchanged.
   SQLite schema unchanged.
   project.json unchanged.
   CSV report schemas unchanged.
   ordinary Start must run mode=all, not apply-names.

v69.6 / Stage 055 — friend-ready README / quick start / troubleshooting polish.
If the problem is not resolved, do not share the ZIP as stable; run through RC_CHECKLIST_EN.txt and RELEASE_GATE_EN.txt.