How jimdan-panda/calm-hypatia works
This tool archives Okta System Log events to Google Drive, with CLI and browser-dashboard entry points. A run chooses a date window, authenticates to Okta, fetches events, partitions them into deduplicated weekly JSON or CSV files, optionally uploads them into Shared Drive folders, and records a high-watermark for later runs. Progress can be shown in the terminal or streamed to the dashboard. The graph follows documented and excerpted calls; some partitioning and upload orchestration details are only partially shown, so uncertain links are marked unverified.
Main entry points: sync_manager.py Sync Manager · web_ui.py Web Dashboard · main.py CLI · progress.py Progress Reporter
Components 16
User Interfaces
- CLI
main.py - Web Dashboard
web_ui.py - Dashboard Event Stream
web_ui.py
Sync Runtime
- Sync Manager
sync_manager.py - Progress Reporter
src/progress.py
Archival
- Partition & Export
src/partitioner.py - Local Archive Files
- High-Watermark State
src/state_manager.py
External Services
- Okta Authentication
src/okta_client.py - Okta Log Fetch
src/okta_client.py - Drive Authentication
src/gdrive_client.py - Drive Folder Management
src/gdrive_client.py - Drive File Upload
src/gdrive_client.py
Other components
- Operator
- Google Shared Drive
- Okta System Log API
Connections 21
- Operator → CLI: runs
main.py - Operator → Web Dashboard: opens
web_ui.py - CLI → Sync Manager: runs sync
main.py - CLI → Web Dashboard: launches
main.py - Web Dashboard → Sync Manager: starts sync
web_ui.py - Sync Manager → High-Watermark State: reads checkpoint
sync_manager.py - Sync Manager → High-Watermark State: records run
sync_manager.py - Sync Manager → Okta Authentication: authenticates
sync_manager.py - Sync Manager → Okta Log Fetch: fetches logs
sync_manager.py - Okta Authentication → Okta System Log API: requests tokens
src/okta_client.py - Okta Log Fetch → Okta System Log API: queries events
README.md - Sync Manager → Partition & Export: partitions events
sync_manager.py - Partition & Export → Local Archive Files: writes exports
src/partitioner.py - Sync Manager → Drive Authentication: authenticates
sync_manager.py - Sync Manager → Drive Folder Management: gets or creates
sync_manager.py - Sync Manager → Drive File Upload: uploads files
sync_manager.py - Drive Folder Management → Google Shared Drive: organizes folders
README.md - Drive File Upload → Google Shared Drive: stores exports
README.md - Sync Manager → Progress Reporter: reports status
sync_manager.py - Progress Reporter → Dashboard Event Stream: emits updates
web_ui.py - Dashboard Event Stream → Web Dashboard: streams progress
web_ui.py