release-tracker/README.md

# Release Tracker

A Zig application that monitors releases from starred repositories across GitHub, GitLab, Codeberg, and SourceHut, generating an RSS feed for easy consumption.

Needs to be able to rotate PAT on GitLab

## Features

- Monitor releases from multiple Git hosting platforms
- Generate RSS feed of new releases
- Configurable authentication for each platform
- Designed to run periodically as a CLI tool
- Static file output suitable for deployment on Cloudflare Pages

## Building

Requires Zig 0.14.1:

```bash
zig build
```

## Usage

1. Copy `config.example.json` to `config.json` and fill in your API tokens
2. Run the application:

```bash
./zig-out/bin/release-tracker config.json
```

3. The RSS feed will be generated as `releases.xml`

## Configuration

Create a `config.json` file with your API tokens:

```json
{
  "github_token": "your_github_token",
  "gitlab_token": "your_gitlab_token", 
  "codeberg_token": "your_codeberg_token",
  "sourcehut": {
    "repositories": [
      "~sircmpwn/aerc",
      "~emersion/gamja"
    ]
  },
  "last_check": null
}
```

### API Token Setup

- **GitHub**: Create a Personal Access Token with `public_repo` and `user` scopes
- **GitLab**: Create a Personal Access Token with `read_api` scope
- **Codeberg**: Create an Access Token in your account settings
- **SourceHut**: No token required for public repositories. Specify repositories to track in the configuration.

## Testing

Run the test suite:

```bash
zig build test
```

## Deployment

This tool is designed to be run periodically (e.g., via cron) and commit the generated RSS file to a Git repository that can be deployed via Cloudflare Pages or similar static hosting services.

Example cron job (runs every hour):
```bash
0 * * * * cd /path/to/release-tracker && ./zig-out/bin/release-tracker config.json && git add releases.xml && git commit -m "Update releases" && git push
```