Skip to content

README.md

Latest commit

 

History

History
52 lines (35 loc) · 2.22 KB

README.md

File metadata and controls

52 lines (35 loc) · 2.22 KB

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