recipe-manager/docs/morning-report.md

Morning Report Utility

Produces a concise consolidated workflow report for relay or status dashboards.

Usage

npx ts-node scripts/morning-report.ts [--window <hours>] [--threshold <minutes>]

• --window <hours>: How many hours back to look for recent commits (default: 24)
• --threshold <minutes>: Minutes without progress to consider workflow stalled (default: 60)

Output

• Markdown/text summary with:
  • Recent commits (hash, message, datetime)
  • Current workflow status (phase, overall, last updated)
  • Any detected blockers (from status file)
  • Pending phase updates not yet relayed
  • Stalled indicator if workflow progress is stale + recommended next steps

Example Output

# 🌅 Morning Workflow Report

## Recent Commits (last 24h)
- `abc123` Add orchestrator status tests _(at 2026-03-25T23:05:00.000Z)_

## Workflow Status
- Current phase: **parse**
- State: **running**
- Last updated: 2026-03-26T04:12:00.000Z
- Completed phases: fetch, parse

## ⚠️ Workflow Stalled
- Reason: No progress in 120 minutes (threshold: 60m). Last update: 2026-03-26T04:12:00.000Z
- Recommendation: Restart or debug orchestrator.

## Blockers
- ❗ Blocked: Recipe site returned 500 error

## Pending Phase Updates
- [phase_started] Phase parse started (phase: parse) at 2026-03-26T04:12:00.000Z [id: ab1234]

Tests

Run all related tests:

npx jest scripts/__tests__/morning-report.test.ts