nightshift/docs/devlog/phase4.md

Phase 4 Devlog: Task Parser

Implemented

• Added nightshift/tasks.py.
• Implemented parsing for documented markdown checklist tasks.
• Extracted task id, title, completion state, description, acceptance criteria, dependency bullets, raw task markdown, and source line number.
• Added selection of the next incomplete task.
• Added selection of a specific task id.
• Added useful errors for malformed task headers, duplicate ids, missing acceptance criteria, missing files, traversal attempts, and unknown task ids.
• Added parser and selection tests.

Decisions Made

• The parser intentionally supports the documented v1 format rather than broad Markdown. This keeps failure behavior explicit and testable.
• Acceptance criteria are required for each task because downstream pipeline stages need concrete review targets.
• Dependencies are parsed as simple bullets under a Dependencies: section, but no dependency solver is implemented in this phase.
• Completed tasks use [x] or [X]; incomplete tasks use [ ].

Notes

• Task mutation, completion updates, and dependency enforcement are deferred until later pipeline phases.