``fhops.web`` Package ===================== Run discovery and the ``run.json`` manifest are implemented in :mod:`fhops.web.discovery`. The FastAPI application factory lives in :mod:`fhops.web.app` and is imported only when the optional ``fhops[web]`` extra is installed. .. automodule:: fhops.web.discovery :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.app :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.runs :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.editing :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.lidarview :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.lidarworkflow :members: :undoc-members: :show-inheritance: :noindex: .. automodule:: fhops.web.agent :members: :undoc-members: :show-inheritance: :noindex: Key objects ----------- - :class:`fhops.web.discovery.RunRecord` – one discovered run directory. - :func:`fhops.web.discovery.discover_runs` – scan roots and classify operational, hauling, and tactical runs. - :func:`fhops.web.discovery.build_run_manifest` / :func:`fhops.web.discovery.write_run_manifest` – build or write ``run.json``. - :class:`fhops.web.app.ServiceConfig` – roots, bind, proxy prefix, remote-bind opt-in, geometry, geometry CRS, workspace, and CLI command prefix. - :class:`fhops.web.runs.RunManager` / :class:`fhops.web.runs.RunRequest` – start, monitor, stream, and control CLI subprocesses without importing the optimizer. - :func:`fhops.web.editing.update_objective` / ``update_locks`` / ``update_hauling`` / ``save_tactical_overlay`` – validated edits through the existing loader. - :func:`fhops.web.lidarview.lidar_payload` – read-only scenario LiDAR evidence for the panel. - :func:`fhops.web.lidarview.lidar_map_values` – block values for LiDAR map layers. - :func:`fhops.web.lidarworkflow.resolve_bundle` / ``validate_bundle`` / ``register_bundle`` / ``map_bundle_products`` – allowlisted LiDAR workflow actions. - :func:`fhops.web.agent.run_agent` – opt-in bridge to the installed ``opencode`` CLI. - :func:`fhops.web.app.create_app` – FastAPI factory. - :func:`fhops.web.app.validate_bind` – loopback/remote-bind guard. - :func:`fhops.web.skins.load_skins` / :func:`fhops.web.skins.validate_skin` – skin registry. - :class:`fhops.web.skins.SkinManifest` – validated domain skin. - :func:`fhops.web.mapdata.load_block_geometry` – resolve block geometry from ``--geometry``, the scenario, or a run-local GeoJSON. - :func:`fhops.web.mapdata.layer_registry` – available/unavailable map layers with reasons. - :func:`fhops.web.mapdata.time_payload` – day/shift/period control values. - :func:`fhops.web.mapdata.map_payload` – GeoJSON FeatureCollection for the requested layers. CLI --- .. code-block:: bash fhops web --runs runs/ --workspace /path/to/fhops-checkout fhops web --runs runs/ --allow-agent fhops web --runs runs/ --lidar-bundles /path/to/femic/bundles fhops web manifest runs/run-a --status optimal fhops web discover runs/