import { describe, it, expect, beforeEach, afterEach } from 'vitest'; import { mkdtempSync, rmSync } from 'fs'; import { tmpdir } from 'os'; import { join } from 'path'; import { buildApp } from '../src/server/index.js'; import { init } from '../src/cli/commands/init.js'; describe('server routes', () => { let cwd: string; let app: ReturnType; beforeEach(() => { cwd = mkdtempSync(join(tmpdir(), 'ah-server-')); init(cwd, { projectName: 'server-test', yes: true }); app = buildApp(cwd); }); afterEach(() => { rmSync(cwd, { recursive: true, force: true }); }); it('creates a task via POST /tasks', async () => { const res = await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'API task', role: 'implementer' }, }); expect(res.statusCode).toBe(200); const task = JSON.parse(res.payload); expect(task.id).toBe('TSK-0001'); }); it('lists tasks via GET /tasks', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'GET', url: '/tasks' }); expect(JSON.parse(res.payload)).toHaveLength(1); }); it('returns 404 for unknown task', async () => { const res = await app.inject({ method: 'GET', url: '/tasks/TSK-9999' }); expect(res.statusCode).toBe(404); }); it('returns 400 for unsupported patch', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'unknown' } }); expect(res.statusCode).toBe(400); }); it('returns 400 when claiming without assignedTo', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'in_progress' } }); expect(res.statusCode).toBe(400); }); it('PATCH /tasks/:id → review', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'review' } }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.payload).status).toBe('review'); }); it('PATCH /tasks/:id → cancelled', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'cancelled' } }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.payload).status).toBe('cancelled'); }); it('PATCH /tasks/:id → open (reopen)', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); // First cancel it, then reopen await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'cancelled' } }); const res = await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'open' } }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.payload).status).toBe('open'); }); it('review and cancelled tasks appear in GET /tasks list', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'B', role: 'implementer' } }); await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'review' } }); await app.inject({ method: 'PATCH', url: '/tasks/TSK-0002', payload: { status: 'cancelled' } }); const allRes = await app.inject({ method: 'GET', url: '/tasks' }); const all = JSON.parse(allRes.payload) as Array<{ status: string }>; const statuses = all.map((t) => t.status); expect(statuses).toContain('review'); expect(statuses).toContain('cancelled'); }); it('updates status via POST /status/update', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'A', role: 'implementer' } }); const res = await app.inject({ method: 'POST', url: '/status/update' }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.payload).body).toContain('Active tasks: 1'); }); it('searches memory via GET /memory/search', async () => { await app.inject({ method: 'POST', url: '/memory', payload: { title: 'DNS cache', category: 'technical', content: 'Use TTL' } }); const res = await app.inject({ method: 'GET', url: '/memory/search?q=TTL' }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.payload)).toHaveLength(1); }); it('serves the task board as HTML via GET /board', async () => { const res = await app.inject({ method: 'GET', url: '/board' }); expect(res.statusCode).toBe(200); expect(res.headers['content-type']).toContain('text/html'); const html = res.payload; expect(html).toContain('AgentHub Board'); // All five status columns are present in the static markup. for (const col of ['open', 'in_progress', 'review', 'done', 'cancelled']) { expect(html).toContain(`data-column="${col}"`); } // Handoffs + decisions panels and the polling logic are wired in. expect(html).toContain('Handoffs'); expect(html).toContain('Decisions'); expect(html).toContain("getJSON('/tasks')"); expect(html).toContain('setInterval(refresh'); }); // ── Activity timeline endpoint ───────────────────────────────────────── it('GET /tasks/:id/activity returns 404 for unknown task', async () => { const res = await app.inject({ method: 'GET', url: '/tasks/TSK-9999/activity' }); expect(res.statusCode).toBe(404); }); it('GET /tasks/:id/activity returns a created event', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'Auth', role: 'implementer' } }); const res = await app.inject({ method: 'GET', url: '/tasks/TSK-0001/activity' }); expect(res.statusCode).toBe(200); const items = JSON.parse(res.payload) as Array<{ kind: string; summary: string }>; expect(items.some((i) => i.kind === 'created')).toBe(true); }); it('GET /tasks/:id/activity includes handoff events linked by taskId', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'Auth', role: 'implementer' } }); await app.inject({ method: 'POST', url: '/handoffs', payload: { fromRole: 'architect', toRole: 'implementer', taskId: 'TSK-0001', summary: 'Design done' }, }); const res = await app.inject({ method: 'GET', url: '/tasks/TSK-0001/activity' }); const items = JSON.parse(res.payload) as Array<{ kind: string; summary: string }>; const handoff = items.find((i) => i.kind === 'handoff'); expect(handoff).toBeDefined(); expect(handoff!.summary).toBe('Design done'); }); it('GET /tasks/:id/activity includes memory result events linked by relatedTasks', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'DNS task', role: 'implementer' } }); await app.inject({ method: 'POST', url: '/memory', payload: { title: 'TTL insight', category: 'technical', content: 'Use 300s', relatedTasks: ['TSK-0001'] }, }); const res = await app.inject({ method: 'GET', url: '/tasks/TSK-0001/activity' }); const items = JSON.parse(res.payload) as Array<{ kind: string; summary: string }>; const result = items.find((i) => i.kind === 'result'); expect(result).toBeDefined(); expect(result!.summary).toBe('TTL insight'); }); it('GET /tasks/:id/activity includes tokens/duration from done metadata', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'Work', role: 'implementer' } }); await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'done', doneTokens: 5000, doneDuration: 60000, doneBy: 'claude' }, }); const res = await app.inject({ method: 'GET', url: '/tasks/TSK-0001/activity' }); const items = JSON.parse(res.payload) as Array<{ kind: string; meta?: Record }>; const status = items.find((i) => i.kind === 'status'); expect(status).toBeDefined(); expect(status!.meta?.tokens).toBe(5000); expect(status!.meta?.duration).toBe(60000); expect(status!.meta?.by).toBe('claude'); }); it('board HTML contains the who-arrow rendering logic', async () => { const res = await app.inject({ method: 'GET', url: '/board' }); const html = res.payload; // The handoffRoute helper and the → arrow must be present expect(html).toContain('handoffRoute'); expect(html).toContain('→'); // The who-cell class must be used in renderHandoffs expect(html).toContain('who-cell'); }); it('board HTML keeps cards slim and links to task detail pages', async () => { const res = await app.inject({ method: 'GET', url: '/board' }); const html = res.payload; // Cards carry data-id for realtime refresh bookkeeping and link to detail pages. expect(html).toContain('data-id'); expect(html).toContain('href="/tasks/'); expect(html).not.toContain('class="timeline"'); expect(html).not.toContain('expanded'); expect(html).not.toContain("'/tasks/' + encodeURIComponent(id) + '/activity'"); }); it('task detail HTML shows activity metadata and linked decisions with reasoning', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'Detail transparency', role: 'implementer' } }); await app.inject({ method: 'POST', url: '/decisions', payload: { title: 'Keep cards slim', context: 'Transparency belongs on the task detail page.', decision: 'Task cards link to detail pages instead of expanding inline.', }, }); await app.inject({ method: 'POST', url: '/handoffs', payload: { fromRole: 'architect', toRole: 'implementer', taskId: 'TSK-0001', summary: 'Implement detail view', decisions: ['DEC-0001'], }, }); await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'done', doneTokens: 3210, doneDuration: 65000, doneBy: 'codex' }, }); const res = await app.inject({ method: 'GET', url: '/tasks/TSK-0001', headers: { accept: 'text/html' } }); expect(res.statusCode).toBe(200); expect(res.headers['content-type']).toContain('text/html'); expect(res.payload).toContain('Decisions & Reasoning'); expect(res.payload).toContain('Keep cards slim'); expect(res.payload).toContain('Transparency belongs on the task detail page.'); expect(res.payload).toContain('3210 tok'); expect(res.payload).toContain('1m'); }); it('serves the activity page with recent activity and done archive', async () => { await app.inject({ method: 'POST', url: '/tasks', payload: { title: 'Done item', role: 'implementer' } }); await app.inject({ method: 'PATCH', url: '/tasks/TSK-0001', payload: { status: 'done', doneBy: 'codex' }, }); await app.inject({ method: 'POST', url: '/messages', payload: { from: 'claude', to: 'codex', text: 'Please check the board', taskId: 'TSK-0001' }, }); const res = await app.inject({ method: 'GET', url: '/activity' }); expect(res.statusCode).toBe(200); expect(res.headers['content-type']).toContain('text/html'); expect(res.payload).toContain('Recent Activity'); expect(res.payload).toContain('Done Archive'); expect(res.payload).toContain('MSG-0001'); expect(res.payload).toContain('TSK-0001'); }); it('GET /handoffs returns fromRole and toRole fields', async () => { await app.inject({ method: 'POST', url: '/handoffs', payload: { fromRole: 'architect', toRole: 'implementer', fromAgent: 'claude', toAgent: 'codex', summary: 'Design done', context: 'See decisions', }, }); const res = await app.inject({ method: 'GET', url: '/handoffs' }); expect(res.statusCode).toBe(200); const items = JSON.parse(res.payload) as Array>; expect(items).toHaveLength(1); expect(items[0].fromRole).toBe('architect'); expect(items[0].toRole).toBe('implementer'); expect(items[0].fromAgent).toBe('claude'); expect(items[0].toAgent).toBe('codex'); }); });