recipe-manager/tests/phase-updates-queue-README.md

Phase Update Queue: Manual Test/Verification

This file documents manual test strategy for phase update events integration.

• Unit tests validate:

  • Events written (appendPhaseUpdate)
  • Reading only pending (getPendingPhaseUpdates)
  • Marking sent (markPhaseUpdateSent)
  • Retrieval (getAllPhaseUpdates)

• Integration Points:

  • SequentialOrchestrator emits correct events at phase boundaries
  • Events expected:
    • phase_started
    • phase_succeeded
    • phase_failed (with failure reason)
    • workflow_completed
  • Fields: eventType, phase, timestamp, summary, details, relayStatus

To run tests:

npx vitest run src/backend/services/__tests__/PhaseUpdateQueue.test.ts

Integration Manual Testing

• Run a workflow and observe contents of status/phase-updates.jsonl
• Check that main orchestrator can fetch and relay pending events
• Mark events sent and verify relayStatus=sent