Implement document approval workflow API

[Dimwiddle]

Summary

• build document lifecycle, review, delegation, and escalation API flows backed by SQLAlchemy
• generate SpecLeft feature specs and map each scenario to tests
• add notification tracking and escalation history in responses

Testing

• uv run pytest

[Dimwiddle]

Retrospective

• Failed test runs before green: 3 (initial module import errors, escalation reviewer_ids, escalation event visibility)
• Effort split: spec externalisation 20%, implementation 45%, testing 20%, behaviour verification 15%
• Clarity grades: spec externalisation A-, implementation B+, testing B, behaviour verification B+
• What went well: SpecLeft flow kept scenarios aligned with tests; iterating via targeted tests made edge cases clear
• What was missed/inefficient: handling test client imports and escalation visibility required extra passes; initial reviewer_ids handling missed escalations
• Next time: wire test harness + app imports earlier and validate escalation/reviewer aggregation upfront before full test run

Session usage overview