# CalEvents

CalEvents is a public UC Berkeley campus events discovery site. It aggregates upcoming events from campus calendars and public source feeds, normalizes them into a single event feed, and refreshes automatically every morning.

## Primary Resources

- [Homepage](https://cal-events.com/): Search and browse upcoming Berkeley events by date, category, source, and keyword.
- [Events JSON](https://cal-events.com/events.json): Public machine-readable event feed. The top-level object contains `events`, `sources`, and `lastUpdated`.
- [Search Index](https://cal-events.com/search-index.json): Compact text-search index generated from the published events.
- [Feed Status](https://cal-events.com/status.json): Machine-readable ingestion status, source health, fallback usage, duplicate counts, and filtering counts.
- [OpenAPI Description](https://cal-events.com/openapi.json): API description for public static data resources.
- [API Catalog](https://cal-events.com/.well-known/api-catalog): Linkset catalog for API discovery.
- [Agent Skills](https://cal-events.com/.well-known/agent-skills/index.json): Skill files that explain how agents can search events and inspect feed status.

## Event Feed Shape

Each event in `events.json` has:

- `id`: stable source-derived event id
- `title`: event title
- `organizer`: organizer or campus unit
- `date`: Pacific date in `YYYY-MM-DD`
- `time`: display time
- `location`: venue or location text
- `description`: event summary
- `tags`: primary category first, with optional secondary tags
- `url`: official source URL
- `source`: normalized source id such as `livewhale`, `bampfa`, `callink`, `calbears`, `cal_performances`, `haas`, `berkeley_law`, `simons`, or `ehub`

## Categories

Supported user-facing categories are `Academic`, `Arts`, `Sports`, `Science & Tech`, `Student Life`, and `Entrepreneurship`.

## Guidance For Agents

- Prefer `events.json` for event data instead of scraping the rendered UI.
- Use `status.json` to understand freshness and source-level health.
- Dates are intended for America/Los_Angeles.
- Use official event `url` values for final user-facing citations or handoff links.
- Do not treat fallback/degraded source status as user-facing copy unless `data_quality_blocked` is true.

## Expanded Context

- [Full Agent Context](https://cal-events.com/llms-full.txt)