Trello Api

trello-api

Servidor de automatización que conecta Trello con el desarrollo asistido por IA. Toma las cards activas del sprint, las procesa y genera prompts listos para usar en [Claude Code](https://claude.ai/code) — con contexto del proyecto, ruta del repositorio, labels y descripción de la tarea incluidos.

Cómo funciona

Boards de Trello → Cards del sprint activo → Prompts estructurados → /prompts/{fecha}/*.md

1. Se obtienen las cards de las listas configuradas (sprint actual, en progreso, sprint-{n})
2. Cada card se enriquece con contexto del proyecto, ruta del repo y labels
3. Se generan archivos markdown organizados por fecha
4. Un scheduler corre la generación automáticamente todos los días a las 9am

Stack

Capa	Tecnología	Por qué
Runtime	Bun	4× más rápido que Node, TypeScript nativo, sin config
Framework	Hono	Mínimo overhead, TypeScript-first, compatible con edge
Validación	Zod	Seguridad en runtime para env vars y límites del sistema
Lenguaje	TypeScript (strict)	Type safety de punta a punta

Sin ORM ni base de datos — los prompts son archivos markdown planos, los boards se configuran en código.

API

GET  /health              → { ok: true }
GET  /cards               → todos los boards, filtrado por listas del sprint activo
GET  /cards/:board        → board específico (vietur | tex)
POST /prompts/generate    → dispara la generación de prompts on demand
GET  /prompts             → índice de todos los archivos generados por fecha

Estructura

src/
├── index.ts        # Bootstrap del servidor + validación de env
├── config.ts       # Definición de boards, repos y templates de prompts
├── trello.ts       # Cliente de la API de Trello (fetch nativo, tipado)
├── claude.ts       # Lógica de generación de prompts
├── prompts.ts      # Orquestación de la generación diaria
├── scheduler.ts    # Scheduler diario con set