recipe-manager/docs/morning-report.md

54 lines
1.4 KiB
Markdown

# Morning Report Utility
Produces a concise consolidated workflow report for relay or status dashboards.
## Usage
```sh
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
```