Docs

Repo health

Repo health is a single-phase workflow that scans a repository and generates a comprehensive health report. It runs weekly via cron by default, summarizing the state of issues, pull requests, and overall project velocity.

Permission profile: read — read-only access to repository contents and metadata. Cannot modify anything.

Pipeline

Report analyze + summarize

What it covers

  • Open issues count and trend
  • Stale issues (no activity for 30+ days)
  • Label distribution
  • Pull request velocity — opened, merged, and time-to-merge
  • Issues missing labels or assignees
  • Action items and recommendations

Report delivery

When SLACK_DELIVERY_CHANNEL is configured, the report is posted to that Slack channel. The report is also visible in the admin dashboard under the workflow run's session logs.

Triggers

  • Cron: Weekly on Monday at 09:00 UTC (configurable in workflows/cron-health.yaml)
  • Slack: health cliftonc/repo
  • CLI: npm run cli -- health owner/repo