Watches user activity on issues, sends reminders on disqualification threshold, and eventually unassigns inactive user to ensure that tasks don't stall, and subtracts XP.
The system utilizes a dedicated CRON workflow (cron.yml) that runs periodically to manage and update reminders. This CRON system maintains state in a database and automatically enables/disables itself based on pending updates. It tracks user activity by updating comment timestamps and handles the reminder notifications and automatic unassign of inactive users according to the configured time frames.
Daemon Disqualifier is built as a TypeScript-based GitHub Action that monitors pull request activity and manages reviewer assignments. The system uses a combination of event-driven processing and scheduled tasks to maintain an efficient code review workflow.
The project includes a comprehensive test suite using Jest:
- Unit Tests: Cover individual components and utilities
- Integration Tests: Test interaction between components
- Mock System (
tests/__mocks__/):- Database mocks
- HTTP route mocks
- GitHub API mocks
- User activity simulation
bun installTo start a local instance, run
supabase startAfterward, you can generate types for full auto-completion with
bun run supabase:generate:localTo start Jest testing, run
bun run test- plugin: ubiquity-os/daemon-disqualifier
with:
# Time period after which inactive reviewers are unassigned
disqualification: "7 days"
# Time period after which warning notifications are sent
warning: "3.5 days"
# Enable faster processing for priority items
prioritySpeed: true
# Enforce pull request requirement
pullRequestRequired: true
watch:
# Repositories to exclude from monitoring
optOut:
- "repoName"
- "repoName2"
# List of GitHub webhook events to process (these are the tail of the webhook event i.e. pull_request.review_requested)
eventWhitelist:
- "review_requested"
- "ready_for_review"
- "commented"
- "committed"