Add reusable GIS run mode and AI runtime opt-in

docs/AI_PIPELINES.md

@@ -84,8 +84,16 @@ Ultralytics/PyTorch compatibility, but it still does not run tile prediction and
 does not download weights. It cannot be combined with `--assume-dependencies`
 because that would turn the smoke into a false positive.
 
+Docker and Unraid runtime support remains opt-in. Set `GEOINTEL_INSTALL_AI=true`
+at build time to install the backend `.[gis,ai]` extra into the container. Leave
+it unset or `false` for the default GIS-only image. Runtime model files should be
+mounted into the container, for example `/app/models/local-model.pt`, and enabled
+with `YOLO_ENABLED=true` plus `YOLO_MODEL_PATH=/app/models/local-model.pt`.
+GeoIntel never downloads weights automatically.
+
 Environment variables:
 
+- `GEOINTEL_INSTALL_AI`
 - `YOLO_ENABLED`
 - `YOLO_MODEL_PATH`
 - `YOLO_MODEL_ID`

docs/CODEX_EXECUTION_LOG.md

@@ -1,3 +1,35 @@
+## Sprint 117 Reusable GIS run and AI runtime opt-in (2026-07-05)
+
+Changed:
+- Added a Map workspace full-run mode selector with `Create new dataset/export` and `Reuse latest saved dataset for QA`.
+- Reuse mode runs QA/QC against the latest saved derived map-selection dataset without creating another derived dataset/export pair.
+- Added opt-in Docker and Unraid AI build support through `GEOINTEL_INSTALL_AI=true`; default builds still install only the GIS runtime.
+- Passed YOLO runtime environment variables and a `/app/models` volume into the all-in-one Unraid container so local PyTorch/Ultralytics models can be mounted explicitly.
+- Updated `.env.example`, `backend/README.md`, `frontend/README.md`, `scripts/README.md`, `docs/AI_PIPELINES.md`, `docs/TODO.md` and `CHANGELOG.md`.
+- Added regression coverage in `backend/tests/test_sprint116_operational_gis_map_workflow.py` and `backend/tests/test_docker_runtime_config.py`.
+
+Validation:
+- RED: `python -m pytest backend\tests\test_sprint116_operational_gis_map_workflow.py backend\tests\test_docker_runtime_config.py -q` failed before implementation because `fullWorkflowMode`, AI build args and YOLO runtime env wiring were absent.
+- `python -m pytest backend\tests\test_sprint116_operational_gis_map_workflow.py backend\tests\test_docker_runtime_config.py -q` passed: 22 tests.
+- `cd frontend && npm run typecheck` passed.
+- `cd frontend && npm run build` passed.
+- `python -m compileall backend/app` passed.
+- `python -m py_compile scripts\yolo_preflight.py backend\scripts\yolo_preflight.py` passed.
+- `python -m pytest backend\tests\test_sprint31_unraid_template.py backend\tests\test_docker_runtime_config.py -q` passed: 27 tests.
+- `cd backend && python -m pytest -q` passed: 366 tests.
+- `bash scripts/run_readiness_check.sh` passed: 366 backend tests plus frontend typecheck/build.
+- `cd backend && python -m alembic heads` passed: `202606120900 (head)`.
+- `cd backend && python -m alembic upgrade head --sql` passed.
+- `bash -n scripts/live_migration_smoke.sh; bash -n scripts/deploy_tower.sh; bash -n deploy/unraid/run-dockerman-container.sh` passed.
+- Local Codex host could not run `docker compose config` because Docker is not installed in this Windows environment; Tower Docker validation is required after push/deploy.
+
+Limitations:
+- `GEOINTEL_INSTALL_AI=true` installs optional PyTorch/Ultralytics dependencies but still requires a user-provided local model file; GeoIntel does not download weights.
+- Reuse mode intentionally reuses only the latest saved map-selection dataset for QA/QC. It does not delete or mutate older derived datasets/exports.
+
+Next recommended pass:
+- Run full readiness, deploy Tower, and browser-verify both Map run modes plus configured-YOLO preflight status in the live container.
+
 ## Sprint 116 Operational GIS map workflow (2026-07-04)
 
 Changed:

docs/TODO.md

@@ -78,6 +78,8 @@ This file now starts with the current implementation status. Older preparation/b
 - [x] Add selected map feature extraction with highlight, property table, copy and GeoJSON download.
 - [x] Add operational GIS map workflow with road basemap, persisted database layer selection and AOI/layer `vector_features` query run.
 - [x] Add basemap policy notice and guided GIS query-to-QA/export workflow in the Map workspace.
+- [x] Add reusable latest-result mode for repeated Map QA/QC runs without duplicate derived artifacts.
+- [x] Add opt-in Docker/Unraid AI build/runtime path for local PyTorch/Ultralytics YOLO operation.
 - [x] Add one-click full GIS workflow action for query, derived dataset, QA/QC and export handoff.
 - [x] Add QA/QC workspace result hierarchy and filter density polish.
 - [x] Add Change Detection panel hierarchy and analysis workspace density polish.