Architecture

This is a practical overview of how Chronos fits together so you can extend it confidently.

Runtime Overview

• CLI Entrypoint: Modules/Console.py loads commands and scripts, sets UTF‑8, and dispatches to modules.
• Item System: Modules/ItemManager.py reads/writes YAML items in User/ and applies defaults.
• Conditions: Modules/Conditions.py provides if logic with parentheses and exists/matches.
• Scheduler: Modules/Scheduler.py + Commands/Today.py build and refine the day plan.
• Listener: Modules/Listener/Listener.py handles alarms/reminders/timer in the background.
• Dashboard: Utilities/Dashboard serves APIs and mounts vanilla‑JS widgets.

Data Model

Items are YAML files with name, type, and properties. Many items nest children to form a fractal hierarchy (routines → subroutines → microroutines → items).

Settings

Settings live under User/Settings/ and prefer lowercase filenames (e.g., points_settings.yml, <item>_defaults.yml). The Settings widget allows direct editing with validation.

Dashboard API (selected)

• POST /api/cli — run commands
• GET /api/today, POST /api/today/reschedule
• GET /api/items, GET /api/item, POST /api/item*
• GET /api/goals, GET /api/habits
• GET/POST /api/settings — list/read/write settings files

Extending Chronos

• Commands: add Commands/MyCommand.py with run(args, properties).
• Item modules: add Modules/My_Item/main.py with handle_* or handle_command.
• Widgets/views: add Utilities/Dashboard/Widgets/<Name>/index.js and wire in dashboard.html.