motief/docs/plans/2026-04-24-002-fix-docker-compose-scheduler-plan.md

title	type	status	date
fix: docker-compose.yml references missing scheduler.py	fix	active	2026-04-24

Fix: docker-compose.yml Missing scheduler.py

Overview

docker-compose.yml defines a scheduler service that runs python scheduler.py, but no scheduler.py exists in the repo. This causes docker-compose up to fail for the scheduler service.

Problem Frame

• The scheduler service is a deployment bug
• Either the file was never created, or it was removed and the compose file was not updated
• The schedule dependency in pyproject.toml suggests automated scheduling was intended

Requirements Trace

• R1. docker-compose.yml must reference only existing files
• R2. If scheduling is desired, create scheduler.py; if not, remove the service

Scope Boundaries

Included:

• Fix docker-compose.yml

Excluded:

• Implementing actual scheduling logic (unless user confirms)

Implementation Units

• U1. Determine scheduler intent

Goal: Decide whether to create scheduler.py or remove the service.

Requirements: R1, R2

Dependencies: None

Files:

• Read: docker-compose.yml, pyproject.toml

Approach:

• Check if schedule dependency is used anywhere
• Check if there's a scheduling script under another name
• Decision: If scheduling is not implemented, remove the service for now and create a plan for it later

Test expectation: none — decision unit.

Verification:

• Clear decision documented in this plan

---

• U2. Apply fix

Goal: Make docker-compose.yml valid.

Requirements: R1

Dependencies: U1

Files:

• Modify: docker-compose.yml

Approach:

• Option A: Remove scheduler service (if scheduling is deferred)
• Option B: Create minimal scheduler.py (if scheduling is desired now)

Test scenarios:

• Integration: docker-compose config validates without error
• Happy path: docker-compose up motief works (existing service unchanged)

Verification:

• docker-compose config passes
• No reference to missing scheduler.py

---

Risks & Dependencies

Risk	Mitigation
Removing service breaks someone's workflow	Only remove if confirmed unused; otherwise create stub

Sources & References

• docker-compose.yml
• pyproject.toml (schedule dependency)