Introduction

Timekeeper is a specialized assistant designed to keep life on track through deterministic logic rather than probabilistic AI. It focuses on the essentials: commute times, weather warnings, and critical transit updates, delivering them directly to Discord.

The Architecture

Timekeeper is a modular Python application designed for 24/7 reliability: - Core Logic: Object-oriented Python 3.8+ monitoring service. - Data Sourcing: Integrates directly with Google Maps (Directions API), WeatherAPI, Translink GTFS feeds, and BOM XML warnings. - Notifications: Discord Webhooks for centralized, cross-platform alerting. - Deployment: Containerized via Docker for consistent execution across environments.

Key Features

• Commute Alerts: Urgent "Time to Leave" notifications based on real-time traffic to ensure arrival before key deadlines.
• Weather Watch: 15-minute condition change detection and immediate alerts for new BOM Severe Weather Warnings.
• Transit Monitoring: Real-time tracking of train delays at specific stations (Eagle Junction/Central) via GTFS feeds.
• Health Checks: Automated daily summaries of all notifications and system health status.