angelia-dev/angelia

> Angelia (ἀγγελία): ancient Greek for "message, news". The spirit of announcements and a daughter of Hermes.
The self-hosted release event bus. Angelia watches upstream artifacts (PyPI, npm, crates.io, GitHub/GitLab releases, OCI images, …), detects every new version, and delivers one clean, signed, machine-readable event (CloudEvents) to your CI, your chat, or your AI agents.
Detect → normalize → deliver.
## Status
Pre-alpha / Phase 0. Nothing here is usable yet. Part of the angelia-dev organization. Design docs:
docs/prd.md: problem, market, goals, requirements, roadmap
docs/architecture.md: components, event contract, language choice, Phase 0 benchmarks
docs/ESTIMATION.md: how stories are sized and which model an agent uses
docs/adr/: architecture decision records
Work is tracked on the Angelia Roadmap board. Contributors, human or AI, start with AGENTS.md.
## Planned repositories (GitHub org angelia-dev)
| Repo | Purpose |
| angelia | Core server, CLI, built-in sources and sinks |
| spec | Event schema (CloudEvents types, JSON Schema) and OpenAPI |
| actions | GitHub Action to consume Angelia events |
| helm-charts | Kubernetes deployment |
| docs | Website and documentation |
| plugin-sdk | WASM plugin SDKs and conformance kit (later) |
| ui | Web UI (later) |
## Development
Requires Go 1.27 or newer (the toolchain pinned in go.mod; Go downloads it automatically) and golangci-lint v2.15.0 or newer, built with Go 1.27 or newer. Run these from the repository root (make help lists them):
| Command | What it does |
| make build | Builds bin/angelia with CGOENABLED=0 and injects version, commit and build date via -ldflags |
| make test | Runs go test -race ./... |
| make lint | Runs golangci-lint run and the gofumpt format check (golangci-lint fmt --diff), config in .golangci.yml |
| make vuln | Runs govulncheck (pinned version) on all packages; needs access to vuln.go.dev |