Dashboard

Repository Dashboard

Use this when: You want a quick overview of repository status, priority work items, and health metrics.

Displays priority PRs/issues, suggested next tasks, CI/CD health, and deployment status with intelligent prioritization based on user context.

Usage

/dashboard [mode]

Modes:

• (none): compact (default) - Top 5-8 most important items
• detailed: Top 10-15 items with more context
• full: Everything with complete details

Implementation

Step 1: Collect Data

Run the data collection script:

bash .claude/commands/dashboard/scripts/dashboard.sh

This outputs structured JSON with all repository data.

Step 2: Parse and Present

Parse the JSON output and present it according to the mode requested. The JSON structure is:

{
  "user": {
    "github_user": "string",
    "is_pulumi_member": boolean,
    "current_branch": "string",
    "uncommitted_changes": number,
    "rate_remaining": number
  },
  "prs": [
    {
      "number": number,
      "title": "string",
      "author": {"login": "string"},
      "isDraft": boolean,
      "createdAt": "timestamp",
      "labels": [{"name": "string"}],
      "priority": number,
      "age_days": number,
      "type": "normal",
      "is_assigned": boolean,
      "is_mentioned": boolean
    }
  ],
  "issues": [
    {
      "number": number,
      "title": "string",
      "age_days": number,
      "labels": [{"name": "string"}]
    }
  ],
  "workflows": {
    "status": "HEALTHY|WARNING|CRITICAL|UNKNOWN",
    "total_runs": number,
    "success_runs": number,
    "failure_runs": number,
    "success_rate": number,
    "recent": [
      {
        "name": "string",
        "status": "string",
        "conclusion": "string",
        "createdAt": "timestamp"
      }
    ]
  },
  "deployment": {
    "last_push_conclusion": "string",
    "last_push_time": "string"
  },
  "stats": {
    "total_prs": number,
    "assigned_prs": number,
    "total_issues": number,
    "assigned_issues": number
  }
}

Step 3: Format Dashboard

Create a terminal-friendly dashboard with these sections:

Header Section

════════════════════════════════════════════════════════════════════════════════
📊 PULUMI REGISTRY DASHBOARD
════════════════════════════════════════════════════════════════════════════════

👤 User: @{github_user} ({internal|external}) | Branch: {branch} | Uncommitted: {count}

If rate_remaining < 50, show warning: ⚠️ GitHub API rate limit low ({count} remaining) - dashboard requires 6+ API calls

Priority Items Section

PRs:

• Sort by priority (descending), then by age_days (descending)
• Show emojis based on type:
• 📝 = normal (or draft if isDraft: true)
• 🤖 = bot author (contains [bot] in username or is pulumi-bot)
• Deprioritize PRs with automation/merge or automation/tfgen-provider-docs labels (these are routine bot PRs)
• Format: {emoji} #{number} {title} ({age}d)
• Truncate titles to 60 characters

Item limits by mode:

• compact: Top 5 PRs
• detailed: Top 10 PRs
• full: Top 20 PRs (or all if less)

Issues:

• Show assigned issues after PRs
• Format: 🐛 #{number} {title} (issue, {age}d)
• Same limits as PRs (5/10/20)

Suggested Tasks Section

Generate actionable tasks based on data. Priority order:

• Uncommitted changes (if uncommitted_changes > 0):
• 📝 Review and commit {count} uncommitted changes → git status

• Assigned PRs (is_assigned: true):
• 🔍 Review assigned PR #{number}: {short_title} → /pr-review {number}
• Limit to top 3 by priority

• Community package submissions (non-bot PRs touching themes/default/data/registry/packages/):
• 📦 Review community package submission PR #{number} → /pr-review {number}
• Limit to top 2

• Assigned issues:
• 🐛 Work on issue #{number}: {short_title} → gh issue view {number}
• Limit to top 2

• Workflow failures (if status: "CRITICAL" and recent failures):
• ❌ Investigate workflow failure: {name} → gh run list --workflow "{name}"

• Current branch work (if not on master/main):
• 🔧 Continue work on branch {current_branch}

Task limits by mode:

• compact: Top 3 tasks
• detailed: Top 5 tasks
• full: Top 10 tasks

Number tasks sequentially: 1., 2., etc.

Health Section

────────────────────────────────────────────────────────────────────────────────
🏥 HEALTH: {emoji} {status} (24h: {total_runs} runs, {success_rate}% success)
────────────────────────────────────────────────────────────────────────────────

Status emojis:

• ✅ = HEALTHY
• ⚠️ = WARNING
• ❌ = CRITICAL
• ❓ = UNKNOWN

Recent workflows (top 3):

• Calculate time ago from createdAt timestamp
• Format: Recent: {emoji} {name} ({time}, {conclusion})
• Join multiple with |
• Emojis: ✅ success, ❌ failure, ⏳ in_progress, ⏸️ other

Deployment info:

• Show last successful push.yml run status and time
• Format: Deploy: {conclusion} ({time_ago}) | PRs: {total} open ({assigned} assigned) | Issues: {total} ({assigned} assigned)

Footer

════════════════════════════════════════════════════════════════════════════════
Tip: Use '/dashboard detailed' or '/dashboard full' for more information

Adjust tip based on current mode.

Priority Scoring Algorithm

PRs are scored with these weights (already calculated in JSON):

• +100: Assigned to me
• +80: Mentions me
• +40: Ready for review (not draft)
• +30: Team member (internal users only)
• +50: Age > 14 days
• +25: Age > 7 days
• -20: Draft
• -30: Has automation/merge or automation/tfgen-provider-docs label (routine bot PRs)

Display Modes

Compact (Default)

• Purpose: Quick status check
• Items: Top 5 PRs/issues, 3 tasks
• Details: Essential info only
• Target: Fits on one screen

Detailed

• Purpose: Standard review workflow
• Items: Top 10 PRs/issues, 5 tasks
• Details: More context per item
• Target: 1-2 screens

Full

• Purpose: Deep investigation
• Items: Top 20+ PRs/issues, 10 tasks
• Details: Complete visibility
• Target: Comprehensive view

Error Handling

If the JSON indicates errors or missing data:

• Show what data is available
• Indicate which sections are unavailable
• Suggest checking GitHub API access or network connection
• Always show local git context (branch, uncommitted changes)

Performance

Target execution time: 3-5 seconds (script runs all API calls in parallel)