CopilotandAlexandru Macocian
246f681ee7
Document the target design: the enrichment/triage vision, the single-LDAP-account SSO access model (Authentik client_credentials for Grafana, unchanged JWT bearer for gssh, read-only PAT for Gitea), the headless-auth blocker and its fix in sherlock, the grounded read-only diagnostic agent, and phased delivery. Index it from the README. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 5749c447-6ecd-46bd-946d-21b4d101d084
3.7 KiB
jarvis
Alert → AI diagnostic → authenticated Atom feed, for the Charlie homelab.
jarvis receives Grafana alert webhooks, runs a headless GitHub Copilot CLI agent (grounded in the cloned Charlie repositories) to produce a short SRE triage for each alert, and serves the results as an authenticated Atom feed that miniflux subscribes to.
The design spec describes the target design — the incident enrichment vision, the SSO-based access model, and the agent's live read-only tooling. This README documents what exists today.
Grafana (webhook contact point)
--> POST /webhook/grafana (Bearer token)
--> queue --> copilot --yolo -p <prompt> (in /context: cloned repos)
--> store entry (SQLite, /data)
<-- GET /feed.atom (HTTP Basic auth) <-- miniflux
Endpoints
| Method | Path | Auth | Purpose |
|---|---|---|---|
| POST | /webhook/grafana |
Bearer token | Receive Grafana alert batches |
| GET | /feed.atom |
HTTP Basic | Atom feed for miniflux |
| GET | /healthz |
none | Liveness |
Configuration (environment)
| Variable | Default | Purpose |
|---|---|---|
JARVIS_LISTEN |
:8080 |
Listen address |
JARVIS_DB_PATH |
/data/jarvis.db |
SQLite path (persist on a volume) |
JARVIS_WORKDIR |
/context |
CWD for the Copilot agent (cloned repos) |
JARVIS_MODEL |
(CLI default) | Pin a model, e.g. claude-sonnet-5 |
JARVIS_DIAG_TIMEOUT |
5m |
Per-alert diagnostic timeout |
JARVIS_QUEUE_SIZE |
128 |
Webhook queue depth |
JARVIS_FEED_TITLE |
Charlie alerts (jarvis) |
Feed title |
JARVIS_FEED_ID |
<BASE_URL>/feed.atom |
Stable feed id |
JARVIS_BASE_URL |
(empty) | Public base URL |
JARVIS_FEED_LIMIT |
50 |
Max entries served |
JARVIS_WEBHOOK_TOKEN |
(empty = open) | Bearer token Grafana must send |
JARVIS_FEED_USER |
(empty = open) | Feed basic-auth username |
JARVIS_FEED_PASSWORD |
(empty) | Feed basic-auth password |
COPILOT_GITHUB_TOKEN |
(empty) | GitHub PAT for Copilot (else stub diagnoser) |
GITEA_URL |
https://gitea… |
Gitea base URL for repo mirroring |
GITEA_ORGS |
Charlie |
Space-separated orgs to clone for context |
GITEA_TOKEN |
(empty) | Read-only Gitea token for private repos |
When no Copilot token is present jarvis falls back to a stub diagnoser (raw alert only) so it still runs in dev/CI.
Deploy
Built by Charlie/project-charlie's build-image scoped workflow (see
.charlie/build.yml) into
gitea.alexandru.macocian.me/amacocian/jarvis, then deployed by the
Charlie/jarvis stack repo.
Develop
go build ./...
go test ./...
JARVIS_FEED_USER=me JARVIS_FEED_PASSWORD=pw go run ./cmd/jarvis