Skip to content

projectbluefin/queue

Repository files navigation

queue.projectbluefin.io — Clanker Control Panel

Human decision queue for Project Bluefin. Shows all open PRs and hive priority issues across the projectbluefin org that require human input, sorted by hive priority and review state.

Machine-readable reviewer briefing: https://queue.projectbluefin.io/review-guide.md
Live data snapshot (JSON): https://queue.projectbluefin.io/data.json

What it shows

  • Stats bar — P0 · P1 · Triage · Issues · PRs · velocity counts at a glance
  • ⚔ Guardians (left column) — human contributor pull requests, styled with warm gold. The Light we carry.
    • Approved — all required approvals satisfied, ready to merge
    • Needs reviews — CI green, needs one or more additional approvals; shows approval count
    • No reviews — CI green, nobody has looked yet
  • ◎ Ghosts (right column) — agent-driven issues and the machine queue, styled dark/cool sapphire. The machines at work.
    • P0 / P1 — hive-tracked blockers and cycle items ordered by label priority
    • Agent Ready Queue — org-wide issues labeled queue/agent-ready, ready for agent pickup
  • Theme toggle — System / Light / Dark (Catppuccin Mocha/Latte, persists via localStorage)

How it works

generate.js fetches the GitHub Search API using GITHUB_TOKEN and writes:

  • index.html — full dashboard with data baked in for instant first paint
  • data.json — raw snapshot served as a static asset for machine consumption and browser auto-refresh

A GitHub Actions workflow (build.yml) runs every hour, always fetches fresh data from the GitHub API, and commits both files. The browser auto-refreshes every 30 minutes in-place (no page reload) by comparing the generated timestamp in /data.json.

Deployment

GitHub Pages, served from main branch root.
CNAME: queue.projectbluefin.io

Local development

GITHUB_TOKEN=$(gh auth token) node generate.js
open index.html

Reviewer guide

Everything needed to review a Bluefin PR — merge rules, what to check, human gates, hive label taxonomy, quick reference commands — is at:

https://queue.projectbluefin.io/review-guide.md

Also: https://docs.projectbluefin.io/agentic-contributing

About

Human decision queue for Project Bluefin — issues sorted by hive priority

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors