patchbay/README.md
matamune 7261b48fa1
All checks were successful
check / check (push) Successful in 35s
Move Patchbay endpoints to root paths
2026-05-12 23:45:58 +00:00

44 lines
1,013 B
Markdown

# patchbay
Containerized Bun service for GitHub and jojo.build webhooks.
## Endpoints
```text
GET /healthz
POST /jojo
POST /github
```
## Environment
```text
HOST=0.0.0.0
PORT=3000
DATA_DIR=/app/data
JOJO_WEBHOOK_SECRET=...
GITHUB_WEBHOOK_SECRET=...
DISCORD_WEBHOOK_URL=
DISCORD_NOTIFY_EVENTS=push,pull_request,release
FEED_SOURCES_PATH=./feed-sources.json
```
Discord notifications are optional. When `DISCORD_WEBHOOK_URL` is unset, the
service skips Discord output. `DISCORD_NOTIFY_EVENTS` is a comma-separated
allow list and defaults to `push,pull_request,release`.
## Development
```bash
bun install
bun run check
bun run dev
```
Accepted webhook events are appended to `DATA_DIR/events.jsonl`; queued work
items are appended to `DATA_DIR/jobs.jsonl`.
Feed watcher events are configured in `feed-sources.json`. The first poll primes
`DATA_DIR/feed-state.json`; later polls append upstream activity to
`DATA_DIR/feed-events.jsonl` and release-triggered fork sync work to
`DATA_DIR/feed-jobs.jsonl`.