[example] Repo Health Dashboard

[bnchrch]

Overview

Aggregates key repository health metrics from the GitHub API — PR merge times, issue response times, contributor activity, release cadence, CI pass rates — and computes bus factor to produce a comprehensive health report with trends.

Input: GitHub repo URL
Output: Repo health report with trend metrics, contributor analysis, and bus factor score

APIs Required

• GitHub REST API

Folder Structure

Based on: output-dev-folder-structure skill

This workflow lives at src/workflows/repo_health_dashboard/:

• workflow.ts — deterministic orchestration (no I/O, no Date.now(), no Math.random())
• steps.ts — all HTTP, LLM, and external API calls
• types.ts — Zod input/output schemas
• prompts/ — LLM prompt templates (if needed)
• scenarios/ — test input JSON files

Scenario

Based on: output-dev-scenario-file skill

Create src/workflows/repo_health_dashboard/scenarios/happy_path.json with a realistic sample input, e.g.:

{
  "repoUrl": "https://github.com/owner/repo"
}

Test Plan

Based on: output-workflow-run skill

1. Start the dev environment:

   npx output dev

2. Add credentials: run npx output credentials edit — add GitHub personal access token
3. Run with the scenario:

   npx output workflow run repo_health_dashboard --scenario happy_path

   Or with inline input:

   npx output workflow run repo_health_dashboard --input '{"repoUrl": "https://github.com/owner/repo"}'

4. Confirm the output matches the expected schema and content.