Unified event and monitoring agent templates for sports, policy, and operational alerting workflows.
This repository consolidates multiple one-off gear-* tracker projects into a single, reusable foundation so future trackers share:
- common ingestion patterns
- common alerting interfaces
- shared deployment and operations guidance
- consistent testing and observability standards
- Source adapters pull data from APIs, feeds, or pages.
- Normalization layer converts raw events into a common event schema.
- Rules engine evaluates event conditions and trigger logic.
- Notification layer routes alerts to configured channels.
- Storage/telemetry records event history, status, and health metrics.
.
├── docs/
│ ├── ARCHITECTURE.md
│ └── MIGRATION_MAP.md
├── templates/
│ ├── tracker-template-python/
│ └── tracker-template-typescript/
├── examples/
│ ├── sports/
│ ├── policy/
│ └── ops/
└── src/
├── adapters/
├── rules/
└── notifiers/
Legacy repos were archived and redirected here (for example: sports live trackers, policy watchers, and state-change monitors).
Use docs/MIGRATION_MAP.md to map old repository names to their new module families.
- Choose a template in
templates/. - Implement source adapter(s) in
src/adapters/. - Add rules in
src/rules/. - Configure notifier(s) in
src/notifiers/. - Add an example under
examples/and validate with local tests.
- Publish canonical event schema (
v1) - Add template CLI scaffolder
- Add pluggable notifier registry
- Add basic replay simulator for backtesting rules
Every new tracker module should include:
- a short architecture note
- local run instructions
- test coverage for rule evaluation
- a migration note if replacing legacy behavior