# 🔨 Hammer Queue

Task queue dashboard for Hammer (AI assistant). Lets Donovan see what Hammer is working on, what's queued, and control task ordering.

## Stack

- **Frontend:** React + Vite + TypeScript + Tailwind CSS
- **Backend:** Elysia + Bun + TypeScript
- **Database:** PostgreSQL + Drizzle ORM
- **Deploy:** Docker Compose / Dokploy

## Quick Start (Local Dev)

```bash
# Start Postgres
docker compose up db -d

# Backend
cd backend
cp .env.example .env
bun install
bun run db:push
bun run dev

# Frontend (separate terminal)
cd frontend
bun install
bun run dev
```

## Docker

```bash
docker compose up --build
```

Frontend: http://localhost:8080
Backend API: http://localhost:3100

## API

### Public (no auth)
- `GET /api/tasks` - List all tasks (sorted: active → queued → blocked → completed)
- `GET /health` - Health check

### Authenticated (Bearer token)
- `POST /api/tasks` - Create task
- `PATCH /api/tasks/:id` - Update task (status, priority, etc.)
- `POST /api/tasks/:id/notes` - Add progress note
- `PATCH /api/tasks/reorder` - Reorder queued tasks `{ ids: string[] }`
- `DELETE /api/tasks/:id` - Delete task

### Example: Hammer creates a task
```bash
curl -X POST http://localhost:3100/api/tasks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Build task queue dashboard", "source": "donovan", "priority": "high"}'
```

### Example: Hammer updates status
```bash
curl -X PATCH http://localhost:3100/api/tasks/$TASK_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'
```

### Example: Add progress note
```bash
curl -X POST http://localhost:3100/api/tasks/$TASK_ID/notes \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note": "Scaffolded backend, working on frontend now"}'
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `DATABASE_URL` | Postgres connection string | `postgres://hammer_queue:hammer_queue@localhost:5432/hammer_queue` |
| `API_BEARER_TOKEN` | Bearer token for write API | `hammer-dev-token` |
| `PORT` | Backend port | `3100` |