feat: guide raster building analysis workflow

docs/AI_PIPELINES.md

@@ -49,6 +49,8 @@ Sprint 8B adds an import-safe real YOLO adapter path:
 - YOLO class labels are normalized to lowercase for persisted detection records and filtering, while the original model label remains available in detection provenance.
 - Detection runs remain synchronous behind the existing job and analysis-run persistence boundary for Sprint 8B.
 
+The guided Detection Lab action does not introduce another inference pipeline. It creates a tile manifest through the existing raster service, validates that manifest and the selected local asset through YOLO preflight, then invokes the same configured detection service. Persisted `Detection` geometry remains the authoritative map output; QA continues to compare those rows against persisted reference `vector_features` and stores `QualityCheck`/`Metric` records.
+
 ### Sprint 13 YOLO operational preflight
 
 Sprint 13 adds a local preflight command for configured YOLO operation:

docs/API_CONTRACTS.md

@@ -610,6 +610,19 @@ Response:
 
 Sprint 8 implements Detection Lab foundation only. YOLO/PyTorch real inference is not enabled, no model is downloaded, and fixture detections require explicit fixture mode.
 
+### Guided browser orchestration
+
+The current frontend offers one guided building-analysis action, but does not add a parallel backend workflow endpoint. It deliberately composes the canonical contracts in this order:
+
+1. optional explicit `POST /api/v1/projects/{project_id}/datasets/upload` for a georeferenced GeoTIFF;
+2. `POST /api/v1/projects/{project_id}/datasets/{dataset_id}/raster/tile` with 512 px tiles and 64 px overlap;
+3. `GET /api/v1/detection/yolo/preflight` with the returned manifest and selected local model asset;
+4. `POST /api/v1/detection/run` only after successful preflight;
+5. persisted run, Detection list and Detection GeoJSON reads;
+6. optional persisted reference QA through the existing detection QA endpoint.
+
+The strict `POST /api/v1/detection/run` contract still requires `tile_manifest_path` for configured YOLO. The frontend does not create fake tiles, bypass tile limits, fetch external imagery or download model weights.
+
 ### GET `/api/v1/detection/models`
 
 Returns object-detection model capability descriptors.

docs/CODEX_EXECUTION_LOG.md

@@ -1,3 +1,20 @@
+## Sprint 195 Guided raster-to-detection workflow (2026-07-14)
+
+Changed:
+- Connected the existing Dataset upload, `raster/tile`, YOLO preflight, configured detection, persisted result listing and MapLibre GeoJSON overlay into one guided frontend action.
+- Added explicit GeoTIFF input inside Detection Lab so users no longer need to navigate to dataset management before starting image analysis.
+- Uses fixed safe tiling defaults of 512 px with 64 px overlap, reuses the current manifest and estimates the tile count from canonical raster inspection before writing tiles; the backend remains authoritative for tile-limit, manifest, dependency and local-model validation.
+- Moved manifest paths, direct-manifest execution and calibration under management disclosures while returning persisted reference QA to the main result flow.
+- Kept every run on the existing `Dataset -> Job -> AnalysisRun -> Detection -> QualityCheck/Metric` chain. No migration, API route, external fetch, model download or synthetic inference was added.
+
+Validated locally:
+- `bash scripts/run_readiness_check.sh` passed with `575 passed`, backend compile, one Alembic head (`202607140001`), frontend typecheck/build and live-smoke syntax validation.
+- `python -m alembic upgrade head --sql` generated the complete 26,972-byte PostgreSQL/PostGIS migration plan successfully.
+- Focused guided-flow, stale-map-state and direct-upload contracts passed. The Windows workstation has no Docker CLI; live container/PostGIS validation therefore remains part of the Tower deployment pass.
+
+Next:
+- Provision one existing real Mol operator orthophoto and matching official GRB reference into the regional workbench through the canonical upload API, then execute the guided action and verify the persisted map/QA result in the browser.
+
 ## Sprint 194 Regional official time series and full-Area performance (2026-07-14)
 
 Changed: