maverick-dashboard 0.1.2__tar.gz

maverick_dashboard-0.1.2/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: maverick-dashboard
+Version: 0.1.2
+Summary: Local web dashboard + REST API for Maverick (FastAPI + htmx)
+Author: cdayAI
+License: MIT
+Project-URL: Homepage, https://github.com/cdayAI/maverick
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: maverick-agent>=0.1
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn>=0.27
+Requires-Dist: jinja2>=3.1
+Requires-Dist: python-multipart>=0.0.9
+
+# maverick-dashboard
+
+Local web dashboard for Maverick. Reads `~/.maverick/world.db` and
+`~/.maverick/skills/` and surfaces:
+
+- Goals: status, plan tree, trajectory replay, cancel, answer pending
+  questions inline.
+- Skills: installed list plus an install form (gated behind
+  `MAVERICK_ALLOW_SKILL_INSTALL=1`).
+- Facts: persistent key/value memory.
+- Spend: per-episode breakdown with CSV export.
+- Providers / tools / channels / plugins / MCP servers: read-only views
+  of what the kernel currently has wired.
+- Audit log: tail and grep over `~/.maverick/audit/`.
+- Halt button: arms `~/.maverick/HALT` from the header on any page.
+
+## Design
+
+- FastAPI + Jinja2. No React, no build step.
+- Server binds to `127.0.0.1` by default.
+- To bind publicly (`--host 0.0.0.0`), set `MAVERICK_DASHBOARD_TOKEN`
+  and send `Authorization: Bearer <token>`. Query-token auth was
+  removed in the council security pass because it leaks via Referer
+  and access logs.
+- Baseline browser security headers (X-Frame-Options DENY,
+  X-Content-Type-Options nosniff, Referrer-Policy no-referrer,
+  Cross-Origin-Opener-Policy same-origin) are applied to every response.
+- WorldModel is held as a singleton per DB path so each request
+  doesn't reopen SQLite + reapply migrations.
+
+## Run
+
+```bash
+pip install -e ./packages/maverick-dashboard
+maverick-dashboard          # listens on http://127.0.0.1:8765
+```
+
+Or via the core CLI:
+
+```bash
+maverick dashboard
+```

maverick_dashboard-0.1.2/README.md

@@ -0,0 +1,42 @@
+# maverick-dashboard
+
+Local web dashboard for Maverick. Reads `~/.maverick/world.db` and
+`~/.maverick/skills/` and surfaces:
+
+- Goals: status, plan tree, trajectory replay, cancel, answer pending
+  questions inline.
+- Skills: installed list plus an install form (gated behind
+  `MAVERICK_ALLOW_SKILL_INSTALL=1`).
+- Facts: persistent key/value memory.
+- Spend: per-episode breakdown with CSV export.
+- Providers / tools / channels / plugins / MCP servers: read-only views
+  of what the kernel currently has wired.
+- Audit log: tail and grep over `~/.maverick/audit/`.
+- Halt button: arms `~/.maverick/HALT` from the header on any page.
+
+## Design
+
+- FastAPI + Jinja2. No React, no build step.
+- Server binds to `127.0.0.1` by default.
+- To bind publicly (`--host 0.0.0.0`), set `MAVERICK_DASHBOARD_TOKEN`
+  and send `Authorization: Bearer <token>`. Query-token auth was
+  removed in the council security pass because it leaks via Referer
+  and access logs.
+- Baseline browser security headers (X-Frame-Options DENY,
+  X-Content-Type-Options nosniff, Referrer-Policy no-referrer,
+  Cross-Origin-Opener-Policy same-origin) are applied to every response.
+- WorldModel is held as a singleton per DB path so each request
+  doesn't reopen SQLite + reapply migrations.
+
+## Run
+
+```bash
+pip install -e ./packages/maverick-dashboard
+maverick-dashboard          # listens on http://127.0.0.1:8765
+```
+
+Or via the core CLI:
+
+```bash
+maverick dashboard
+```

maverick_dashboard-0.1.2/maverick_dashboard/__init__.py

@@ -0,0 +1,3 @@
+"""Maverick web dashboard."""
+
+__version__ = "0.1.2"