meshai/work/scripts/preview_dashboard.py

76 lines
3.1 KiB
Python
Raw Normal View History

feat(region-routing): unified per-family routing cards + region-scoped family→channel routing (#87) * feat(region-routing): P1 tagging + region_routes primitive + read/write API + preview launcher - config.py: add Coverage.region_tagging (bool=False); add RegionRouteMatrix dataclass (enabled, cells) above NotificationsConfig; add region_routes field to NotificationsConfig; add explicit hydration branch for region_routes in _dict_to_dataclass mirroring destinations pattern. - coverage_area.py: add MonitoringArea.name (str|None=None, frozen); update areas_from_config to preserve name; refactor inline geom extraction from classify_event_areas into shared _event_geom_json helper; add matching_area_names(geom_json, areas)->list[str] (additive, all named matches, config-order, deduped; gate unchanged); add event_region_names convenience wrapper. - coverage_filter.py: add region_tagging ctor kwarg; stamp event.region/ regions before the gate when region_tagging=True and areas non-empty and not event.regions (never clobbers satpass preset). - pipeline/__init__.py: wire region_tagging into CoverageFilter construction. - notification_routes.py: add GET /notifications/regions (named coverage area names, config-order, deduped); GET /notifications/region-routing (matrix as JSON); POST /notifications/region-routing (explicit RMW — only region_routes changes, toggles/rules/destinations survive). - scripts/preview_dashboard.py: mesh-free launcher — dashboard API only, no mesh connector, no broadcast loop; vite runs separately. All 87 coverage tests pass; 300 total pass; 6 pre-existing failures unchanged (adapter config count mismatch + MeshCore EventType.NEW_CONTACT). * feat(region-routing): manual region x family matrix editor page Adds RegionRoutingMatrix.tsx — a plain editor over the region_routes config primitive. Rows = families (via useFamilies()), cols = regions (from GET /api/notifications/regions). Each cell exposes MT channel (ChannelPicker single + includeDisabled), MC channel name (text input), min_severity select (routine/priority/critical/immediate), and an enabled checkbox. Only cells where MT or MC is set are included in the sparse POST payload. Master enable toggle maps to top-level enabled. MT budget guard warns when more than 7 distinct MT indices are in use. Sticky family column; horizontal scroll for wide region sets. Registers route /region-routing in App.tsx and adds "Region Routing" nav entry (Map icon) under the Meshtastic section in Layout.tsx, immediately after Routing. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(region-routing): regions endpoint reads saved (disk) coverage so routing columns are dynamic without a bot restart; preview reloads config after writes * feat(routing): unify MT/MC routing into per-family cards; region routing as an in-card expand; remove rules/destinations UI + standalone page * refactor(routing): move Meshtastic Routing from /notifications to /meshtastic/routing (mirror /meshcore/routing); redirect legacy path * feat(region-routing): dispatcher honors region_routes matrix (authoritative-on-match, per-region cooldown, per-channel dedup); non-matrix path unchanged Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(region-routing): matrix dedup key must match boot-restore 2-tuple form (prevents restart re-broadcast flood); regression test --------- Co-authored-by: Matt Johnson <mj@k7zvx.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-07 16:52:03 -06:00
"""Mesh-free preview launcher for the MeshAI dashboard API.
Stands up ONLY the FastAPI dashboard (NO MeshAI instance, NO mesh connector,
NO broadcast loop) so the region-routing UI can be developed and tested without
a live mesh radio.
Usage:
python3 scripts/preview_dashboard.py [config_dir]
config_dir defaults to /tmp/meshai-region-preview/config.
The directory may be empty an empty/missing config.yaml yields safe defaults.
The script sets app.state.config and app.state.config_path so all config-backed
endpoints work. Endpoints that read other app.state attrs (notification_router,
env_store, alert_engine, etc.) guard with getattr(..., None) already, so they
return graceful empty/404 responses rather than crashing.
Run vite separately for the frontend:
cd dashboard-frontend && npm run dev
Then hit the API at http://localhost:8082/api/...
"""
import sys
from pathlib import Path
# Resolve the config directory from the first CLI arg or use the default preview path.
cfg_dir = Path(sys.argv[1]) if len(sys.argv) > 1 else Path("/tmp/meshai-region-preview/config")
cfg_dir.mkdir(parents=True, exist_ok=True)
# Ensure there is a minimal config.yaml so load_config doesn't error.
_cfg_yaml = cfg_dir / "config.yaml"
if not _cfg_yaml.exists():
_cfg_yaml.write_text("# meshai preview config\n")
# Import AFTER path is ready so relative imports resolve correctly.
from meshai.dashboard.server import create_app
from meshai.config_loader import load_config
import uvicorn
app = create_app()
cfg = load_config(cfg_dir)
app.state.config = cfg
app.state.config_path = cfg_dir / "config.yaml"
# Stub out attrs that endpoints guard with getattr(..., None) to avoid AttributeError
# on first access in case FastAPI touches app.state eagerly.
for _attr in ("notification_router", "env_store", "alert_engine", "health_engine",
"data_store", "connector", "bus", "danger_correlator", "mesh_context",
"broadcaster"):
if not hasattr(app.state, _attr):
setattr(app.state, _attr, None)
# PREVIEW-ONLY: coverage is a restart-required section, so a normal deploy keeps
# the running config stale until restart. In the preview we want create/delete/save
# to reflect immediately, so reload the in-memory config from disk after any
# /api/config write. (Prod keeps the restart-gated semantics; this hook is local.)
@app.middleware("http")
async def _reload_config_after_write(request, call_next):
response = await call_next(request)
try:
if (request.method in ("PUT", "POST", "DELETE", "PATCH")
and request.url.path.startswith("/api/config")):
app.state.config = load_config(cfg_dir)
except Exception:
pass
return response
if __name__ == "__main__":
print(f"[preview] config dir : {cfg_dir}")
print(f"[preview] config path: {app.state.config_path}")
print(f"[preview] listening : http://0.0.0.0:8082")
print(f"[preview] regions API: http://localhost:8082/api/notifications/regions")
print(f"[preview] matrix API : http://localhost:8082/api/notifications/region-routing")
uvicorn.run(app, host="0.0.0.0", port=8082)