API and Dashboard

API and Dashboard

The repository contains app/api.py and app/dashboard.py as application-facing entry points.

API role

The API layer is intended to expose IncidentGraph operations without embedding business logic directly into the web layer. Core evidence, fusion and benchmark logic remains under the incidentgraph/ package.

Dashboard role

The dashboard is an inspection surface for research/development output. It should display evidence and uncertainty without implying that a selected hypothesis is automatically a factual or consequential decision.

Development guidance

• keep evidence references traceable through API responses;
• do not hide contradiction groups when presenting selected claims;
• distinguish missing evidence from negative evidence in the UI;
• avoid exposing local filesystem evidence paths to untrusted clients;
• sanitize any uploaded or externally supplied identifiers;
• keep private camera data outside public demonstrations.

Tests

tests/test_api.py provides automated coverage for the API layer. Run the project test suite before publishing an API change:

python -m pytest -q