Scheduling Deep Dive

This is a code-aligned walkthrough of the today pipeline.

Core Phases

1. Select the best day template based on status alignment.
2. Expand the template tree, apply variants, and resolve start/end constraints.
3. Compute importance (subtractive model with weighted factors).
4. Re-queue missed items for today reschedule with an importance boost.
5. Inject status-triggered items.
6. Run capacity check and conflict resolution.
7. Fill work windows with flexible items.
8. Insert buffers, then save the schedule.

Conflict Resolution Loop

• Shift the less important item after the more important one.
• Trim down to a 5-minute minimum.
• Cut items if enabled and not essential/anchored.

Work Windows vs. Time Blocks

• Time Blocks are fixed activities scheduled at specific times.
• Work Windows are dynamic containers that pull matching items into gaps.

Key Files

• Modules/Scheduler.py and Modules/Today.py (core logic).
• User/Settings/Scheduling_Priorities.yml (importance weights).
• User/Settings/Buffer_Settings.yml (buffer rules).