feat: add GitHub repository dashboard with Prometheus metrics

ghtracker authenticates as a GitHub App and scans a configured list of repositories on a schedule. It serves a dashboard, a JSON state endpoint, a health probe and Prometheus metrics. The dashboard lists only items that need attention: failing workflows, pull requests that wait too long or fail their checks, stale issues and projects that failed to scan. It has search, dynamic filters and a button that rescans on demand. The Vue app is embedded in the Go binary. The client protects the GitHub rate limit with conditional requests, a request reserve and Retry-After handling.
2026-10-14 00:58:36 +00:00 · 2026-10-02 04:28:52 +01:00
commit 5313b56774
110 changed files with 10967 additions and 0 deletions
@@ -0,0 +1,306 @@
+import { mount } from '@vue/test-utils'
+import { describe, expect, it } from 'vitest'
+import AgeMeter from './AgeMeter.vue'
+import AppHeader from './AppHeader.vue'
+import AttentionList from './AttentionList.vue'
+import FilterBar from './FilterBar.vue'
+import AttentionRow from './AttentionRow.vue'
+import FleetOverview from './FleetOverview.vue'
+import ProjectList from './ProjectList.vue'
+import RepoGroup from './RepoGroup.vue'
+import { activeFilterCount, emptyFilters, facetCounts, type Filters } from '@/lib/filters'
+import { buildBlocks, computeFacts, countByRepo } from '@/stores/tracker'
+import { hoursAgo, mixedState, NOW, repo } from '@/test/fixtures'
+import type { Row } from '@/lib/types'
+
+const nowMs = Date.parse(NOW)
+const CRIT_SECONDS = 604800
+const text = (w: { text(): string }) => w.text().replace(/\s+/g, ' ')
+
+describe('AppHeader', () => {
+  const base = {
+    lastRefresh: '2026-10-02T11:00:00Z',
+    nowMs,
+    intervalSeconds: 21600,
+    loaded: true,
+    scanning: false,
+  }
+
+  it('shows when data was fetched and when the next refresh is due', () => {
+    const w = mount(AppHeader, { props: { ...base, manualRefresh: false } })
+    expect(text(w.get('[data-test=updated]'))).toBe('Scanned 1h ago · next in 5h')
+    expect(w.find('[data-test=rescan]').exists()).toBe(false)
+  })
+
+  it('shows Loading before the first refresh finishes', () => {
+    const w = mount(AppHeader, { props: { ...base, loaded: false, manualRefresh: false } })
+    expect(w.text()).toContain('Loading')
+  })
+
+  it('emits rescan and shows progress while a scan runs', async () => {
+    const w = mount(AppHeader, { props: { ...base, manualRefresh: true } })
+    expect(w.get('[data-test=rescan]').text()).toBe('Rescan repositories')
+    await w.get('[data-test=rescan]').trigger('click')
+    expect(w.emitted('rescan')).toHaveLength(1)
+    const busy = mount(AppHeader, { props: { ...base, manualRefresh: true, scanning: true } })
+    expect(busy.get('[data-test=rescan]').attributes('disabled')).toBeDefined()
+    expect(busy.get('[data-test=rescan]').text()).toBe('Rescanning…')
+  })
+})
+
+describe('FleetOverview', () => {
+  const s = mixedState()
+  const props = {
+    crit: 2,
+    warn: 1,
+    blockCount: 1,
+    repos: s.repos,
+    counts: countByRepo(s),
+    facts: computeFacts(s),
+    focused: null,
+    matching: new Set(['o/r', 'o/fine']),
+  }
+
+  it('leads with the critical and warning counts and the scope', () => {
+    const w = mount(FleetOverview, { props })
+    const headline = w.get('[data-test=headline]').text()
+    expect(headline).toMatch(/2\s*critical/)
+    expect(headline).toMatch(/1\s*warning/)
+    expect(w.get('[data-test=scope]').text()).toBe('1 of 2 projects need attention')
+  })
+
+  it('lists the headline facts, dimming zeros', () => {
+    const w = mount(FleetOverview, { props })
+    const facts = Object.fromEntries(
+      w.findAll('[data-test=facts] > div').map((d) => [d.get('dt').text(), d.get('dd').text()]),
+    )
+    expect(facts).toMatchObject({
+      'Workflows failing': '1',
+      'Stale issues': '2',
+      'Data problems': '0',
+    })
+  })
+
+  it('says all clear when nothing is wrong', () => {
+    const w = mount(FleetOverview, { props: { ...props, crit: 0, warn: 0, blockCount: 0 } })
+    expect(w.get('[data-test=headline]').text()).toBe('All clear')
+    expect(w.get('[data-test=scope]').text()).toBe('All 2 projects are healthy')
+  })
+
+  it('draws one segment per project, labelled for screen readers, and emits on click', async () => {
+    const w = mount(FleetOverview, { props: { ...props, focused: 'o/r' } })
+    const segments = w.findAll('[data-test=segment]')
+    expect(segments).toHaveLength(2)
+    expect(segments[0].attributes('aria-label')).toBe('o/r: 2 critical · 1 warning')
+    expect(segments[0].attributes('aria-pressed')).toBe('true')
+    expect(segments[1].attributes('aria-label')).toBe('o/fine: healthy')
+    await segments[1].trigger('click')
+    expect(w.emitted('select')?.[0]).toEqual(['o/fine'])
+  })
+})
+
+describe('AgeMeter', () => {
+  it('fills proportionally and always shows at least one segment', () => {
+    const filled = (ratio: number) =>
+      mount(AgeMeter, { props: { ratio, severity: 'crit' } })
+        .findAll('span span')
+        .filter((s) => s.classes().includes('bg-crit')).length
+    expect(filled(0)).toBe(1)
+    expect(filled(0.5)).toBe(5)
+    expect(filled(3)).toBe(10)
+  })
+
+  it('uses the warning colour for warnings', () => {
+    const w = mount(AgeMeter, { props: { ratio: 0.2, severity: 'warn' } })
+    expect(w.find('.bg-warn').exists()).toBe(true)
+    expect(w.find('.bg-crit').exists()).toBe(false)
+  })
+})
+
+describe('AttentionRow', () => {
+  const row = (over: Partial<Row> = {}): Row => ({
+    kind: 'pr_waiting',
+    subject: '#5 <b>bold</b> title',
+    detail: 'open 9d',
+    url: 'https://github.com/o/r/pull/5',
+    since: hoursAgo(216),
+    severity: 'crit',
+    ...over,
+  })
+
+  it('links the subject, shows the age and escapes markup', () => {
+    const w = mount(AttentionRow, { props: { row: row(), nowMs, critSeconds: CRIT_SECONDS } })
+    expect(w.get('a').attributes('href')).toBe('https://github.com/o/r/pull/5')
+    expect(w.text()).toContain('<b>bold</b>')
+    expect(w.find('b').exists()).toBe(false)
+    expect(w.text()).toContain('9d')
+    expect(w.text()).toContain('Critical')
+  })
+
+  it('shows the age meter only for waiting pull requests', () => {
+    const pr = mount(AttentionRow, { props: { row: row(), nowMs, critSeconds: CRIT_SECONDS } })
+    expect(pr.find('[aria-label$="critical age"]').exists()).toBe(true)
+    const wf = mount(AttentionRow, {
+      props: { row: row({ kind: 'workflow_failed' }), nowMs, critSeconds: CRIT_SECONDS },
+    })
+    expect(wf.find('[aria-label$="critical age"]').exists()).toBe(false)
+  })
+
+  it('omits the age for an unknown timestamp', () => {
+    const w = mount(AttentionRow, {
+      props: {
+        row: row({ since: '0001-01-01T00:00:00Z', kind: 'issues_stale' }),
+        nowMs,
+        critSeconds: CRIT_SECONDS,
+      },
+    })
+    expect(w.find('.font-mono').text()).toBe('')
+  })
+})
+
+describe('RepoGroup', () => {
+  const block = buildBlocks(mixedState())[0]
+
+  it('shows the repo, its version link and an item count', () => {
+    const w = mount(RepoGroup, { props: { block, nowMs, critSeconds: CRIT_SECONDS } })
+    expect(w.text()).toContain('o/')
+    expect(w.get('a[href="https://github.com/o/r"]').text()).toContain('r')
+    expect(w.get('a[href="https://github.com/o/r/releases/tag/v1.0.0"]').text()).toBe('v1.0.0')
+    expect(w.text()).toContain('2 items')
+    expect(w.findAll('[data-test=row]')).toHaveLength(2)
+  })
+
+  it('omits the version badge without a release and uses the singular for one item', () => {
+    const one = { repo: repo({ release: null }), rows: [block.rows[0]] }
+    const w = mount(RepoGroup, { props: { block: one, nowMs, critSeconds: CRIT_SECONDS } })
+    expect(w.find('a[href*="/releases/"]').exists()).toBe(false)
+    expect(w.text()).toContain('1 item')
+  })
+})
+
+describe('AttentionList', () => {
+  const blocks = buildBlocks(mixedState())
+  const props = {
+    blocks,
+    nowMs,
+    critSeconds: CRIT_SECONDS,
+    facets: facetCounts(blocks, emptyFilters(), ['o']),
+    owners: ['o'],
+    active: 0,
+    filters: emptyFilters(),
+  }
+
+  it('renders one group per repo', () => {
+    const w = mount(AttentionList, { props })
+    expect(w.findAll('[data-test=repo-block]')).toHaveLength(1)
+  })
+
+  it('bubbles filter changes up', async () => {
+    const w = mount(AttentionList, { props })
+    await w.get('[data-test=sev-crit]').trigger('click')
+    const [emitted] = w.emitted('update:filters')!.at(-1) as [Filters]
+    expect(emitted.severity).toBe('crit')
+  })
+
+  it('forwards clear', async () => {
+    const w = mount(AttentionList, { props: { ...props, active: 2 } })
+    await w.get('[data-test=clear-all]').trigger('click')
+    expect(w.emitted('clear')).toHaveLength(1)
+  })
+
+  it('explains an empty selection', () => {
+    const w = mount(AttentionList, { props: { ...props, blocks: [] } })
+    expect(w.get('[data-test=empty]').text()).toContain('Nothing matches')
+  })
+})
+
+describe('FilterBar', () => {
+  const blocks = buildBlocks(mixedState())
+  const base = (filters: Filters = emptyFilters(), owners = ['o', 'p']) => ({
+    facets: facetCounts(blocks, filters, owners),
+    owners,
+    active: activeFilterCount(filters),
+    filters,
+  })
+
+  it('shows live counts in every facet', () => {
+    const w = mount(FilterBar, { props: base() })
+    expect(w.get('[data-test=sev-all]').text()).toBe('All 2')
+    expect(w.get('[data-test=sev-crit]').text()).toBe('Critical 2')
+    expect(w.get('[data-test=sev-warn]').text()).toBe('Warnings 0')
+    expect(w.get('[data-test=kind-workflow]').text()).toContain('1')
+    expect(w.get('[data-test=kind-pr]').text()).toContain('1')
+    expect(w.get('[data-test=owner-o]').text()).toContain('2')
+  })
+
+  it('disables facet values that would match nothing, but not selected ones', () => {
+    const w = mount(FilterBar, { props: base() })
+    expect(w.get('[data-test=kind-issue]').attributes('disabled')).toBeDefined()
+    expect(w.get('[data-test=owner-p]').attributes('disabled')).toBeDefined()
+    expect(w.get('[data-test=kind-pr]').attributes('disabled')).toBeUndefined()
+    const sel = mount(FilterBar, { props: base({ ...emptyFilters(), kinds: ['issue'] }) })
+    expect(sel.get('[data-test=kind-issue]').attributes('disabled')).toBeUndefined()
+  })
+
+  it('narrows the other facets when one is selected', () => {
+    const w = mount(FilterBar, { props: base({ ...emptyFilters(), kinds: ['workflow'] }) })
+    expect(w.get('[data-test=sev-all]').text()).toBe('All 1')
+    expect(w.get('[data-test=kind-pr]').text()).toContain('1')
+  })
+
+  it('hides the owner filter when there is only one owner', () => {
+    const w = mount(FilterBar, { props: base(emptyFilters(), ['o']) })
+    expect(w.find('[data-test=owner-o]').exists()).toBe(false)
+  })
+
+  it('emits typed search text and clears it with Escape', async () => {
+    const w = mount(FilterBar, { props: base() })
+    const input = w.get('[data-test=search]')
+    await input.setValue('grpc')
+    expect((w.emitted('update:filters')!.at(-1) as [Filters])[0].query).toBe('grpc')
+    const typed = mount(FilterBar, { props: base({ ...emptyFilters(), query: 'grpc' }) })
+    await typed.get('[data-test=search]').trigger('keydown', { key: 'Escape' })
+    expect((typed.emitted('update:filters')!.at(-1) as [Filters])[0].query).toBe('')
+  })
+
+  it('offers to clear active filters with a count', async () => {
+    const f = { ...emptyFilters(), query: 'x', kinds: ['pr' as const] }
+    const w = mount(FilterBar, { props: base(f) })
+    expect(w.get('[data-test=clear-all]').text()).toBe('Clear 2 filters')
+    await w.get('[data-test=clear-all]').trigger('click')
+    expect(w.emitted('clear')).toHaveLength(1)
+    expect(mount(FilterBar, { props: base() }).find('[data-test=clear-all]').exists()).toBe(false)
+  })
+})
+
+describe('ProjectList', () => {
+  const repos = mixedState().repos
+
+  it('lists every project with release, counts and links', () => {
+    const w = mount(ProjectList, { props: { repos, total: 2, focused: null, nowMs } })
+    const rows = w.findAll('[data-test=project]')
+    expect(rows).toHaveLength(2)
+    expect(rows[0].text()).toContain('v1.0.0')
+    expect(rows[0].text()).toContain('released 3d ago')
+    expect(rows[0].text()).toContain('1/3 failing')
+    expect(rows[0].get('a[href="https://github.com/o/r/pulls"]').text()).toContain('2')
+    expect(rows[0].get('a[href="https://github.com/o/r/issues"]').text()).toContain('4')
+    expect(rows[1].get('a[href="https://github.com/o/fine/releases"]').text()).toBe('no release')
+  })
+
+  it('shows how many projects match and a hint when none do', () => {
+    const some = mount(ProjectList, {
+      props: { repos: repos.slice(0, 1), total: 2, focused: null, nowMs },
+    })
+    expect(some.get('[data-test=project-count]').text()).toBe('1 of 2')
+    const none = mount(ProjectList, { props: { repos: [], total: 2, focused: null, nowMs } })
+    expect(none.find('[data-test=no-projects]').exists()).toBe(true)
+  })
+
+  it('emits the repo when its name is chosen and highlights the focused one', async () => {
+    const w = mount(ProjectList, { props: { repos, total: 2, focused: 'o/fine', nowMs } })
+    await w.findAll('[data-test=project] button')[0].trigger('click')
+    expect(w.emitted('select')?.[0]).toEqual(['o/r'])
+    expect(w.findAll('[data-test=project]')[1].classes()).toContain('bg-accent')
+  })
+})