An internal tool that automates issue tracking and reporting by fetching top issues from GitHub repositories and generating Slack-compatible payloads for automated notifications.
This tool is designed to:
- Surface high-engagement issues from GitHub repositories
- Automate community reporting through scheduled GitHub Actions
- Provide insights into popular topics and community concerns
- Streamline issue prioritization based on user +1 reactions
- Smart Issue Filtering: Fetches open issues from the last 30 days
- Reaction-based Sorting: Prioritizes issues by +1 reaction count
- Slack Integration: Generates formatted payloads for Slack notifications
- Configurable Parameters: Customizable time range and issue count
- GitHub Actions Ready: Designed for automated workflows
- TypeScript API: Programmatic usage via
src/index.ts
This package uses Bun as the runtime and package manager:
# Install dependencies
bun install# Basic usage
bun src/cli.ts <output-directory>
# Or via npm script
bun run generate ./output
# Example
bun src/cli.ts ./outputimport { createTopIssuesClient } from "@frontal-labs/top-issues";
const client = await createTopIssuesClient({
token: process.env.GH_TOKEN,
repository: "owner/repo",
days: 30,
limit: 5,
});
const result = await client.generateReport("./output");
console.log(result.payload);# .github/workflows/top-issues.yml
name: Top Issues Report
on:
schedule:
- cron: '0 13 * * 1' # Every Monday at 1PM UTC
workflow_dispatch: # Manual trigger
jobs:
generate-report:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Install dependencies
run: bun install
- name: Generate top issues report
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
GH_REPOSITORY: ${{ github.repository }}
run: bun src/cli.ts ./output
- name: Post to Slack
uses: 8398a7/action-slack@v3
with:
status: success
payload_file_path: ./output/slack-payload.json
env:
SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}| Variable | Required | Description |
|---|---|---|
GH_TOKEN |
Yes | GitHub personal access token or Actions token |
GITHUB_TOKEN |
Yes | Alternative name for GitHub token |
GH_REPOSITORY |
No | Repository in format owner/repo (defaults to current repo via git remote) |
GITHUB_REPOSITORY |
No | Alternative name for repository |
OUTPUT_DIR |
No | Default output directory |
The following constants can be modified in src/index.ts:
const DEFAULT_DAYS = 30; // Time range for issue search
const DEFAULT_LIMIT = 5; // Number of top issues to fetchThe tool generates a slack-payload.json file with the following structure:
{
"prelude": "Top 5 issues sorted by +1 reactions (last 30 days).\nNote: This GitHub workflow will run every Monday at 1PM UTC (9AM EST).",
"issue1URL": "https://github.com/owner/repo/issues/123",
"issue1Text": "+1 42: Add support for custom plugins",
"issue2URL": "https://github.com/owner/repo/issues/456",
"issue2Text": "+1 28: Improve error handling in build process"
}# Run tests
bun test
# Generate report locally
bun src/cli.ts ./outputbun test
bun run generate
### Manual Testing
```bash
# Test with a specific repository
GH_REPOSITORY=vercel/turbo bun src/cli.ts ./test-output
# Verify output
cat ./test-output/slack-payload.json
Error: "GITHUB_TOKEN not set"
- Ensure the
GITHUB_TOKENenvironment variable is properly configured - For GitHub Actions, use
${{ secrets.GITHUB_TOKEN }}
Error: "Pass a directory to write the slack payload in"
- Provide an output directory as a command line argument
- Ensure the directory exists and is writable
No issues found
- Check if the repository has open issues in the specified time range
- Verify the repository name and permissions
Enable verbose logging by adding debug statements:
// In src/index.ts
console.log('Search query:', `repo:${owner}/${repo} is:issue is:open created:>=${daysAgo}`);
console.log('Found issues:', issues.map(issue => ({
title: issue.title,
reactions: issue.thumbsUpCount,
url: issue.html_url
})));