feat(demo): add real-time agent governance dashboard with Streamlit

Author: vnscka

demo/governance-dashboard/Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.11.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+COPY requirements.txt /app/requirements.txt
+RUN pip install --no-cache-dir -r /app/requirements.txt
+
+COPY . /app
+
+EXPOSE 8501
+
+CMD ["streamlit", "run", "app.py", "--server.address=0.0.0.0", "--server.port=8501"]

demo/governance-dashboard/README.md

@@ -0,0 +1,65 @@
+# Agent Governance Dashboard (Demo)
+
+Real-time governance monitoring dashboard for agentic systems, built with Streamlit.
+
+This demo visualizes:
+- Live policy evaluations (`allow` / `deny` / `escalate`)
+- Trust score heatmap between agents
+- Violation alerts with event drill-down
+- Policy coverage overview
+- Agent activity timeline
+
+## Project Structure
+
+- `app.py` - Streamlit dashboard entrypoint
+- `simulator.py` - Real-time governance event simulator and trust model
+- `requirements.txt` - Python dependencies
+- `Dockerfile` - Container image for the dashboard
+- `docker-compose.yml` - One-command launch
+
+## Local Run
+
+From `demo/governance-dashboard`:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\activate
+pip install -r requirements.txt
+streamlit run app.py
+```
+
+Open: `http://localhost:8501`
+
+## Docker Compose Run
+
+From `demo/governance-dashboard`:
+
+```powershell
+docker compose up --build
+```
+
+Open: `http://localhost:8501`
+
+To stop:
+
+```powershell
+docker compose down
+```
+
+## Usage Guide
+
+1. Enable `Live mode` to stream new policy events.
+2. Adjust `Refresh interval` and `Events per tick` in the sidebar.
+3. Filter by source agents, policy, or decision.
+4. Inspect `Violation Alerts` and select an `audit_id` for drill-down details.
+
+```markdown
+![Dashboard Overview](screenshots/dashboard-overview.jpeg)
+![Violation Drill-down](screenshots/violation-drilldown.jpeg)
+![Trust Heatmap](screenshots/trust-heatmap.jpeg)
+```
+
+## Notes
+
+- Data is generated by an in-app simulator for demo purposes.
+- Events are retained in a rolling in-memory window for responsive UI updates.